docs: 기록·설계서·결정 기록을 docs/history·docs/design·docs/adr로 옮긴다
문제: 프론트 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개만 보인다.
This commit is contained in:
Reference in New Issue
Block a user