Write your AI agent workflow once. Sync it everywhere.
Portable skills for Claude Code, Cursor, Gemini, and Codex — start, review, deploy — across all your projects.
AI coding agents are powerful, but every project reinvents the same workflows: how to create issues, open PRs, run reviews, deploy releases. These instructions live in scattered prompt files, maintained per-project, per-agent, with no consistency and no reuse.
Code Cannon is a shared skill library that lives as a git submodule. Skills are written once as portable markdown. A sync script reads your project config and generates agent-specific command files:
skills/*.md → sync.py + .codecannon.yaml → .claude/commands/*.md
→ .cursor/rules/*.mdc
One source of truth for every project and every agent.
A complete development workflow in five commands:
/start → [code + test] → /submit-for-review → [QA] → /deploy
| Command | What it does |
|---|---|
/start |
Create a GitHub issue, feature branch, and write code |
/submit-for-review |
Check, commit, open PR, run AI review, merge |
/review |
Standalone code review on any PR |
/deploy |
Bump version, create a GitHub Release, promote to production |
/status |
Standup-ready snapshot of PRs, issues, and progress |
Plus /qa for structured QA workflows and /setup for guided onboarding.
Humans stay in the loop. The agent proposes; you approve. /start waits for your sign-off before creating anything. /deploy requires explicit confirmation.
Every change has a ticket. There is no path for code without an issue. The issue is the unit of work — branch, PR, and release all link back to it.
Configure, don't fork. Skills use {{PLACEHOLDER}} tokens. Your .codecannon.yaml fills them in. When upstream improves, pull the submodule and re-sync.
Requires Python 3.8+ (stdlib only — no pip install needed).
git submodule add https://github.com/LightbridgeLab/CodeCannon.git CodeCannon
cp CodeCannon/templates/codecannon.yaml .codecannon.yaml
CodeCannon/sync.pyThen optionally run /setup for a guided walkthrough.
To update to the latest version:
CodeCannon/sync.py --update- Getting started — full quickstart, migration guide, and workflow details
- Branching models — trunk, two-branch, and three-branch workflows
- Customization — tailoring skills, sync.py reference
- Config reference — every
.codecannon.yamlsetting documented - Adapters — supported agents and how to add new ones
- Skill reference: /start · /submit-for-review · /review · /deploy · /qa · /status · /setup