Canon — spec-driven development platform
Project description
Canon
Spec-driven development, automated.
Canon is an AI-native documentation platform. Write structured specs in markdown, and AI agents handle PR reviews, ticket sync, and code verification — keeping product, engineering, and business aligned.
This is the private monorepo. The open-source repo is at canonhq/canon.
Features
- Spec-Aware PR Reviews — Analyzes PRs against relevant specs, identifies which acceptance criteria are addressed, flags gaps
- Bidirectional Ticket Sync — Spec sections sync to Jira, Linear, or GitHub Issues in both directions
- Code-Aware Verification — AI verifies that acceptance criteria are actually implemented, not just that tickets were closed
- Coverage Dashboard — Track spec completion across your org by repo, team, and status
- CLI & MCP Server — Plan, verify, status, sync, search, and dashboard commands with rich terminal output. MCP server for AI coding agents.
- Claude Code Plugin — Spec-aware skills for spec-driven development workflows
Quick Start
Install the GitHub App on your organization:
Or use the CLI:
pip install canonhq
canon setup
canon status
canon dashboard
Documentation
- Docs Site — Full documentation
- Self-Hosting Guide
- Agent Behavior
- Vision
Development
With Devbox (recommended)
Devbox provides a reproducible environment with all tools:
curl -fsSL https://get.jetify.com/devbox | bash # one-time install
devbox shell # enter environment
devbox run test # run tests
devbox run lint # lint + format check
devbox run dev # start dev server
Without Devbox
uv sync --extra dev --extra cloud
uv run pytest
uv run ruff check
uv run uvicorn canon.main:app --reload
See docs/contributing/testing.md for the full testing guide (integration tests, scenario tests, contract recording).
License
BSL 1.1 — converts to Apache 2.0 after four years per release.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file canonhq-1.70.4.tar.gz.
File metadata
- Download URL: canonhq-1.70.4.tar.gz
- Upload date:
- Size: 1.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
50240ea7c02d0a23b702838105de9eccad10d1483dad6faccec5c66e40f12e7c
|
|
| MD5 |
914e7b9a86df5912713d5156abf5b7f1
|
|
| BLAKE2b-256 |
3efc0d8096d5dac3870b83dfc776605619b1dffa4f119299bb1b486fe6c25e1f
|
Provenance
The following attestation bundles were made for canonhq-1.70.4.tar.gz:
Publisher:
publish.yml on canonhq/canon-private
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
canonhq-1.70.4.tar.gz -
Subject digest:
50240ea7c02d0a23b702838105de9eccad10d1483dad6faccec5c66e40f12e7c - Sigstore transparency entry: 1552370966
- Sigstore integration time:
-
Permalink:
canonhq/canon-private@115e47d0f06103e4273b89f91ff6c6a6a1d057ef -
Branch / Tag:
refs/heads/main - Owner: https://github.com/canonhq
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@115e47d0f06103e4273b89f91ff6c6a6a1d057ef -
Trigger Event:
push
-
Statement type:
File details
Details for the file canonhq-1.70.4-py3-none-any.whl.
File metadata
- Download URL: canonhq-1.70.4-py3-none-any.whl
- Upload date:
- Size: 585.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6a0aeffcb327063dc6ad333e0dc54f3907f55a81d498505c4e4b1dacbd283bda
|
|
| MD5 |
b784e5f1009d0535744d8493a27bfc82
|
|
| BLAKE2b-256 |
e2c5747674ffbe8de82afa88b83d100732e933eadacd9a1795f25468636a8f6d
|
Provenance
The following attestation bundles were made for canonhq-1.70.4-py3-none-any.whl:
Publisher:
publish.yml on canonhq/canon-private
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
canonhq-1.70.4-py3-none-any.whl -
Subject digest:
6a0aeffcb327063dc6ad333e0dc54f3907f55a81d498505c4e4b1dacbd283bda - Sigstore transparency entry: 1552370973
- Sigstore integration time:
-
Permalink:
canonhq/canon-private@115e47d0f06103e4273b89f91ff6c6a6a1d057ef -
Branch / Tag:
refs/heads/main - Owner: https://github.com/canonhq
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@115e47d0f06103e4273b89f91ff6c6a6a1d057ef -
Trigger Event:
push
-
Statement type:
