agent-team-composerlisted

# Agent Team Composer 요청 → 환경 확인 → 작업 분해 → 서비스·역할 배정 → meta-prompt 컴파일 → 실행·통합·검증. 사용자의 목표를 만족하는 **가장 작은 실행 가능한 팀**을 구성한다. 역할은 책임, 서비스는 실행 경로, 모델은 추론·생성 엔진이다. 세 가지를 구분하며 서비스 수를 늘리는 것 자체를 목표로 삼지 않는다. ## 목표와 실행 범위 요청과 세션에서 결과물, 완료 기준, 필수 서비스, 비용·기한·데이터 제약을 수집한다. “기획/조합/프롬프트만”이면 `plan`, “만들어/구현/실행까지”이면 `execute`. 이 스킬 자체를 만드는 요청은 스킬 구현이지 예시 서비스의 실행 허가가 아니다. 필수 정보만 한 번에 질문하고 독립적으로 가능한 준비를 진행한다. 기본 우선순위는 결과물 적합성 → 실행 가능성 → 적은 조율 비용이다. 사용자가 속도·비용·품질을 지정하면 따른다. 예산 미지정을 무제한 외부 과금 허가로 해석하지 않는다. ## 실행 환경과 기반 스킬 가용 도구·스킬 목록을 먼저 확인하고 필요한 도구만 검색한다. 설치된 스킬이나 모델 가이드북만으로 실행 가능하다고 판단하지 않는다. 서비스 관측과 배정은 [references/routing.md](references/routing.md)를 따른다. `meta-prompt`는 다음 순서로 찾는다. 1. 세션 스킬 목록의 `meta-prompt` 위치. 2. 이 스킬의 실제 디렉터리 기준 `../../SKILL.md`가 `name: meta-prompt`이고 `../../guidebooks/registry.yaml`이 존재하면 저장소 내 기반 스킬. 3. 환경에서 제공한 스킬 루트의 `meta-prompt/SKILL.md`. 발견한 `SKILL.md`와 `guidebooks/registry.yaml`을 읽는다. 중복 복사본을 만들지 않는다. 기반 스킬이 없으면 작업 분해·서비스 가용성 확인까지만 수행하고, 프롬프트 컴파일과 의존 작업은 보류한 채 누락 위치를 보고한다. 기반 스킬이 있는 상태에서 **개별 모델 가이드만 없는 경우**에는 `_generic`을 사용한다. 현재 세션의 서비스·모델은 환경에서 확인한다. 카드가 특정 호스트나 기본 모델을 가정해도 현재 런타임 정보를 우선한다. 카드 검증일은 서비스 연결 증거나 오늘의 가격·성능 증거가 아니다. ## 작업과 팀 구성 먼저 결과물 단위로 작업을 나누고 선행 결과가 필요한 작업을 연결한다. 그 후 역할을 배정한다. 오케스트레이터는 현재 주 에이전트이며 불필요하게 별도 팀장 에이전트를 생성하지 않는다. - 독립적으로 진행할 수 있고 조율 비용보다 이득이 큰 작업만 병렬 배정한다. 순차 작업과 작은 작업은 현재 에이전트가 맡을 수 있다. - 서브에이전트는 독립적인 경계가 있는 작업에 사용한다. 같은 파일을 수정하면 파일 소유권을 나누거나 지원되는 격리 환경을 사용한다. - 팀 규모는 실제 동시 실행 한도와 독립 작업 수로 제한한다. 역할 수와 동시에 실행할 에이전트 수를 구분한