quad/.claude/session/2026-08-13-11-corpus-audit-sequential-direct.md

2026-08-13 열한 번째 세션 — 서브 에이전트 없이 순차 직접 감사, 부정확성 4건 수정

배경

사용자가 "전체 문서 감사를 시작해. 부정확하여 문제되는 부분 있나 봐줘. 단 서브 에이전트 없이 직접 수행해. 오래 걸려도 좋아." — 열 번째 세션이 6개 병렬 Explore 에이전트로 감사했던 것과 달리, 이번엔 명시적으로 에이전트 위임 없이 메인 컨텍스트가 직접 전체 코퍼스를 순회하는 방식을 요청받음.

방법

1. python3 .claude/tools/doc-check.py 선실행 — ERROR 0, WARN 59건은 기존과 동일(전부 절 제목 의역 인용류 허용 범위).
2. .claude/base/ 20개 문서 전체를 처음부터 끝까지 순서대로 정독 (architecture → store-semantics → bind-system-plan(2284줄) → module-lifecycle-plan → lifecycle-pattern → slot-plan(1920줄) → modifier-plan → purity-and-effects-plan → component-composition-plan → blocker-plan → effect-plan → ui-shorthand-plan → tag-plan → attribute-plan → onchange-plan → relate-plan → ref-plan → event-plan → brand-plan → tween-plan) — 특히 최근 재설계(인덱스 기반 Dispatch, Slot 언마운트 전환, 0-Z 배너)가 집중된 문서들의 배너 부착 여부와 본문 정합성을 중점 확인.
3. research/ 9개 문서 전체 정독(existing-instance-bind-plan, debug-tooling-plan, framework-comparison-findings, additional-primitives-plan, pre-implementation-audit(732줄), operator-sugar-plan, v1-compat-plan, documentation-plan, documentation-content-map, dispatch-redispatch-diff-plan).
4. reference/ 3개 문서, luau-test/STATUS.md+README.md(폴더 구조와 개수 대조), audit/ 2개 문서, archive/ 18개 파일 목록과 .claude/README.md 색인 매핑을 확인.
5. ROADMAP.md/HUMAN_TODO.md/.claude/question.md를 다시 정독하며 위에서 확인한 최신 상태와 대조.

발견 및 수정

1~2. question.md 0-Z/0-A — "6개 문서" stale 카운트: 0-Z 해소 시 옮겨야 할 문서 개수가 "6개"로 남아 있었으나, research/ dispatch-redispatch-diff-plan.md 6절(소스)은 이미 ref-plan.md를 포함한 "7개"로 확정돼 있었음 — 9차 세션 분할 때 ref-plan.md에 배너가 안 옮겨간 걸 10차 세션이 발견해 여러 곳을 정정했는데, question.md 자신의 이 두 문단(0-Z 상단, 0-A "실행 규모")은 그때 놓쳤던 것. 둘 다 "7개"+ref-plan.md로 정정.

3. HUMAN_TODO.md 4번 항목 — 동일한 stale 카운트: 위와 완전히 같은 "6개" 문구가 이 파일에도 독립적으로 남아있었음(10차 세션이 정정한 파일 목록엔 HUMAN_TODO.md가 없었음) — "7개"로 정정.

4. ROADMAP.md 백로그 — 이미 해소된 항목이 여전히 할 일로 남음: "v1 마이그레이션 가이드 + objectListClass.__newIndex 오타 기능 재현 테스트"가 여전히 미체크 백로그 항목이었으나, 2026-08-13 세 번째 세션 (session/2026-08-13-03-v1-newindex-typo-scoped-out.md)에 이미 "v2엔 대응 개념 자체가 없어 재현 여부와 무관하게 다룰 대상 아님"으로 해소돼 있었음(archive/question-resolved.md/reference/quad-v1-architecture.md 둘 다 반영됐으나 ROADMAP.md만 놓침) — 해소 사실과 근거 포인터를 남기고 재현 테스트 문구는 제거.

문제 없음으로 확인된 것

• base/ 20개 문서 전체 — 특히 0-Z 배너가 붙어야 하는 7개 (bind-system-plan/tag-plan/slot-plan/attribute-plan/ref-plan/ architecture/ROADMAP) 전부 배너 부착 확인, 배너 밖 서술도 최신 결정(retract 항상 호출/State<State<T>> 정상 지원/인덱스 기반 chains/Slot 언마운트 전환/and·or 삼항 금지)과 전부 일치.
• research/ 9개 문서 — stale 정정 배너(Tag 구모델, Tween 구모델 등) 전부 정확한 위치에 정확한 내용으로 부착됨.
• luau-test/STATUS.md↔README.md↔실제 폴더 구조 — done 15/ review-required 1/rewrite-required 3/not-run 1(+헬퍼 1), 세 문서 전부 같은 숫자로 일치.
• archive/ 실제 파일 18개 ↔ .claude/README.md 색인 표 18행 — 완전 매핑, 누락/초과 없음.
• reference/ 3개 문서 — Fusion/Vide/v1 비교 자료의 stale 모델 참조는 전부 이미 "[정정]" 배너로 최신 모델 포인터가 달려 있었음.

교훈

• 같은 stale 값이 여러 문서에 독립적으로 복붙된 경우, 한 문서에서 고쳐도 나머지가 자동으로 안 따라온다 — 10차 세션이 이미 같은 종류의 "6→7" 정정을 겪었는데도(그때는 dispatch-redispatch-diff-plan.md/ CLAUDE.md), 그 정정 자체가 다른 두 문서(question.md/ HUMAN_TODO.md)엔 안 퍼져 있었음 — CLAUDE.md가 이미 명문화한 "개수· 목록·상태는 소스를 하나만 둘 것" 원칙이 지켜지지 않은 사례라기보다는, "소스 하나(dispatch-redispatch-diff-plan.md)를 인용하는 여러 자리를 전부 grep으로 찾아 동시에 고치지 않으면 한쪽만 갱신되고 나머지는 그대로 남는다"는 걸 재확인.
• "해소됨" 처리가 원본 근거 문서(archive/, reference/)엔 반영돼도 그걸 인용하던 실행 문서(ROADMAP.md)엔 전파 안 될 수 있다 — objectListClass.__newIndex 사례처럼, 결정이 내려진 세션 자체는 관련 문서 2곳을 정확히 갱신했지만 원래 이 항목을 만들어낸 자리 (ROADMAP.md 백로그)는 그 세션의 반영 대상 목록에 없었던 것으로 보임 — "이 결정이 어디서 인용되는지" grep을 결정 시점에 한 번 더 돌리는 습관이 필요.
• 10차례 감사를 거친 코퍼스라도, 카운트/포인터류의 국소적 stale은 여전히 남을 수 있음 — 설계 자체의 모순보다 이런 종류가 훨씬 잦다는 건 이미 여러 세션이 확인한 패턴이고 이번에도 동일했음.

반영 상태

question.md/HUMAN_TODO.md/ROADMAP.md 3개 파일 수정, doc-check.py ERROR 0 유지 확인. 새로 연 설계 질문 없음(전부 기존 서술 정합성 문제), 0-Y/0-Z 상태 불변.