By crenshawdev Verified
A planning and execution system for a single developer in Claude Code: one disciplined discuss/plan/execute/verify loop, state in files not conversation, opinionated defaults, a deliberately small surface.
Studies the codebase for a single phase and returns structured, evidence-backed assumptions a planner would otherwise have to guess. Spawned by cad-context.
Executes a Cadence PLAN.md task-by-task with one atomic conventional commit per task, records deviations, and returns a structured report. Spawned by cad-execute or cad-task. Never writes STATE.md.
High-effort escalation variant of cad-plan-checker. Dispatched by the spawn-agent seam's routing step (bin/route.mjs) when auto mode escalates the plan-check role after a prior failure. Identical contract, harder reasoning.
Goal-backward pre-execution gate - verifies a phase plan WILL achieve the phase goal. Spawned by /cad-plan when workflow.plan_check is true.
Turns a roadmap phase into an executable plan - goal-backward task breakdown, dependency ordering, falsifiable verification per task. Spawned by /cad-plan through the spawn-agent seam.
Pre-ship requirement-traceability audit - every requirement traced to a phase, a plan, and a verification; orphan detection both directions; a FAIL gate that catches silently-dropped requirements before a milestone ships
Capture without losing your place - an actionable phase-linked todo (the queue mem-* lacks), a seed idea for a future milestone, or a note. One file: .planning/CAPTURE.md, which the builtin memory backend makes recallable at planning time
Verify factual claims in docs against the live codebase - file paths, commands, code symbols, config keys, structure - and report which are accurate, stale, or unverifiable. Reports; it does not rewrite docs
Execute all plans in a phase - one cad-executor per plan, atomic commit per task, slim per-phase SUMMARY
Quick planning-health check - are .planning's core docs present, and is the STATE cursor / ROADMAP / REQUIREMENTS parseable and mutually consistent? Reports issues and offers to fix trivial ones. Not a traceability audit (that is /cad-audit)
Executes bash commands
Hook triggers when Bash tool is used
Uses power tools
Uses Bash, Write, or Edit tools
Verified owner:John Crenshaw
Based on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Cadence is a planning and execution system for a single developer working in Claude Code. It runs one disciplined loop, discuss then plan then execute then verify, with an atomic commit per task, opinionated defaults, and a deliberately small surface. Your state lives in files, not in the conversation, so you can /clear aggressively and the next command rebuilds from disk.
It is built to say no. One runtime, no team tooling, no feature catalog. What it keeps, it keeps sharp: model routing that spends tokens like a budget, review gates that stop bad work before it lands, and a git model that guards protected branches from ad-hoc pushes and asks how you publish rather than deciding for you, unless you opt into an autonomous close.
Cadence's methodology descends from GSD, the discuss/plan/execute/verify loop, which is where I first ran into it. GSD is what happens when that loop gets built to government standards, an elephant: hundreds of workflows, dozens of agents, a whole TypeScript product wrapped around a four-step idea. Cadence is the mouse. Same loop, its own implementation, about 3% of GSD's documentary mass (measured 2026-07-10, GSD commit d010ea1). See
LINEAGE.mdfor the measured distance,MANIFESTO.mdfor the why, andDESIGN.mdfor the full design.
Most of what makes AI-assisted development expensive is not the model, it is the mess. Context piles up, the same files get read again and again, the conversation drags a week of history into every single turn, and the bill follows the clutter.
Cadence is built the other way around. One loop, discuss then plan then execute then verify. State lives in files, not in the conversation. Clear between steps and you lose nothing. Every task lands as one commit. The heavy reading happens in fresh-context subagents that hand back a short answer instead of emptying a file into your window. Small batches, clean state, tight loops, the same discipline that has always separated software that scales from software that seizes up.
The effect shows up in the numbers. These are measurements of my own real usage, taken from my account's usage data, not telemetry the tool collects. Cadence ships no instrumentation and phones nothing home. Across roughly a billion input tokens of real work, about 96% of that input was served from cache, the cached prefix was reused around 27 times for every rebuild, and fresh uncached input stayed near six hundredths of a percent. Your numbers will vary with your habits. That is not the tool being clever with your money. It is the tool refusing to let your context rot, which keeps the model reading the same clean prefix instead of a growing pile. You still do real work and spend real tokens. You just stop paying full freight to re-read your own history.
Cadence is a Claude Code plugin. Add the marketplace, then install:
/plugin marketplace add https://github.com/crenshawdev/cadence.git
/plugin install cadence@cadence
Update with /plugin update cadence@cadence, remove with /plugin uninstall cadence@cadence. Requires Claude Code with plugin support, plus node and git on your PATH. The scripts inside are zero-dependency: there is no npm install, ever.
Cadence runs as slash commands in Claude Code, namespaced /cadence:cad-* (for example /cadence:cad-new-project). They are written below without the cadence: prefix for brevity. A project moves through five steps, each its own command:
/cad-new-project — define the project through deep questioning: what, why, who, done./cad-context <phase> — gather locked decisions and acceptance criteria before planning./cad-plan <phase> — turn a phase into an executable, checkable plan./cad-execute <phase> — build it, one atomic commit per task./cad-verify <phase> — confirm the phase delivered what it promised./cad-progress tells you where you stand and what's next at any point, and auto-resumes incomplete work.
Everything is a /cad-* command. /cad-help prints the full reference, /cad-help <name> shows one entry.
Review & quality
/cad-plan-review — adversarial review of a plan before any code is written./cad-audit — pre-ship traceability: every requirement traced to a phase, a plan, a verification. Catches silently-dropped work./cad-coverage — find a phase's requirements that have zero failing-capable test coverage, then close the gaps./cad-docs-verify — check factual claims in docs against the live codebase./cad-debug — systematic debugging with hypotheses that survive /clear.npx claudepluginhub crenshawdev/cadenceHarness-native ECC operator layer - 67 agents, 278 skills, 94 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Develop, test, build, and deploy Godot 4.x games with Claude Code. Includes GdUnit4 testing, web/desktop exports, CI/CD pipelines, and deployment to Vercel/GitHub Pages/itch.io.
A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.
Matt Pocock's agent skills for real engineering — grilling, spec/ticket flows, TDD, code review, domain modelling and more. Plug-and-play, not vibe coding.
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques