playbook
playbook
Section titled “playbook”How to work with Claude Code, and how to notice what should become permanent. Ships practice skills for running parallel agents in worktrees, suggesting the right model for a task, and verifying without burning the clock, a session retro, and a transcript miner that finds work you keep redoing and routes each finding to the cheapest durable fix: a skill, a bundled script, a live rule, a memory entry, a codebase-map edit, or a ticket. Sessions run to tens of megabytes, so the miner streams them and emits bounded aggregates instead of loading transcripts into context.
Version: 0.4.1
Skills
Section titled “Skills”fan-out: Run several subagents in parallel git worktrees and consolidate their work. Use when asked to fan out, parallelize, split work across agents, use subagent teams, or run agents in worktrees.pick-model: Suggest which model to use for a task, and what each available model is actually good at. Use when choosing or comparing models, deciding what to route work to, or asking which model fits a job.retro: Review this session’s recurring friction and apply workspace improvements. Use for a retrospective, reflection, session review, or workspace improvement.skill-retro: Mine recent Claude Code transcripts, including subagent transcripts, for work that keeps getting redone, then turn each finding into a new or amended skill, bundled script, live rule, memory entry, codebase-map edit, or ticket. Use for a cross-session retro, “what do I keep redoing”, “what do you keep redoing”, turning repeated work into tooling, fixing a skill that keeps failing to trigger or to be followed, or auditing recent sessions for waste and for private data that was one commit from being exposed.verify-discipline: Run tests without burning the clock or the context window: narrow checks while you iterate, the full suite once at the end. Use when running tests, verifying a change, choosing a test command, or when a suite is being re-run repeatedly.
- SessionEnd:
node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/session-nudge.js" - SessionStart (startup):
node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/session-nudge.js"
Bin entrypoints
Section titled “Bin entrypoints”playbook.js