diff --git a/docs/work/evidence.md b/docs/work/evidence.md index 96aaecf8..85683ff9 100644 --- a/docs/work/evidence.md +++ b/docs/work/evidence.md @@ -377,3 +377,38 @@ - 합계: 52건, 34행. 고침 34행(그중 기본값 7행), 고치지 않음 0, 소유자 결정 필요 0. - 소유자 결정(2026-11-07)으로 한 일: 이력 ID 0 규칙을 진입 문서로 넓혔다(10절, 결정 색인 2.1 「이력 ID 0 규칙의 범위」). - 「자주 하는 실수」에 넣은 줄: `improve.md`(탐침의 Error Prone을 기존 줄에 더함). + +## 12. cold-read 시험 3회차 빈틈과 쌓인 매뉴얼 규칙 처리 (2026-11-07) + +하네스 재설계를 적용한 묶음(design-docs `harness/01-harness-design.md`, 소유자 결정 2026-11-07 「매뉴얼 보강은 한 묶음」)에서 함께 넣었다. 원천은 넷이다: cold-read 3회차(수정 세션 넷 `r9-g1`~`r9-g4`의 빈틈 9건), 위임 장부(design-docs `delegation-loop/ledger.jsonl`)의 `"to": "manual"` 줄 중 백엔드 몫, 공유 노트의 매뉴얼 보강 목록, design-docs `repo-structure/01-backend-layout.md` 10·12절·`02-docs.md` 9절·`03-ci.md` 8절. + +- 처리 칸: 고침(고친 곳) / 이미 있음(그 자리) / 고치지 않음(이유). 「고침(기본값)」은 이 묶음이 정하고 결정 색인에 기본값으로 남긴 것이다. +- 1·2회차 빈틈(장부 6~22줄)은 9절·11절에서 이미 처리했다. 다시 넣지 않았다. + +| # | 출처 | 빈틈 | 처리 | +| --- | --- | --- | --- | +| R3-1 | G1-1 | brief가 옮긴 결정 설명과 결정 원문이 다를 때 무엇을 따르나 | 고침 — `reference/decisions.md` 1절 1(원문을 따르고 차이를 보고) | +| R3-2 | G1-3 | desktop 잠금을 여러 세션이 기다릴 때 순서와 시간 | 고침 — `reference/gates.md` 4절 「공유 잠금 기다리기」 | +| R3-3 | G2-1 | 커밋하는 수정에서 lockfile을 손으로 고쳐도 되나 | 고침 — `reference/gates.md` 2절 탐침 첫 줄(desktop `resolveAndLockAll --write-locks`) | +| R3-4 | G2-2 | desktop에서 자기 실행을 멈추는 법(`pkill -f`가 ssh 세션을 끊음) | 고침 — `operate.md` 4.1절 | +| R3-5 | G3-1, G3-3 | 절차 문서 결함과 대기 결함의 RED 모양 | 고침 — `improve.md` 4.2절 3 | +| R3-6 | G3-2 | 검증 뒤 앞 커밋에 형식 수정을 넣는 법 | 고침 — `operate.md` 4.1절(커밋을 나누기 전에 확인, 편집 훅이 파일마다 맞춤) | +| R3-7 | G4-1 | 그 코드를 지키는 lane을 찾는 법 | 고침 — `improve.md` 4.2절 8 | +| R3-8 | G4-2 | upgrade 안내 「커밋:」 줄을 여러 묶음이 고칠 때 | 고침 — `delegate.md` 4.2절 표 | +| R3-9 | 장부 r9 통합(5건) | OOM 재시작 거짓 통과, 자원 의존 실패의 판정, `--no-build-cache` 차이, zsh 파이프 rc, 처음 켜진 lane의 이전 실패 | 고침 — `reference/gates.md` 6절 표·4절 「원래 있던 실패 가리기」·3절, `operate.md` 4.1절, `reference/gates.md` 3절 (나) 5 | +| R3-10 | 장부 t1(5건) | smoke 이미지 재사용, `if` 안 `set -e`, leaf 데이터 폴더, 트리 해시로 커밋에 묶기, 코드 주석 언어 | 고침 — `reference/gates.md` 4절·6절, `new-feature.md` 6절, 이미 있음 — `operate.md` 4.1절 「push 전에 검증하기」, 고침 — `docs-writing.md` 4절 4 | +| R3-11 | 장부 d1(5건) | 이동 커밋과 검사, Gradle 밖 검사의 자리, 줄기만 하는 예외 목록, MANIFEST, scripts 시험 위치 | 고침 — `docs-writing.md` 4절 13·14, `reference/gates.md` 7절 1·8, 이미 있음 — `docs/README.md` 「문서 검사」 | +| R3-12 | 장부 i1(4건+2) | 병합에서만 생긴 수정, FROZEN 지문, smoke 이미지, 순서 의존 재현, check-docs 줄 누락, lychee·buf·trivy | 고침(기본값) — `delegate.md` 4.2절(병합 커밋에는 충돌 해결만), 이미 있음 — `docs/README.md`, 고침 — `reference/gates.md` 4절 둘, `docs-writing.md` 4절 10·5절·8절, `review-criteria.md` 9절, `reference/gates.md` 3절 (다) | +| R3-13 | 장부 i2(4건) | smoke 이미지 출처, trivy DB 받기, 문체 검사의 주인, 테스트 Javadoc | 고침 — `reference/gates.md` 4절, 고침(기본값) — `operate.md` 4.1절·결정 색인 「desktop 도구 설치」, 고침 — `check-docs.py` `style`, `improve.md` 4.2절 6 | +| R3-14 | 장부 d2a, d2c(4건) | 레지스트리 yaml 번역, 영어 절 제목 인용, 머리말 없는 runbook, `@DisplayName` 범위 | 고침 — `docs-writing.md` 4절 14, `.claude/rules/java-tests.md` 규칙 2 | +| R3-15 | 장부 41(프론트 총괄) | brief의 「충돌 없음」, 중복 PR | 고침 — `delegate.md` 9절 | +| R3-16 | 공유 노트 | 결정 기록 머리 둘째 줄이 번역한 ADR에 맞지 않음 | 고침 — `check-docs.py` `DECISION_LABEL`, `docs/README.md`, ADR 머리 블록. design-docs `docs-system.md` 4.1절과 프론트는 이 repo 밖 | +| R3-17 | 공유 노트 | `check-repo-layout.py` 설명과 지도 범위, `template-vs-consumer.md` 분류 | 고침 — 루트 `AGENTS.md` 지도, `check-repo-layout.py`, `docs/ci-cd/template-vs-consumer.md` | +| R3-18 | 01-backend-layout 10.1·10.3 | 리뷰 기준의 최상위 폴더·참조 0 파일·배포·개발자 경험·삭제 가능성, 최상위 폴더 일의 크기, 테스트 환경 위치 | 고침 — `review-criteria.md` 관점 2·9·18·20·27, `README.md` 2절, `new-feature.md` 6절 | +| R3-19 | 01-backend-layout 12절 | 개발 환경의 뜻 | 고침 — `reference/terms.md`(새) | +| R3-20 | 02-docs 9절 | 용어집, 모듈 README 칸, 리뷰의 문서 기준, Important 예시 | 고침 — `reference/terms.md`, `docs/README.md` 「모듈 README」, `review-criteria.md` 관점 4·9·20·23·26·3절 | +| R3-21 | 03-ci 8절 | workflow·스크립트를 더하는 기준, 빌드·CI 비례성, 같은 장치 결함 되풀이, runner 사실 | 고침 — `reference/gates.md` 7절, `review-criteria.md` 관점 4·20·21, `improve.md` 7절·`delegate.md` 4.2절, `operate.md` 4.1절 | +| R3-22 | 장부 1·33·43줄, 01 10.2·12절 6, 02·03의 design-docs 몫 | 결정 질문 상자, 훅 빈틈, live 클러스터 적용, 성숙도 리뷰 가이드, design-docs README | 고치지 않음 — design-docs(총괄) 몫. 이 repo 밖 | + +- 합계: 22행. 고침 21행(그중 기본값 2), 고치지 않음 1행(이 repo 밖). +- 「자주 하는 실수」에 넣은 줄: `delegate.md` 둘.