agent-teamlisted

# 에이전트 팀 ## `$agent-team` 목적과 실행 범위 `$agent-team`은 AI 기능 개발을 PM, Domain Expert, Architect, Developer, Reviewer 다섯 역할로 나눠 진행한다. Root orchestrator는 실행 준비, `run-state.json` 실행 상태, 산출물 파일, `stage gate`, `handoff`를 관리하고, PM은 사용자 인터뷰와 기능 명세를 담당한다. `$agent-team`은 명시 호출 전용이다. 사용자가 `$agent-team`을 호출하지 않았다면 실행하지 않는다. 기본 역할은 PM, Domain Expert, Architect, Developer, Reviewer 다섯 개다. 각 역할은 아래 실행 경계를 따른다: - 역할 정의 포맷: 각 역할 brief에는 역할명, description, 권한/도구 경계, 입력, 출력, 완료 기준을 명확히 쓴다. - read-only 제한: Domain Expert와 Reviewer는 읽기/검증 전용이며 직접 코드나 제품 산출물을 수정하지 않는다. Architect는 설계/계획 문서만 작성하고 코드 구현은 Developer가 한다. - Reviewer 세분화: Reviewer는 필요할 때 보안, 성능, 테스트/평가, 필수 플랫폼 연동 같은 검토 관점으로 findings를 나눌 수 있지만 기본 역할을 여러 reviewer로 늘리지는 않는다. - Debugger 보조 역할: 테스트 실패나 Reviewer 주요 이슈가 있을 때 Developer fix 반복 안에서 원인 분석 관점으로만 사용한다. 별도 기본 단계로 추가하지 않는다. - hook 기반 quality gate: hook 또는 check script는 agent가 아니라 Root orchestrator의 stage gate 보조 검증 장치다. 산출물 누락, 권한 위반, 가짜 성공 결과, 승인 누락을 자동으로 막는 데 쓴다. 용어 표기는 아래를 기준으로 통일한다: | 표준 용어 | 의미 | | --- | --- | | Root orchestrator | `run-state.json` 실행 상태, 산출물, 역할 전환을 관리하는 중앙 실행자. 도메인 판단이나 코드 리뷰를 직접 수행하지 않는다. | | `sub-agent` | `auto_split`에서 PM 인터뷰를 제외한 역할별 작업을 분리 실행하는 에이전트 | | `stage gate` | Root orchestrator가 단계 전환 전에 수행하는 산출물 존재 여부, 최소 형식, `run-state.json` 갱신 가능성 검증 | | Domain Expert Gateway | Domain Expert가 수행하는 도메인 유효성 검토. 결과는 `Approved`, `Revise`, `Blocked` 중 하나다. | | `handoff` | 다음 역할에 넘기는 입력 파일, 출력 파일, 제약, 관련 `last_decision`, `blocked_reason` 후보, `stage gate` 실패 정보 | | `bri