moai-alfred-agent-guide

name	moai-alfred-agent-guide
description	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.
allowed-tools	Read, Glob, Grep

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

Install Skill

SKILL.md