donghyeon.kang/document-haness
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

feat(pipeline): keycloak-session-store 25편·virtualization 59편을 S3→S5→S6 으로 돌린다

Browse Source 
기록 84편을 계약 에이전트로 다시 썼다. 기존 71편(kss 25 · virt 46)과, 계약에만
있고 안 쓰여 있던 새 글감 13편이다. 원장 84개를 열어 단계마다 스킬 영수증과 관문
종료 코드를 적었고 verify-pipeline-run.py 가 error 0 으로 닫는다.

SSOT 결함 둘을 고쳤다.

- kss 의 `약 58일` 이 반입 중 `약 59일` 로 바뀌어 있었다. 원 증거 파일이
  「남은 일수: 88일 … 실제 갱신까지 약 58일」로 산수를 직접 적는다. D-4a 쪽
  `약 59일` 은 강제 갱신 뒤(`VALID: 89 days`)라 맞는 값이라 그대로 뒀다.
- virt §198 의 `11.6GB` 는 §178 의 원 측정 `Mem: 11648`(MiB)과 어긋나는데
  원 가이드의 표기 그대로라 고치지 않고 쓰이는 자리에 대조를 적었다.

기록의 수치 오류 셋을 고쳤다 — CASE 요약의 「게스트 셋에 8240MB」(5120+3120 은
둘이다), k3s 편이 같은 것을 여섯·일곱·여덟로 세던 것, no-docker 편의 「셋을 더
든다」(§281 의 표는 네 행이고 디스크 행이 빠져 있었다).

계약을 셋 고쳤다.

