# task-566 Phase 2~5 재위임 (한정승인)

## 배경
task-566 Phase 1(기반 구축) 완료됨. chain_manager.py 버그로 체이닝이 끊겨서 재위임한다.
2팀이 별도로 체이닝 버그를 수정 중이나, 이 작업은 그것과 무관하게 Phase 2~5를 순차 진행한다.

## 한정승인 (Scoped Delegation)
제이회장님이 **전체 Phase를 1팀에 한정승인**하셨다.
- 각 Phase 완료 → .done → 즉시 다음 Phase 진행 (아누 승인 대기 없음)
- Phase 간 산출물은 파일로 연결
- 중간보고: 각 Phase 완료 시 간결 3줄 보고
- 마지막 Phase 완료 시 전체 통합 보고
- **chain_manager.py를 사용하지 말 것** — 버그 수정 전이므로 신뢰 불가. 직접 다음 Phase dispatch 호출로 이어갈 것.

## Phase 1 완료 산출물 (참조)
- `memory/reports/task-566.1.md` — Phase 1 보고서
- `memory/organization-structure.json` v3.2 — 신규 조직 등록 완료
  - 제품전략센터: **프로메테우스 (Prometheus)** (아폴론→프로메테우스 이름 변경됨)
  - 회고분석센터: 크로노스 (Chronos)
- gstack 6개 프롬프트/문서 반영 완료
- 프로젝트별 메모리 분리 완료

## 참조 문서 (반드시 읽을 것)
1. `memory/research/letta-whisper-impact-analysis.md` — 위스퍼 비서 설계 + 시스템 영향 분석
2. `memory/research/gstack-analysis.md` — gstack 17개 도입 항목 상세
3. `memory/tasks/dispatch-whisper-letta-gstack-master.md` — 마스터 디스패치 (전체 Phase 상세)

---

## Phase 2: 위스퍼 비서 핵심 구현 (task-566.2)

**2-1. whisper-compile.py**
위치: `/home/jay/workspace/scripts/whisper-compile.py`
기능:
- bot-activity.json에서 팀 상태 추출
- task-timers.json에서 active/최근 completed 추출
- memory/events/*.done 스캔 (미처리 완료 작업)
- memory/reports/*.md에서 SCQA 첫 4줄 추출
- memory/whisper/session-guidance.json에서 이전 가이던스 로드
- memory/projects/<cwd기반>/context.md 로드
- memory/events/questions/*.json에서 팀장 질문 로드
- 유휴 팀 경고 (3시간 이상)
- stdout으로 XML 포맷 브리핑 출력

출력 형식:
```xml
<whisper-briefing>
[팀] 1팀:task-565.1 작업중 | 2팀:유휴(3h) | 3팀:완료
[완료] task-564.1 — S:done-watcher 개선 ...
[프로젝트] InsuWiki: Phase 미시작 | ThreadAuto: Remotion 대기
[가이던스] 이전 세션 키워드
[질문] 없음
[유휴경고] 2팀 3시간째 유휴
</whisper-briefing>
```

**2-2. whisper-save-guidance.py**
위치: `/home/jay/workspace/scripts/whisper-save-guidance.py`
기능:
- 현재 팀 상태 스냅샷 저장
- 다음 세션 가이던스 생성 (파일 기반, AI 불필요)
- 저장: `memory/whisper/session-guidance.json`

**2-3. Hook 수정**
- `~/.claude/hooks/user-prompt-submit.sh` 아누 케이스에 whisper-compile.py 호출 추가
- `~/.claude/hooks/stop-qc-reminder.sh` 아누 케이스에 whisper-save-guidance.py 호출 추가

**2-4. 양방향 대화 채널 (Letta #4)**
- `memory/events/questions/` 디렉토리
- 팀장 질문 JSON → whisper-compile.py 감지 → 브리핑 포함

**2-5. 테스트**
- 단위 테스트 + hook 통합 테스트 + 빈 상태 graceful 처리

**완료 기준**: whisper-compile.py + whisper-save-guidance.py + hook 수정 + 양방향 채널 + 테스트 PASS
**보고서**: `memory/reports/task-566.2.md`

---

## Phase 3: gstack 코드 구현 (task-566.3)

- A1: diff-aware QA → `scripts/diff-aware-qa.py`
- A2: Health Score → `scripts/health-score.py` (7카테고리 가중평균 0-100)
- A4: CRITICAL GAP → qc_verify.py에 verifier 추가
- A13: baseline 비교 → `memory/whisper/qa-baseline.json`
- A15: 에러 메시지 AI-actionable 개선
- A17: fix_pct 경고 → task-timer 데이터에서 fix 비율 계산
- A7: SKILL.md 템플릿 시스템 → `scripts/gen-skill-docs.py`

**완료 기준**: 각 스크립트 + 테스트 + 기존 테스트 회귀 없음
**보고서**: `memory/reports/task-566.3.md`

---

## Phase 4: 학습/회고 시스템 (task-566.4)

- A3: 주간 회고 시스템 (크로노스) → `scripts/weekly-retro.py`
- Letta #1: 트랜스크립트 학습 → `scripts/transcript-learner.py`
- Letta #2: session_patterns 감지 → `scripts/pattern-detector.py`
- Letta #5: self_improvement → `scripts/memory-janitor.py`
- cokacdir --cron으로 매주 월요일 회고 자동 실행 등록

**완료 기준**: 4개 스크립트 + 주간 회고 cron 등록 + 테스트
**보고서**: `memory/reports/task-566.4.md`

---

## Phase 5: 고급 기능 + 통합 검증 (task-566.5)

- A6: LLM-as-judge (선택적)
- A9: AI 코드리뷰 로컬 패턴 매칭
- A16: @ref 브라우저 자동화 (선택적)
- 전체 통합 테스트
- 대시보드에 프로메테우스/크로노스 표시 확인
- **전체 통합 보고서** 작성 → `memory/reports/task-566.5.md`

---

## 공통 규칙
- 코딩은 팀원(Sonnet)에게 위임. 팀장(Opus)은 설계/검토만.
- pyright 에러 0건 유지
- 기존 테스트 회귀 금지
- 보안: 토큰/키 하드코딩 금지
- CODING-STANDARDS.md 준수
- 각 Phase 완료 시 보고서: `memory/reports/task-566.{phase번호}.md`
- task-timer로 작업 기록 필수
