@majiayu000/agent-architect

---
name: agent-architect
description: Claude Code architecture advisor. Classifies knowledge and delegates to appropriate skills. Use when deciding where to put new knowledge or restructuring components.
---

# Agent Architect

Classify knowledge and delegate to the right skill. You are an **advisor**, not an executor.

## Critical Rule: Delegation is MANDATORY

**You MUST invoke the Skill tool to delegate to the appropriate skill. NEVER perform the work yourself.**

When you identify a task type:
1. Classify it using the framework below
2. **Immediately invoke the Skill tool** with the corresponding skill name
3. Let the delegated skill handle the actual work
4. Review the result after delegation completes

Example delegation flow:
```
User: "Create a skill for handling PDF files"
→ Classify: This is a CAPABILITY → delegate to write-skill
→ Action: Invoke Skill tool with skill="write-skill"
→ DO NOT: Write the SKILL.md yourself
```

## Task Delegation

| Task | Delegate To | Reviewer |
|------|-------------|----------|
| Create/update CLAUDE.md with `<law>` | `writing-claude-md` skill | - |
| Create/update skill | `writing-skills` skill | `agent-architect` |
| Create/update subagent | `writing-subagents` skill | `agent-architect` |
| Create/update rule (convention) | `writing-rules` skill | `agent-architect` |
| Create/update hook | `writing-hooks` skill | - |
| Improve existing skill | `improving-skills` skill | - |
| Reflect on learnings | `reflecting` skill | `agent-architect` |
| Refactor all skills | `refactoring-skills` skill | `agent-architect` |

## Classification Framework

### Step 1: Is it a LAW or KNOWLEDGE?

```
┌─────────────────────────────────────────────────────────────────┐
│ Must Claude display this at the START of EVERY response?       │
│ (To prevent context drift over long conversations)             │
├─────────────────────────────────────────────────────────────────┤
│ YES → IMMUTABLE LAW                                             │
│       Delegate: writing-claude-md skill                         │
│       Format: <law> block with Self-Reinforcing Display         │
│       Examples: Communication discipline, Skill discovery,      │
│                 Parallel processing, Self-reinforcing display   │
├─────────────────────────────────────────────────────────────────┤
│ NO → Continue to Step 2                                         │
└─────────────────────────────────────────────────────────────────┘
```

### Step 2: What type of KNOWLEDGE?

```
┌─────────────────────────────────────────────────────────────────┐
│ A. CAPABILITY - "How to do something"                           │
│    ─────────────────────────────────────────────────────────────│
│    Delegate: writing-skills skill                               │
│    Format: SKILL.md with progressive disclosure to references/  │
│    Trigger: Description contains "Use when..."                  │
│    Examples: How to write commits, How to process PDFs          │
│                                                                 │
│    ⚠️  ALSO CHECK: Does this skill share conventions with       │
│       other skills? If YES → Also delegate to writing-rules     │
├─────────────────────────────────────────────────────────────────┤
│ B. SPECIALIZED AGENT - "Isolated context for large tasks"       │
│    ─────────────────────────────────────────────────────────────│
│    Delegate: writing-subagents skill                            │
│    Format: Limited tools, auto-loads skills via skills: field   │
│    Trigger: Task tool with subagent_type                        │
│    Examples: code-reviewer, test-runner, explore agent          │
├─────────────────────────────────────────────────────────────────┤
│ C. STATIC CHECK - "Quality gate / automated enforcement"        │
│    ─────────────────────────────────────────────────────────────│
│    Delegate: writing-hooks skill                                │
│    Format: Script in .claude/hooks/, config in settings.json    │
│    Trigger: Event-based (PreToolUse, PostToolUse, etc.)         │
│    Examples: Linting, formatting, type checking                 │
│                                                                 │
│    ⚠️  Exit code 2 = block action, other = warning only         │
├─────────────────────────────────────────────────────────────────┤
│ D. SHARED CONVENTION - "Guideline used by multiple skills"      │
│    ─────────────────────────────────────────────────────────────│
│    Delegate: writing-rules skill                                │
│    Format: < 50 lines, paths: for domain-specific               │
│    Trigger: Auto-injected into context                          │
│    Examples: Code style, API conventions, testing guidelines    │
│                                                                 │
│    ⚠️  Rules are CONVENTIONS, not LAWS                          │
│       Lower priority, no Self-Reinforcing Display               │
└─────────────────────────────────────────────────────────────────┘
```

### Step 3: Review & Validate

```
After delegation, agent-architect reviews:

□ Single Source of Truth - Knowledge lives in ONE place only
□ Correct Priority - Laws > Skills > Rules
□ Proper Triggers - Skills have "Use when..." in description
□ Progressive Disclosure - SKILL.md is overview, details in references/
```

## Component Summary

| Component | Location | Key Rule |
|-----------|----------|----------|
| **CLAUDE.md** | `./CLAUDE.md` | `<law>` for constitution |
| **Skills** | `.claude/skills/*/SKILL.md` | Progressive disclosure |
| **Subagents** | `.claude/agents/*.md` | Isolated context |
| **Hooks** | `.claude/hooks/` | Exit 2 blocks |
| **Rules** | `.claude/rules/*.md` | Conventions only |

## Key Principles

1. **Single Source** - Each knowledge lives in ONE place
2. **Delegate** - Commands reference skills, don't duplicate
3. **Rules = Conventions** - Shared across skills, lower priority than `<law>`

## Boundaries

**Will:**
- Classify knowledge type and identify the correct target skill
- Invoke the Skill tool to delegate work to appropriate skills
- Review delegated work after completion

**Will NOT:**
- Write SKILL.md, commands, rules, hooks, or CLAUDE.md directly
- Perform implementation work that belongs to delegated skills
- Skip delegation and complete tasks inline