# task-1282.1 완료 보고서

**S**: dispatch.py가 팀장 봇에 전달하는 프롬프트에 작업 규칙, 세션 경량화, QC 검증 등 공통 규칙이 매번 인라인으로 포함되고 있다. 팀장은 이미 DIRECT-WORKFLOW.md를 읽도록 되어 있어, 해당 규칙들이 참조 파일에 이미 존재한다.

**C**: 매 dispatch마다 ~328+ 토큰의 중복 텍스트가 전송되어 컨텍스트 윈도우를 불필요하게 소비한다. dev1~dev7 + dev8-mcp 모든 개발팀 위임에서 반복된다.

**Q**: 공통 규칙 인라인 텍스트를 파일 참조로 교체하여 토큰을 절약할 수 있는가?

**A**: 3개 인라인 섹션(작업 규칙, 세션 경량화, QC 검증 상세)을 제거하고, DIRECT-WORKFLOW.md와 QC-RULES.md 파일 참조만 남겼다. 동적 부분(검증 레벨, 참조 파일 크기 경고)은 유지. 테스트 252건 전체 통과.

---

## 수정 파일

- `/home/jay/workspace/prompts/team_prompts.py` — 56줄 제거 (인라인 규칙 → 파일 참조)
- `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` — 3줄 추가 (SCQA 참조, QC-RULES.md 참조)
- `/home/jay/workspace/tests/test_team_prompts.py` — 17개 테스트 assertion 업데이트

## 변경 상세

### team_prompts.py

| 함수 | 제거 내용 | 토큰 절감 |
|---|---|---|
| `_build_direct_prompt` | `## 작업 규칙` (isolation_rule + 디자인 금지), `## 세션 경량화 규칙` (4항목) | ~185 토큰 |
| `_build_mcp_prompt` | 동일 (작업 규칙 + 세션 경량화) | ~185 토큰 |
| `_build_verification_section` | Fantasy Approval 금지, level별 상세, workers 참조, 산출물 표기, SCQA 참조 → 3줄로 간소화 | ~143 토큰 |
| `_build_glm_prompt` | **변경 없음** (GLM-WORKFLOW.md는 DIRECT-WORKFLOW.md를 참조하지 않으므로) | - |

### DIRECT-WORKFLOW.md

- Step 5: `보고서 포맷: SCQA 프레임워크 → {WORKSPACE_ROOT}/memory/specs/scqa-report-template.md` 추가
- Step 6: `{WORKSPACE_ROOT}/teams/shared/QC-RULES.md를 읽고, 프롬프트에서 전달받은 검증 레벨에 맞게 수행` 추가

### 유지된 동적 부분

- `task_id`, `team_id`, `WORKSPACE_ROOT`, `CHAT_ID`, `ANU_KEY` — placeholder 변수
- `project_id`, `chain_id` — 선택적 변수
- `검증 레벨: {level}` — QC 동적 파라미터
- `⚠️ 참조 파일 크기 주의` — dispatch.py에서 동적 생성 (team_prompts.py 범위 밖)

## 테스트 결과

- `tests/test_team_prompts.py`: **111 passed** (0.19s)
- `tests/test_dispatch.py`: **141 passed** (0.84s)
- 구문 검증: `ast.parse()` 통과

## 토큰 절감 측정

- direct/mcp 팀 프롬프트 (normal): **~328 토큰/dispatch** 절감
- 프롬프트 크기 감소: 1,324 chars → 501 chars (62.2% 감소)

## 발견 이슈 및 해결

1. **MCP isolation_rule 참조 잔존**: 초기 수정 시 `_build_mcp_prompt`에서 isolation_rule 참조가 남아 Pyright 경고 → 실제 확인 결과 정상 제거 완료
2. **dev8-team 테스트 경로 분기**: dev8-team은 MCP 타입으로 DIRECT-WORKFLOW.md를 사용하므로, 기존 "시스템 작업" 체크를 "DIRECT-WORKFLOW.md" 참조 체크로 변경
3. **GLM 프롬프트 제외 판단**: GLM-WORKFLOW.md에는 세션 경량화/작업 규칙이 포함되어 있지 않아, GLM 인라인 유지가 올바른 결정

## 셀프 QC

- [x] 1. 영향 파일: DIRECT-WORKFLOW.md, test_team_prompts.py (dispatch.py 간접 영향, 141 tests pass)
- [x] 2. 엣지 케이스: project_id 유/무, level normal/critical/security/unknown, task_type coding/research
- [x] 3. 작업 지시 일치: 3/4 섹션 제거, 1개 유지(동적), DIRECT-WORKFLOW.md 보강
- [x] 4. 보안: 해당 없음 (프롬프트 문자열)
- [x] 5. 테스트 커버: 252 tests pass
- [x] 6. 이슈 직접 해결: 3건 발견, 3건 해결
- [x] 7. DRY 원칙 적용 (중복 제거가 본 작업 목적)
- [x] 8. 인터페이스 변경: `_build_verification_section` 출력 간소화, 테스트 업데이트 완료