- kss 의 sourceRepository 리비전이 cdac9b8 이었는데 그 커밋에는 docs/guides/**
  28개가 아예 없다. 9465582b 로 바꾸고, 반입한 바이트가 어느 커밋과도 같지 않다는
  것을 측정값과 함께 적었다 — 반입은 커밋이 아니라 그 시점의 작업 트리에서 떠 온
  것이다(kss 297/306 · virt 12/14 가 작업 트리와 같고, 200 커밋을 거슬러 전수
  대조했을 때 가장 가까운 커밋도 28개가 어긋났다).
- virt 계약이 「2026-09-11 재배분」이라고 적는데 SSOT 는 재배분 날짜를 적지 않고
  재배분 뒤 값은 이미 2026-09-10 측정에 찍혀 있다.
- kss 후보 대장이 지나친 절 아홉에 처분을 적었다(warn 9 → 0). 새 글감은 0건이고
  넷은 앵커가 h3 슬러그의 접두가 아니라 중간 토막이라 검사기가 못 본 것이었다.

style_profile.mjs 의 결함 둘을 고쳤다 — frontmatter 가 문장으로 세어져
(실측 398자짜리 「문장」 하나) 평균 길이를 기준 안으로 밀어 올리고 있었고,
engPerSent 의 분자는 목록을 포함한 글에서, 분모는 목록을 걷어낸 글에서 세고
있었다(Question 기록에서 11.94 → 3.86).

verify-pipeline.py 전 항목 PASS · error 0 · unittest 334건 OK.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-09-17 11:01:55 +09:00
co-authored by Claude Opus 5
parent d473609e0a
commit 2109f726fe
574 changed files with 159654 additions and 1551 deletions
Download Patch File Download Diff File Expand all files Collapse all files
runs/virtualization/2026-09-11-2013/run.json
+266
View File
@@ -0,0 +1,266 @@
{
"schemaVersion": 1,
"runId": "2026-09-11-2013",
"project": "virtualization",
"record": "docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md",
"startedAt": "2026-09-11T20:13:58+09:00",
"finishedAt": "2026-09-11T20:14:37",
"stages": [
{
"id": "S1",
"name": "코드베이스 → SSOT",
"skill": "analyzing-codebase-for-tech-log",
"runBy": "subagent",
"status": "SKIPPED",
"skipReason": "분석할 코드베이스가 없다. 이 프로젝트의 SSOT 는 밖에서 쓴 문서 한 편이고, 이번 글감의 근거인 제5부(§178~§183)가 이미 final/document.md 안에 있다. 새로 분석하지 않고 그 절만 읽었다.",
"skillEcho": "",
"inputs": [],
"outputs": [],
"gates": [],
"notes": ""
},
{
"id": "S2",
"name": "SSOT → 분해 계약",
"skill": "deriving-tech-log-root-tree",
"runBy": "subagent",
"status": "DONE",
"skipReason": "",
"skillEcho": "8. Group `PROMOTE` candidates into Topics. Write one reader question per Topic.",
"inputs": [
"docs/virtualization/final/document.md"
],
"outputs": [
"docs/virtualization/tech-log-studio/tech-log-tree.json"
],
"gates": [
{
"cmd": "python3 scripts/build-tech-log-tree.py virtualization",
"exit": 0
},
{
"cmd": "python3 scripts/verify-tech-log-tree.py virtualization",
"exit": 0
}
],
"notes": "제5부(§178~§183)를 candidateScope 에 더하고 후보 19건에 처분을 적어 PROMOTE 7건을 새 주제 lab-environment-build 로 올렸다. 제외 12건(KEEP_IN_SSOT 2 · MERGE_INTO 10). 이 프로젝트의 첫 Case 와 첫 Decision 이 여기서 나왔다 — 앞 네 부에는 이 호스트에서 잰 값이 없었다."
},
{
"id": "S3",
"name": "글감 → 기록",
"skill": "writing-tech-log-records",
"runBy": "subagent",
"status": "DONE",
"skipReason": "",
"skillEcho": "**코드·표·다이어그램·이미지는 본문에만 들어간다. 본문이 있는 종류는 Case 와 Concept 둘뿐이다.**",
"inputs": [
"docs/virtualization/tech-log-studio/tech-log-tree.json",
"docs/virtualization/final/document.md"
],
"outputs": [
"docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md",
"docs/virtualization/tech-log-studio/lab-environment-build/concept/concept-what-a-qcow2-file-carries.md",
"docs/virtualization/tech-log-studio/lab-environment-build/reference/reference-verify-a-build-guide-in-execution-order.md",
"docs/virtualization/tech-log-studio/lab-environment-build/decision/decision-edge-nginx-moved-into-a-guest-vm.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-guest-input-hole-under-the-iptables-backend.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-virsh-save-ram-dump-size-and-time.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-qcow2-transfer-time-over-wifi.md"
],
"gates": [
{
"cmd": "python3 scripts/studio-body.py <기록.md> -o /tmp/sb-<이름>.md (7건)",
"exit": 0
},
{
"cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/sb-<이름>.md",
"exit": 0
},
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs --warn <기록.md> (7건)",
"exit": 0
},
{
"cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs virtualization --repo",
"exit": 0
},
{
"cmd": "python3 scripts/audit-records.py virtualization",
"exit": 0
}
],
"notes": "기록 7편을 네 갈래로 나눠 썼다 — Case / Concept / Reference+Decision / Question 3편. 본문이 있는 종류는 Case 와 Concept 둘뿐이라 나머지 다섯은 칸만 평문으로 채웠다. source/ 의 원본 가이드는 열지 않았고 근거는 SSOT 절뿐이다."
},
{
"id": "S4",
"name": "기록 → 그림",
"skill": "technical-visualizer",
"runBy": "subagent",
"status": "DONE",
"skipReason": "",
"skillEcho": "**관계선을 다 지워도 뜻이 남는가.** 남으면 표다. 마크다운 표로 쓴다.",
"inputs": [
"docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md",
"docs/virtualization/tech-log-studio/lab-environment-build/concept/concept-what-a-qcow2-file-carries.md",
"docs/virtualization/final/document.md"
],
"outputs": [
"docs/virtualization/final/.techviz/nftables-forward-hook-chain-order/spec.json",
"docs/virtualization/final/assets/diagrams/nftables-forward-hook-chain-order/nftables-forward-hook-chain-order.svg",
"docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md"
],
"gates": [
{
"cmd": "./scripts/techviz lint docs/virtualization/final/.techviz/nftables-forward-hook-chain-order/spec.json --context docs/virtualization/final/.techviz/nftables-forward-hook-chain-order/context.json",
"exit": 0
},
{
"cmd": "python3 scripts/check-figure-text.py virtualization",
"exit": 0
},
{
"cmd": "python3 scripts/check-figure-overlap.py virtualization",
"exit": 0
},
{
"cmd": "python3 scripts/preview-figure.py virtualization -o /tmp/figs (PNG 로 떠서 눈으로 봤다)",
"exit": 0
},
{
"cmd": "python3 scripts/verify-project-layout.py virtualization",
"exit": 0
}
],
"notes": "Case 만 그렸다(nftables-forward-hook-chain-order). Concept 은 관문 2·3 에 걸려 안 그렸다 — 「파일 안/밖」은 관계선을 지워도 목록이 남아 표이고 그 표가 이미 본문에 있다. 그리는 중에 검사기가 못 잡는 결함을 눈으로 잡았다 — 그룹 상자가 멤버가 아닌 노드(edge nginx)를 삼켜 엣지 nginx 가 libvirt 체인 안에 있는 것처럼 보였다. 겹침 검사는 rect 끼리만 보고 group-box 대 node-shape 는 안 센다. 멤버 하나를 빼 고쳤다."
},
{
"id": "S5",
"name": "AI 티 제거",
"skill": "rewriting-technical-prose-naturally",
"runBy": "subagent",
"status": "DONE",
"skipReason": "",
"skillEcho": "- **Do not remove implementation detail because the paragraph feels dense.** Density is not a style defect.",
"inputs": [
"docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md",
"docs/virtualization/tech-log-studio/lab-environment-build/concept/concept-what-a-qcow2-file-carries.md",
"docs/virtualization/tech-log-studio/lab-environment-build/reference/reference-verify-a-build-guide-in-execution-order.md",
"docs/virtualization/tech-log-studio/lab-environment-build/decision/decision-edge-nginx-moved-into-a-guest-vm.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-guest-input-hole-under-the-iptables-backend.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-virsh-save-ram-dump-size-and-time.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-qcow2-transfer-time-over-wifi.md"
],
"outputs": [
"docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md",
"docs/virtualization/tech-log-studio/lab-environment-build/concept/concept-what-a-qcow2-file-carries.md",
"docs/virtualization/tech-log-studio/lab-environment-build/reference/reference-verify-a-build-guide-in-execution-order.md",
"docs/virtualization/tech-log-studio/lab-environment-build/decision/decision-edge-nginx-moved-into-a-guest-vm.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-guest-input-hole-under-the-iptables-backend.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-virsh-save-ram-dump-size-and-time.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-qcow2-transfer-time-over-wifi.md"
],
"gates": [
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs --warn <기록.md> (7건 전수)",
"exit": 0
},
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/style_profile.mjs docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md · docs/virtualization/tech-log-studio/lab-environment-build/concept/concept-what-a-qcow2-file-carries.md · docs/virtualization/tech-log-studio/lab-environment-build/reference/reference-verify-a-build-guide-in-execution-order.md · docs/virtualization/tech-log-studio/lab-environment-build/decision/decision-edge-nginx-moved-into-a-guest-vm.md",
"exit": 0
},
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/style_profile.mjs docs/virtualization/tech-log-studio/lab-environment-build/question/question-guest-input-hole-under-the-iptables-backend.md · docs/virtualization/tech-log-studio/lab-environment-build/question/question-virsh-save-ram-dump-size-and-time.md · docs/virtualization/tech-log-studio/lab-environment-build/question/question-qcow2-transfer-time-over-wifi.md",
"exit": 1
},
{
"cmd": "python3 scripts/studio-body.py <기록.md> -o /tmp/sb5-<이름>.md (7건)",
"exit": 0
},
{
"cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/sb-5-<이름>.md",
"exit": 0
},
{
"cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs virtualization --repo",
"exit": 0
}
],
"notes": "style_profile 은 측정 관문이라 종료 코드 0 을 요구하지 않는다. Question 셋은 「문장당 맨몸 영문 낱말」이 기준(0~3.5)을 넘어 exit 1 이다 — 이 지표는 백틱 안 식별자를 빼고 세는데 Question 은 평문 렌더링이라 백틱을 못 쓰고 frontmatter 도 함께 센다. 남은 토큰은 제품명·체인 이름·출력 원문이라 한글로 바꿀 자리가 없어 수치를 맞추려고 문장을 넣지 않았다. S5 가 근거 등급 문제를 하나 올렸고 사람이 고쳤다 — Decision 의 「브리지였다면 …」이 SSOT §178·§179 에 없는 반사실 추론이라 그 문장을 뺐다."
},
{
"id": "S6",
"name": "일한 사람의 목소리",
"skill": "writing-as-the-person-who-did-it",
"runBy": "subagent",
"status": "DONE",
"skipReason": "",
"skillEcho": "고치는 방법은 하나뿐이다. **자료에 남아 있는 사람의 흔적을 찾아서 제자리에 놓는다.**",
"inputs": [
"docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md",
"docs/virtualization/tech-log-studio/lab-environment-build/concept/concept-what-a-qcow2-file-carries.md",
"docs/virtualization/tech-log-studio/lab-environment-build/reference/reference-verify-a-build-guide-in-execution-order.md",
"docs/virtualization/tech-log-studio/lab-environment-build/decision/decision-edge-nginx-moved-into-a-guest-vm.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-guest-input-hole-under-the-iptables-backend.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-virsh-save-ram-dump-size-and-time.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-qcow2-transfer-time-over-wifi.md",
"docs/virtualization/final/document.md",
"docs/virtualization/tech-log-studio/tech-log-tree.json"
],
"outputs": [
"docs/virtualization/tech-log-studio/lab-environment-build/case/case-nftables-accept-did-not-stop-the-libvirt-reject.md",
"docs/virtualization/tech-log-studio/lab-environment-build/concept/concept-what-a-qcow2-file-carries.md",
"docs/virtualization/tech-log-studio/lab-environment-build/reference/reference-verify-a-build-guide-in-execution-order.md",
"docs/virtualization/tech-log-studio/lab-environment-build/decision/decision-edge-nginx-moved-into-a-guest-vm.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-guest-input-hole-under-the-iptables-backend.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-virsh-save-ram-dump-size-and-time.md",
"docs/virtualization/tech-log-studio/lab-environment-build/question/question-qcow2-transfer-time-over-wifi.md"
],
"gates": [
{
"cmd": "node .agents/skills/writing-as-the-person-who-did-it/scripts/check_voice.mjs <기록.md> (7건 전수)",
"exit": 0
},
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs --warn <기록.md> (7건 전수)",
"exit": 0
},
{
"cmd": "python3 scripts/studio-body.py <기록.md> -o /tmp/sb6-<이름>.md (7건)",
"exit": 0
},
{
"cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/sb-6-<이름>.md",
"exit": 0
},
{
"cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs virtualization --repo",
"exit": 0
}
],
"notes": "상류에 남아 있던 흔적 여섯을 제자리로 옮겼다 — §180 의 「가장 오래 막힌 지점」, §127 이 qcow2 내부 구조를 별도 문서로 미룬 원문, §182 이 결함 여섯에는 observed 를 공통 원인에는 inferred 를 붙인 사실, 전후를 같은 부하로 잰 측정이 없다는 한계, §183 의 「제2부의 balloon 실사용값과 대조하면 재미있는 대조군이 된다」(미측정). 어긋난 자리·1인칭·감정은 §178~§183 어디에도 없어 넣지 않았다 — 찾아본 결과다."
},
{
"id": "S7",
"name": "Studio 저장",
"skill": "publishing-tech-log-to-studio",
"runBy": "subagent",
"status": "SKIPPED",
"skipReason": "사용자가 이번 작업의 범위를 「트리 + 기록 .md + SVG (저장소까지)」로 정했다. Studio 반입을 요청하지 않았다.",
"skillEcho": "",
"inputs": [],
"outputs": [],
"gates": [],
"notes": ""
}
],
"riders": [
{
"id": "ssot-value-correction",
"why": "이 원장이 닫힌 뒤 같은 기록을 한 번 더 고쳤다. SSOT 대조에서 값 셋이 틀린 것이 드러났고 사용자가 판정했다 — (1) 11.6GiB 는 반입할 때 단위가 바뀐 것이라 원 측정 11,648MiB(free -m)로 통일, (2) 19ms 는 source/ 어디에도 근거가 없어 삭제(같은 줄의 connection refused 와 카운터 4 패킷 240 바이트는 근거가 있어 남김), (3) 「§57 의 overcommit 이 걸리는 배치」는 산수가 반대라 정정 — 10,240MB < 11,648MiB, 배정률 87.9%. 이 런의 관문 기록은 그때 사실 그대로이고 고치지 않았다.",
"seconds": null,
"addedAt": "2026-09-16T21:43:42+09:00",
"duringStage": null
}
],
"revision": 1,
"updatedAt": "2026-09-16T21:43:42+09:00"
}
runs/virtualization/2026-09-11-2013/run.json.lock
View File