Files
document-haness/docs/keycloak-session-store/final/assets/measurement-control/measurement-control.alt.md
T
DongHyeonkaandClaude Opus 5 75bed382c8 docs(keycloak-session-store): remake all 28 diagrams through the techviz pipeline
The originating repository's SVGs were drawn by hand and every one of them
put a title, a subtitle and an explanation band inside the canvas. This
repository forbids both, so they could not be carried over — the whole set
was rebuilt through the skill's pipeline instead.

Each diagram went through prepare, references, prompt, a VizSpec 1.1 citing
document line ranges, lint, and render. All 28 pass lint and produce the
same eight formats the existing keycloak project has. Sentences moved out of
the canvas into <desc> and the paragraph beside each figure; the drawings
carry names only.

Two lint rules did real work rather than formatting work:

  edge-through-node                  caught arrows crossing an unrelated
                                     node and implying an adjacency that
                                     does not exist — four diagrams had to
                                     be restructured, not just relaid out
  evidence-outside-prepared-context  caught a diagram citing another
                                     section; its anchor moved from B-0 to
                                     B-1 so all three sections it draws on
                                     are inside the prepared context

lab-topology also had to change profile: its context offers a different
candidate set, and query-fanout with shard roles is what the section
actually shows — one entry point spreading to two Keycloak nodes.

The document now carries all 28 inline, one per claim that needed one, and
the section recording what was still missing is updated: the diagram gap is
closed, Studio records remain.

verify-pipeline.py passes. audit-records.py reports no issues.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 11:03:10 +09:00

1.4 KiB
Raw Blame History

대조군 없이는 귀속할 수 없다

Alternative text

주입 결과가 대조군과 대비될 때만 귀속이 성립하고, 대조군이 없으면 같은 관측이 두 가지로 읽히는 구성.

Long description

D-4 에서 주입 전에 900건을 재서 오류 0을 확인했다. 그래서 갱신 중 비200 이 한 번 나와도 갱신 탓으로 귀속할 수 있었다. 이 규칙을 어긴 사례가 있었다. A-6 에서 −41% 인 대조군을 영향 없음이라고 적었고 A-8 에서 표본 9개로 무중단을 주장했다. 가장 최근에는 in-flight 감시에서 76건이 실패했는데 같은 순간 폴링 49건이 전부 200 이었고 연결수가 0이었으며 재현이 0/100 이었다. 대조군이 오보를 막았다.

Elements and evidence

  • 주입 전 대조군 (process): 평시 오류율을 잰다. Evidence: L596L606.
  • 주입 중 관측 (process): 이상이 보인다. Evidence: L607L618.
  • 귀속 (process): 대조군과 대비될 때만 성립한다. Evidence: L596L618.
  • 오보 (process): 대조군이 없으면 여기로 간다. Evidence: L607L618.

Relationships

  • 주입 전 대조군 → 주입 중 관측: 비교 기준을 준다. Evidence: L596L610.
  • 주입 중 관측 → 귀속: 대조가 있으면. Evidence: L596L618.
  • 주입 중 관측 → 오보: 대조가 없으면. Evidence: L607L618.