orchestrate

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

워커 완료 후, 하나씩 순차적으로 머지:

1. pre_merge=$(git rev-parse HEAD)
2. git merge <worker-branch> --no-edit
3. bash score.sh --quick
4. score 하락 → git reset --hard $pre_merge (롤백)
5. 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에 수정 지시