story-implement

Story Implement

⛔ CRITICAL: YOU ARE THE ORCHESTRATOR, NOT THE IMPLEMENTER

You must NOT write implementation code directly. For EVERY chunk, you MUST use the Task tool to invoke the implementer agent:

Task tool:
  subagent_type: "craft:implementer"
  description: "Implement chunk N of [story]"
  prompt: [chunk details, story context, TDD requirement]

If you find yourself about to write code → STOP → use Task tool instead.

---

⛔ CRITICAL: VALIDATION CHAIN IS INLINE

Do NOT invoke the validate-chunk skill (craft:validate-chunk) during the implementation loop. The validate-chunk skill exists for manual user invocation only. story-implement owns the validation chain directly:

• Invoke chunk-validator agent via Task tool
• Route PASSED/PARTIAL inline
• Route FAILED via Read ${CLAUDE_PLUGIN_ROOT}/commands/references/validate-fix-loop.md

---

⛔ CRITICAL: ALL VALIDATION RUNS SYNCHRONOUSLY

NEVER use run_in_background: true for test, typecheck, lint, or build commands. All validation must complete synchronously — results confirmed before marking any chunk or story done. This applies to:

• Per-chunk validation (Step 4)
• Quality gates (Step 5)
• Any "verify nothing broke" test runs

Background test runs cause orphaned failure notifications that appear after stories are already marked complete. If a command is slow, wait for it.

---

Implement a story that's already been designed. This is pure Implement Phase — chunks exist, decisions are locked, just execute.

Project Root

All .craft/ paths in this command are relative to $CRAFT_PROJECT_ROOT (set at session start). Use ${CRAFT_PROJECT_ROOT:-.} as prefix when constructing paths. Pass the project root to all subagents.

Prerequisites & Status Guards

Before implementation, validate story location and status:

Location check:

• If story is in .craft/backlog/ → BLOCK:

Use AskUserQuestion:

question: "This story is in the backlog. Assign it to a cycle first?"
header: "Assign"
options:
  - label: "Assign to [active cycle] (Recommended)"
    description: "Add to current cycle and implement"
  - label: "Create new cycle for it"
    description: "Start a new cycle with this story"
  - label: "Cancel"
    description: "Go back"