Files
platform-core/docs
DongHyeonka ec9a118d15 docs(design): plan the separation of state data from the root SSD
All SSD Local PVs share the root filesystem with the OS, container
images and build caches; review A12 and risk 2. Owner decision 3 asks
for a plan only.

Compare four options (shrink the Windows SSD, a new SSD, the HDD, do
nothing), recommend a new SSD and otherwise the Windows SSD, and give
the migration: mount the new filesystem at the same /srv/k3s/ssd path
so no PV changes, two rsync passes around a short stop, rollback. Note
the scripts whose root-SSD findmnt checks must change in the same PR.

Risk: documentation only; status 제안.

Verification: the PV sizes and paths come from the 2026-11-11 cluster
inventory; the findmnt checks were found with git grep.
2026-11-12 01:38:58 +09:00
..

platform-core 문서 지도

이 폴더는 이 저장소 안에 두는 기록 문서만 담는다. 아키텍처·운영 절차·결정 기록의 정본은 루트 README가 가리키는 중앙 Platform 문서다. 구성요소의 사용법과 적용 절차는 각 디렉터리의 README.md와 bootstrap/manual/에 있다.

폴더 담는 것 수명
runbooks/ 운영 절차(복원, 재구축, 업그레이드, 재부팅 뒤 확인, 재시작 창) 살아 있음
design/ 설계서(결정 전·후) 기록(상태가 있다)
reviews/ 점검·리뷰 결과 기록(쓴 날의 상태)
platform/plans/ 설계 메모 기록
superpowers/plans/ 실행 계획 기록

폴더 이름과 수명 구분은 design-docs conventions/docs-system.md 2절을 따른다. 새 폴더를 만들면 같은 변경에서 이 표에 더한다.

기록 문서의 머리 블록

reviews/·design/에 새로 쓰는 기록은 맨 위에 머리 블록(상태·작성일·요약·현재 정본)을 단다. 형식과 상태 어휘는 design-docs conventions/docs-system.md 4절이 정본이다. 리뷰의 상태는 「진행 중」·「닫힘」 둘이다. 이 절을 만들기 전에 쓴 platform/plans/· superpowers/plans/ 문서에는 머리 블록이 없다.