| name | capture-work |
| description | Capture a lightweight work item into BUGS.md, NEXT_STEPS.md, DEFERRED.md, or recommend the feature workflow. Use when a bug, fix, small follow-up, next step, deferred idea, or possible feature comes up during development. |
| argument-hint | ["work item"] |
| allowed-tools | Read, Write, Edit, Glob, AskUserQuestion |
Capture Work
Capture one lightweight work item without the old generic TODO workflow.
Work Lanes
| Lane | File/location | Use when |
|---|
| Feature | features/<name>/ | Meaningful new product capability that needs spec/planning |
| Bug | BUGS.md | Broken behavior, regression, crash, incorrect result, or fix |
| Next step | NEXT_STEPS.md | Small non-bug work the user expects to do soon |
| Deferred | DEFERRED.md | Feature idea or next-step idea not planned indefinitely |
Do not defer bugs. If a bug will not be fixed soon, keep it in BUGS.md with a
note about priority or blocker.
Process
- Get the item text from
$ARGUMENTS; if missing, ask for a concise item.
- Classify using the work lanes above.
- Ask only when classification is genuinely ambiguous.
- Create the target file if missing.
- Append a lightweight entry.
Formats
BUGS.md
# Bugs
## Open
### {Title}
- Severity: P0|P1|P2
- Repro: {short reproduction steps, or "Needs reproduction"}
- Expected: {expected behavior}
- Actual: {actual behavior}
- Notes: {optional context}
If the user did not provide repro/expected/actual, infer only from clear
context. Use Needs reproduction or Not specified instead of inventing.
NEXT_STEPS.md
# Next Steps
## Ranked
1. **{Title}** — {brief context}
Append at the end by default. /triage owns ranking.
DEFERRED.md
# Deferred
## Ideas
- **{Title}** — {why deferred or context}
Deferred means the user is not planning to work on it indefinitely. Imminent
work belongs in NEXT_STEPS.md.
Feature-Sized Work
If the item is too large for NEXT_STEPS.md, do not create a feature directory
automatically. Recommend /feature-spec <name> and include a suggested feature
slug.
Completion
Report the lane and file changed. If no file was changed because the item should
be a feature, report the recommended command.
