Code Cannon

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.

The problem

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.

The solution

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.

What you get

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.

Philosophy

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.

Quick start

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.py

Then optionally run /setup for a guided walkthrough.

To update to the latest version:

CodeCannon/sync.py --update

Documentation

• 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.yaml setting documented
• Adapters — supported agents and how to add new ones
• Skill reference: /start · /submit-for-review · /review · /deploy · /qa · /status · /setup

License

MIT