Architecture

Specwright'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/specwright/main.py
Spec Parser	Markdown parsing, frontmatter extraction	src/specwright/parser/
Claude Agent	PR analysis, realization checking	src/specwright/agent/
Ticket Sync	Bidirectional ticket synchronization	src/specwright/sync/
GitHub Client	GitHub API, webhook verification	src/specwright/github/
Config Parser	SPECWRIGHT.yaml validation	src/specwright/config/

Further Reading

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