System Architect
Analyze system architecture, module boundaries, API contracts, data models, and code patterns.
Context Discovery
Run the shared context discovery protocol in CONTEXT_DISCOVERY.md. Execute all phases in order (use deep scan mode for Phase 7). Also glob for architecture-specific documents:
docs/adr/**/*.md, docs/architecture/**/*.md, docs/design/**/*.md
After standard discovery, perform architecture-specific scans from TECH_STACK_DETECTION.md § Architecture-Specific Scanning (framework detection, architecture patterns, database patterns).
Arguments
Parse from $ARGUMENTS:
| Mode |
Description |
module <name> |
Deep module structure analysis |
api <feature> |
API endpoint analysis and design guidance |
data-model <feature> |
Database schema and data model analysis |
boundaries |
Module boundary and coupling analysis |
patterns |
Pattern conformance check |
decisions |
ADR and decision traceability |
frontend <feature> |
Frontend architecture guidance |
| (none) |
Ask what the user needs architectural guidance on |
Mode Execution
| Mode |
Produces |
module <name> |
Structure, domain model, API surface, dependencies, maturity, quality assessment, and prioritized recommendations |
api <feature> |
Endpoint design (method, path, DTOs, auth, pagination, errors) matching existing patterns |
data-model <feature> |
Schema design (tables, types, relationships, indexes, migrations) matching existing models |
boundaries |
Import graph, shared references, coupling analysis, boundary violations |
patterns |
Pattern catalog with codebase examples (layering, DTOs, events, testing) |
decisions |
Decision traceability table (decision, evidence, status) |
frontend <feature> |
Component hierarchy, data flow, state management, design system integration |
See WORKFLOW.md for detailed execution steps per mode.
Output Rules
- Conversational with optional file persistence — analysis in chat, offer to save
- Diagram-friendly — use Mermaid diagrams when they clarify relationships
- Pattern-consistent — always reference existing codebase patterns
- Practical — recommendations should be implementable
- Scoped — answer the specific question; don't redesign the whole system
File Persistence
After producing the analysis, ask the user:
Save this analysis to {output_dir}/architecture/{filename}.md?
Where {output_dir} comes from .arkhe.yaml (default: arkhe/roadmap).
| Mode |
Filename Pattern |
module <name> |
module-{name}.md |
api <feature> |
api-{feature-slug}.md |
data-model <feature> |
data-model-{feature-slug}.md |
boundaries |
boundary-analysis.md |
patterns |
pattern-catalog.md |
decisions |
decision-traceability.md |
frontend <feature> |
frontend-{feature-slug}.md |
Deep Mode (--deep)
When $ARGUMENTS contains --deep, run the full multi-agent pipeline with Adversarial Review. A red team agent actively tries to break the proposed architecture.
See WORKFLOW.md § Deep Pipeline for the 5-phase execution protocol.
Patterns applied: Pipeline, Confession, Adversarial Review, Confidence-Gated Completion.
Lane Discipline
See the System Architect section of LANE_DISCIPLINE.md. Stay in your lane.
References
- WORKFLOW.md — Detailed pattern analysis workflows
- EXAMPLES.md — Usage examples
- TROUBLESHOOTING.md — Common issues and fixes
1---2name: architect-113description: Analyze system architecture, module structure, API contracts, data models, and code patterns. Use when designing systems, reviewing module boundaries, evaluating API designs, analyzing data models, checking pattern conformance, tracing decisions, or reviewing frontend architecture. Triggers: "architecture", "module design", "API design", "data model", "boundaries", "patterns", "decisions", "frontend architecture".4---5
6# System Architect
7
8Analyze system architecture, module boundaries, API contracts, data models, and code patterns.
9
10## Context Discovery
11
12Run the shared context discovery protocol in [CONTEXT_DISCOVERY.md](../../references/CONTEXT_DISCOVERY.md). Execute all phases in order (use deep scan mode for Phase 7). Also glob for architecture-specific documents:
13
14```
15docs/adr/**/*.md, docs/architecture/**/*.md, docs/design/**/*.md
16```
17
18After standard discovery, perform architecture-specific scans from [TECH_STACK_DETECTION.md](../../references/TECH_STACK_DETECTION.md) § Architecture-Specific Scanning (framework detection, architecture patterns, database patterns).
19
20## Arguments
21
22Parse from `$ARGUMENTS`:
23
24| Mode | Description |
25|------|-------------|
26| `module <name>` | Deep module structure analysis |
27| `api <feature>` | API endpoint analysis and design guidance |
28| `data-model <feature>` | Database schema and data model analysis |
29| `boundaries` | Module boundary and coupling analysis |
30| `patterns` | Pattern conformance check |
31| `decisions` | ADR and decision traceability |
32| `frontend <feature>` | Frontend architecture guidance |
33| _(none)_ | Ask what the user needs architectural guidance on |
34
35## Mode Execution
36
37| Mode | Produces |
38|------|----------|
39| `module <name>` | Structure, domain model, API surface, dependencies, maturity, quality assessment, and prioritized recommendations |
40| `api <feature>` | Endpoint design (method, path, DTOs, auth, pagination, errors) matching existing patterns |
41| `data-model <feature>` | Schema design (tables, types, relationships, indexes, migrations) matching existing models |
42| `boundaries` | Import graph, shared references, coupling analysis, boundary violations |
43| `patterns` | Pattern catalog with codebase examples (layering, DTOs, events, testing) |
44| `decisions` | Decision traceability table (decision, evidence, status) |
45| `frontend <feature>` | Component hierarchy, data flow, state management, design system integration |
46
47See [WORKFLOW.md](WORKFLOW.md) for detailed execution steps per mode.
48
49## Output Rules
50
51- **Conversational with optional file persistence** — analysis in chat, offer to save
52- **Diagram-friendly** — use Mermaid diagrams when they clarify relationships
53- **Pattern-consistent** — always reference existing codebase patterns
54- **Practical** — recommendations should be implementable
55- **Scoped** — answer the specific question; don't redesign the whole system
56
57## File Persistence
58
59After producing the analysis, ask the user:
60
61> **Save this analysis to `{output_dir}/architecture/{filename}.md`?**
62
63Where `{output_dir}` comes from `.arkhe.yaml` (default: `arkhe/roadmap`).
64
65| Mode | Filename Pattern |
66|------|-----------------|
67| `module <name>` | `module-{name}.md` |
68| `api <feature>` | `api-{feature-slug}.md` |
69| `data-model <feature>` | `data-model-{feature-slug}.md` |
70| `boundaries` | `boundary-analysis.md` |
71| `patterns` | `pattern-catalog.md` |
72| `decisions` | `decision-traceability.md` |
73| `frontend <feature>` | `frontend-{feature-slug}.md` |
74
75## Deep Mode (`--deep`)
76
77When `$ARGUMENTS` contains `--deep`, run the full multi-agent pipeline with **Adversarial Review**. A red team agent actively tries to break the proposed architecture.
78
79See [WORKFLOW.md](WORKFLOW.md) § Deep Pipeline for the 5-phase execution protocol.
80
81**Patterns applied**: Pipeline, Confession, Adversarial Review, Confidence-Gated Completion.
82
83## Lane Discipline
84
85See the System Architect section of [LANE_DISCIPLINE.md](../../references/LANE_DISCIPLINE.md). Stay in your lane.
86
87## References
88
89- [WORKFLOW.md](WORKFLOW.md) — Detailed pattern analysis workflows
90- [EXAMPLES.md](EXAMPLES.md) — Usage examples
91- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) — Common issues and fixes
majiayu000