# Moai Alfred Agent Guide

> 19-agent team structure, decision trees for agent selection, Haiku vs Sonnet model selection, and agent collaboration principles. Use when deciding which sub-agent to invoke, understanding team responsibilities, or learning multi-agent orchestration.

- Skill: `majiayu000/moai-alfred-agent-guide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/moai-alfred-agent-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/moai-alfred-agent-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/moai-alfred-agent-guide

---


## What It Does

MoAI-ADK의 19개 Sub-agent 아키텍처, 어떤 agent를 선택할지 결정하는 트리, Haiku/Sonnet 모델 선택 기준을 정의합니다.

## When to Use

- ✅ 어떤 sub-agent를 invoke할지 불명확
- ✅ Agent 책임 범위 학습
- ✅ Haiku vs Sonnet 모델 선택 필요
- ✅ Multi-agent 협업 패턴 이해

## Agent Team at a Glance

### 10 Core Sub-agents (Sonnet)
- spec-builder: SPEC 작성
- tdd-implementer: TDD 구현 (RED → GREEN → REFACTOR)
- doc-syncer: 문서 동기화
- implementation-planner: 구현 전략
- debug-helper: 오류 분석
- quality-gate: TRUST 5 검증
- tag-agent: TAG 체인 검증
- git-manager: Git 워크플로우
- Explore: 코드베이스 탐색
- Plan: 작업 계획

### 4 Expert Agents (Sonnet - Proactively Triggered)
- **backend-expert**: Backend 아키텍처, API 설계, 데이터베이스
- **frontend-expert**: Frontend 아키텍처, 컴포넌트 설계, 상태 관리
- **devops-expert**: DevOps 전략, 배포, 인프라
- **ui-ux-expert**: UI/UX 설계, 접근성, 디자인 시스템 (Figma MCP)

### 6 Specialist Agents (Haiku)
- project-manager: 프로젝트 초기화
- skill-factory: Skill 생성/최적화
- cc-manager: Claude Code 설정
- cc-hooks: Hook 시스템
- cc-mcp-plugins: MCP 서버
- trust-checker: TRUST 검증

## Agent Selection Decision Tree

```
Task Type?
├─ SPEC 작성/검증 → spec-builder
├─ TDD 구현 → tdd-implementer
├─ 문서 동기화 → doc-syncer
├─ 구현 계획 → implementation-planner
├─ 오류 분석 → debug-helper
├─ 품질 검증 → quality-gate + Skill("moai-foundation-trust")
├─ 코드베이스 탐색 → Explore
├─ Git 워크플로우 → git-manager
└─ 전체 프로젝트 계획 → Plan
```

## Model Selection

- **Sonnet**: Complex reasoning (spec-builder, tdd-implementer, implementation-planner)
- **Haiku**: Fast execution (project-manager, quality-gate, git-manager)

---

Learn more in `reference.md` for complete agent responsibilities, collaboration patterns, and advanced orchestration strategies.

**Related Skills**: moai-alfred-rules, moai-alfred-practices