# task-329.1 완료 보고서

## 작업 요약
Superpowers의 TDD 강제 메커니즘과 마이크로태스크 분해 체계를 아누 시스템에 도입

## 파트 A: TDD 강제 스킬 도입

### A-1. TDD 스킬 파일 작성
- **파일**: `/home/jay/.claude/skills/tdd-enforcement/SKILL.md` (신규)
- RED-GREEN-REFACTOR 사이클 정의, 경고 메커니즘, 적용 범위(Lv.2+), 네이밍 규칙, 실행 체크리스트, 금지사항 포함

### A-2. DIRECT-WORKFLOW.md 업데이트
- **파일**: `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md`
- "TDD 규칙 (Lv.2+ 작업)" 섹션 추가 (Step 3 코딩 진입 전 테스트 파일 확인/작성 강제)
- 스킬 파일 참조 경로 포함

### A-3. tdd_check verifier 작성
- **파일**: `/home/jay/workspace/teams/dev1/qc/verifiers/tdd_check.py` (신규)
- audit-trail.jsonl 기반 검증 (테스트 파일 수정 순서 확인)
- check_files 기반 fallback (audit-trail에 task_id 없을 때)
- PASS/FAIL/WARN/SKIP 4가지 판정
- qc_verify.py에 등록 완료 (ALL_CHECKS + run_check 핸들러)

### A-4. QC-RULES.md 업데이트 (v2.3)
- **파일**: `/home/jay/workspace/teams/shared/QC-RULES.md`
- tdd_check verifier 설명 추가 (TDD-1~TDD-4 검증 항목)
- TDD 적용 기준 명시 (Lv.2+)
- 변경 이력 v2.3 추가

## 파트 B: 마이크로태스크 분해 체계화

### B-1. DIRECT-WORKFLOW.md 마이크로태스크 단계 추가
- Step 2.5 "마이크로태스크 분해" 단계 추가
- 2~5분 단위 분해, 명시 항목 4가지, 팀원 할당 규칙

### B-2. team_prompts.py 코워크 섹션 업데이트
- **파일**: `/home/jay/workspace/prompts/team_prompts.py`
- `_build_cowork_section()` 함수에 마이크로태스크 분해 규칙 추가

## 생성/수정 파일 목록
- `/home/jay/.claude/skills/tdd-enforcement/SKILL.md` (신규)
- `/home/jay/workspace/teams/dev1/qc/verifiers/tdd_check.py` (신규)
- `/home/jay/workspace/teams/dev1/qc/qc_verify.py` (수정 - tdd_check 등록)
- `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` (수정 - TDD + 마이크로태스크)
- `/home/jay/workspace/teams/shared/QC-RULES.md` (수정 - v2.3)
- `/home/jay/workspace/prompts/team_prompts.py` (수정 - 코워크 섹션)

## 검증 결과

### pyright 체크
- tdd_check.py: 0 errors, 0 warnings

### tdd_check.py mock 테스트 (5/5 통과)
- check_files PASS (테스트+구현): PASS
- check_files FAIL (구현만): FAIL
- task_id 없음 + check_files 없음: SKIP
- TypeScript 테스트 인식: PASS
- audit-trail 미존재 fallback: PASS

### qc_verify.py 자동 검증
- api_health: SKIP (서버 작업 아님)
- file_check: PASS (모든 파일 존재)
- data_integrity: PASS
- test_runner: SKIP (별도 테스트 디렉토리 없음)
- tdd_check: SKIP (문서/스킬/verifier 작업이므로 스킵)
- schema_contract: SKIP (workers 없음)
- pyright_check: PASS (에러 0건)
- style_check: PASS (black+isort 포매팅 완료)
- scope_check: SKIP

## 비고
- team_prompts.py의 기존 pyright 경고 (unused imports List/Tuple, unused parameters) — 기존 코드 문제이며 이번 작업 범위 외
- tdd_check verifier는 현재 audit-trail에 task_id 필드가 없으므로 check_files fallback이 주 동작 경로. 향후 post-tool-use.sh에 task_id 기록 기능 추가 시 audit-trail 기반 순서 검증이 활성화됨