Architecture

Canon's architecture is designed around three tiers — repo agents, agent mesh, and org brain — with a modular component structure.

System Overview

Component Map

Component	Role	Key Files
FastAPI App	Webhook routes, health checks	src/canon/main.py
Spec Parser	Markdown parsing, frontmatter extraction	src/canon/parser/
Claude Agent	PR analysis, realization checking	src/canon/agent/
Ticket Sync	Bidirectional ticket synchronization	src/canon/sync/
GitHub Client	GitHub API, webhook verification	src/canon/github/
Config Parser	CANON.yaml validation	src/canon/config/

Further Reading

• System Design — Detailed component breakdown
• Data Flow — Key workflow diagrams
• Components — Per-module documentation