next
Figure out where the Pieceful project stands and propose (then run, after confirmation) the next step in the workflow. Use when the owner types /next, asks "what now / where were we", or a session sta
SKILL.md.claude/skills/next/SKILL.md
GitHub/next: what's the next step?
- Gather state (read only what exists):
- private notes (path in
CLAUDE.local.md):planning/progress.md(Current state),planning/open-questions.md,ideas/inbox.md(Untriaged),backlog/README.md,planning/design-docs-plan.md(phases) - public:
docs/tasks/README.md(board),docs/roadmap.md,docs/product/features/README.md
- private notes (path in
- Pick the most useful next step, in this priority order:
- A task in
review→ remind the owner to review/commit it. - A task in
in-progress→ offer to continue it (/start-task <id>). - Open questions that block the current phase → ask them (AskUserQuestion: options + recommendation).
- The current phase's deliverables are all drafted but not yet reviewed → offer
/tech-review <phase scope>before the owner approves the phase. - The current phase's next deliverable (e.g. the next unwritten feature spec, research item, ADR).
- Untriaged inbox items → offer to triage them into the backlog or feature specs.
- A
todotask whose dependencies are done → offer/start-task <id>.
- A task in
- Report briefly: where things stand (2–3 lines), the proposed next step, and 1–2 alternatives.
- Ask before acting. On confirmation, do the step, using the matching skill (
/new-task,/tech-review,/adr, …) where one exists./start-taskcan only be run by the owner: tell the owner to type/start-task <id>.