Architecture | Specwright
Description: AI-native enterprise documentation platform. Living specs, agent-maintained docs, repo-native knowledge.

Skip to content

# 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