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