문제: 정리 단계 미출시 절이 main을 두 번 받은 뒤 더한 문서 체계 고침(하네스
문서 맞추기, 줄임표 자리표시자, 시험 시간 한도, a11y 기록 경로)을 적지 않는다.
고른 방법: 「그 밖의 수정」에 세 줄을 더한다. 계약 행은 바뀌지 않는다.
검증: changelog-review-ids 시험과 verify:documentation을 desktop에서 본다.
정리 3·4단계 PR #14와 CI 재편 PR #16(main 38c0dc7d)을 받는다. 충돌은 아홉
파일이다. 이 브랜치가 한국어로 다시 쓴 문서에 두 PR이 영어 판에서 바꾼
것을 한국어로 넣었다.
- a11y 기록 경로 `artifacts/tests/a11y-manual/` → `docs/accessibility/route-reviews/`:
README, docs/README.md, manual-checklist, starter-experience,
ci-quality-gates. 문서 검사의 `NOT_DOCUMENT`도 새 경로로 바꿨다(정해진 영어
키 형식의 게이트 입력이라 문서로 보지 않는다)
- ci-quality-gates.md: merge 단계 job 셋, 지운 CI 계약 기준선, main 단계
FE-GATE-029의 `check:ci:gating`
- adapter 재검토 원장: 합친 음성 fixture script
- README 프로젝트 구조: `schemas/`는 `config/schemas/`로, `artifacts/`는
`.gitkeep`만 추적, 최상위 항목 등록부 `config/repository-layout.json`
- verify-documentation-readiness.ts: #14의 배치 규칙 검사(R6·R7)와 이 브랜치의
문서 체계 검사를 둘 다 둔다. R7의 「현재 문서」는 #14의 폴더 목록(옛
`docs/superpowers/` 포함) 대신 문서 검사의 `checkedForDrift`로 고른다
- deletable-history-documents 시험: #14의 등록부 기반 경로와 이 브랜치의
검사기 예외를 같이 둔다
- CHANGELOG: 범위 문장과 표 행을 둘 다 둔다
- 루트 등록부에서 SPEC.md 항목을 뺀다(그 항목이 「문서 체계 작업이 이력 폴더로
옮기고 이 항목을 뺀다」고 적었다)
- #14가 옛 `docs/testing/frontend-platform-testing-strategy.md`를 고친 것이
이름 바뀜을 따라 기록(docs/design/…)에 들어와서, 기록은 옮길 때의 글로 되돌렸다
문제: tests/unit/documentation-readiness.test.ts의 사례마다
verify:documentation을 새 프로세스로 띄운다. 이 브랜치에서 그 검사가 살아
있는 문서 전부를 읽게 돼 한 번 도는 시간이 늘었고, 부하가 큰 desktop(load
25)에서 FE-GATE-020의 기능 생성 드릴이 사본 안에서 이 파일을 돌릴 때 세
사례가 기본 시간 10초를 넘겨 실패했다. 같은 사례는 부하가 낮을 때 1~8초다.
고른 방법: 이 파일의 사례에 저장소 관례대로 시간 한도 60초를 준다
(`VERIFY_TIMEOUT`). 그리고 livingDocuments가 문서 내용을 읽지 않고 경로만
고르게 해 한 번 도는 일을 줄인다. 버린 안: vitest 전역 testTimeout을
올리는 것(다른 시험의 멈춤을 늦게 알게 된다).
위험: 진짜로 멈춘 검사를 60초 뒤에야 알게 된다.
검증: desktop에서 이 파일과 FE-GATE-005·FE-GATE-020을 다시 돌린다.
문제: 기능 제거 드릴과 template-feature-removal-documents 시험은 repo
사본에서 verify:documentation을 돈다. 사본은 scripts/lib/removal-fixture.ts의
목록만 복사하고, 하네스 PR #13 뒤로 그 목록에 루트 CLAUDE.md가 없다.
docs/README.md 「폴더 밖 문서」가 `../CLAUDE.md`를 마크다운 링크로 가리켜
사본에서 없는 경로로 실패한다(.claude/rules/docs.md가 금하는 꼴).
고른 방법: CLAUDE.md와 PRODUCT.md 두 행을 링크 대신 인라인 코드 이름으로
적는다. 버린 안: 사본 목록에 CLAUDE.md를 더하는 것(목록은 드릴이 지우지
않는 문서만 담는다는 하네스 쪽 결정이다).
위험: 지도에서 그 두 파일로 바로 가는 링크가 없어진다. 이름은 그대로다.
검증: template-feature-removal-documents 시험이 desktop에서 통과한다.
문제: 하네스 PR #13이 더한 scripts/hooks/README.md는 `node scripts/…`처럼
줄임표 「…」(U+2026)로 「아무 스크립트」를 적는다. 참조 검사가 살아 있는
문서 전부로 넓어지자 verify:documentation이 `scripts/…`를 없는 경로로
잡아 실패한다. 경로 검사는 `...`만 자리표시자로 알고 「…」는 몰랐다.
같은 repo의 문서 검사(scripts/lib/docs-system.ts의 PLACEHOLDER)는 이미
「…」를 자리표시자로 본다.
고른 방법: verify-documentation-readiness.ts의 경로 후보 거르기에 「…」를
더해 두 검사를 맞춘다. 버린 안: 하네스 문서의 표기를 바꾸는 것(같은 표기를
다른 문서도 쓸 수 있고, 검사 둘이 다르게 판정하는 것이 원인이다).
위험: 「…」가 든 진짜 경로는 검사에서 빠진다. 파일 이름에 「…」를 쓰는
일은 없다고 본다.
검증: documentation-readiness 시험의 자리표시자 사례에 `node scripts/…`를
더했다. 고치기 전 코드에서는 그 사례가 실패하고 고친 뒤 통과한다(desktop).
문제: 이 브랜치는 SPEC.md의 공통 완료 기준을
docs/manual/reference/done-criteria.md로 옮겼다. 하네스 PR #13은 같은 기준을
작업 매뉴얼 docs/work/improve.md 5절로 옮겼다. 같은 규칙의 사본이 둘이면
하나만 고쳐져 갈라진다.
고른 방법: 소유자 결정 D5가 말한 「매뉴얼」은 일하는 순서를 정하는 작업
매뉴얼(docs/work/) 쪽이 맞아서 개발 매뉴얼 사본을 지운다. 매뉴얼 README의
그 행과 CHANGELOG 줄을 고친다.
위험: 없음에 가깝다. 사본은 이 브랜치에서 생겼고 다른 문서가 가리키지
않는다.
검증: `git grep -n done-criteria`가 CHANGELOG의 이력 줄 밖에서 0건.
문제: 하네스 PR #13이 더한 작업 매뉴얼·규칙은 이 브랜치가 바꾼 문서
체계의 옛 모습을 적는다.
- 옛 경로: `docs/architecture/decisions/`, `docs/superpowers/`, 루트
`SPEC.md`, 목표 설계였던 `docs/testing/frontend-platform-testing-strategy.md`
- 옛 검사 범위: 「docs/README.md 1절이 링크한 문서, 폴더 링크는 바로 아래
.md만」. 지금 verify:documentation은 살아 있는 문서 전부를 보고 언어·
문체·숫자·머리 블록도 본다
- 옛 docs/README.md 절(1절 묶음 / 2절 목표 설계 / 3절 작업 이력)과 README
절 이름(「Support scope」, 「Updating a copied project」)
- #13의 template-contract-documents 시험은 README 지워도 되는 표를
`docs/superpowers/` 행으로 찾는데, 그 행은 이제 없다
고른 방법: 그 줄만 새 위치·새 절 이름·새 범위로 고친다(.claude/rules/docs.md,
docs/work의 docs-writing·operate·research-design·reference 다섯,
docs/problem-statement.md). 시험은 `docs/history/` 행으로 표를 찾는다.
docs/work/evidence.md는 백엔드처럼 매뉴얼 규칙의 근거 기록이라 고치지 않고
`HISTORY_HOLDERS`에 넣어 참조·숫자 검사에서 뺀다.
위험: 하네스 문서의 다른 문장은 건드리지 않았다. 하네스 세션이 쓴 뜻을
바꾸지 않으려는 것이다.
검증: 문서 검사 여섯이 0건, `git grep -n -E 'docs/superpowers|architecture/decisions'`가
기록·CHANGELOG·출처 표시 밖에서 0건.
하네스 PR #13(main d1b9c087)을 받는다. 충돌은 README.md와 docs/README.md
둘이다. 이 브랜치가 두 파일을 한국어로 다시 썼고, #13이 영어 판에
AGENTS.md·docs/work/·docs/ledger/를 가리키는 줄과 지워도 되는 표 행을 더했다.
이 브랜치 판을 바탕으로 #13이 더한 것을 한국어로 넣었다.
- README: 최상위 표에 AGENTS.md·.claude/, 문서 지도에 AGENTS.md·docs/work/·
docs/vision.md·docs/problem-statement.md·docs/ledger/, 지워도 되는 표에서
CLAUDE.md를 빼고 docs/ledger/estimates.jsonl을 더함, 새 서비스로 시작하기와
규칙과 기여의 CLAUDE.md 줄을 AGENTS.md 기준으로
- docs/README.md: 1절 「처음 읽을 문서」에 ../AGENTS.md·work/·work/reference/
링크(#13의 template-contract-documents 시험이 본다), 지도에 work/·ledger/
행, 폴더 밖 문서에 AGENTS.md·vision.md·problem-statement.md, 2절 살아 있는
문서 목록
문제: 이 범위는 파생 서비스가 받을 때 할 일이 있다. 옛 문서 경로를 가리킨
자기 문서는 깨지고, verify:documentation이 살아 있는 문서 전부의 언어·
문체·숫자·README 절·문서 지도를 보게 돼 영어 문서를 가진 프로젝트는
게이트가 실패한다. README 절 이름도 바뀌었다.
고른 방법: 정리 단계 미출시 절에 범위를 더하고, 「먼저 할 일」에 옛 경로
찾기와 7·8단계(문서 검사에 맞추기, 바뀐 README 절 이름)를, 표에 [계약]
행 셋(검사, 문서 이동, README)을, 그 밖의 수정에 번역·원장 검사·완료
기준·설정 설명 칸을 적는다.
위험: 두 다운스트림에 받아 보지 않았다. 행의 커밋 해시는 이 브랜치의
지금 해시다. 병합 전에 다시 rebase하면 고친다.
검증: 문서 검사 여섯이 0건이다. changelog-review-ids 시험은 desktop에서
돌린다.
문제: recipe 카탈로그(config/recipes/frontend-capability-recipes.json),
runbook 등록(config/runbooks/runbooks.json), 규모 상한
(config/scale/feature-shape-ceilings.json), 짝 백엔드 pin의 `fact`,
secret scan 허용 이유의 설명 칸이 영어다. 소유자 결정(2026-11-07):
레지스트리의 설명 칸은 번역하되 그 칸을 읽는 테스트를 먼저 찾는다.
고른 방법: 칸마다 읽는 코드를 찾아, 비었는지만 보거나 자유 문자열로
산출물에 복사하는 칸만 옮긴다. 키, 배열 길이, 순서, 식별자·상태·경로·
명령·숫자는 그대로다.
- 옮기지 않은 칸: registry-baseline.json의 `trigger`·`compatibilityRole`
(승인 파일이 그 사본의 digest를 고정한다), 승인·변경 증거 파일의
`reason`(쓴 때의 기록), benchmark-baseline.json의 승인 이유,
feature-shape-ceilings의 `axes[].axis`(테스트가 영어 리터럴로
비교한다), 값이나 이름뿐인 칸. config/ci/는 정리 3단계·CI 세션
범위라 보지 않았다.
위험: scripts/drill-runbook.ts의 복구 확인 항목 이름은 아직 영어라 설정과
코드의 언어가 다르다. 비교하지는 않는다.
검증: 다섯 파일 모두 HEAD와 키 경로·순서·배열 길이가 같다.
json-schema·runbook-contract·feature-shape-growth·backend-contract-pin
시험을 desktop에서 돌렸다.
문제: docs/runbooks, docs/security, docs/styling/design-tokens.md,
docs/accessibility, docs/contracts, docs/testing/taxonomy.md와
src/adapters/browser-transfer/image-cdn/README.md는 본문이 영어다.
PRODUCT.md는 「~합니다」 체라 한 문서 안 문체 규칙(「~한다」)과 다르다.
고른 방법: 뜻을 바꾸지 않고 옮긴다. runbook 제목의 ID와 오류 code,
기록 양식의 영어 키(`Status:`, `M1 Keyboard:` 등, 코드 블록 안)는 그대로
둔다. PRODUCT.md는 디자인 도구가 읽는 제목(`## Users` 등)을 두고 문장
끝만 바꾼다.
위험: 이 커밋으로 문서 검사의 예외 목록이 빈다. 앞으로 영어 문서나 높임
문체를 더하면 verify:documentation이 실패한다.
검증: 백틱 span·링크 대상·코드 블록을 옮기기 전과 python으로 비교해 같다.
문서 검사 여섯이 모두 0건이고 예외 목록과 FROZEN이 비었다.
문제: docs/operations의 release-cache-rollback.md와
adapter-remediation-ledger.md는 본문이 영어이고, 나머지 복구 문서와
ci-quality-gates.md에도 영어 문단이 남아 있다.
고른 방법: 뜻을 바꾸지 않고 옮긴다. 원장은 check:remediation-ledger가
읽으므로 같은 변경에서 스크립트를 맞춘다.
- `SECTION_HEADING`을 옮긴 절 제목(`## 세 번째 재검토 (2026-08-14)`)으로
- 「모두 닫혔다」를 잡는 `BLANKET_CLOSURE`에 한국어 대안을 더한다. 영어
대안은 원장이 인용한 옛 문장을 잡도록 그대로 둔다
- 표 구조, id 칸, disposition 칸의 백틱 값, file-transfer 예산 숫자는
그대로다
- ci-quality-gates.md의 advisory 표가 복사한 zod·react-router 버전을
`package.json`·`pnpm-lock.yaml`을 가리키게 바꾼다(number 검사)
위험: check:remediation-ledger는 게이트 밖이라 CI가 돌리지 않는다.
desktop에서 손으로 돌려 확인했다.
검증: dispositions.json의 id 25개가 그 절의 행과 맞는지, 예산 숫자가
있는지를 스크립트로 확인했다. 문서 검사의 language·number 줄이 0이 되어
예외 목록에서 지웠다.
문제: docs/architecture의 현재 계약 문서 가운데 scale-architecture.md,
starter-experience.md, capability-consumer-experience.md,
contract-ownership.md, static-delivery.md, review-evidence.md는 본문이
영어이고, backend-api-and-server-state-contract.md와
optional-adapter-recipes.md에는 영어 문단이 남아 있다.
고른 방법: 뜻을 바꾸지 않고 옮긴다. 백틱 안, 링크 대상, 절 번호(코드
주석이 `scale-architecture.md §N`으로 인용한다), 표 구조, 코드 블록은
그대로 둔다. 문서를 읽는 테스트와 절 이름을 인용한 곳을 같은 변경에서
고친다.
- tests/unit/feature-tracked-files.test.ts: starter-experience.md 표를
자르는 시작·끝 문장과 표 행마다 찾는 낱말(`병합 충돌`)
- 「Ownership declarations」「Adding a feature」를 인용한 주석
(create-feature.ts, generate-product-feature-index.ts, app-module.ts)과
docs/manual의 절 이름 인용
- optional-adapter-recipes.md의 recipe 개수 복사를 카탈로그를 가리키게
바꾼다(number 검사)
위험: create-feature.ts 417줄은 생성하는 context-module.ts의 JSDoc이라
새로 만드는 기능의 주석 글자가 바뀐다. 그 글자를 비교하는 테스트는 없다.
review-evidence.md는 산문만 옮겼고 해시·점수 칸은 그대로다.
검증: 백틱 span·링크 대상·코드 블록·번호 제목을 옮기기 전과 python으로
비교해 같다. 문서 검사의 language 줄이 이 문서들에서 0이 되어 예외
목록에서 지웠다.
문제: 프론트 문서 체계는 백엔드와 다르다. docs/README.md는 "README와
입구 문서는 영어"라고 정해 두어 2026-11-07 소유자 결정(살아 있는
문서는 본문까지 한국어)과 반대이고, 기록의 머리 블록·언어·숫자 복사를
보는 검사가 없다. verify:documentation은 docs/README.md 1절이 링크한
문서의 경로만 본다.
고른 방법: 백엔드 scripts/check-docs.py의 규칙(language, head, number,
map, readme, style)을 같은 이름·문턱으로 TypeScript로 옮겨
scripts/lib/docs-system.ts에 두고 verify:documentation(FE-GATE-017)이
부르게 한다. 참조 검사는 지금 있는 것을 그대로 쓰고 대상만 살아 있는
문서 전부로 넓힌다. FE-GATE-017 job은 workflow_dispatch(documentation
단계)에서만 돌아서, PR에서 실패하도록 merge 단계 FE-GATE-005의
documentation-readiness 시험이 이 repo를 그대로 두고
verify:documentation을 한 번 돌린다.
- 버린 안: 새 게이트나 package script를 더하는 것. config/ci(정리
3단계·CI 세션 범위)와 CI 계약의 개수·해시를 건드린다.
- 버린 안: check-docs.py를 그대로 복사하는 것. 프론트 CI 이미지와
도구는 Node뿐이고, 참조 검사(짝 백엔드 pin, 지운 샘플, 생성 산출물)는
이미 TS에 있다.
- 예외 목록 scripts/docs-system-exceptions.txt는 줄기만 한다(줄마다
FROZEN 지문). 이 커밋의 줄은 아직 옮기지 않은 문서의 기준선이고 뒤
번역 커밋들이 지운다.
- docs/README.md를 모든 문서 폴더를 덮는 지도와 수명·언어·머리 블록·
검사 규칙으로 다시 쓰고, 루트 README.md를 docs-system.md 6.1절의 필수
절 순서로 한국어로 다시 쓴다. README의 src 폴더 설명은 layers.md 표와
글자가 같아야 하므로 layers.md·overview.md·foundation.md를 같이 옮긴다.
- README 「복사한 뒤 지워도 되는 것」을 읽는 정규식과, 문서를 바꿔 넣는
테스트의 기대 문자열을 새 한국어 문장으로 고친다. 검사기는 기록
폴더 이름을 적지만 지운 사본에서도 통과하므로
deletable-history-documents 테스트의 검사 대상에서 뺀다(그 이유를
테스트와 검사기 시험에 적었다).
위험: 파생 서비스가 이 변경을 받으면 자기 살아 있는 문서가 영어일 때
verify:documentation이 실패한다. CHANGELOG에 「먼저 할 일」로 적는다.
review-evidence.md는 다른 작업 공간의 경로를 적은 사본이라 참조·숫자
검사에서 뺐다(HISTORY_HOLDERS).
검증: tests/unit/docs-system.test.ts(조건마다 실패 입력),
documentation-readiness·template-feature-removal-documents·
deletable-history-documents 시험, verify:documentation을 desktop에서 돌렸다.
문제: 링크를 고친 앞 커밋은 옮긴 파일의 옛 위치를 지금 트리에서
찾았다. 그래서 VD와 superpowers 계획서 안에서 나가는 상대 링크
28개(예: VD-14의 `../../operations/…`)는 옛 위치 기준 그대로 남아
없는 곳을 가리킨다.
고른 방법: 옛 위치를 `git diff --name-status -M ad3a071f HEAD`의 이름
바뀜으로 다시 구해, 옮기기 전에는 풀리던 링크만 새 위치 기준으로 다시
쓴다. 옮기기 전에도 깨져 있던 링크 22개는 쓴 때의 글이라 그대로 둔다.
고친 것은 링크 대상뿐이다.
위험: 없음에 가깝다. 기록 본문의 글자는 바뀌지 않는다.
검증: 같은 스크립트를 다시 돌려 「옮기기 전엔 풀리던 깨진 링크」 0건.
문제: 옮긴 기록은 지금 동작을 설명하는지, 상태가 무엇인지, 지금
정본이 어디인지 알 길이 없다. 설계서·계획서 27개와 docs/architecture
목표 설계 16개에는 상태 칸이 없고, VD는 「상태: Accepted」 같은 영어
값을 쓴다.
고른 방법: docs-system.md 4절 형식으로 맨 위에 머리 블록을 달고 본문은
한 글자도 고치지 않는다. 상태는 기계 변환이다.
- 설계서: Accepted·확정·정본·설계 완료 → 채택, 상태 줄이 없으면
확인 안 함 (채택 4, 확인 안 함 21)
- 계획서: 체크 상자가 모두 표시됐으면 끝남, 아니면 확인 안 함. SPEC.md는
같은 폴더 plan.md와 같은 근거(0.2.0으로 끝난 라운드)로 끝남 (끝남 5,
확인 안 함 14. 이미 블록이 있던 5개는 그대로)
- 결정 기록: Accepted → 채택, 날짜가 붙은 뒤늦은 보완 메모가 본문에
있으면 채택(보완) (채택 14, 채택(보완) 9). 프론트 VD는 처음부터
한국어로 썼고 번역하지 않으므로 둘째 줄은 「원문이다」 문구다.
- 작성일: 파일 이름 날짜 → 본문 날짜 줄(VD는 `결정일:`) → git 첫 추가일.
위험: VD-09·11·13은 git으로 보면 결정 뒤 본문이 그 자리에서
고쳐졌지만 본문에 날짜 표시가 없어 기계 규칙대로 채택으로 두었다.
보완으로 올릴지는 사람이 정한다. 「현재 정본」은 지금 있는 살아 있는
문서나 코드 경로만 쓴다.
검증: 블록과 그 뒤 빈 줄 하나를 빼면 72개 모두 `git show HEAD:`와 바이트가
같다. 뒤 커밋의 문서 검사 head 규칙으로 돌려 문제 0건.
문제: SPEC.md는 끝난 2026-09-25 리뷰 수정 라운드의 요구사항이다. 기록인데
저장소 루트에 있어 지금 쓰는 문서처럼 보인다.
고른 방법: 공통 완료 기준을 앞 커밋에서 매뉴얼로 옮겼으므로, 내용 변경
없이 같은 라운드의 계획서 폴더로 옮긴다(소유자 결정 D5). 루트 항목
등록부는 이 repo에 없어서 고칠 곳이 없다.
위험: 루트 README와 docs/README.md의 SPEC.md 줄은 뒤 커밋이 다시 쓴다.
검증: git status가 이름 바뀜 하나만 보인다.
문제: 2026-09-25 리뷰 수정 라운드의 요구사항 SPEC.md는 라운드가
0.2.0으로 끝난 기록인데, 그 안의 「공통 완료 기준」(RED→GREEN, 변이
확인, 게이트, INVENTORY, kernel 위치, 포트 추가만, 커밋 하나, 문서
주장의 코드 위치)은 지금도 쓰는 규칙이다. 기록으로 옮기면 규칙이
지울 수 있는 이력 안에만 남는다(소유자 결정 D5, 2026-11-07).
고른 방법: docs/manual/reference/done-criteria.md로 옮기고 매뉴얼
README 표에 더한다. 게이트 여덟 개를 적은 원문 3·4번은 매뉴얼 규칙
(원칙 8, 목록을 복사하지 않음)에 맞춰 정본 config/ci/gates.json과
`ci:gate`를 가리키게 바꿨다. 작업 매뉴얼(docs/work/)은 하네스 세션이
만드는 중이라 이 변경은 개발 매뉴얼에 둔다.
위험: 하네스 세션이 docs/work/에 같은 기준을 두면 둘 중 하나를
가리키게 정리해야 한다.
검증: 문서만 바뀐다. 경로는 뒤의 verify:documentation 실행에서 본다.
문제: 앞 커밋이 기록·설계서·결정 기록을 옮겨서, 그 문서를 가리키는
상대 링크 182개와 살아 있는 문서·코드 주석의 경로 23곳이 없는 곳을
가리킨다.
고른 방법: 기계적으로 바꾼다.
- 상대 링크: 모든 .md(기록 포함)에서 옮기기 전 트리로 대상을 풀고,
대상이나 문서 자신이 옮겨졌으면 새 위치 기준 상대 경로로 다시 쓴다.
옮기기 전에도 없던 대상은 건드리지 않는다. 기록 본문에서 고친 것은
링크 대상뿐이다(백엔드 1단계와 같은 예외).
- 경로 글자: 살아 있는 문서와 코드·설정 주석의 `docs/architecture/…`,
`docs/superpowers/…`, `decisions/VD-…`를 새 경로로 바꾼다. 기록 본문과
CHANGELOG.md는 쓴 때의 경로를 그대로 둔다. review-evidence.md와
review-ledger.json의 `docs/superpowers/specs/…`는 이 트리가 아닌 검토
작업 공간의 출처 표시라 그대로 둔다.
위험: 경로 글자를 바꾼 곳은 주석과 문서뿐이고 실행 코드의 경로 상수는
없다. 문서 지도(docs/README.md)의 옛 폴더 행은 뒤 커밋이 다시 쓴다.
검증: `git grep -n -E "docs/superpowers|architecture/decisions"`가 기록,
CHANGELOG.md, 출처 표시 두 곳, docs/README.md·README.md(뒤에서 다시
쓴다) 밖에서 0건.
문제: 프론트 docs/는 지금 동작을 설명하는 문서와 쓴 때의 기록이 한
폴더에 섞여 있다. docs/architecture/에는 현재 계약 10개와 목표 설계
14개, 결정 기록 VD 23개가 같이 있고, 설계서·계획서는 플러그인 이름
폴더(docs/superpowers/)에 있다. 문서 체계 규칙(design-docs
conventions/docs-system.md v1, 2026-11-07 소유자 결정)은 수명으로
나누고 폴더 이름을 백엔드와 같게 하라고 정한다.
고른 방법: 내용 변경 없이 git mv만 담는다. git이 이름 바뀜을 알아보고
리뷰어가 이동과 내용 변경을 따로 볼 수 있게 하려는 것이다. 참조 수정과
머리 블록은 다음 커밋들이 한다.
- docs/superpowers/specs → docs/design/, plans → docs/history/plans/
- docs/architecture/ 목표 설계 13개와 styling·testing의 목표 설계
2개 → docs/design/<작성일>-<이름>-design.md (2026-07-30 결정 정본은
이름 그대로)
- docs/architecture/decisions/VD-* → docs/adr/ (번호 유지)
위험: 이 커밋만으로는 옮긴 문서를 가리키는 링크와 경로가 깨진다.
다음 커밋이 고친다. 게이트가 읽는 파일(review-ledger.json,
review-evidence.md, adapter-remediation-ledger.md, INVENTORY.md)은
옮기지 않았다. docs/history/는 복사한 프로젝트가 지워도 된다는 약속
(tests/unit/deletable-history-documents.test.ts)이 있어서 코드가 읽는
파일을 둘 수 없다. SPEC.md는 공통 완료 기준을 매뉴얼로 옮긴 뒤 따로
옮긴다.
검증: git status가 이름 바뀜(R) 66개만 보인다.