문제: README가 두 매뉴얼에서 다른 것은 종료 조건 하나라고만 적었다. 프론트
매뉴얼 세션이 알려 온 것을 보면 장 번호와 파일 이름은 같지만, 「소유자 환경」
절 번호, 심각도 체계, 부록 패턴 ID가 다르다. 두 repo를 같은 번호로 비교하는
사람이 절 번호를 그대로 옮기면 엉뚱한 절을 찾는다.
방법: "소유자가 의도적으로 다르게 둔 것"은 종료 조건 하나로 남기고, repo 이력
때문에 다른 세 가지를 표로 적는다. 비교할 때는 장 번호로 찾고 절 번호와
패턴 ID는 각 매뉴얼에서 다시 찾으라고 적는다.
검증: 인용·링크 대조 스크립트를 다시 돌렸다(새 불일치 없음).
문제: 07장은 desktop 빌드를 "겹치지 않게"라고만 적고 잠금 파일을 정하지
않았다. 짝 프론트도 같은 desktop에서 돌려 부하와 포트(4173·4174)가 겹칠 수
있다. 또 두 repo 매뉴얼은 장 구성이 같은데, 리뷰 반복 종료 조건은 소유자가
"각자 유지"로 정해 서로 다르다. 이 차이가 매뉴얼에 없으면 같은 뼈대를 보고
같은 조건으로 오해한다.
방법: 07장 6절 절차와 규칙에 `flock /tmp/claude-gates/heavy.lock`을 넣고
한 줄 명령을 적는다(총괄 세션 지시). 08장 색인에 "두 repo의 종료 조건"과
"desktop 공유 잠금" 행을 더하고, 누가 칸에 "총괄 지시"·"정책" 뜻을 적는다.
README의 프론트 뼈대 절과 09장 5절에 이 조건만 의도적으로 다르다고 적는다.
검증: 인용 경로·ID·링크·절 번호 대조 스크립트를 다시 돌렸다(새 불일치 없음).
문서 대조 lane은 push 뒤 desktop에서 잠금 아래 다시 돌린다.
문제: 이 repo를 리뷰하거나 결함 수정·리팩터링·성능 최적화·구조 변경을 할 때
기준으로 삼을 문서가 없다. docs/manual/은 새 기능을 만드는 순서이고, 리뷰
기준으로 써 온 공용 가이드는 프론트 repo에만 있으며 AGENTS.md·CLAUDE.md가
가리키지 않는다. 2026-11-01부터 쌓인 소유자 결정과 반복 결함 패턴은 리뷰
문서 여러 곳에 흩어져 있다.
방법: docs/improvement/에 README, 01~09장, 결함 패턴 부록을 둔다. 규칙은
다시 쓰지 않고 정본(AGENTS.md, modules.json, application-core/CLAUDE.md,
TESTING_STRATEGY.md, src/build.gradle, 리뷰 문서의 결정 절)을 가리킨다.
정본이 없는 것 — 작업 종류별 절차, 이 repo의 28개 관점 점검 항목과 결함
정의, 반복 결함 패턴, 성능 측정 조건, 무거운 실행 위치, 결정 색인, 세션
분업과 리뷰 반복 종료 조건 — 만 매뉴얼이 정본이 된다. AGENTS.md에
「리뷰·개선 작업 기준」 절, CLAUDE.md에 그 요약을 두고 docs/README.md와
docs/manual/README.md에서 가리킨다. 프론트 매뉴얼과 같은 장 번호를 쓴다.
버린 대안: docs/reviews/ 안에 두기(결과 보관소와 기준서가 섞인다), 공용
가이드 복사(갈라진 복사본이 된다), 소유자 환경 규칙을 AGENTS.md에 직접
쓰기(파생 프로젝트가 정책 문서를 고쳐야 한다).
위험·한계: 매뉴얼을 정본과 대조하는 자동 검사는 없다(문서 파서를 두지
않는 repo 방침). 08장 결정 표는 색인이고 원문과 다르면 원문이 맞다. 저장소
밖 문서(공용 가이드, 커밋 규칙)는 lychee가 따라갈 수 없어 링크 대신 코드
표기로 썼다. 근거를 찾지 못한 것 하나(측정 스크립트를 scripts/perf/로
넣기)는 [제안]으로 표시했다.
검증: 인용한 저장소 경로·리뷰 ID·클래스 이름·태스크 이름·상대 링크·절
번호를 스크립트로 전수 대조했다(로컬, 읽기만). 남은 불일치는 저장소 밖
가이드 경로, 자리표시자, 제안 경로, 원래 있던 문장뿐이다. CLAUDE.md는
DeveloperExperienceContractTest가 요구하는 architectureTest 명령을 그대로
둔다. 문서 대조 lane은 이 커밋을 push한 뒤 desktop에서 돌린다.