Skills

aid-specify

Frontmatter

name — aid-specify
description — Technical specification through conversational refinement, one feature at a time. The agent acts as a tech lead — reads KB, Requirements, and codebase, proposes technical solutions, and builds the spec collaboratively with the user. Writes to SPEC.md in the feature folder. State machine: INITIALIZE → CONTINUE → REVIEW → DONE (SPIKE / BLOCKED are loopback states that return to CONTINUE).
allowed-tools — Read, Glob, Grep, Bash, Write, Edit
argument-hint — work-001/feature-001 (required) [—reset] clear technical spec for this feature

Definition: canonical/skills/aid-specify/SKILL.md

Flow

flowchart TB
  classDef aidNode color:#fff
  classDef aidEntry fill:#166534,stroke:#14532d,color:#fff
  classDef aidExit fill:#991b1b,stroke:#7f1d1d,color:#fff
  classDef aidDecision fill:#92400e,stroke:#78350f,color:#fff
  classDef aidLoopBack fill:#1e3a8a,stroke:#1e3a8a,color:#fff
  classDef aidStep fill:#1a2035,stroke:#d4a853,color:#f1f5f9
  n1(["INITIALIZE<br/>First run for this feature; load context, determine…"])
  n2["CONTINUE<br/>Work STATE.md ## Features State shows this feature In…"]
  n3(["SPIKE<br/>&gt; Source: references/handling-outcomes.md §&quot;Spike Needed…"])
  n4(["BLOCKED<br/>&gt; Source: references/handling-outcomes.md §&quot;Blocked (State…"])
  n5["REVIEW<br/>All sections complete; re-review entire spec against…"]
  n6(["DONE<br/>Spec is Ready and has met the minimum grade; this feature's…"])
  n1 --> n2
  n2 -. "otherwise" .- n2
  n2 -->|"when all sections are Complete"| n5
  n3 --> n2
  n4 --> n2
  n5 -. "otherwise" .- n5
  n5 -->|"when spec is Ready and meets minimum grade"| n6
  class n1 aidEntry
  class n2 aidLoopBack
  class n3 aidExit
  class n4 aidExit
  class n5 aidLoopBack
  class n6 aidExit
  class n1 aidNode
  class n2 aidNode
  class n3 aidNode
  class n4 aidNode
  class n5 aidNode
  class n6 aidNode

Source fragments

Every node in the chart above, in chart order, with the exact canonical/ text it was derived from.

1 · INITIALIZE — First run for this feature; load context, determine… · entry

| INITIALIZE | `references/state-initialize.md` | `aid-architect` | → CONTINUE |

Source: canonical/skills/aid-specify/SKILL.md#L198 · full step: canonical/skills/aid-specify/references/state-initialize.md#L1-L129

2 · CONTINUE — Work STATE.md ## Features State shows this feature In… · loop-back

| CONTINUE | `references/state-continue.md` | `aid-architect` | → REVIEW |

Source: canonical/skills/aid-specify/SKILL.md#L199 · full step: canonical/skills/aid-specify/references/state-continue.md#L1-L112

3 · SPIKE — > Source: references/handling-outcomes.md §“Spike Needed… · exit · PAUSE-FOR-USER-ACTION

| SPIKE | `references/state-spike.md` | `inline` | → CONTINUE |

Source: canonical/skills/aid-specify/SKILL.md#L200 · full step: canonical/skills/aid-specify/references/state-spike.md#L1-L20

4 · BLOCKED — > Source: references/handling-outcomes.md §“Blocked (State… · exit · PAUSE-FOR-USER-ACTION

| BLOCKED | `references/state-blocked.md` | `inline` | → CONTINUE |

Source: canonical/skills/aid-specify/SKILL.md#L201 · full step: canonical/skills/aid-specify/references/state-blocked.md#L1-L17

5 · REVIEW — All sections complete; re-review entire spec against… · loop-back

| REVIEW | `references/state-review.md` | `aid-reviewer` | → DONE |

Source: canonical/skills/aid-specify/SKILL.md#L202 · full step: canonical/skills/aid-specify/references/state-review.md#L1-L74

6 · DONE — Spec is Ready and has met the minimum grade; this feature’s… · exit · HALT

| DONE | `references/state-done.md` | `inline` | → halt |

Source: canonical/skills/aid-specify/SKILL.md#L203 · full step: canonical/skills/aid-specify/references/state-done.md#L1-L19

Report an issue with this page →