# task: Superpowers v5.0.5 분석 결과 실제 적용 (한정승인)

## 제이회장님 지시
- task-830.1 분석 결과를 학습하고 **실제 시스템에 적용**
- 3팀 한정승인: 전체 Phase를 팀장이 자율 진행

## 참조 파일 (반드시 읽을 것)
- 비교 분석 + 액션 아이템: `/home/jay/workspace/memory/research/superpowers-our-system-comparison.md`
- 심층 분석: `/home/jay/workspace/memory/research/superpowers-deep-analysis.md`

## 작업 범위

### Phase 1: 즉시 적용 (A-1, A-2, A-3)

**A-1. subagent-driven-development 컨텍스트 격리 원칙 추가**
- 파일: `/home/jay/workspace/skills/subagent-driven-development/SKILL.md`
- 수정: "컨텍스트 구성 원칙" 섹션 추가
  1. 세션 히스토리 전달 금지 (격리 원칙)
  2. 태스크 전문 텍스트만 전달
  3. 필요한 파일 내용은 직접 첨부
  4. 완료 상태 4종 명시: DONE / DONE_WITH_CONCERNS / NEEDS_CONTEXT / BLOCKED

**A-2. 고빈도 스킬 토큰 최적화**
- 대상: `/home/jay/workspace/skills/systematic-debugging/SKILL.md`
- 방법: 150단어 이하 핵심 원칙만 남기고, 상세 내용을 같은 디렉토리의 `SKILL-EXAMPLES.md`로 분리
- tdd-enforcement가 이미 이 구조를 채택 → 동일 패턴 적용
- ⚠️ SKILL.md의 트리거/description은 유지. 본문 워크플로우만 압축

**A-3. 스킬 description CSO 점검 (3개 우선)**
- 대상: `agent-meeting`, `3docs-create`, `project-kickoff`
- 각 스킬의 SKILL.md 파일을 읽고:
  - description에서 워크플로우 요약 제거
  - "Use when..." 트리거 조건만 남기기
  - 본문 내용(steps, workflow)은 절대 description에 넣지 않음
- CSO 원칙: description에 워크플로우 요약 시 Claude가 본문 스킵함

### Phase 2: 단기 적용 (B-1, B-2, B-3)

**B-1. verification-before-completion 스킬 신규 작성**
- 경로: `/home/jay/workspace/skills/verification-before-completion/SKILL.md`
- 내용:
  1. 기능이 실제로 동작하는가? (런타임 검증)
  2. 모든 테스트가 통과하는가? (qc_verify.py 실행 확인)
  3. 팀장에게 보고한 내용이 정확한가? (Self-Deception 방지)
  4. 범위를 벗어난 부수 변경은 없는가? (scope_check)
- .done 파일 생성 전에 이 검증을 통과해야 함
- TDD 스킬 참고해서 "예외 없음" 명시

**B-2. tdd-enforcement 합리화 표 추가**
- 파일: `/home/jay/workspace/skills/tdd-enforcement/SKILL.md`
- 추가할 합리화 표 (Rationalization Table):
  - "이건 너무 단순해서 테스트 불필요" → "단순한 코드가 가장 많이 변경됨"
  - "시간이 없어서 나중에 테스트" → "나중에는 더 없음. 지금이 가장 빠름"
  - "이미 다른 테스트가 커버함" → "커버한다고? 증거를 보여줘"
  - "리팩토링이라 기능 변경 없음" → "리팩토링이야말로 테스트가 잡아줘야 할 것"
  - "설정 파일이라 테스트 불가" → "설정 로딩은 테스트 가능함"
- ⚠️ 기존 SKILL.md 구조 유지하며 섹션 추가만

**B-3. dispatch.py 4-state 완료 코드 설계 문서**
- 파일: `/home/jay/workspace/memory/specs/4-state-completion-design.md` (신규)
- 내용:
  - DONE: 작업 완료, 이슈 없음
  - DONE_WITH_CONCERNS: 완료했지만 우려사항 있음 (팀장이 판단)
  - NEEDS_CONTEXT: 추가 정보 필요 (에스컬레이션)
  - BLOCKED: 진행 불가 (외부 의존성 등)
  - .done 파일 포맷 변경안
  - done-watcher.py, task-timer.py 연동 변경점
- ⚠️ 이 Phase에서는 **설계 문서만 작성**. 코드 수정은 하지 않음

### Phase 3: 중기 적용 (C-1, C-2)

**C-1. chain_manager.py 리뷰 루프 3회 제한**
- 파일: `/home/jay/workspace/chain_manager.py`
- 수정: `max_review_iterations` 파라미터 추가 (기본값 3)
- 초과 시 팀장 에스컬레이션 로직
- 기존 기능 깨지지 않도록 테스트 필수

**C-2. qc_verify.py diff-aware + SHA 기반 범위 지정**
- 파일: `/home/jay/workspace/teams/dev1/qc/qc_verify.py`
- 수정: scope_check verifier에 git SHA 파라미터 추가
- 변경 파일만 선별 검증 (전체 재검증 방지)
- 기존 verifier 8개 동작 깨지지 않도록 주의

## 작업 원칙
1. 각 Phase 완료 후 .done 통보 (Phase 간 순차 진행)
2. 파일 수정 시 기존 기능 유지 확인 (테스트 필수)
3. 코드 수정 파일은 pyright + 기존 테스트 통과 확인
4. 스킬 수정 시 기존 description 트리거 정확도 저하 안 되도록 주의
5. 한정승인: Phase 1→2→3 순서대로 자율 진행. 아누 개입 없음