canon

A CLI and Claude Code plugin that runs your agent's work from plan to merge, holds it to established engineering practice, and installs the same setup in every repo.

Quick start

claude plugin marketplace add https://github.com/erclx/canon
claude plugin install canon@canon
bun install --global @erclx/canon

The skills land as /canon:<name>, and the CLI needs Bun on your path. canon runs on Linux and macOS.

Set up a repository with canon init, which lays down its rules, seeds, and configs.

How a change runs

1. Plan	2. Build	3. Review	4. Merge
A planner reads the code and writes one plan you approve	A worker builds it on its own branch, held to the rules	A fresh session reviews the pull request and posts findings	You read the review and merge

Each session works in its own worktree, so several changes run at once.

What lands in your repo

Part	How it reaches you
Skills	Loaded live from the plugin, so there is no copy to drift
Rules	Files under .claude/rules/ that load when you edit a matching path
Configs and seeds	Real files you own, laid down by canon init and kept current by canon sync

For your agent

• Every command runs without a prompt, and data on stdout pipes clean
• canon <command> --help prints each command's flags, exit codes, and examples
• Rules load by path, so the agent gets the rule for the file it is editing

Docs

• AI workflow: the loop a feature runs
• Operating model: planners, workers, and reviewers in parallel
• Skill map: every skill by the moment you reach for it
• Agents: flags, exit codes, and output shapes
• Docs index: every reference doc, updating canon among them

Contributing

Issues are welcome. Pull requests are by invitation, so read the contributing guide before you open one. Released under the MIT license.