Mode A — Triage (no args)
List every file in {CONTENT_DIR}/specs/drafts/. For each one:
- Read the file
- Print a one-line summary:
[filename] — {title} ({source tag if present}) - Ask the user: pursue, defer, or discard?
After each decision:
- pursue — add a
status: pursueline to the stub's frontmatter (or top of file if no frontmatter) and move on - defer — add
status: deferand move on - discard — confirm once, then delete the file
After all stubs are triaged, print a summary:
Triage complete — {N} pursue, {N} defer, {N} discarded
Pursue list: {names}
Run `/nurture {name}` to flesh out any of these.
Mode B — Flesh out a stub (arg = spec name fragment)
Find the matching file in {CONTENT_DIR}/specs/drafts/ by name fragment. Read it fully.
Then run a focused grill-me interview to build it into a complete spec. Follow the grill-me rules:
- One question at a time
- Walk every branch of the decision tree
- Provide a recommended answer for each question
- If a question can be answered by exploring the codebase, do that instead of asking
Branches to cover (skip any already answered in the stub):
- Problem — what pain does this solve, for whom, how often?
- Sources & inputs — what data/systems does it touch?
- Output — what does done look like? Files, UI, API, side effects?
- Stack — language, libraries, auth strategy
- Phases — what's Phase 1 (smallest useful thing)?
- Risk — what's the hardest part?
- Prerequisites — any one-time setup needed?
When the interview is complete, rewrite the stub file as a full spec using the gestor-collector spec at {CONTENT_DIR}/specs/gestor-collector.md as a format reference.
Ask the user: "Move to candidates for /review-spec?"
- Yes → move file from
{CONTENT_DIR}/specs/drafts/to{CONTENT_DIR}/specs/candidates/ - No → leave in drafts