SKILL.md
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
└─ 전체 프로젝트 계획 → PlanModel 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