# task-1621.1 완료 보고: CLAUDE.md 비대화 경고 + QC 통합

**작업 ID**: task-1621.1
**팀**: dev6-team (페룬)
**작업일**: 2026-04-11

---

## SCQA

**S**: qc_verify.py에 12개 verifier가 등록되어 팀별 QC 자동 검증을 수행 중이며, 팀 CLAUDE.md는 33~59줄로 관리되고 있다.

**C**: CLAUDE.md가 비대해지면 팀장 봇 프롬프트 비용과 혼란이 증가하나, 비대화를 자동 감지하는 메커니즘이 없어 수동 점검에 의존한다. 현재 design 팀 CLAUDE.md가 310줄로 기준(100줄)을 초과한 상태다.

**Q**: CLAUDE.md 비대화를 QC 파이프라인에서 자동 감지하여 경고할 수 있는가?

**A**: `claude_md_check` verifier를 WARN 전용으로 추가하여 100줄 초과 시 자동 경고 출력. QC 셀프 체크리스트 10번 항목도 추가 완료. 자동 트리밍은 team_prompts.py 동적 생성 구조와 충돌하므로 미구현(합의사항). 통합 테스트에서 11개 팀 CLAUDE.md 스캔 → design 팀 310줄 WARN 정상 출력 확인.

---

## 생성/수정 파일

- `/home/jay/workspace/teams/dev6/qc/verifiers/claude_md_check.py` (신규 생성, 53줄)
- `/home/jay/workspace/teams/shared/qc_verify.py` (수정: import 추가, ALL_CHECKS 추가, run_check 분기 추가)
- `/home/jay/workspace/teams/shared/QC-RULES.md` (수정: 10번 항목 추가, verifier 목록 테이블 추가)

---

## 테스트 결과

1. **WARN 케이스**: design/CLAUDE.md 310줄 → `"status": "WARN"` ✅
2. **PASS 케이스**: dev1~dev8, marketing, security 모두 100줄 이하 → 개별 OK 표시 ✅
3. **SKIP 케이스**: 존재하지 않는 workspace_root 전달 → `"status": "SKIP"` ✅
4. **QC 파이프라인 통합**: qc_verify.py --task-id task-1621.1 실행 → claude_md_check가 13번째 verifier로 정상 실행 ✅
5. **기존 verifier 회귀**: 12개 기존 verifier 모두 정상 동작 (FAIL 없음, 기존 기대 상태 유지) ✅

---

## 발견 이슈 및 해결

### 자체 해결 (1건)
1. **claude_md_check.py task_id 미사용 pyright 경고** — `_ = task_id` 추가로 해소
   - 수정: `/home/jay/workspace/teams/dev6/qc/verifiers/claude_md_check.py:11`

### 범위 외 미해결 (1건)
1. **design 팀 CLAUDE.md 310줄 초과** — 범위 외 사유: 디자인팀 자체 관리 영역. 아누 주간 정리 대상.

---

## verifier 동기화 참고

- `claude_md_check.py`는 현재 dev6 팀 verifiers에만 생성됨
- 다른 팀은 `sync_verifiers.py --fix`로 동기화 필요
- shared/qc_verify.py는 `try/except ImportError`로 optional import하므로 동기화 전에도 다른 팀에서 SKIP으로 안전 동작

---

## 모델 사용 기록

- 스바로그(백엔드): sonnet — verifier 생성 + qc_verify.py 수정
- 벨레스(테스터): sonnet — QC-RULES.md 항목 추가
- 페룬(팀장): opus — 설계/검토/통합/보고서