Initialize Spec Structure

Set up the spec-driven development structure for this project.

What This Does

1. Creates .claude/spec/ directory with SPEC.md
2. Creates .claude/spec/tasks/ for task breakdown files
3. Creates .claude/steering/ with product.md, tech.md, decisions.md
4. Optionally runs the spec-create skill to interview you about the project

Arguments

$ARGUMENTS can include:

• --skip-interview - Just create structure without running interview
• --from-readme - Seed spec from existing README.md

Workflow

1. Check if .claude/spec/SPEC.md already exists

   • If exists: Ask if they want to reset or update
   • If not: Proceed with creation

2. Create directory structure:

   .claude/
   ├── spec/
   │   ├── SPEC.md
   │   ├── tasks/
   │   └── archive/
   └── steering/
       ├── product.md
       ├── tech.md
       └── decisions.md
   

3. Copy templates from plugin:

   • Use ${CLAUDE_PLUGIN_ROOT}/templates/ as source
   • Replace {{DATE}} with current date
   • Replace {{AUTHOR}} with git user.name if available

4. Unless --skip-interview:

   • Invoke the spec-create skill to conduct project interview
   • Generate SPEC.md content from interview answers
   • Create initial task files based on milestones

5. Report what was created and next steps

Example Usage

/spec-flow:init
/spec-flow:init --skip-interview
/spec-flow:init --from-readme

After Initialization

Suggest the user:

1. Review and refine .claude/spec/SPEC.md
2. Run /spec-flow:status to see current state
3. Start working on tasks with spec context loaded