docs(keycloak-session-store): take the sentences out of the diagram canvases

The skill says drawings carry names and sentences go in <desc> and the
paragraph beside the figure. I put sentences in node details and edge labels
instead, and 27 of the 28 diagrams shipped with prose inside the canvas —
"예측 다섯 개가 틀렸다", "아홉 번 조용히 실패했다", "막혀서 닿지 않는다".

Only label and details render on the canvas; description does not. So every
sentence moved to a noun phrase and the meaning stays in description, which
was already carrying it.

  막혀서 닿지 않는다              -> 차단
  아홉 번 조용히 실패했다         -> 조용한 실패 9건
  예측 다섯 개가 틀렸다           -> 틀린 예측 5건
  로그아웃이 정리하지 않는다      -> 로그아웃 미정리
  볼륨이 없으면 여기까지다        -> 볼륨 없음

Three node labels were sentences too and became names: 세션 스냅샷, 예측
선기록, 대조군 확보.

What stays is what the rules protect — identifiers, commands and measured
values: PRIMARY KEY (client_registration_id, principal_name),
ValidationFailedException: 1 changesets check sum, nginx -t && nginx -s
reload, SET LOCAL synchronous_commit TO OFF. Those are names of things, not
prose about them.

294 canvas strings across 28 diagrams, none matching a sentence ending,
average 11 characters. All 28 still lint clean and re-rendered.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-09-05 11:50:33 +09:00
co-authored by Claude Opus 5
parent 75bed382c8
commit 95c0e680b5
221 changed files with 1156 additions and 1152 deletions
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="1059" height="300" viewBox="0 0 1059 300" role="img" aria-labelledby="diagram-title diagram-description">
<svg xmlns="http://www.w3.org/2000/svg" width="1035" height="300" viewBox="0 0 1035 300" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">주입이 걸렸는지 따로 확인한다</title>
<desc id="diagram-description">이 실험대에서 아홉 번의 주입이 조용히 실패했다. conntrack 이 ESTABLISHED 연결을 통과시키고, kubectl delete --force 가 크래시가 아니며, PID 1 이 SIGKILL 을 무시하고, kube-router 가 iptables 체인을 다시 끼워 넣는다. 모두 아무 일도 없었다로 보였다. 그래서 주입 뒤에는 결과를 보기 전에 대상이 실제로 그 상태인지를 cluster_size, 워커 PID, conntrack 표, 패킷 카운터로 확인한다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;injection-verification&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;주입이 먹지 않는다 — 아홉 번, 전부 조용히&quot;,&quot;line&quot;:113}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
@@ -49,18 +49,18 @@
.timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
</style>
</defs>
<rect class="canvas" width="1059" height="300" />
<rect class="canvas" width="1035" height="300" />
<polyline class="edge kind-request style-solid emphasis-normal" points="220.0,95.5 300.0,95.5 300.0,95.5 380.0,95.5" data-evidence="128-133" />
<rect class="edge-label-bg" x="254.2" y="53.5" width="91.7" height="22" rx="3" />
<text class="edge-label" x="300.0" y="68.5">걸렸는가를 먼저 본다</text>
<rect class="edge-label-bg" x="274.2" y="53.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="300.0" y="68.5">상태 확인</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="680.0,95.5 760.0,95.5 760.0,95.5 840.0,95.5" data-evidence="128-133" />
<rect class="edge-label-bg" x="704.1" y="53.5" width="111.8" height="22" rx="3" />
<text class="edge-label" x="760.0" y="68.5">걸린 뒤에만 결과를 읽는다</text>
<rect class="edge-label-bg" x="734.2" y="53.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="760.0" y="68.5">결과 판독</text>
<g id="node-inject">
<rect class="node-shape kind-process emphasis-primary role-source" data-evidence="109-112" x="70.0" y="60.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="87.0">주입 명령</text>
<line class="node-detail-divider" x1="84.0" y1="108.0" x2="206.0" y2="108.0" />
<text class="node-detail" x="86.0" y="125.0">아홉 번 조용 실패했다</text>
<text class="node-detail" x="86.0" y="125.0">조용 실패 9건</text>
</g>
<g id="node-verify">
<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="128-133" x="380.0" y="60.0" width="300.0" height="71.0" rx="7" />
@@ -69,9 +69,9 @@
<text class="node-detail" x="396.0" y="125.0">cluster_size · 워커 PID · conntrack · 패킷 카운터</text>
</g>
<g id="node-observe">
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="128-131" x="840.0" y="60.0" width="174.0" height="71.0" rx="7" />
<text class="node-label" x="927.0" y="87.0">결과 관측</text>
<line class="node-detail-divider" x1="854.0" y1="108.0" x2="1000.0" y2="108.0" />
<text class="node-detail" x="856.0" y="125.0">주입 실패 = 영향 없음 으로 읽힌다</text>
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="128-131" x="840.0" y="60.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="915.0" y="87.0">결과 관측</text>
<line class="node-detail-divider" x1="854.0" y1="108.0" x2="976.0" y2="108.0" />
<text class="node-detail" x="856.0" y="125.0">실패 · 무영향 구별 불가</text>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 6.4 KiB

After

Width:  |  Height:  |  Size: 6.3 KiB