Skills

aid-specify

Frontmatter

name — aid-specify
description — Turn one feature into a technical specification, collaboratively. Use this skill when a feature has been defined and how it will actually be built needs settling before any task is planned. The agent works as a tech lead: it reads the Knowledge Base, the requirements, and the codebase, proposes a technical approach, and refines it with you, writing the result to that feature’s SPEC.md. One feature at a time.
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#L211 · full step: canonical/skills/aid-specify/references/state-initialize.md#L1-L135

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#L212 · 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#L213 · 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#L214 · 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#L215 · full step: canonical/skills/aid-specify/references/state-review.md#L1-L75

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#L216 · full step: canonical/skills/aid-specify/references/state-done.md#L1-L19

Report an issue with this page →