docs: 감사 루프 4라운드에서 중단(사용자 결정) + 다음 세션 핸드오버 정리

수렴 조건(무발견 2연속)은 못 채웠으나 사용자 결정으로 중단. 발견 추이
6→5→2→2이고 3·4라운드분은 이 세션 변경의 stale이 아니라 코퍼스에 오래
있던 일반 부채(개수 하드코딩, 날짜 없는 시한부 주장)라, 계속 돌리면 수렴이
아니라 옛 부채를 끝없이 캐는 쪽이 된다는 판단. 이 세션 변경분 자체는
안정적(4라운드 설계 코퍼스 각도에서 확실 발견 0건).

todos.md 7번에 중단 사유와 "이번 미수렴 때문에 이어서 돌릴 필요 없음"을
명시하고, 세션 로그에 다음 세션 핸드오버 절(§18) 추가.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
qwreey 2026-08-16 04:05:05 +09:00
parent 01c4abf727
commit d23d46f746
Signed by: qwreey
GPG key ID: D28DB79297A214BD
2 changed files with 41 additions and 0 deletions

View file

@ -457,3 +457,35 @@ The exact model ID is claude-sonnet-5."로 보고 — §13/§14의 트랜스크
**`HUMAN_TODO.md` 8번**으로 옮겼다: 사용자가 시점을 파악하거나, 사용
가능해질 때 에이전트에 알린다. **알려주기 전까지 에이전트는 스스로 판단하지
않고 "일단 `local`로" 원칙을 유지한다.**
## 18. 다음 세션에 넘기는 것
**감사 루프는 4라운드에서 사용자 결정으로 중단**(수렴 미달). 발견 추이
6→5→2→2, 3·4라운드분은 이 세션 변경의 stale이 아니라 코퍼스의 오래된
일반 부채였음. **이번 미수렴 때문에 이어서 돌릴 필요 없음** — 다음 세션이
중대 변경을 하면 그때 평소 절차대로.
**먼저 읽을 것**: `.claude/conventions.md`(이번에 크게 바뀜 — "설계 원칙"
절 신설, 감사 루프 절차 전면 재설계, "사용자 발언 인용 시 논거까지" 관례
신설, `@import` 신선도 주의) → `.claude/todos.md` 7번 → 필요하면 이 문서.
**M0 게이트는 여전히 없음** — 이 세션은 툴링만 만졌고 설계 결정은 안
건드렸다. 착수 전 필독은 그대로 `base/typing-limits.md`
`base/dispatch-core-plan.md`.
**사용자 대기 항목**:
- `HUMAN_TODO.md` 8번 — `const` 툴링 지원 시점(사용자가 알려줄 때까지
에이전트는 판단하지 말 것)
- `question.md` — 용어 정리 잔여, `Operator` 이름 등 기존 항목. 이번 세션이
새로 연 질문은 없음(연 것 둘 다 같은 날 닫힘)
**열린 툴링 미스터리 둘**(M0와 무관, 급하지 않음):
1. 서브에이전트 정의가 언제 반영되는지 모름 — 관측표는
`agents/quad-doc-auditor.md` 상단 배너. **세 번째 가설을 세우지 말 것**,
필요하면 마커로 확인.
2. `tools:` 필드 미반영(적힌 Grep/Glob 안 주어지고, 안 적은 `advisor`
주어짐).
**착수하지 말 것**: `session-summary.md` 자동생성 마이그레이션 — 사용자가
직접 다듬기로 한 항목(`research/doc-include-plan.md`).

View file

@ -132,6 +132,15 @@
`tools:` 필드가 그대로 반영되지 않는 건 **여전히 미해결**이라, 읽기
전용은 도구 유무가 아니라 프롬프트의 행동 규약으로 계속 지킨다.
**[2026-08-16] 이번 세션의 감사 루프는 4라운드에서 사용자 결정으로
중단 — 수렴 조건(무발견 2연속)은 못 채웠다.** 라운드별 새 발견은
6→5→2→2로 줄었고, 3·4라운드에 나온 것은 **이 세션 변경의 stale이 아니라
코퍼스에 오래 있던 일반 부채**(개수 하드코딩, 날짜 없는 시한부 주장)라
계속 돌리면 수렴이 아니라 옛 부채를 끝없이 캐는 쪽이 된다는 판단.
**이 세션 변경분 자체는 안정적**(4라운드 설계 코퍼스 각도에서 확실
발견 0건). 다음 세션이 중대 변경을 하면 그때 평소대로 감사 루프를
돌리면 되고, 이번 미수렴 때문에 따로 이어서 돌릴 필요는 없다.
**미해결 1 — 정의 파일이 언제 반영되는지 모른다.** 감사자가 실제로 받은
정의 텍스트가 실행마다 달랐다: 세션 시작 상태 → 그 시점 HEAD 커밋 →
**어느 커밋과도 일치하지 않는 중간 워킹트리 상태**(커밋된 적 없음,