From 21579b2b0e9586c233301ef885fa8d8322b4cbae Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 12:12:21 +0900 Subject: [PATCH] =?UTF-8?q?docs(records):=20=EC=84=A4=EA=B3=84=EC=84=9C?= =?UTF-8?q?=EC=99=80=20=EA=B8=B0=EB=A1=9D=20=EB=AC=B8=EC=84=9C=EB=A5=BC=20?= =?UTF-8?q?docs/design=C2=B7docs/history=EB=A1=9C=20=EC=98=AE=EA=B8=B4?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: docs/ 바로 아래에 매뉴얼·운영 문서와 쓴 때의 기록(계획서·설계서· 납품 패키지·증거·학습)이 같은 층에 섞여 있다. 기록이라는 표시도 없어 읽는 사람이 지금 동작을 설명하는 문서와 구분하지 못한다. 고른 방법: 2026-11-07 소유자가 승인한 수명 기준 분리를 따른다. - docs/superpowers/specs → docs/design/ - docs/superpowers/plans → docs/history/plans/ - docs/superpowers/packages/* → docs/history/packages/* - docs/{graphql,web,websocket}-superpowers-package → docs/history/packages/<같은 이름>/ (packages/graphql과 겹치지 않게 원래 폴더 이름을 둔다) - docs/evidence → docs/history/evidence/, docs/study → docs/history/study/ - git에 들어가 있던 __pycache__ .pyc를 지우고 .gitignore에 더한다. 옮긴 경로를 가리키는 줄을 같은 커밋에서 고쳤다: 살아 있는 문서의 인라인 경로, AGENTS.md·CLAUDE.md, 빌드 스크립트·테스트 주석, docs/README.md 위치 표, 파생 서비스용 docs/upgrade/2026-11-docs-records.md. 기록 본문은 고치지 않고, 이동으로 깨진 마크다운 상대 링크 32개의 대상만 고쳤다(lychee와 check-work-docs.py --links가 docs/** 전체를 본다). 이동만 따로 두면 그 커밋에서 링크 검사가 실패하므로 한 커밋으로 묶었다. 대부분 R100이라 이름 바뀜은 그대로 보인다. 위험·한계: 기록 본문과 docs/reviews/** 안의 인라인 코드 경로는 옛 경로로 남는다(기록은 고치지 않는다). 실험용 Flyway 파일 db/experimental-rls/V1__tenant_rls.sql의 주석은 체크섬이 바뀌므로 두었다. 납품 패키지 셋의 MANIFEST.sha256과 validate_*.py는 패키지 안 상대 경로라 이동 뒤에도 그대로다. 검증: python3 scripts/check-work-docs.py rc=0, --links(gates.md 범위 + CLAUDE.md·AGENTS.md) 581개 파일 깨진 링크 0, --history docs/manual rc=0. --- grpc/CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/grpc/CLAUDE.md b/grpc/CLAUDE.md index dbaaccd..7893494 100644 --- a/grpc/CLAUDE.md +++ b/grpc/CLAUDE.md @@ -11,7 +11,7 @@ Root 정책(`CLAUDE.md` / `AGENTS.md`)과 충돌하면 root가 이긴다. `adapter:inbound:grpc`를 통해 라이브러리로서 도달한다. 설계 근거와 원본 계획 대비 deviation은 -[docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md](../../docs/superpowers/specs/2026-08-30-grpc-platform-adaptation-design.md)가 SSOT다. +[docs/design/2026-08-30-grpc-platform-adaptation-design.md](../../docs/design/2026-08-30-grpc-platform-adaptation-design.md)가 SSOT다. ## Family와 framework 규칙