# task-381.1 완료 보고서

## 작업 요약
토큰 절약 Phase 1 — Team 1: QC-RULES 레벨 분리 + Step 7 완료 통보 스크립트화

## 작업 내용

### 작업 1: QC-RULES 레벨 분리

**1-1. QC-RULES.md 분리**
- `QC-RULES.md` (base): Section 1-A(기본 체크리스트), Section 2(자동 검증), Section 5(에러 처리), 변경이력 유지. 하단에 extended 참조 안내 추가.
- `QC-RULES-EXTENDED.md` (신규): Section 1-B(데이터 계약), Section 1.5(인터페이스 계약), Section 3(마아트), Section 4(로키) 이동.
- 효과: normal 레벨 세션에서 약 2,500 토큰 절감 (206줄 → ~120줄)

**1-2. team_prompts.py 수정**
- `_build_verification_section()` 레벨별 분기 경로 변경:
  - normal: base만 참조 + workers/ 변경 시 extended 데이터 계약 참조 안내
  - critical: base + extended (마아트 독립 검증 포함)
  - security/else: base + extended (마아트/로키 검증 포함)

### 작업 2: Step 7 완료 통보 스크립트화

**2-1. notify-completion.py 생성**
- `scripts/notify-completion.py`: argparse + subprocess로 cokacdir 호출 래핑
- 500자 긴 cokacdir 명령을 `build_prompt()` 함수로 캡슐화
- 효과: DIRECT-WORKFLOW.md Step 7이 1줄로 축소 (~500자 → ~60자)

**2-2. DIRECT-WORKFLOW.md Step 7 수정**
- 기존: 긴 인라인 cokacdir 명령
- 변경: `python3 {WORKSPACE_ROOT}/scripts/notify-completion.py {task_id}`

## 생성/수정 파일 목록
- **수정**: `/home/jay/workspace/teams/shared/QC-RULES.md` (축소: 206줄 → ~120줄)
- **신규**: `/home/jay/workspace/teams/shared/QC-RULES-EXTENDED.md` (분리된 섹션)
- **수정**: `/home/jay/workspace/prompts/team_prompts.py` (`_build_verification_section()` 경로 분기)
- **신규**: `/home/jay/workspace/scripts/notify-completion.py` (Step 7 대체 스크립트)
- **수정**: `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` (Step 7 축소)
- **신규**: `/home/jay/workspace/scripts/tests/test_notify_completion.py` (11개 테스트)

## 테스트 결과
- `tests/test_team_prompts.py`: 54 passed, 4 failed (기존 실패 — direct 팀 project_id 테스트, 프롬프트 경량화 이후 미업데이트)
- `scripts/tests/test_notify_completion.py`: 11 passed
- pyright: 0 errors
- black + isort: OK

## 자동 검증 결과 (qc_verify.py)
- pyright_check: PASS
- style_check: PASS (black + isort OK)
- test_runner: PASS (21 passed)
- tdd_check: PASS
- data_integrity: PASS
- file_check: PASS (보고서/done 생성 후)

## 비고
- 기존 테스트 4개 실패(TestBuildPromptProjectId 3개 + TestBuildPromptOriginal 1개)는 프롬프트 경량화(direct 팀에서 isolation rule을 DIRECT-WORKFLOW.md로 위임) 이후 미업데이트된 기존 결함. 이번 작업 범위 외.
- task 명세의 2-3(chain_id 지원)은 "선택" 항목이며, 현재 notify-completion.py에서 chain_manager.py를 이미 호출하므로 별도 --chain-id 옵션 없이도 기능 동작함.