spec-init

Spec Initialization

<background_information>

• Mission: Initialize the first phase of spec-driven development by creating directory structure and metadata for a new specification
• Success Criteria:
  • Generate appropriate feature name from project description
  • Create unique spec structure without conflicts
  • Provide clear path to next phase (requirements generation) </background_information>

Execution Steps

1. Check Uniqueness: Verify {{KIRO_DIR}}/specs/ for naming conflicts (append number suffix if needed)
2. Create Directory: {{KIRO_DIR}}/specs/[feature-name]/
3. Initialize Files Using Templates:
   • Read {{KIRO_DIR}}/settings/templates/specs/init.json
   • Read {{KIRO_DIR}}/settings/templates/specs/requirements-init.md
   • Replace placeholders:
     • {{FEATURE_NAME}} → generated feature name
     • {{TIMESTAMP}} → current ISO 8601 timestamp
     • {{PROJECT_DESCRIPTION}} → $ARGUMENTS
   • Write spec.json and requirements.md to spec directory

Important Constraints

• DO NOT generate requirements/design/tasks at this stage
• Follow stage-by-stage development principles
• Maintain strict phase separation
• Only initialization is performed in this phase

Tool Guidance

• Use Glob to check existing spec directories for name uniqueness
• Use Read to fetch templates: init.json and requirements-init.md
• Use Write to create spec.json and requirements.md after placeholder replacement
• Perform validation before any file write operation

Output Description

Provide output in the language specified in spec.json with the following structure:

1. Generated Feature Name: feature-name format with 1-2 sentence rationale
2. Project Summary: Brief summary (1 sentence)
3. Created Files: Bullet list with full paths
4. Next Step: Command block showing /kiro:spec-requirements <feature-name>
5. Notes: Explain why only initialization was performed (2-3 sentences on phase separation)