spec
/spec
Create or open a per-task spec from the canonical template.
When to use
- You have an idea for a slice but haven't written the spec yet.
- A slice was decomposed but needs polish on its constraints / examples.
Steps
- Ask the user (if not provided):
- Slice title
- Target file path (default:
docs/specs/<feature>/<NN>-<slug>.md)
- Copy
agentic-playbook/templates/spec.template.mdto the target path. - Prefill known sections from context:
- Constraints: include the canonical pattern pointer extracted from AGENTS.md / CLAUDE.md or linked docs if known.
- Open the file for the user to edit.
More from wiseiodev/agentic-playbook
worktree
Create a git worktree + branch for a slice using the project naming convention. Use when starting a new slice that should run in parallel with others. Triggers on /worktree, "make a worktree", "new worktree for this slice".
1work
Execute one scoped implementation slice end-to-end with the playbook's full trust loop. Use when the user invokes /work, asks to complete a Linear or GitHub work item, asks to implement one approved plan phase, or explicitly wants an agent-owned implementation slice. The command authorizes branch, implementation, gates, self-QA evidence, anti-overeng review, adversarial review, report, metrics sidecar, commit, push, and a Ready PR after all required gates pass.
1pr
Draft the PR body via the pr-author subagent and open the PR via gh. Use after self-QA + anti-overeng review are clean. Triggers on /pr, "open the PR", "draft the PR body".
1plan
Generate an implementation plan from a locked per-task spec, gated by human approval before any code is written. Use after the spec exists and before implementation. Triggers on /plan, "make a plan", "draft a plan for this spec".
1review
Run anti-overengineering review on the current diff. Invoke after self-QA is green and before opening a PR. Triggers on /review, "review for overengineering", "check the diff for overeng".
1implement
Run implementation phase against an approved plan. Use after /plan has been approved by the human. Triggers on /implement, "implement the plan", "code this up", "execute the plan".
1