virtualization 의 setup 9편은 같은 커밋(2109f72)에서 한꺼번에 생겼는데 그때
Studio 반입이 7편만 덮고 둘을 빠뜨렸다. 둘 다 readiness 가 READY 이고 관문도
통과하는데 frontmatter 에 id 도 studio 도 없었다 — Studio 문서가 아예 없었다는
뜻이다. 빼놓을 이유가 없어서 만들었다.
- setup-tear-down-the-lab-and-know-what-survives -> 87e0138d-…
- setup-power-cycle-the-lab-and-reallocate-guest-memory -> 8a9ca3d4-…
주제는 새로 만들지 않고 같은 폴더의 기존 편에서 topicId·projectId 를 읽어
같은 값을 썼다. 둘 다 저장까지만 하고 게시하지 않았다(currentPublication: null).
pinnedVersions 의 40자 상한
- power-cycle 의 「기준 배치」 값이 51자여서 서버가 422 로 거절했다
(size must be between 1 and 40)
- 그 칸에 문장이 들어가 있었다. CLAUDE.md 는 Setup 에 대해 「명령이 본문에
들어가고 버전만 pinnedVersions 에 남는다」고 적는다
- 잘라내기 전에 그 설명이 본문에 있는지 먼저 봤다. 셋 다 있었다 — 63행이
호스트 RAM 증설, 176행이 2026-09-03, 215행이 2026-09-10 과의 날짜 엇갈림.
그래서 날짜만 남겼고 잃은 내용이 없다
- 저장소 전체를 훑어 40자를 넘는 값은 이것 하나뿐이었다
기록 두 편의 diff 는 frontmatter 뿐이고, tech-log-tree.json 은 파생 칸
(publication · studioId) 넷만 바뀌었다. 「게시됨」은 Studio 에 있다는 뜻이지
공개됐다는 뜻이 아니다.
관문: check_body PASS · check_prose error 0 · check_evidence 문제 없음 ·
verify-tech-log-tree error 0 · verify-project-layout error 0 ·
check-studio-whitespace PASS
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
virtualization
- 분석 대상: 없음. 밖에서 가져온 문서 네 편이 출발점이다
- 이 폴더: SSOT(
final/document.md)와 Studio 에 올릴 글(tech-log-studio/)의 정본
범위
가상화 전반을 담을 프로젝트다. SSOT 는 아홉 부이고 절 번호가 문서 전체에서 이어진다.
| 부 | 절 | 반입 전 원본 |
|---|---|---|
| 제1부 — CPU 가상화 | §1~§28 | kvm-cpu-virtualization-ssot.md (절 1~28) |
| 제2부 — 메모리 가상화 | §29~§88 | kvm-memory-virtualization-ssot.md (절 1~60) |
| 제3부 — 네트워크 가상화 | §89~§126 | kvm-network-virtualization-ssot.md (절 1~38) |
| 제4부 — 스토리지 가상화 | §127~§177 | kvm-storage-virtualization-ssot.md (절 0~50) |
| 제5부 — 실험대에서 실제로 확인한 것 | §178~§183 | docs/guides/ · docs/lab-virtualization.md · docs/session-lab-concepts.md 에서 골라 다시 씀 |
| 제6부 — 실험대는 어떻게 세워졌나 | §184~§194 | docs/guides/ 00~06 (묶음 3,223줄)을 다시 씀 |
| 제7부 — 실험대에서 실제로 잰 값 | §195~§205 | docs/lab-virtualization.md (496줄) 전문 |
| 제8부 — 설정 원본이 자기 안에 적어 둔 것 | §206~§210 | deploy/lab/edge/ 네 파일의 주석 59줄 |
| 제9부 — 실험대 개념 사전 | §211~§338 | docs/session-lab-concepts.md (4,725줄) 전문 |
제1~4부는 반입할 때 heading 단계를 한 칸 내리고 절 번호만 옮겼다. heading 이 아닌 줄은 한 글자도 바꾸지 않았고, 원본과 대조해 확인했다. PCIe/VFIO/IOMMU 상세와 K3s 네트워크·컨테이너 런타임 상세는 어느 부에도 없다.
제7·9부도 같은 방식인데 heading 단계를 한 칸 올렸다 — 실제 항목이 사는 단계를
절로 삼았다. 두 부 모두 heading 이 아닌 줄을 원본과 줄 단위로 대조했고, 다른 곳은
비밀 한 자리뿐이다(plain_text_passwd 의 값을 __CONSOLE_PW__ 로 바꿨다).
제5·6·8부는 옮겨 쓴 것이 아니라 원본을 읽고 다시 쓴 것이다. 제8부만 원본 주석을 영어 원문 그대로 인용한다.
끝난 프로젝트의 폴더
| 폴더 | 무엇 |
|---|---|
final/ |
SSOT — 이 프로젝트에 대해 아는 것 전부 |
tech-log-studio/ |
SSOT 에서 뽑아 쓴 글. 정본은 tech-log-tree.json |
반입하는 동안에만 있는 것
source/ — 밖에서 가져온 원본. final/ 이 그 내용을 담으면 지운다.