# task-1115.1 완료 보고서
> 세션 경량화 시스템 — strategic-compact 훅 + 워크플로우 규칙 코드화
> 팀: dev4 (비슈누) | 레벨: Lv.2 | 날짜: 2026-03-27

## SCQA

**S**: Claude Code 세션의 자동 압축 임계값이 50%로 설정되어 있으나(1단계 완료), 자동 압축은 임의 시점에 발생하여 논리적 전환점에서의 수동 압축보다 효과가 떨어진다. 세션 경량화 관련 워크플로우 규칙이 문서화되지 않아 팀별 준수가 불균일하다.

**C**: 실측 데이터에 따르면 컨텍스트 50K~147K 구간(25~73%)에서 성능이 서서히 하락하고, 147K+ (73%+)에서 성능 붕괴가 발생한다. 도구 호출 횟수 기반 경고 없이는 봇이 성능 붕괴 지점까지 진행하고, 리서치→구현 세션 분리 규칙이 코드로 강제되지 않아 긴 세션이 반복된다.

**Q**: 도구 호출 횟수 기반 경고 훅과 워크플로우 규칙 코드화로 세션 성능 붕괴를 예방할 수 있는가?

**A**: 3단계 구현으로 해결. (1) strategic-compact.sh PostToolUse 훅: 도구 50회 호출 시 첫 경고, 이후 25회마다 반복 경고 — 14/14 bash 테스트 통과. (2) DIRECT-WORKFLOW.md에 세션 경량화 규칙 6개 원칙 + 4개 /compact 트리거 조건 문서화 (23줄 추가). (3) dispatch.py에 지시서 크기 3000자 초과 경고 가드 추가 + research-impl 혼합 경고에 /compact 안내 삽입 + team_prompts.py에 세션 경량화 규칙 자동 주입 — pytest 197건 전체 통과, pyright 0 에러.

## 산출물

### 신규 파일 (2건)
1. `/home/jay/workspace/hooks/strategic-compact.sh` — PostToolUse 훅 (72줄)
2. `/home/jay/workspace/hooks/tests/test_strategic_compact.sh` — bash 테스트 (14 assertions)

### 수정 파일 (5건)
1. `~/.claude/settings.json` — PostToolUse에 strategic-compact 훅 등록 (matcher: "")
2. `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` — 세션 경량화 규칙 섹션 추가 (23줄)
3. `/home/jay/workspace/dispatch.py` — `_warn_large_task_desc()` 함수 신규 + `_warn_research_impl_mix()` 강화
4. `/home/jay/workspace/prompts/team_prompts.py` — `_build_direct_prompt()`, `_build_glm_prompt()`에 세션 경량화 규칙 주입
5. `/home/jay/workspace/tests/test_dispatch.py` — 3건 테스트 추가 (98 total passed)
6. `/home/jay/workspace/tests/test_team_prompts.py` — 2건 테스트 추가 (99 total passed)

## 검증 결과

- bash 훅 테스트: 14/14 PASS
- pytest test_dispatch.py: 98 passed
- pytest test_team_prompts.py: 99 passed
- pyright: 0 errors, 0 warnings
- 기존 테스트 회귀: 없음

## 자체 해결 (0건)
작업 중 발견된 이슈 없음.

## 범위 외 미해결 (0건)
없음.