Setup

Propose a concrete stack (language, framework, database, test runner, package manager). Base it on what the PRD implies. If the user specified a stack, use that exactly.

Step 4 — Fill in CLAUDE.md

Rewrite the placeholder sections in CLAUDE.md with real values:

• Project name and overview (from PRD)
• Stack & Key Technologies (from Step 3)
• Directory Structure (propose based on stack)
• Common Commands (real commands for the chosen stack)
• Architecture Notes (key decisions and patterns)
• Coding Conventions (stack-specific rules)

Also fill in the Stack-Specific sections in:

• .claude/rules/code-style.md
• .claude/rules/testing.md

Step 5 — Populate .claude/docs/tasks.md

Decompose all PRD features into concrete, actionable tasks. Organise them as:

• 🔴 In Progress — nothing yet (project not started)
• 🟡 Up Next — the first 3–5 tasks to tackle in order
• ⚪ Backlog — everything else from the PRD
• ✅ Done — empty for now

Each task should be one implementable unit of work, not a vague feature name. Bad: - [ ] Authentication Good: - [ ] Set up NextAuth with GitHub + email providers and session middleware

Step 6 — Write an architecture plan

Write .claude/docs/plans/initial-architecture.md covering:

• System overview (what the major layers are)
• Key technical decisions and why
• Directory structure with a brief note on what lives where
• Data models (rough schema for core entities)
• Any risks or open questions from the PRD

Step 7 — Present and wait for approval

Output a summary:

Project: [name] Stack: [chosen stack]

Key decisions:

• [decision 1]
• [decision 2]

Files updated:

• CLAUDE.md
• .claude/docs/tasks.md
• .claude/docs/plans/initial-architecture.md

First 3 tasks queued:

• ...
• ...
• ...

Ready to scaffold. Shall I proceed?

Do NOT write any source code or run any shell commands until the user says yes.

Step 8 — Scaffold (after approval)

Once the user approves:

1. Run the project initialisation command (e.g. npm create vue@latest, poetry init)
2. Install dependencies
3. Create the directory structure
4. Write minimal starter files for each major layer (just enough to run, not full features)
5. Add a placeholder test file
6. Save PRD.md if the user hasn't already — write their PRD text to it
7. Run /commit with message: chore: initial scaffold from PRD