문제: 리뷰 README 18.6절은 합치기 전 사실(결함 13건, round7 1차 Declined
12건 미판정, 결정 3건 대기, r10 트리 게이트)에 머물러 있고, 수정 브랜치를
합친 트리를 어떻게 합쳤고 어떤 게이트로 확인했는지 적은 곳이 없다.
방법: 18.6절 네 칸을 2026-11-07 사실로 고친다. Declined는 round6 30건과
round7 1차 12건이 모두 판정돼 0이고, 게이트는 합친 트리에서 통과했다.
발견 15건은 고쳤지만 다음 확인 리뷰가 판정할 몫이라 "아님"으로 둔다.
README 남은 항목은 수정 세션이 범위 밖으로 적은 메모 넷을 그대로 옮긴다.
18.8절에 병합 순서, 충돌 세 곳과 처리, 게이트 표(PR 단계, 경로 필터
lane, main 단계, releaseCheck 둘), 못 돌린 것을 적는다. 버린 대안: 남은
메모를 결함으로 판정해 색인에 넣기 — 이 일은 합치고 검증만 하고, 판정은
확인 리뷰가 한다.
위험·한계: lychee·buf·trivy·GitHub dependency review는 돌리지 못했다
(18.8절에 이유와 대체). mainCheck 안 verifyFeatureScaffold의 중첩 빌드는
--no-build-cache를 넘겨받지 않아 FROM-CACHE 2줄이 남았다.
검증: desktop ~/integration-r8-logs/(pr-summary.txt, main-summary.txt)에서
48565718 대상 명령 46개 rc=0. 이 커밋 뒤 노트북에서
check-work-docs.py 전체·--history docs/manual·lychee 범위 --links(링크 520,
깨짐 0), check-review-index.py(172/172) rc=0, git diff --check 통과.
docs
저장소의 모든 문서는 이 디렉터리 아래에 있다. 어떤 문서를 어디에 두는지가 유일한 규칙이고, 파일 목록은 디렉터리를 직접 읽는다. 개수를 여기에 적으면 다음 문서가 추가되는 순간 틀린 글이 된다.
어댑터별 운영 문서
각 어댑터의 지원 범위, 설정, 보안, 운영, 마이그레이션 문서다. 코드와 함께 갱신되어야 하는 문서이고,
docs/httpclient/ 는 scripts/verify-httpclient-docs.py 가 코드에서 뽑은 이름과 대조한다.
| 디렉터리 | 대상 |
|---|---|
fileserver/ |
파일 서버 어댑터 |
httpclient/ |
HTTP 클라이언트 플랫폼 |
jpa/ |
JPA·PostgreSQL 영속성 |
messaging/ |
메시징 어댑터 |
mongodb/ |
MongoDB 문서 영속성 (advanced/, runbooks/ 포함) |
notification/ |
알림 전달 플랫폼 (adr/ 포함) |
redis/ |
Redis 캐시·세션 |
횡단 문서
| 디렉터리 | 대상 |
|---|---|
adr/ |
아키텍처 결정 기록 |
architecture/ |
공개 API 표면 스냅숏 |
work/ |
작업 매뉴얼: 이 repo에서 하는 일(새 기능, 개선, 조사·설계, 문서 작성, 운영, 총괄)의 절차서. 루트 CLAUDE.md 다음에 읽는다 |
manual/ |
개발 매뉴얼: 새 기능을 만드는 순서와 판단 지점, 생성 명령(scripts/new-feature.sh). 입구는 work/new-feature.md |
evidence/ |
작업 단계별 증거·체크포인트 |
registries/ |
env 키·에러 코드·메트릭·헤더 등 레지스트리 SSOT |
reviews/ |
모듈 코드 리뷰 결과 |
runbooks/ |
장애 코드별 대응 런북 (template.md 기준) |
security/ |
공개 경로 스냅숏 |
설계와 계획
| 디렉터리 | 대상 |
|---|---|
superpowers/specs/ |
설계서. YYYY-MM-DD-<주제>-design.md |
superpowers/plans/ |
구현·확장 계획서. YYYY-MM-DD-<주제>-plan.md |
superpowers/packages/ |
외부에서 납품된 설계 패키지의 README와 정적 검증 결과 |
superpowers/packages/<어댑터>/ 는 설계서가 처음 전달됐을 때의 안내와 VALIDATION.md 검증 이력을
남긴 기록 보관소다. 설계서·계획서 본문은 전부 specs/ 와 plans/ 에 있으므로 이 디렉터리에서
문서를 찾을 필요는 없다. 각 README 상단의 보존 안내가 무엇이 옮겨졌고 무엇이 제거됐는지 밝힌다.
계획서 본문에는 당시 계획한 경로와 명령이 그대로 남아 있다. 그중 일부는 실제 구현에서 다른 위치로
조정됐고, 저장소에 어떻게 대응시켰는지는 각 어댑터의 repository-adaptation.md 또는
module-mapping.md 가 기록한다. 계획서를 사후에 고치지 않는 이유는 그렇게 하면 계획의 기록이 아니라
결과를 계획처럼 보이게 만든 글이 되기 때문이다.
여기에 없는 것
- 실행되는 검증 스크립트는 문서가 아니다.
scripts/와.github/scripts/에 있다. - 모듈 레지스트리·Gradle 정책은
src/config/architecture/modules.json과src/build.gradle이 소유한다. - 각 모듈의 지역 규칙은 해당 모듈의
src/**/CLAUDE.md가 소유한다.