docs: rewrite Quick Start as short developer guide (CTORNDGAIN-1301)#82
Open
ymakaruk-pixel wants to merge 5 commits into
Open
docs: rewrite Quick Start as short developer guide (CTORNDGAIN-1301)#82ymakaruk-pixel wants to merge 5 commits into
ymakaruk-pixel wants to merge 5 commits into
Conversation
ymakaruk-pixel
commented
May 12, 2026
- Plugin-first install; MCP demoted to labeled fallback
- Bootstrap rule promoted to mandatory step for MCP mode
- Real example regenerated as in coding-flow.md
- New Customize page with examples - needs review and testing
Contributor
Rosetta Triage ReviewSummary: This PR rewrites the Quick Start page as a developer-focused Overview with a plugin-first install path, demotes MCP to a fallback, and adds a new Customize page (209 lines) covering context files, project rules, and helper MCPs — all as website documentation changes only (no code logic modified). Findings:
Suggestions:
Automated triage by Rosetta agent |
da63cee to
28f5321
Compare
- Plugin-first install; MCP demoted to labeled fallback - Bootstrap rule promoted to mandatory step for MCP mode - Real example regenerated against canonical coding-flow.md - New Customize page with worked examples (CONTEXT.md, rules, MCPs) - Sidebar + docs index updated to include Customize Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Cross-checked against docs/web/docs/coding-flow.md per Igor's review request: - Phase names: "Specs + plan" → "Tech plan"; "Plan review" → "Review plan"; "Code review" → "Review code"; "Tests review" → "Review tests" - Artifact names use <FEATURE>-SPECS.md / <FEATURE>-PLAN.md placeholder with plans/PASSWORD-RESET/ as the concrete example - Prompt updated to "Add password reset support to the customer portal. I want to review the plan first." (matches canonical "How To Start" style) - Added scaling footnote: small tasks handle some phases inline and may combine the two HITL gates; approval still always explicit - Linked to /docs/coding-flow/ for canonical phase reference Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- What is Rosetta: cut meta-prompting/four-phase jargon; replaced with plain definition + concrete usage example + IDE list inline. - Why use it: 6 slogan-led bullets to 4 benefit-led bullets; demoted cross-project intelligence to a small italic callout. - How it works: cut duplicate privacy paragraphs and 3 security control bullets (kept in SECURITY.md); added plugin/MCP delivery split with plugin recommended (clients prefer plugins). - Get Started: plugin-first install (Option A) with MCP fallback (Option B); added model-choice warning and mandatory bootstrap rule step for MCP mode; merged verify and initialize. - Cut redundant "Supported IDEs and Agents" section; "any MCP- compatible tool" folded into Option B. - Documentation table: row labels cleaned up for verb consistency and reordered (security before changelog). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
5ab14d8 to
edc35b6
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.