Subagent
architect
Structure & schema — coupling, boundaries, migration safety.
Structural/system-design reviewer — coupling, boundaries, invariants, quality attributes, reversibility, and migration risk; whether a change fits the architecture rather than fighting it. Use for design-plan vetting and for reviewing schema/subsystem-level or cross-cutting changes before merge.
What this agent does
The architect reviews the structure of a change rather than its lines: whether the change fits the system's existing boundaries, layering, and single sources of truth, or forks logic that already lives elsewhere. A one-off exception that fights the established pattern is a reject even when it works.
One-way doors — public APIs, persisted schemas, data migrations, hard-to-drop dependencies — get scrutinised hard, while reversible changes wave through. Every finding is grounded in specific file:line evidence, and significant decisions capture the trade-off and the rejected alternative, so the why survives.
When you'd want it
A design plan needs vetting
Before a big build starts, the architect checks the plan against the system's real boundaries and quality attributes — coupling, reversibility, and what breaks at ten times the load.
A schema or API is changing
Cross-cutting and schema-level changes get a structural review before merge: backward and forward compatibility, versioning, and a concrete migration path for existing data and callers.
Complexity is creeping in
When a change adds abstraction, the architect asks whether that complexity is essential to the problem — and prefers removing the need over adding a clever layer.
What it checks
- Fit and duplication. Whether the change respects existing boundaries and single sources of truth, or quietly forks logic that already lives elsewhere.
- Coupling and blast radius. What the change makes harder to change later — dependency direction, cohesion, and how far a future edit would have to reach.
- Reversibility. Two-way doors get waved through; one-way doors like public APIs, persisted schemas, and migrations get scrutinised hard.
- Quality attributes. Real risks to security, performance, scalability, reliability, and observability — including what breaks at ten times the load, data, or users.
- Data and schema evolution. Backward and forward compatibility, versioning, and a concrete migration path for existing data and its callers.
- Essential complexity. Whether new complexity is essential to the problem or accidental — and whether the need could be removed instead.
How it fits the crew
The architect usually runs early and late: vetting a design plan before the senior-engineer builds from it, then reviewing the finished structure before merge. A REJECT hands the engineer the specific structural concern and a concrete alternative, and the sdet later proves the rework actually runs.
Related roles: senior-engineer sdet security-engineer
Called in by: /ship-issue /ship-epic /shipmates-fix-bug /plan-epics /shipmates-spike /shipmates-migrate /pr-review /shipmates-onboard /shipmates-refactor
Reference
- Name
architect- Description
- Structural/system-design reviewer — coupling, boundaries, invariants, quality attributes, reversibility, and migration risk; whether a change fits the architecture rather than fighting it. Use for design-plan vetting and for reviewing schema/subsystem-level or cross-cutting changes before merge.
- Tools
Read,Grep,Glob,Bash
Where this lives
This page is generated from crew/architect.md. The installer copies it to ~/.claude/agents/architect.md for every project, or .claude/agents/architect.md inside a single repo.