Design systems and analyze trade-offs with architectural reasoning
Version: v3.12.0 | Archetype: Architect | Skills: 2 specialized + 15 universal
The Architect archetype brings systematic design thinking to system planning. Unlike ad-hoc design discussions, architect agents provide:
- Structured design — Decompose systems into components with clear responsibilities
- Trade-off analysis — Evaluate competing quality attributes with explicit reasoning
- Decision documentation — Record architectural decisions with context and rationale
For evaluators: If you need an AI that can reason about system design, evaluate architectural options, and document decisions for posterity, the Architect archetype provides structured design support.
Domain knowledge that compounds: Architect agents build persistent understanding of your system landscape — past decisions, quality attribute priorities, and architectural patterns that work in your context. Unlike tools that start fresh each session, your agent accumulates design context that makes each architecture more informed and each trade-off analysis more grounded.
Architect agents come with 2 archetype-specific skills plus the universal AGET skills.
| Skill | Description |
|---|---|
| aget-design-architecture | Design system architecture including components, relationships, and patterns. Addresses quality attributes and produces architectural artifacts. |
| aget-assess-tradeoffs | Analyze trade-offs between competing concerns. Classifies decisions as one-way/two-way doors and provides structured recommendations. |
All AGET agents include session management, knowledge capture, and health monitoring:
aget-wake-up/aget-wind-down— Session lifecycleaget-create-project/aget-review-project— Project managementaget-record-lesson/aget-record-observation— Learning captureaget-check-health/aget-check-kb/aget-check-evolution— Health monitoringaget-propose-skill/aget-create-skill— Skill developmentaget-save-state/aget-file-issue— State and issue management
Architect agents use a formal vocabulary of 7 concepts organized into 3 clusters:
| Cluster | Concepts |
|---|---|
| System Design | Architecture, Component, Pattern |
| Decision Making | Decision, ADR (Architecture Decision Record) |
| Trade-off Analysis | Trade_off, Quality_Attribute |
This vocabulary enables precise communication about architectural decisions.
See: ontology/ONTOLOGY_architect.yaml
# 1. Clone the template
git clone https://github.com/aget-framework/template-architect-aget.git my-architect-agent
cd my-architect-agent
# 2. Configure identity
# Edit .aget/version.json:
# "agent_name": "my-architect-agent"
# "domain": "your-domain"
# 3. Verify setup
python3 -m pytest tests/ -v
# Expected: All tests passing# In Claude Code CLI
/aget-design-architecture # Create system design
/aget-assess-tradeoffs # Analyze competing options| Aspect | Ad-hoc Design | Architect Agent |
|---|---|---|
| System decomposition | Informal discussion | Structured component analysis |
| Trade-offs | Implicit preferences | Explicit quality attribute evaluation |
| Decisions | Lost in chat | ADRs with context and rationale |
| Reversibility | Assumed | One-way vs. two-way door classification |
| Domain memory | Starts fresh each session | Accumulates architectural expertise over time |
| Directory | Purpose | Owner |
|---|---|---|
.claude/skills/ |
Slash command definitions | Framework + Agent |
.claude/agents/ |
Subagent definitions | Agent |
.claude/rules/ |
Path-scoped context rules | Agent |
Skills are provided by the template. Agents and rules directories are scaffolded for your customization.
| Attribute | Value |
|---|---|
| Framework | AGET v3.12.0 |
| Archetype | Architect |
| Skills | 17 total (2 archetype + 15 universal) |
| Ontology | 7 concepts, 3 clusters |
| License | Apache 2.0 |
- AGET Framework — Core framework documentation
- Archetype Guide — All 12 archetypes explained
- Getting Started — Full onboarding guide
| Archetype | Best For |
|---|---|
| Developer | Implementation and code quality |
| Spec-Engineer | Requirements and specifications |
| Reviewer | Quality assurance and feedback |
AGET Framework | Apache 2.0 | Issues