NAS 복구 증거와 백로그 상태 정리

This commit is contained in:
Yun Chan 2026-11-01 20:09:02 +09:00
parent ea1a0d50d3
commit d9040e2a05
9 changed files with 327 additions and 32 deletions

View file

@ -295,6 +295,17 @@ Bash 문법을 섞으면 바로 지연된다. 명령을 작성할 때 아래 규
- **`docs/dev_dashboard.html`이 SSOT(단일 진실 공급원)다.** 상태·검증 증거·결정 필요·로드맵의 권위 기준이며, 새 발견·작업 결과·상태 변경은 별도 문서로만 남기지 말고 대시보드에 반영/동기화한다. 백로그(`docs/ops/backlog-*.md`)는 대시보드와 일치시킨다(어긋나면 대시보드 기준).
- 소유자(윤찬) 단독 결정 사안을 임의로 정하지 않는다(월권 금지).
## 1.1 토큰·캐시 예산 (2026-10-27 소유자 지시)
도구를 쓸 때마다 대화 전체를 다시 읽으므로 세션이 길수록 호출 한 번이 비싸진다. 2026-10-27 백로그 일괄 처리 세션이 도구 호출 261회·기록 8MB·워커 12개로 불어나 중단됐다.
- **대규모 작업은 세션을 나눈다.** 백로그 전체·여러 배포를 한 세션에서 하지 않는다. 주제 1~2개를 끝내면 `docs/ops/handoff-*.md`에 인계를 쓰고 새 세션에서 잇는다.
- **워커는 꼭 필요할 때만, 세션당 3개 이하.** 보고는 요약으로 받고(원문은 파일로), 같은 일을 워커와 오케스트레이터가 중복하지 않는다.
- **긴 출력은 파일로 저장하고 요약만 읽는다.** 로그·테스트 원문·스크립트 결과를 대화에 붙이지 않는다.
- **Playwright MCP `browser_run_code_unsafe` 금지**(코드 전문을 결과에 되돌린다). 스크립트를 파일로 쓰고 Bash로 `node` 실행, 결과 JSON은 파일로.
- **예약 깨우기로 폴링하지 않는다.** 백그라운드 작업은 완료 알림을 기다린다.
- 전역 hook(`~/.claude/hooks/session-budget-guard.py`)이 도구 호출 120회·기록 6MB·워커 3개를 넘으면 승인을 묻고, `autoCompactWindow=200000`으로 대화를 자동 요약한다.
## 2. 검증 기준 (프론트 변경 시)
- `cd apps/web && npm run typecheck`