Documentation
PlaybookDiff compiles the instructions, skills, and MCP servers Claude Code and Codex each effectively receive from a repository, then reports the differences it can prove from that repository’s own files.
Install
The CLI is published to npm as playbookdiff and needs Node.js 24.11 or newer within the 24.x line.
npm install -g playbookdiff
playbookdiff check .To try it without installing anything, run npx playbookdiff check .. To run it from a checkout instead, see the CLI reference.
Contents
Using it
- CLIInstall, the three commands, --cwd vs --path, exit codes, and the JSON contract.
- GitHub ActionWorkflow setup, what one run covers, inputs and outputs, and pass/fail behaviour.
- Git regression analysisHow two revisions are compared, and why pre-existing divergence never fails CI.
What it claims
- Scope and limitationsThe supported-semantics matrix, and everything deliberately left unknown.
- Security modelRead-only analysis, no execution, no network, and how secrets are handled.
- Comparison specificationThe deterministic rules behind equivalent, divergent, and unknown.
How it works
- ArchitecturePackages, boundaries, and where harness-specific behaviour is allowed to live.
- Validation strategyHow harness behaviour is established and kept honest by fixtures and tests.
- Claude Code harnessDiscovery rules modelled for Claude Code, with its official documentation cited.
- Codex harnessDiscovery rules modelled for Codex, with its official documentation cited.
Every page here renders the Markdown in the repository’s docs directory (opens in a new tab), which stays the source of truth.