diff --git a/CHANGELOG.md b/CHANGELOG.md index b74de10f..71e2fa81 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,35 @@ - 괄호 안 ID는 리뷰 발견 ID다. `MMDD/NN-MM`으로 적는다. `MMDD`는 리뷰 폴더 `docs/reviews/YYYY-MM-DD-maturity-review/`의 월일이고, 근거와 재현 조건은 그 폴더의 영역 문서에 있다. 복사한 프로젝트가 README대로 `docs/reviews/`를 지웠다면 이 폴더와 `PRODUCT.md`는 원본 템플릿 repo에서 찾는다. 라운드마다 `NN-MM`을 새로 매기므로 같은 `14-02`라도 라운드가 다르면 다른 결함이다. `F-N`은 그 라운드 `FOLLOW-UP.md`의 ID다. 리뷰 README의 절은 `MMDD README N.N`으로 적고 다시 돌린 항목은 그 뒤에 `X2`처럼 번호를 붙인다. 영역 문서가 따로 매긴 ID는 `MMDD NN 영역 P-NN-NN`, 짝 백엔드 리뷰의 ID는 `백엔드 리뷰 MMDD/NN-MM`으로 적는다. `tests/unit/changelog-review-ids.test.ts`가 라운드 없는 ID와 이 꼴을 벗어난 참조를 막는다. - 0.2.0의 커밋 해시는 브랜치 `fix/maturity-review-2026-09-25`에서 만들었고, `main`에서도 같은 해시로 찾을 수 있다(2026-11-03에 52개 모두 확인). 그 뒤 절은 절 머리에 범위(기준 커밋과 브랜치)를 적고, 그 절의 해시는 모두 그 범위에 있다. 통합에서 해시를 다시 쓴 뒤(fixup 접기, rebase)에는 절의 해시와 범위 커밋 본문의 해시를 `git merge-base --is-ancestor <해시> <브랜치 끝>`으로 하나씩 대조하고, 결과를 그 라운드 리뷰 README의 조치 절에 적는다. 1105 통합은 이 대조를 하지 않아, 올린 커밋 `287dc6f`의 본문이 다시 짓기 전 해시 둘을 가리킨다. 맞는 해시는 그 라운드 리뷰 README의 D7 행에 있다 (1106/14-02, 1105 README 16.2). 0.2.0의 커밋 제목은 라운드 없이 ID만 적었다(`git log --grep '03-03'`). +## 미출시 — `8327e221` → 하네스와 작업 매뉴얼 + +2026-11-07 소유자가 정한 Claude Code 작업 환경(하네스)을 백엔드 템플릿과 같은 방식으로 둔다(design-docs `harness/01-harness-design.md` 13절). 루트 지침 `AGENTS.md`(정본)와 `CLAUDE.md`(가져오기), `.claude/`(규칙·스킬·서브에이전트·권한·훅), 작업 매뉴얼 `docs/work/`, 검증 진입점 `scripts/verify.sh`, 장부 `docs/ledger/`다. 제품 코드와 게이트 동작은 바뀌지 않는다. + +### 먼저 할 일 + +- 루트 `CLAUDE.md`를 더 이상 걸러 내지 않는다. `AGENTS.md`·`CLAUDE.md`, `.claude/settings.json`·`rules/`·`skills/`·`agents/`, `docs/work/`, `scripts/hooks/`, `scripts/verify.sh`, `scripts/check-work-docs.py`, `scripts/tests/`는 템플릿 계약이라 받는다. 자기 환경에 맞게 바꿀 곳은 `docs/work/operate.md` 4.1절, `docs/work/delegate.md` 4.3절, `scripts/verify.sh`의 환경 변수(호스트, 원격 checkout, 잠금, 로그 폴더)다. +- `.gitignore`가 `.claude/`를 넷만 남기고 무시한다. 자기 `.claude/` 파일을 추적하고 있었으면 그 줄에 `!` 예외를 더한다. +- `docs/ledger/estimates.jsonl`은 줄을 비우고 받는다. `.gitattributes`의 `merge=union` 한 줄도 받는다. + +### 보안·계약 변경 + +| 표시 | 변경 | 영향 경로 | 커밋 | +| --- | --- | --- | --- | +| [계약] | 제거 드릴의 문서 사본(`REMOVAL_FIXTURE_DOCUMENT_TARGETS`)에 `AGENTS.md`가 들어간다. `docs/README.md` 1절이 `../AGENTS.md`, `work/`, `work/reference/`를 링크해 `verify:documentation`(FE-GATE-017, FE-GATE-005·020 안의 같은 검사) 범위에 든다. 이 문서들의 경로·script·게이트 ID가 틀리면 merge가 막힌다 | `scripts/lib/removal-fixture.ts`, `docs/README.md`, `tests/unit/template-contract-documents.test.ts` | `98f5c6e7` | +| [계약] | README 지워도 되는 파일 표에서 `CLAUDE.md` 행이 빠지고 `docs/ledger/estimates.jsonl`(줄을 비운다)이 들어간다. `tests/unit/deletable-history-documents.test.ts`는 `CLAUDE.md`를 더 보지 않는다 | `README.md`, `tests/unit/deletable-history-documents.test.ts` | `98f5c6e7` | + +### 그 밖의 수정 + +- 작업 매뉴얼 `docs/work/`: README, playbook 여섯, reference 일곱, 근거 `evidence.md`. 개선 매뉴얼 초안(PR #6, main에 없음)과 옛 `CLAUDE.md`의 리뷰 기준을 흡수했다. `SPEC.md`의 공통 완료 기준은 `docs/work/improve.md` 5절로 옮겼다(`3524d6b0`). +- 루트 `AGENTS.md`(꼭 지킬 것 5·지도·검증·라우터)와 `@AGENTS.md`를 가져오는 `CLAUDE.md`, 검사기 `scripts/check-work-docs.py`(`6e8cc963`). +- `.claude/rules/` 다섯, 스킬 `desktop-gates`·`new-feature`, 읽기 전용 서브에이전트 `arch-reviewer`·`verify-app`·`code-simplifier`, 하네스 플러그인 켜기와 실제 `.env` 읽기 차단(`9f859628`). +- repo 훅 `scripts/hooks/hooks.py`: 편집 직후 경계(`.dependency-cruiser.json` 규칙)·게이트 기준·문서 알림과 턴 끝 desktop 검증 알림. 막지 않는다(`9961ecb1`). +- `scripts/verify.sh <단계>`: stage·게이트·명령을 `config/ci/gates.json`에서 읽어 desktop에서 CI env로 돈다(`c6e42528`). 장부 `docs/ledger/`(`9d65a41d`). + +### 알려진 제한 + +- 훅·검사기·`verify.sh` 시험(`python3 -m unittest discover -s scripts/tests`)은 아직 CI workflow가 부르지 않는다. 노트북 `scripts/verify.sh hooks`로 돈다. + ## 미출시 — `48c7695b` → 정리 단계 2026-11-07 소유자가 지시한 저장소 정리다(design-docs `repo-structure/04-frontend-layout.md` 9.2절, 결정은 `repo-structure/README.md` 3.4절). 범위는 `main` `48c7695b`(PR #9 병합) 다음부터다. 1단계(PR #11, `85f941c4`~`121e1125`, `main` `f33e4778`에 합침)와 2단계(브랜치 `chore/layout-2-sample-removal`, `c7e80f2f`부터 브랜치 끝까지)를 담는다. 3단계(합치기)는 아직 없다. 기준점 `48c7695b`를 빼면 이 절의 해시는 모두 이 범위에 있다.