agentic-playbook

Interactive guide for hand-shaping a reference feature in a greenfield repo. Use on day 1 of a new project to seed quality gates and canonical patterns before agents take over. Triggers on /bootstrap, "bootstrap a reference feature", "scaffold a canonical pattern".

Set up or operate per-feature Neon database branches for Drizzle projects. Use when schema-changing branches, agents, or worktrees need isolated databases, branch work should use db:push, feature branches must not commit generated migrations, and production migrations should be generated and applied only after merge.

Set up or tighten a repo's preferred quality-gate toolchain. Use when the user invokes /setup-quality, asks to add Biome, Vitest, Commitlint, Lefthook, pnpm scripts, Turbo quality gates, GitHub Actions CI, or wants the preferred quality setup applied to a project.

Break a PRD into ordered tracer-bullet slice specs. Use when a PRD exists and you need a queue of specs ready for plan-gate. Triggers on /decompose, "decompose this PRD", "break this into slices".

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".

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".

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".

Open a per-task spec scaffold from the canonical template, prefilled with reasonable defaults. Use when starting a new slice that needs a spec written. Triggers on /spec, "draft a spec", "spec this slice".

Turn an idea or conversation context into a Linear Project-as-PRD, then into approved Linear issues with Given/When/Then mini-specs. Use when the user wants to create a Linear project from an idea, shape a PRD in Linear, draft behavior slice specs, or publish an approved issue queue to Linear before running /work.

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".

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.

Remove a merged slice's worktree and delete its branch. Run from the main checkout after a PR is merged. Triggers on /cleanup-worktree, "clean up the worktree", "remove the merged 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".