Skills

aid-describe

Frontmatter

name — aid-describe
description — 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, Edit
argument-hint — [work-001] resume work [—reset work-001] clear and restart

Definition: canonical/skills/aid-describe/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(["FIRST-RUN<br/>This state runs only when STATE.yml (with its interview…"])
  n2["Q-AND-A<br/>STATE.md ## Cross-phase Q&amp;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

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

Report an issue with this page →