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>
122 lines
3.9 KiB
JSON
122 lines
3.9 KiB
JSON
{
|
|
"version": "1.1",
|
|
"id": "injection-verification",
|
|
"title": "주입이 걸렸는지 따로 확인한다",
|
|
"question": "주입했다는 것과 주입이 걸렸다는 것을 어떻게 구별하는가",
|
|
"type": "architecture",
|
|
"direction": "LR",
|
|
"audience": [
|
|
"장애 주입으로 시스템을 검증하는 엔지니어"
|
|
],
|
|
"summary": "주입이 실패하면 아무 일도 없어 보이고, 그것은 영향이 없다와 구별되지 않는다. 결과가 아니라 대상의 상태를 따로 확인해야 한다.",
|
|
"alt": "주입 명령에서 대상 상태 확인을 거쳐 결과 관측으로 가는 경로. 상태 확인을 건너뛰면 두 가지 다른 상황이 같은 관측으로 보인다.",
|
|
"long_description": "이 실험대에서 아홉 번의 주입이 조용히 실패했다. conntrack 이 ESTABLISHED 연결을 통과시키고, kubectl delete --force 가 크래시가 아니며, PID 1 이 SIGKILL 을 무시하고, kube-router 가 iptables 체인을 다시 끼워 넣는다. 모두 아무 일도 없었다로 보였다. 그래서 주입 뒤에는 결과를 보기 전에 대상이 실제로 그 상태인지를 cluster_size, 워커 PID, conntrack 표, 패킷 카운터로 확인한다.",
|
|
"source_context": {
|
|
"document": "docs/keycloak-session-store/final/document.md",
|
|
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
|
|
"anchor": {
|
|
"kind": "heading",
|
|
"value": "주입이 먹지 않는다 — 아홉 번, 전부 조용히",
|
|
"line": 113
|
|
}
|
|
},
|
|
"composition": {
|
|
"profile": "component-flow",
|
|
"diagram_only": true,
|
|
"reference_ids": [
|
|
"payment-event-flow"
|
|
],
|
|
"rationale": "주입과 관측 사이에 상태 확인 단계가 있어야 한다는 것이 이 절의 지배적 질문이다. 검증 고리이므로 reconciliation-loop 를 골랐다."
|
|
},
|
|
"groups": [],
|
|
"nodes": [
|
|
{
|
|
"id": "inject",
|
|
"label": "주입 명령",
|
|
"kind": "process",
|
|
"role": "source",
|
|
"emphasis": "primary",
|
|
"description": "NetworkPolicy · tc · kill · iptables.",
|
|
"details": [
|
|
"아홉 번 조용히 실패했다"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 109,
|
|
"end_line": 112
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "verify",
|
|
"label": "대상 상태 확인",
|
|
"kind": "process",
|
|
"role": "control",
|
|
"emphasis": "warning",
|
|
"description": "결과가 아니라 대상이 그 상태인지를 본다.",
|
|
"details": [
|
|
"cluster_size · 워커 PID · conntrack · 패킷 카운터"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 128,
|
|
"end_line": 133
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "observe",
|
|
"label": "결과 관측",
|
|
"kind": "process",
|
|
"role": "target",
|
|
"emphasis": "primary",
|
|
"description": "여기만 보면 두 상황이 같아 보인다.",
|
|
"details": [
|
|
"주입 실패 = 영향 없음 으로 읽힌다"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 128,
|
|
"end_line": 131
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"edges": [
|
|
{
|
|
"id": "i-v",
|
|
"from": "inject",
|
|
"to": "verify",
|
|
"label": "걸렸는가를 먼저 본다",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 128,
|
|
"end_line": 133
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "v-o",
|
|
"from": "verify",
|
|
"to": "observe",
|
|
"label": "걸린 뒤에만 결과를 읽는다",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 128,
|
|
"end_line": 133
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"legend": [],
|
|
"metadata": {
|
|
"rationale": "아홉 번의 실패가 전부 같은 자리에서 생겼다. 주입과 관측 사이가 비어 있었다."
|
|
}
|
|
} |