| name | orchestrate |
| description | quant.cpp 개발 오케스트레이터. 에이전트 팀을 구성하고, score 기반 Phase 전환, 병렬 작업 위임, Merge Gate를 자동 수행한다. '개발 시작', '하네스 실행', '팀 구성', '오케스트레이션' 요청 시 사용. 프로젝트의 핵심 개발 루프를 조율하는 상위 스킬. |
quant.cpp Orchestrator
quant.cpp 에이전트 팀을 조율하여 프로젝트를 자율적으로 발전시키는 통합 스킬.
아키텍처: 계층적 위임 + 팬아웃/팬인
[Orchestrator/Leader]
├── score.sh 실행 → Phase 결정
├── Phase에 맞는 에이전트 팀 구성
│ ├── core-dev (알고리즘)
│ ├── perf-dev (SIMD/GPU)
│ └── qa (검증)
├── 워커들이 병렬 작업 (Fan-out)
├── Merge Gate: 하나씩 머지 + score 확인 (Fan-in)
└── 다음 라운드 결정
워크플로우
Step 1: 상태 평가
bash score.sh --quick
현재 점수, 가장 낮은 차원, 다음 WBS 항목을 파악한다.
Step 2: Phase 결정 및 팀 구성
| Score | Phase | 전략 |
|---|
| < 0.05 | Foundation | 직접 수행 (단일) |
| 0.05~0.30 | Core | core-dev × 3 병렬 (polar, qjl, uniform) |
| 0.30~0.60 | Advanced | core-dev + perf-dev + qa 병렬 |
| 0.60~1.00 | Fine-tune | 단일 에이전트 정밀 작업 |
Step 3: 작업 위임
에이전트 팀 모드:
TeamCreate("tq-round-N", members=[core-dev, perf-dev, qa])
TaskCreate("Implement tq_polar.c", owner="core-dev", blocked_by=[])
TaskCreate("NEON optimize polar", owner="perf-dev", blocked_by=["polar"])
TaskCreate("Verify polar boundaries", owner="qa", blocked_by=["polar"])
서브에이전트 모드 (ClawTeam):
clawteam spawn --team tq-N --agent-name core-polar --workspace \
--task "Read .claude/agents/core-dev.md for your role. Implement tq_polar.c..."
Step 4: Merge Gate
워커 완료 후, 하나씩 순차적으로 머지:
pre_merge=$(git rev-parse HEAD)git merge <worker-branch> --no-editbash score.sh --quick- score 하락 →
git reset --hard $pre_merge (롤백)
- score 유지/상승 → 다음 워커
Step 5: QA 검증
Merge Gate 통과 후 QA 에이전트에게 경계면 검증 요청:
.claude/agents/qa.md의 체크리스트 실행- 발견 사항을 다음 라운드에 반영
Step 6: 루프 반복
목표 score 도달 또는 WBS 완료까지 Step 1로 돌아간다.
에러 핸들링
| 상황 | 대응 |
|---|
| 워커 빌드 실패 | 해당 워커 결과 버리고 다음 워커로 |
| score 하락 | 즉시 롤백, 원인 분석 후 재시도 |
| 테스트 실패 | QA에게 위임하여 원인 파악 |
| 머지 충돌 | 모듈 소유권 위반 — 충돌 워커 결과 버림 |
테스트 시나리오
정상 흐름: score 0.90 → architect가 perf-dev에 NEON 최적화 위임 → simd_speedup 4x → merge gate 통과 → score 0.95
에러 흐름: core-dev의 polar 변경이 turbo 테스트를 깨뜨림 → merge gate에서 score 하락 감지 → 롤백 → qa가 경계면 불일치 보고 → core-dev에 수정 지시
