aid-describe
Frontmatter
Section titled “Frontmatter”name— aid-describedescription— Gather requirements through an adaptive interview and write them to REQUIREMENTS.md. Use this skill when you know roughly what you want built but the scope, the users, and the acceptance criteria are not yet pinned down. It asks one question at a time, each chosen by a seasoned-analyst elicitation engine that picks its next move from the gaps in what you have said so far. The first run builds the document incrementally; a later run resumes wherever it is still incomplete. It ends by presenting the finished requirements for your approval and handing off to/aid-define.allowed-tools— Read, Glob, Grep, Bash, Write, Editargument-hint— [work-001] resume work [—reset work-001] clear and restart
Definition: canonical/skills/aid-describe/SKILL.md
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(["FIRST-RUN<br/>This state runs only when STATE.yml (with its interview…"])
n2["Q-AND-A<br/>STATE.md ## Cross-phase Q&A has entries with Status…"]
n3{"CONTINUE"}
n4["DESCRIBE-SEED<br/>The seed-authoring step of aid-describe (the aid-describe…"]
n5(["COMPLETION<br/>All sections are Complete or N/A in STATE.md ## Interview…"])
n1 -->|"after scaffolding is complete"| n3
n1 -->|"emits the D1 opener and runs the full-path interview"| n3
n2 --> n3
n3 -. "otherwise" .- n3
n3 -->|"greenfield: no brownfield KB on disk and seed not yet complete"| n4
n3 -->|"when all sections are Complete or N/A"| n5
n4 --> n5
n5 -.-> n2
class n1 aidEntry
class n2 aidStep
class n3 aidDecision
class n4 aidStep
class n5 aidExit
class n1 aidNode
class n2 aidNode
class n3 aidNode
class n4 aidNode
class n5 aidNode
Source fragments
Section titled “Source fragments”Every node in the chart above, in chart order, with the exact canonical/ text it was derived from.
1 · FIRST-RUN — This state runs only when STATE.yml (with its interview… · entry
| FIRST-RUN | `references/state-first-run.md` | `aid-interviewer` | → CONTINUE |Source: canonical/skills/aid-describe/SKILL.md#L274 · full step: canonical/skills/aid-describe/references/state-first-run.md#L1-L111
2 · Q-AND-A — STATE.md ## Cross-phase Q&A has entries with Status… · step
| Q-AND-A | `references/state-q-and-a.md` | `aid-interviewer` | → CONTINUE |Source: canonical/skills/aid-describe/SKILL.md#L275 · full step: canonical/skills/aid-describe/references/state-q-and-a.md#L1-L65
3 · CONTINUE — Resume the conversational interview; STATE.yml’s… · decision
| CONTINUE | `references/state-continue.md` | `aid-interviewer` | → DESCRIBE-SEED (greenfield: no brownfield KB on disk and seed not yet complete) / → COMPLETION (brownfield or seed already complete) |Source: canonical/skills/aid-describe/SKILL.md#L276 · full step: canonical/skills/aid-describe/references/state-continue.md#L1-L44
4 · DESCRIBE-SEED — The seed-authoring step of aid-describe (the aid-describe… · step
| DESCRIBE-SEED | `references/state-describe-seed.md` | `aid-interviewer` | → COMPLETION |Source: canonical/skills/aid-describe/SKILL.md#L277 · full step: canonical/skills/aid-describe/references/state-describe-seed.md#L1-L527
5 · COMPLETION — All sections are Complete or N/A in STATE.md ## Interview… · exit · PAUSE-FOR-USER-DECISION
| COMPLETION | `references/state-completion.md` | `aid-interviewer` | PAUSE-FOR-USER-DECISION → Run /aid-define {work} |Source: canonical/skills/aid-describe/SKILL.md#L278 · full step: canonical/skills/aid-describe/references/state-completion.md#L1-L140