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>
2026-09-05 11:50:33 +09:00
parent 75bed382c8
commit 95c0e680b5
221 changed files with 1156 additions and 1152 deletions
@@ -19,4 +19,4 @@ certbot 이 갱신에 성공한 뒤 deploy 훅이 nginx 를 reload 하는 경로

 - **deploy 훅 → nginx 워커 교체:** reload 신호. Evidence: L560–L580.
 - **certbot 갱신 성공 → deploy 훅:** 갱신 성공 시 호출. Evidence: L560–L575.
- **nginx 워커 교체 → 새 인증서 서빙:** 새 워커가 새 인증서를 읽는다. Evidence: L571–L580.
+- **nginx 워커 교체 → 새 인증서 서빙:** 새 인증서 적재. Evidence: L571–L580.
@@ -15,4 +15,4 @@ n3: "새 인증서 서빙" {
 }
 n0 -> n1: "갱신 성공 시 호출"
 n1 -> n2: "reload 신호"
-n2 -> n3: "새 워커가 새 인증서를 읽는다"
+n2 -> n3: "새 인증서 적재"
@@ -8,5 +8,5 @@ digraph techviz {
  n3 [label="새 인증서 서빙", shape=box, style="rounded,filled"];
  n0 -> n1 [label="갱신 성공 시 호출", style=solid];
  n1 -> n2 [label="reload 신호", style=solid];
-  n2 -> n3 [label="새 워커가 새 인증서를 읽는다", style=solid];
+  n2 -> n3 [label="새 인증서 적재", style=solid];
 }
@@ -27,7 +27,7 @@
            <mxPoint x="205.5" y="172.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_w-s" value="새 워커가 새 인증서를 읽는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_worker" target="n_serving">
+        <mxCell id="e_w-s" value="새 인증서 적재" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_worker" target="n_serving">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="205.5" y="506.0" as="offset"/>
          </mxGeometry>
@@ -264,9 +264,9 @@
    {
      "id": "edge-label-w-s",
      "type": "text",
-      "x": 141.5,
+      "x": 160.5,
      "y": 494.0,
-      "width": 128,
+      "width": 90,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -292,11 +292,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "새 워커가 새 인증서를 읽는다",
+      "text": "새 인증서 적재",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "새 워커가 새 인증서를 읽는다",
+      "originalText": "새 인증서 적재",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "d4a-hook-effect",
  "spec_version": "1.1",
-  "spec_sha256": "59efe2ccd992f17d10ab3dfb326165c08f77c325c5d080f339ea556a07daefe3",
+  "spec_sha256": "94bfbe9e771b5ce00e14823ff32b308db3853d5c388631c9e2e8f58fc1532697",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -7,4 +7,4 @@ flowchart TB
    n3["새 인증서 서빙"]
    n0 -->|"갱신 성공 시 호출"| n1
    n1 -->|"reload 신호"| n2
-    n2 -->|"새 워커가 새 인증서를 읽는다"| n3
+    n2 -->|"새 인증서 적재"| n3
@@ -57,8 +57,8 @@
 <rect class="edge-label-bg" x="163.0" y="158.0" width="85.0" height="22" rx="3" />
 <text class="edge-label" x="205.5" y="173.0">갱신 성공 시 호출</text>
 <polyline class="edge kind-request style-solid emphasis-normal" points="181.5,458.0 181.5,506.0 181.5,506.0 181.5,554.0" data-evidence="571-580" />
-<rect class="edge-label-bg" x="142.9" y="492.0" width="125.2" height="22" rx="3" />
-<text class="edge-label" x="205.5" y="507.0">새 워커가 새 인증서를 읽는다</text>
+<rect class="edge-label-bg" x="169.7" y="492.0" width="71.6" height="22" rx="3" />
+<text class="edge-label" x="205.5" y="507.0">새 인증서 적재</text>
 <g id="node-renew">
 <rect class="node-shape kind-process emphasis-primary role-source" data-evidence="560-570" x="106.5" y="60.0" width="150.0" height="64.0" rx="7" />
 <text class="node-label" x="181.5" y="90.0">certbot 갱신 성공</text>