DongHyeonkaandClaude Opus 5
75bed382c8
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>
150 lines
4.3 KiB
JSON
150 lines
4.3 KiB
JSON
{
|
|
"version": "1.1",
|
|
"id": "wrong-predictions",
|
|
"title": "틀린 예측이 남긴 것",
|
|
"question": "예측을 지우지 않고 남기면 무엇이 달라지는가",
|
|
"type": "architecture",
|
|
"direction": "TB",
|
|
"audience": [
|
|
"실험 기록을 쓰는 엔지니어"
|
|
],
|
|
"summary": "예측을 먼저 적고 주입이 걸렸는지 따로 확인하고 대조군 없이 귀속하지 않는다. 세 번째가 가장 자주 어겨졌다.",
|
|
"alt": "예측 기록에서 주입 검증과 대조군 확보를 거쳐 결론에 이르는 경로. 각 단계가 빠지면 다른 방식으로 틀린다.",
|
|
"long_description": "이 실험대에서 예측 다섯 개가 틀렸고 주입이 아홉 번 조용히 실패했다. A-1 이 틀리지 않았다면 A-0 의 인과 설명이 잘못된 채로 남았을 것이고 A-7 의 가설이 확정되지 않았다면 volatile 이면 이렇다는 표가 조건 없이 유통됐을 것이다. 그래서 규칙이 셋이다. 예측을 먼저 적고, 주입이 걸렸는지를 결과와 따로 확인하고, 대조군 없이 귀속하지 않는다.",
|
|
"source_context": {
|
|
"document": "docs/keycloak-session-store/final/document.md",
|
|
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
|
|
"anchor": {
|
|
"kind": "heading",
|
|
"value": "결국 지키려던 것은 무엇이었나",
|
|
"line": 706
|
|
}
|
|
},
|
|
"composition": {
|
|
"profile": "component-flow",
|
|
"diagram_only": true,
|
|
"reference_ids": [
|
|
"payment-event-flow"
|
|
],
|
|
"rationale": "기록의 신뢰가 어느 단계에서 만들어지는가가 지배적 질문이다. 절차의 사슬이므로 component-flow 를 골랐다."
|
|
},
|
|
"groups": [],
|
|
"nodes": [
|
|
{
|
|
"id": "predict",
|
|
"label": "예측을 먼저 적는다",
|
|
"kind": "process",
|
|
"role": "source",
|
|
"emphasis": "primary",
|
|
"description": "결과를 보고 나면 정직하게 쓸 수 없다.",
|
|
"details": [
|
|
"예측 다섯 개가 틀렸다"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 744,
|
|
"end_line": 752
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "verify",
|
|
"label": "주입이 걸렸는지 확인",
|
|
"kind": "process",
|
|
"role": "control",
|
|
"emphasis": "primary",
|
|
"description": "아무 일도 없었다와 영향이 없다를 가른다.",
|
|
"details": [
|
|
"아홉 번 조용히 실패했다"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 744,
|
|
"end_line": 752
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "control",
|
|
"label": "대조군을 잡는다",
|
|
"kind": "process",
|
|
"role": "control",
|
|
"emphasis": "warning",
|
|
"description": "가장 자주 어겨졌고 가장 비쌌다.",
|
|
"details": [],
|
|
"evidence": [
|
|
{
|
|
"start_line": 744,
|
|
"end_line": 753
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "conclusion",
|
|
"label": "결론",
|
|
"kind": "component",
|
|
"role": "target",
|
|
"emphasis": "primary",
|
|
"description": "세 단계를 거친 것만 남긴다.",
|
|
"details": [],
|
|
"evidence": [
|
|
{
|
|
"start_line": 744,
|
|
"end_line": 753
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"edges": [
|
|
{
|
|
"id": "p-v",
|
|
"from": "predict",
|
|
"to": "verify",
|
|
"label": "주입 뒤",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 744,
|
|
"end_line": 752
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "v-c",
|
|
"from": "verify",
|
|
"to": "control",
|
|
"label": "관측 전",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 744,
|
|
"end_line": 752
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "c-cn",
|
|
"from": "control",
|
|
"to": "conclusion",
|
|
"label": "귀속",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 744,
|
|
"end_line": 753
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"legend": [],
|
|
"metadata": {
|
|
"rationale": "세 규칙을 순서로 놓았다. 각 단계가 빠졌을 때 어떤 방식으로 틀리는지가 이 실험대의 실제 이력이다."
|
|
}
|
|
} |