new-task
Turn an idea, backlog draft, or feature slice into a refined public task spec under docs/tasks/ with a per-milestone ID. Use for /new-task or when the owner wants something made buildable.
SKILL.md.claude/skills/new-task/SKILL.md
GitHub/new-task: write a task spec
- Find the source: the argument, an inbox/backlog item (private notes), or a feature spec
docs/product/features/F-xx. Read the linked requirements, ADRs, anddocs/roadmap.md. - Clarify with the owner (AskUserQuestion: options + recommendation) whatever is ambiguous: scope, milestone, acceptance criteria, UX choices. Never fill gaps with silent assumptions.
- Pick the ID: the next free
M<milestone>-NNNfromdocs/tasks/README.md. - Write
docs/tasks/M?-NNN-<short-name>.mdfromdocs/tasks/_template.md:- small enough for one session
- testable acceptance criteria
- a test plan
- the third-party load section
- Update the board in
docs/tasks/README.md. Mark the source as→ promoted to M?-NNNin the private inbox/backlog. - Summarize and stop. Don't commit.