New Feature

Quick Spec Generator

<instructions>
## CRITICAL: Automatic Mode Execution Rules

If --auto flag is present in $ARGUMENTS, you are in AUTOMATIC MODE.

In Automatic Mode:

• Execute ALL 4 phases in a continuous loop without stopping
• Display progress after each phase (e.g., "Phase 1/4 complete: spec initialized")
• IGNORE any "Next Step" messages from Phase 2-4 (they are for standalone usage)
• After Phase 4, run the final sanity review before exiting
• Stop ONLY after the sanity review completes or if error occurs

Core Task

Execute 4 spec phases sequentially. In automatic mode, execute all phases without stopping. In interactive mode, prompt user for approval between phases.

Before claiming quick generation is complete, run one lightweight sanity review over the generated requirements, design, and tasks. If the host supports fresh subagents, use one. Otherwise run the sanity review inline.

Execution Steps

Step 1: Parse Arguments and Initialize

Parse $ARGUMENTS:

• If contains --auto: Automatic Mode (execute all 4 phases)
• Otherwise: Interactive Mode (prompt at each phase)
• Extract description (remove --auto flag if present)

Example:

"User profile with avatar upload --auto" → mode=automatic, description="User profile with avatar upload"
"User profile feature" → mode=interactive, description="User profile feature"

Display mode banner and proceed to Step 2.

Step 2: Execute Phase Loop

Execute these 4 phases in order:

Phase 1: Initialize Spec (Direct Implementation)

Core Logic:

1. Check for Brief:

   • If .kiro/specs/{feature-name}/brief.md exists (created by /kiro-discovery), read it for discovery context (problem, approach, scope, constraints)
   • Use brief content as the project description instead of $ARGUMENTS

2. Generate Feature Name:

   • Convert description to kebab-case
   • Example: "User profile with avatar upload" → "user-profile-avatar-upload"
   • Keep name concise (2-4 words ideally)

3. Check Uniqueness:

   • Use Glob to check .kiro/specs/*/
   • If directory exists with only brief.md (no spec.json), use that directory (discovery created it)
   • Otherwise if feature name exists, append -2, -3, etc.

4. Create Directory:

   • Use Bash: mkdir -p .kiro/specs/{feature-name} (skip if already exists from discovery)

5. Initialize Files from Templates:

   a. Read templates:

   - .kiro/settings/templates/specs/init.json
   - .kiro/settings/templates/specs/requirements-init.md

   b. Replace placeholders:

   {{FEATURE_NAME}} → feature-name
   {{TIMESTAMP}} → current ISO 8601 timestamp (use `date -u +"%Y-%m-%dT%H:%M:%SZ"`)
   {{PROJECT_DESCRIPTION}} → description
   zh → language code (detect from user's input language, default to `en`)

   c. Write files using Write tool:

   - .kiro/specs/{feature-name}/spec.json
   - .kiro/specs/{feature-name}/requirements.md

6. Output Progress: "Phase 1/4 complete: Spec initialized at .kiro/specs/{feature-name}/"

Automatic Mode: IMMEDIATELY continue to Phase 2.

Interactive Mode: Prompt "Continue to requirements generation? (yes/no)"

• If "no": Stop, show current state
• If "yes": Continue to Phase 2

Phase 2: Generate Requirements

Invoke /kiro-spec-requirements {feature-name} via the Skill tool.

Wait for completion. IGNORE any "Next Step" message (it is for standalone usage).

Output Progress: "Phase 2/4 complete: Requirements generated"

Automatic Mode: IMMEDIATELY continue to Phase 3.

Interactive Mode: Prompt "Continue to design generation? (yes/no)"

• If "no": Stop, show current state
• If "yes": Continue to Phase 3

Phase 3: Generate Design

Invoke /kiro-spec-design {feature-name} -y via the Skill tool. The -y flag auto-approves requirements.

Wait for completion. IGNORE any "Next Step" message.

Output Progress: "Phase 3/4 complete: Design generated"

Automatic Mode: IMMEDIATELY continue to Phase 4.

Interactive Mode: Prompt "Continue to tasks generation? (yes/no)"

• If "no": Stop, show current state
• If "yes": Continue to Phase 4