feat: [verified] widen Skills Adoption diagram stories
Build and publish Eldorado documentation / build (pull_request) Successful in 39s

This commit is contained in:
jarvis-at-skic committed 2026-10-06 19:37:49 +00:00
1 parent 3238e1d809
commit ad7312b65a
18 files changed
+870 -687

No files matched your search

@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Learn before expanding",
"title": "TO-BE: Adoption",
"output": "static/diagrams/strategy-adoption-mobile/index.html",
"quality_profile": "showcase",
"legend": {
@@ -11,129 +11,136 @@
},
"components": [
{
"id": "choose",
"id": "delivery",
"type": "backend",
"label": "Choose workflow",
"sublabel": "Department outcome",
"label": "Delivery first",
"tag": "Understand real work",
"sublabel": "Codebase + principles\nSystem logic and tests\nBuilds and packaging\nDeployments + baseline",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "workflow",
"type": "security",
"label": "Choose bounded work",
"tag": "Team + Product owner",
"sublabel": "Define accepted outcome\nData & AI shapes the skill\nQuality sets acceptance\nSecurity clears data",
"pos": [
40,
610
],
"size": [
560,
440
]
},
{
"id": "coach",
"type": "backend",
"label": "Coach people",
"sublabel": "Verify + recover",
"type": "frontend",
"label": "Practice together",
"tag": "Human + AI Agent",
"sublabel": "Platform qualifies client\nPeople supports learning\nSelect skill; inspect work\nKeep a manual path",
"pos": [
20,
140
40,
1180
],
"size": [
180,
60
560,
440
]
},
{
"id": "canary",
"type": "backend",
"label": "Run bounded canary",
"sublabel": "Qualified skill + client",
"id": "verify",
"type": "security",
"label": "Accept actual work",
"tag": "Independent reviewer",
"sublabel": "Check artifacts, not calls\nRecognize unsafe inputs\nUse incident routes\nExplain limits + recovery",
"pos": [
20,
260
40,
1750
],
"size": [
180,
60
560,
440
]
},
{
"id": "accept",
"type": "backend",
"label": "Accept real work",
"sublabel": "Independent review",
"id": "learn",
"type": "database",
"label": "Review the feedback",
"tag": "Owning team",
"sublabel": "Collect metrics + friction\nNon-use is useful feedback\nRevise through review\nNo quotas or rankings",
"pos": [
20,
380
40,
2320
],
"size": [
180,
60
]
},
{
"id": "feedback",
"type": "backend",
"label": "Review feedback",
"sublabel": "Usefulness + non-use",
"pos": [
20,
500
],
"size": [
180,
60
560,
440
]
},
{
"id": "expand",
"type": "backend",
"label": "Expand or revise",
"sublabel": "Keep a manual path",
"type": "cloud",
"label": "Expand with evidence",
"tag": "Other SDLC phases",
"sublabel": "Later order undecided\nRepeat baseline + topology\nDelivery keeps improving\nNot autonomous authority",
"pos": [
20,
620
40,
2890
],
"size": [
180,
60
560,
440
]
}
],
"connections": [
{
"id": "flow-0",
"from": "choose",
"to": "coach",
"label": "Prepare"
"from": "delivery",
"to": "workflow",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-1",
"from": "coach",
"to": "canary",
"label": "support pilot"
"from": "workflow",
"to": "coach",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-2",
"from": "canary",
"to": "accept",
"label": "Verify"
"from": "coach",
"to": "verify",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "accept",
"to": "feedback",
"label": "learn"
"from": "verify",
"to": "learn",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-4",
"from": "feedback",
"from": "learn",
"to": "expand",
"label": "decide"
},
{
"id": "feedback-loop",
"from": "expand",
"to": "coach",
"label": "Review revision",
"variant": "dashed",
"fromSide": "right",
"toSide": "right"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
}
]
}
+82 -75
View File
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Learn before expanding",
"title": "TO-BE: Adoption",
"output": "static/diagrams/strategy-adoption/index.html",
"quality_profile": "showcase",
"legend": {
@@ -11,129 +11,136 @@
},
"components": [
{
"id": "choose",
"id": "delivery",
"type": "backend",
"label": "Choose workflow",
"sublabel": "Department outcome",
"label": "Delivery first",
"tag": "Understand real work",
"sublabel": "Codebase + principles\nSystem logic and tests\nBuilds and packaging\nDeployments + baseline",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "workflow",
"type": "security",
"label": "Choose bounded work",
"tag": "Team + Product owner",
"sublabel": "Define accepted outcome\nData & AI shapes the skill\nQuality sets acceptance\nSecurity clears data",
"pos": [
700,
40
],
"size": [
560,
440
]
},
{
"id": "coach",
"type": "backend",
"label": "Coach people",
"sublabel": "Verify + recover",
"type": "frontend",
"label": "Practice together",
"tag": "Human + AI Agent",
"sublabel": "Platform qualifies client\nPeople supports learning\nSelect skill; inspect work\nKeep a manual path",
"pos": [
260,
20
1360,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "canary",
"type": "backend",
"label": "Run bounded canary",
"sublabel": "Qualified skill + client",
"id": "verify",
"type": "security",
"label": "Accept actual work",
"tag": "Independent reviewer",
"sublabel": "Check artifacts, not calls\nRecognize unsafe inputs\nUse incident routes\nExplain limits + recovery",
"pos": [
260,
150
1360,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "accept",
"type": "backend",
"label": "Accept real work",
"sublabel": "Independent review",
"id": "learn",
"type": "database",
"label": "Review the feedback",
"tag": "Owning team",
"sublabel": "Collect metrics + friction\nNon-use is useful feedback\nRevise through review\nNo quotas or rankings",
"pos": [
20,
150
700,
610
],
"size": [
180,
60
]
},
{
"id": "feedback",
"type": "backend",
"label": "Review feedback",
"sublabel": "Usefulness + non-use",
"pos": [
20,
280
],
"size": [
180,
60
560,
440
]
},
{
"id": "expand",
"type": "backend",
"label": "Expand or revise",
"sublabel": "Keep a manual path",
"type": "cloud",
"label": "Expand with evidence",
"tag": "Other SDLC phases",
"sublabel": "Later order undecided\nRepeat baseline + topology\nDelivery keeps improving\nNot autonomous authority",
"pos": [
260,
280
40,
610
],
"size": [
180,
60
560,
440
]
}
],
"connections": [
{
"id": "flow-0",
"from": "choose",
"to": "coach",
"label": "Prepare"
"from": "delivery",
"to": "workflow",
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-1",
"from": "coach",
"to": "canary",
"label": "support pilot"
"from": "workflow",
"to": "coach",
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-2",
"from": "canary",
"to": "accept",
"label": "Verify"
"from": "coach",
"to": "verify",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "accept",
"to": "feedback",
"label": "learn"
"from": "verify",
"to": "learn",
"fromSide": "left",
"toSide": "right",
"route": "straight"
},
{
"id": "flow-4",
"from": "feedback",
"from": "learn",
"to": "expand",
"label": "decide"
},
{
"id": "feedback-loop",
"from": "expand",
"to": "coach",
"label": "Review revision",
"variant": "dashed",
"fromSide": "right",
"toSide": "right"
"fromSide": "left",
"toSide": "right",
"route": "straight"
}
]
}
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Independent approval",
"title": "TO-BE: Governance",
"output": "static/diagrams/strategy-governance-mobile/index.html",
"quality_profile": "showcase",
"legend": {
@@ -12,86 +12,92 @@
"components": [
{
"id": "owner",
"type": "security",
"label": "Owner proposes",
"sublabel": "Existing accountable team",
"type": "backend",
"label": "Propose a skill",
"tag": "Owning team",
"sublabel": "Problem + intended users\nData and authority scope\nSKILL.md + dependencies\nTestable outcome",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "review",
"type": "security",
"label": "Independent review",
"sublabel": "Quality + risk evidence",
"tag": "Quality + Security",
"sublabel": "Evaluate useful outcomes\nCheck risk boundaries\nAuthor is not sole approver\nRecord revision evidence",
"pos": [
20,
140
40,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "canary",
"type": "security",
"label": "Bounded canary",
"sublabel": "Qualified client path",
"type": "frontend",
"label": "Qualify real use",
"tag": "Human + AI Agent",
"sublabel": "Test exact client build\nRun a bounded canary\nInspect work independently\nNo failed mandatory gate",
"pos": [
20,
260
40,
1180
],
"size": [
180,
60
560,
440
]
},
{
"id": "approve",
"type": "security",
"label": "Approve revision",
"sublabel": "Exact digest + scope",
"label": "Approve exact scope",
"tag": "Accountable approvers",
"sublabel": "Bind approval to digest\nPermitted uses + expiry\nExceptions cannot bypass\nprotected controls",
"pos": [
20,
380
40,
1750
],
"size": [
180,
60
560,
440
]
},
{
"id": "publish",
"type": "security",
"label": "Publish bundle",
"sublabel": "Data & AI catalog",
"type": "database",
"label": "Version the bundle",
"tag": "Data & AI catalog",
"sublabel": "Pin skill + adapter\nand dependency revisions\nRecord approval evidence\nKeep last-known-good",
"pos": [
20,
500
40,
2320
],
"size": [
180,
60
560,
440
]
},
{
"id": "distribute",
"type": "security",
"label": "Verify effective state",
"sublabel": "Platform & IT",
"type": "cloud",
"label": "Verify loaded state",
"tag": "Platform & IT",
"sublabel": "Stage and check digest\nRead effective revision\nTest open-session reload\nRevoke unsafe revisions",
"pos": [
20,
620
40,
2890
],
"size": [
180,
60
560,
440
]
}
],
@@ -100,31 +106,41 @@
"id": "flow-0",
"from": "owner",
"to": "review",
"label": "submit"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-1",
"from": "review",
"to": "canary",
"label": "qualify"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-2",
"from": "canary",
"to": "approve",
"label": "Accept"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "approve",
"to": "publish",
"label": "record approval"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-4",
"from": "publish",
"to": "distribute",
"label": "Deliver"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
}
]
}
+61 -45
View File
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Independent approval",
"title": "TO-BE: Governance",
"output": "static/diagrams/strategy-governance/index.html",
"quality_profile": "showcase",
"legend": {
@@ -12,86 +12,92 @@
"components": [
{
"id": "owner",
"type": "security",
"label": "Owner proposes",
"sublabel": "Existing accountable team",
"type": "backend",
"label": "Propose a skill",
"tag": "Owning team",
"sublabel": "Problem + intended users\nData and authority scope\nSKILL.md + dependencies\nTestable outcome",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "review",
"type": "security",
"label": "Independent review",
"sublabel": "Quality + risk evidence",
"tag": "Quality + Security",
"sublabel": "Evaluate useful outcomes\nCheck risk boundaries\nAuthor is not sole approver\nRecord revision evidence",
"pos": [
260,
20
700,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "canary",
"type": "security",
"label": "Bounded canary",
"sublabel": "Qualified client path",
"type": "frontend",
"label": "Qualify real use",
"tag": "Human + AI Agent",
"sublabel": "Test exact client build\nRun a bounded canary\nInspect work independently\nNo failed mandatory gate",
"pos": [
260,
150
1360,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "approve",
"type": "security",
"label": "Approve revision",
"sublabel": "Exact digest + scope",
"label": "Approve exact scope",
"tag": "Accountable approvers",
"sublabel": "Bind approval to digest\nPermitted uses + expiry\nExceptions cannot bypass\nprotected controls",
"pos": [
20,
150
1360,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "publish",
"type": "security",
"label": "Publish bundle",
"sublabel": "Data & AI catalog",
"type": "database",
"label": "Version the bundle",
"tag": "Data & AI catalog",
"sublabel": "Pin skill + adapter\nand dependency revisions\nRecord approval evidence\nKeep last-known-good",
"pos": [
20,
280
700,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "distribute",
"type": "security",
"label": "Verify effective state",
"sublabel": "Platform & IT",
"type": "cloud",
"label": "Verify loaded state",
"tag": "Platform & IT",
"sublabel": "Stage and check digest\nRead effective revision\nTest open-session reload\nRevoke unsafe revisions",
"pos": [
260,
280
40,
610
],
"size": [
180,
60
560,
440
]
}
],
@@ -100,31 +106,41 @@
"id": "flow-0",
"from": "owner",
"to": "review",
"label": "submit"
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-1",
"from": "review",
"to": "canary",
"label": "qualify"
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-2",
"from": "canary",
"to": "approve",
"label": "Accept"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "approve",
"to": "publish",
"label": "record approval"
"fromSide": "left",
"toSide": "right",
"route": "straight"
},
{
"id": "flow-4",
"from": "publish",
"to": "distribute",
"label": "Deliver"
"fromSide": "left",
"toSide": "right",
"route": "straight"
}
]
}
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Maintain trust over time",
"title": "TO-BE: Maintenance",
"output": "static/diagrams/strategy-maintenance-mobile/index.html",
"quality_profile": "showcase",
"legend": {
@@ -12,86 +12,92 @@
"components": [
{
"id": "monitor",
"type": "backend",
"label": "Monitor skills",
"sublabel": "Usefulness + safety",
"type": "database",
"label": "Watch for change",
"tag": "Data & AI + owners",
"sublabel": "Review usefulness + safety\nDue dates and feedback\nModel / client / tool drift\nFailures trigger early review",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "triage",
"type": "backend",
"label": "Triage changes",
"sublabel": "Owner + risk review",
"label": "Triage the evidence",
"tag": "Owner + Quality",
"sublabel": "Reproduce the failure\nKeep artifact / client IDs\nAdd sanitized regressions\nAssess business effects",
"pos": [
20,
140
40,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "contain",
"type": "security",
"label": "If unsafe: contain",
"tag": "Security + Platform",
"sublabel": "Revoke authority\nQuarantine revision\nRestore known-good bundle\nVerify effective state",
"pos": [
40,
1180
],
"size": [
560,
440
]
},
{
"id": "correct",
"type": "backend",
"label": "Correct and test",
"sublabel": "Independent regression",
"label": "Create a new revision",
"tag": "Owning team",
"sublabel": "Correct skill + dependencies\nIndependent tests / review\nRequalify client + model\nNo automatic reinstatement",
"pos": [
20,
260
40,
1750
],
"size": [
180,
60
560,
440
]
},
{
"id": "decision",
"type": "backend",
"label": "Approve or hold",
"sublabel": "Exact revised bundle",
"id": "approve",
"type": "security",
"label": "Authorize restart",
"tag": "Accountable human",
"sublabel": "Require regression evidence\nVerify rollback / revocation\nApprove exact new revision\nCanary before wider use",
"pos": [
20,
380
40,
2320
],
"size": [
180,
60
560,
440
]
},
{
"id": "promote",
"type": "backend",
"label": "Promote safely",
"sublabel": "Verify state + monitor",
"id": "retire",
"type": "cloud",
"label": "Retire when obsolete",
"tag": "Data & AI + Platform",
"sublabel": "Deprecate with migration\nRetire: no new invocation\nTrack revoked versions\nHistory stays in metrics",
"pos": [
20,
500
40,
2890
],
"size": [
180,
60
]
},
{
"id": "observe",
"type": "backend",
"label": "Quarantine / rollback",
"sublabel": "Revoke unsafe revision",
"pos": [
20,
620
],
"size": [
180,
60
560,
440
]
}
],
@@ -100,42 +106,41 @@
"id": "flow-0",
"from": "monitor",
"to": "triage",
"label": "Detect"
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-1",
"from": "triage",
"to": "correct",
"label": "scope correction"
"to": "contain",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-2",
"from": "correct",
"to": "decision",
"label": "Prove"
"from": "contain",
"to": "correct",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "decision",
"to": "promote",
"label": "authorize"
},
{
"id": "unsafe",
"from": "triage",
"to": "observe",
"label": "Unsafe",
"variant": "security",
"fromSide": "right",
"toSide": "right"
"from": "correct",
"to": "approve",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "review-loop",
"from": "observe",
"to": "correct",
"label": "Requalify",
"variant": "dashed"
"id": "flow-4",
"from": "approve",
"to": "retire",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
}
]
}
+79 -74
View File
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Maintain trust over time",
"title": "TO-BE: Maintenance",
"output": "static/diagrams/strategy-maintenance/index.html",
"quality_profile": "showcase",
"legend": {
@@ -12,86 +12,92 @@
"components": [
{
"id": "monitor",
"type": "backend",
"label": "Monitor skills",
"sublabel": "Usefulness + safety",
"type": "database",
"label": "Watch for change",
"tag": "Data & AI + owners",
"sublabel": "Review usefulness + safety\nDue dates and feedback\nModel / client / tool drift\nFailures trigger early review",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "triage",
"type": "backend",
"label": "Triage changes",
"sublabel": "Owner + risk review",
"label": "Triage the evidence",
"tag": "Owner + Quality",
"sublabel": "Reproduce the failure\nKeep artifact / client IDs\nAdd sanitized regressions\nAssess business effects",
"pos": [
260,
20
700,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "contain",
"type": "security",
"label": "If unsafe: contain",
"tag": "Security + Platform",
"sublabel": "Revoke authority\nQuarantine revision\nRestore known-good bundle\nVerify effective state",
"pos": [
1360,
40
],
"size": [
560,
440
]
},
{
"id": "correct",
"type": "backend",
"label": "Correct and test",
"sublabel": "Independent regression",
"label": "Create a new revision",
"tag": "Owning team",
"sublabel": "Correct skill + dependencies\nIndependent tests / review\nRequalify client + model\nNo automatic reinstatement",
"pos": [
260,
150
1360,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "decision",
"type": "backend",
"label": "Approve or hold",
"sublabel": "Exact revised bundle",
"id": "approve",
"type": "security",
"label": "Authorize restart",
"tag": "Accountable human",
"sublabel": "Require regression evidence\nVerify rollback / revocation\nApprove exact new revision\nCanary before wider use",
"pos": [
20,
150
700,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "promote",
"type": "backend",
"label": "Promote safely",
"sublabel": "Verify state + monitor",
"id": "retire",
"type": "cloud",
"label": "Retire when obsolete",
"tag": "Data & AI + Platform",
"sublabel": "Deprecate with migration\nRetire: no new invocation\nTrack revoked versions\nHistory stays in metrics",
"pos": [
20,
280
40,
610
],
"size": [
180,
60
]
},
{
"id": "observe",
"type": "backend",
"label": "Quarantine / rollback",
"sublabel": "Revoke unsafe revision",
"pos": [
260,
280
],
"size": [
180,
60
560,
440
]
}
],
@@ -100,42 +106,41 @@
"id": "flow-0",
"from": "monitor",
"to": "triage",
"label": "Detect"
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-1",
"from": "triage",
"to": "correct",
"label": "scope correction"
"to": "contain",
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-2",
"from": "correct",
"to": "decision",
"label": "Prove"
"from": "contain",
"to": "correct",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "decision",
"to": "promote",
"label": "authorize"
},
{
"id": "unsafe",
"from": "triage",
"to": "observe",
"label": "Unsafe",
"variant": "security",
"fromSide": "right",
"toSide": "right"
"from": "correct",
"to": "approve",
"fromSide": "left",
"toSide": "right",
"route": "straight"
},
{
"id": "review-loop",
"from": "observe",
"to": "correct",
"label": "Requalify",
"variant": "dashed"
"id": "flow-4",
"from": "approve",
"to": "retire",
"fromSide": "left",
"toSide": "right",
"route": "straight"
}
]
}
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Measure skills adoption",
"title": "Recommended collection plan: Measurement",
"output": "static/diagrams/strategy-measurement-mobile/index.html",
"quality_profile": "showcase",
"legend": {
@@ -11,120 +11,95 @@
},
"components": [
{
"id": "collect",
"id": "baseline",
"type": "backend",
"label": "Establish baseline",
"sublabel": "Current workflow",
"tag": "Comparable workflow",
"sublabel": "Join task / PR / CI IDs\nAgree acceptance + window\nRecord revision and client\nKeep unknowns visible",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "validate",
"type": "backend",
"label": "Join evidence",
"sublabel": "Tasks / versions / costs",
"id": "success",
"type": "frontend",
"label": "Accepted outcomes",
"tag": "Quality · weekly",
"sublabel": "Tracker: starts + acceptance\nAccepted / eligible starts\nwith ended window × 100\nKeep failed, stopped, unknown\nShow outcome coverage",
"pos": [
20,
140
40,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "calculate",
"type": "backend",
"label": "Measure the pilot",
"sublabel": "Outcomes / quality",
"id": "quality",
"type": "security",
"label": "Escaped quality",
"tag": "Quality · monthly",
"sublabel": "PRs + linked defect records\nAffected / followed-up\naccepted changes × 100\nCount each change once\nMissing links ≠ clean",
"pos": [
20,
260
40,
1180
],
"size": [
180,
60
560,
440
]
},
{
"id": "balance",
"type": "backend",
"label": "Report together",
"sublabel": "Cost / confidence / gaps",
"id": "cost",
"type": "cloud",
"label": "Cost per outcome",
"tag": "Finance · monthly",
"sublabel": "Invoices + review minutes\nAll costs / accepted tasks\nSame matured start cohort\nFailed work + licenses too\nMissing buckets = partial",
"pos": [
20,
380
40,
1750
],
"size": [
180,
60
560,
440
]
},
{
"id": "weigh",
"type": "backend",
"label": "Broader adoption",
"sublabel": "Availability + use",
"id": "confidence",
"type": "frontend",
"label": "Verification confidence",
"tag": "People · each cycle",
"sublabel": "Anonymous 1–5 survey\nSum of valid scores / replies\nShow spread; response rate:\nreplies / invitations × 100\nProtect small cohorts",
"pos": [
20,
500
40,
2320
],
"size": [
180,
60
560,
440
]
},
{
"id": "decide",
"type": "backend",
"id": "monitor",
"type": "database",
"label": "Ongoing monitoring",
"sublabel": "Review + maintenance",
"tag": "Catalog + cohort report",
"sublabel": "Catalog + cohort records\nTrack support, use, reviews\nCompare with baseline\nShow counts + coverage\nZero denominator = N/A",
"pos": [
20,
620
40,
2890
],
"size": [
180,
60
560,
440
]
}
],
"connections": [
{
"id": "flow-0",
"from": "collect",
"to": "validate",
"label": "prepare"
},
{
"id": "flow-1",
"from": "validate",
"to": "calculate",
"label": "collect"
},
{
"id": "flow-2",
"from": "calculate",
"to": "balance",
"label": "calculate"
},
{
"id": "flow-3",
"from": "balance",
"to": "weigh",
"label": "extend"
},
{
"id": "flow-4",
"from": "weigh",
"to": "decide",
"label": "repeat"
}
]
"connections": []
}
+53 -78
View File
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Measure skills adoption",
"title": "Recommended collection plan: Measurement",
"output": "static/diagrams/strategy-measurement/index.html",
"quality_profile": "showcase",
"legend": {
@@ -11,120 +11,95 @@
},
"components": [
{
"id": "collect",
"id": "baseline",
"type": "backend",
"label": "Establish baseline",
"sublabel": "Current workflow",
"tag": "Comparable workflow",
"sublabel": "Join task / PR / CI IDs\nAgree acceptance + window\nRecord revision and client\nKeep unknowns visible",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "validate",
"type": "backend",
"label": "Join evidence",
"sublabel": "Tasks / versions / costs",
"id": "success",
"type": "frontend",
"label": "Accepted outcomes",
"tag": "Quality · weekly",
"sublabel": "Tracker: starts + acceptance\nAccepted / eligible starts\nwith ended window × 100\nKeep failed, stopped, unknown\nShow outcome coverage",
"pos": [
260,
20
700,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "calculate",
"type": "backend",
"label": "Measure the pilot",
"sublabel": "Outcomes / quality",
"id": "quality",
"type": "security",
"label": "Escaped quality",
"tag": "Quality · monthly",
"sublabel": "PRs + linked defect records\nAffected / followed-up\naccepted changes × 100\nCount each change once\nMissing links ≠ clean",
"pos": [
260,
150
1360,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "balance",
"type": "backend",
"label": "Report together",
"sublabel": "Cost / confidence / gaps",
"id": "cost",
"type": "cloud",
"label": "Cost per outcome",
"tag": "Finance · monthly",
"sublabel": "Invoices + review minutes\nAll costs / accepted tasks\nSame matured start cohort\nFailed work + licenses too\nMissing buckets = partial",
"pos": [
20,
150
1360,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "weigh",
"type": "backend",
"label": "Broader adoption",
"sublabel": "Availability + use",
"id": "confidence",
"type": "frontend",
"label": "Verification confidence",
"tag": "People · each cycle",
"sublabel": "Anonymous 1–5 survey\nSum of valid scores / replies\nShow spread; response rate:\nreplies / invitations × 100\nProtect small cohorts",
"pos": [
20,
280
700,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "decide",
"type": "backend",
"id": "monitor",
"type": "database",
"label": "Ongoing monitoring",
"sublabel": "Review + maintenance",
"tag": "Catalog + cohort report",
"sublabel": "Catalog + cohort records\nTrack support, use, reviews\nCompare with baseline\nShow counts + coverage\nZero denominator = N/A",
"pos": [
260,
280
40,
610
],
"size": [
180,
60
560,
440
]
}
],
"connections": [
{
"id": "flow-0",
"from": "collect",
"to": "validate",
"label": "prepare"
},
{
"id": "flow-1",
"from": "validate",
"to": "calculate",
"label": "collect"
},
{
"id": "flow-2",
"from": "calculate",
"to": "balance",
"label": "calculate"
},
{
"id": "flow-3",
"from": "balance",
"to": "weigh",
"label": "extend"
},
{
"id": "flow-4",
"from": "weigh",
"to": "decide",
"label": "repeat"
}
]
"connections": []
}
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Risk-tiered qualification",
"title": "TO-BE: Quality",
"output": "static/diagrams/strategy-quality-mobile/index.html",
"quality_profile": "showcase",
"legend": {
@@ -13,85 +13,91 @@
{
"id": "risk",
"type": "security",
"label": "Classify risk",
"sublabel": "R1 / R2 / R3",
"label": "Define the envelope",
"tag": "Owner + reviewers",
"sublabel": "R1: nonsensitive drafting\nR2: code / customer work\nR3: human-authorized\nAgree acceptance rules",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "plan",
"type": "security",
"label": "Agree evaluation",
"sublabel": "Task mix + thresholds",
"id": "compare",
"type": "backend",
"label": "Compare three paths",
"tag": "Same starting artifacts",
"sublabel": "No skill / approved / new\nPositive + negative cases\nRepeat trials per client\nKeep failed attempts",
"pos": [
20,
140
40,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "trial",
"type": "security",
"label": "Repeat trials",
"sublabel": "Candidate vs approved",
"id": "inspect",
"type": "frontend",
"label": "Inspect the outcome",
"tag": "Independent evidence",
"sublabel": "Right skill selected?\nProcedure safe?\nArtifact checks pass?\nUseful workflow result?",
"pos": [
20,
260
40,
1180
],
"size": [
180,
60
]
},
{
"id": "verify",
"type": "security",
"label": "Verify artifacts",
"sublabel": "Independent checks",
"pos": [
20,
380
],
"size": [
180,
60
560,
440
]
},
{
"id": "gate",
"type": "security",
"label": "All gates pass?",
"sublabel": "Safety cannot be traded",
"label": "Every gate must pass",
"tag": "Quality Engineering",
"sublabel": "Safety + authorization\nSchema + provenance\nCritical effect blocks\nMissing coverage blocks",
"pos": [
20,
500
40,
1750
],
"size": [
180,
60
560,
440
]
},
{
"id": "promote",
"type": "security",
"label": "Promote or hold",
"sublabel": "Owner decision",
"id": "canary",
"type": "cloud",
"label": "Test bounded work",
"tag": "Human + AI Agent",
"sublabel": "Qualified client + model\nHuman judges usefulness\nShow counts / uncertainty\nEvidence before promotion",
"pos": [
20,
620
40,
2320
],
"size": [
180,
60
560,
440
]
},
{
"id": "improve",
"type": "database",
"label": "Feed the next revision",
"tag": "Owning team",
"sublabel": "Failures to regression set\nReview corrections\nMaterial client/model drift\ntriggers requalification",
"pos": [
40,
2890
],
"size": [
560,
440
]
}
],
@@ -99,32 +105,42 @@
{
"id": "flow-0",
"from": "risk",
"to": "plan",
"label": "Scope"
"to": "compare",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-1",
"from": "plan",
"to": "trial",
"label": "freeze plan"
"from": "compare",
"to": "inspect",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-2",
"from": "trial",
"to": "verify",
"label": "Assess"
"from": "inspect",
"to": "gate",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "verify",
"to": "gate",
"label": "review evidence"
"from": "gate",
"to": "canary",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-4",
"from": "gate",
"to": "promote",
"label": "decide"
"from": "canary",
"to": "improve",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
}
]
}
+81 -65
View File
@@ -2,7 +2,7 @@
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Risk-tiered qualification",
"title": "TO-BE: Quality",
"output": "static/diagrams/strategy-quality/index.html",
"quality_profile": "showcase",
"legend": {
@@ -13,85 +13,91 @@
{
"id": "risk",
"type": "security",
"label": "Classify risk",
"sublabel": "R1 / R2 / R3",
"label": "Define the envelope",
"tag": "Owner + reviewers",
"sublabel": "R1: nonsensitive drafting\nR2: code / customer work\nR3: human-authorized\nAgree acceptance rules",
"pos": [
20,
20
40,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "plan",
"type": "security",
"label": "Agree evaluation",
"sublabel": "Task mix + thresholds",
"id": "compare",
"type": "backend",
"label": "Compare three paths",
"tag": "Same starting artifacts",
"sublabel": "No skill / approved / new\nPositive + negative cases\nRepeat trials per client\nKeep failed attempts",
"pos": [
260,
20
700,
40
],
"size": [
180,
60
560,
440
]
},
{
"id": "trial",
"type": "security",
"label": "Repeat trials",
"sublabel": "Candidate vs approved",
"id": "inspect",
"type": "frontend",
"label": "Inspect the outcome",
"tag": "Independent evidence",
"sublabel": "Right skill selected?\nProcedure safe?\nArtifact checks pass?\nUseful workflow result?",
"pos": [
260,
150
1360,
40
],
"size": [
180,
60
]
},
{
"id": "verify",
"type": "security",
"label": "Verify artifacts",
"sublabel": "Independent checks",
"pos": [
20,
150
],
"size": [
180,
60
560,
440
]
},
{
"id": "gate",
"type": "security",
"label": "All gates pass?",
"sublabel": "Safety cannot be traded",
"label": "Every gate must pass",
"tag": "Quality Engineering",
"sublabel": "Safety + authorization\nSchema + provenance\nCritical effect blocks\nMissing coverage blocks",
"pos": [
20,
280
1360,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "promote",
"type": "security",
"label": "Promote or hold",
"sublabel": "Owner decision",
"id": "canary",
"type": "cloud",
"label": "Test bounded work",
"tag": "Human + AI Agent",
"sublabel": "Qualified client + model\nHuman judges usefulness\nShow counts / uncertainty\nEvidence before promotion",
"pos": [
260,
280
700,
610
],
"size": [
180,
60
560,
440
]
},
{
"id": "improve",
"type": "database",
"label": "Feed the next revision",
"tag": "Owning team",
"sublabel": "Failures to regression set\nReview corrections\nMaterial client/model drift\ntriggers requalification",
"pos": [
40,
610
],
"size": [
560,
440
]
}
],
@@ -99,32 +105,42 @@
{
"id": "flow-0",
"from": "risk",
"to": "plan",
"label": "Scope"
"to": "compare",
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-1",
"from": "plan",
"to": "trial",
"label": "freeze plan"
"from": "compare",
"to": "inspect",
"fromSide": "right",
"toSide": "left",
"route": "straight"
},
{
"id": "flow-2",
"from": "trial",
"to": "verify",
"label": "Assess"
"from": "inspect",
"to": "gate",
"fromSide": "bottom",
"toSide": "top",
"route": "straight"
},
{
"id": "flow-3",
"from": "verify",
"to": "gate",
"label": "review evidence"
"from": "gate",
"to": "canary",
"fromSide": "left",
"toSide": "right",
"route": "straight"
},
{
"id": "flow-4",
"from": "gate",
"to": "promote",
"label": "decide"
"from": "canary",
"to": "improve",
"fromSide": "left",
"toSide": "right",
"route": "straight"
}
]
}