Compare commits

...
Author SHA1 Message Date
jarvis-at-skic 4cc2bb4dfd docs: label central autonomous agent Human Controlled
Build and publish Eldorado documentation / build (pull_request) Successful in 1m22s
2026-10-05 17:59:59 +00:00
jarvis-at-skic afb6a97e97 Merge pull request 'docs: center Target lifecycle on autonomous agent' (#19) from docs/target-central-agent into main
Build and publish Eldorado documentation / build (push) Successful in 40s
2026-10-05 10:25:47 -07:00
jarvis-at-skic 1057433c2a docs: center Target lifecycle on autonomous agent
Build and publish Eldorado documentation / build (pull_request) Successful in 41s
2026-10-05 17:23:56 +00:00
jarvis-at-skic 504d9f8845 Merge pull request 'docs: lead Strategy with autonomous SDLC cycle' (#18) from docs/autonomous-sdlc-cycle into main
Build and publish Eldorado documentation / build (push) Successful in 42s
2026-10-05 09:34:42 -07:00
jarvis-at-skic 29beebb379 docs: lead Strategy with autonomous SDLC cycle
Build and publish Eldorado documentation / build (pull_request) Successful in 51s
2026-10-05 16:32:51 +00:00
jarvis-at-skic e95b85afee Merge pull request 'fix: right-align inline diagram controls' (#17) from fix/right-align-inline-controls into main
Build and publish Eldorado documentation / build (push) Successful in 45s
2026-10-05 05:51:58 -07:00
jarvis-at-skic d7e1ad1c0c fix: right-align inline diagram controls
Build and publish Eldorado documentation / build (pull_request) Successful in 48s
2026-10-05 12:50:12 +00:00
jarvis-at-skic 714090a83d Merge pull request 'fix: restore inline diagram controls and synchronize portal theme' (#16) from fix/inline-diagram-controls into main
Build and publish Eldorado documentation / build (push) Successful in 42s
2026-10-05 05:22:41 -07:00
jarvis-at-skic 9347de298f fix: restore inline diagram controls and synchronize portal theme
Build and publish Eldorado documentation / build (pull_request) Successful in 43s
2026-10-05 12:18:45 +00:00
jarvis-at-skic 62d2afc152 Merge pull request 'docs: redesign AI strategy as a diagram-first story' (#15) from docs/strategy-visual-story into main
Build and publish Eldorado documentation / build (push) Successful in 38s
2026-10-04 05:25:56 -07:00
jarvis-at-skic 794f2aa2d6 docs: present AI strategy as a diagram-first story
Build and publish Eldorado documentation / build (pull_request) Successful in 40s
2026-10-04 12:23:41 +00:00
jarvis-at-skic 7f40de708c Merge pull request 'fix: cross-only full-screen diagram close control' (#14) from fix/diagram-cross-only-close into main
Build and publish Eldorado documentation / build (push) Successful in 33s
2026-10-04 04:44:21 -07:00
jarvis-at-skic d3b9f7af14 fix: use cross-only fullscreen diagram close control
Build and publish Eldorado documentation / build (pull_request) Successful in 33s
2026-10-04 11:43:00 +00:00
jarvis-at-skic 577117e19c Merge pull request 'docs: AI adoption strategy, TO-BE model and tested KPI examples' (#13) from docs/ai-adoption-strategy into main
Build and publish Eldorado documentation / build (push) Successful in 32s
2026-10-04 04:15:33 -07:00
41 changed files with 2778 additions and 22 deletions

No files matched your search

+4
View File
@@ -31,6 +31,10 @@ Top-level sections are Organization, Strategy, and Contribution, each with an in
Archify 3.0.1 is vendored under `vendor/archify/` from commit `d5a1333d7447c866a765adac7d4d062f2f02e4d2`. MIT and third-party notices are preserved. `diagrams/` holds editable JSON; `pnpm diagrams:build` validates and generates local standalone viewers before every site build. The iframe is sandboxed without same-origin permission. See `docs/contribution/diagrams.md` for capability analysis, authoring, boundaries, and upgrade procedure.
The build checks upstream provenance before applying the portal integration: `scripts/inline-viewer.css` restores compact embed controls, two guarded preset restrictions are removed from generated viewers only, and `scripts/viewer-theme-bridge.js` synchronizes theme with the portal through source-validated messages. Vendor files remain unchanged. Delivery receipts describe the upstream artifact before this integration, not the final served bytes. Theme changes do not reload viewers or discard visual presets. PNG, JPEG, WebP and SVG downloads remain available; browser-dependent exports stay disabled when unsupported.
For interaction acceptance, serve the production build on port 4173 and run `pnpm test:browser` with an installed Playwright Chromium (or `PLAYWRIGHT_CHROMIUM_EXECUTABLE`). This checks story layouts, portal/diagram theme synchronization, all four presets, actual exported artifact decoding, route changes, and fullscreen click/Escape/focus behavior at desktop and mobile widths. Screenshots, downloads and results are saved under ignored `.cache/` directories.
## Design
Inspired by https://www.eldorado.gg/: Lato, near-black navigation, charcoal, gold `#ffc950`, light panels, bold headings. Original documentation artwork and square panels; no official marketplace assets or business claims. See `docs/core/reference.md`.
@@ -0,0 +1,139 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Learn before expanding",
"output": "static/diagrams/strategy-adoption-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "choose",
"type": "backend",
"label": "Choose workflow",
"sublabel": "Department outcome",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "coach",
"type": "backend",
"label": "Coach people",
"sublabel": "Verify + recover",
"pos": [
20,
140
],
"size": [
180,
60
]
},
{
"id": "canary",
"type": "backend",
"label": "Run bounded canary",
"sublabel": "Qualified skill + client",
"pos": [
20,
260
],
"size": [
180,
60
]
},
{
"id": "accept",
"type": "backend",
"label": "Accept real work",
"sublabel": "Independent review",
"pos": [
20,
380
],
"size": [
180,
60
]
},
{
"id": "feedback",
"type": "backend",
"label": "Review feedback",
"sublabel": "Usefulness + non-use",
"pos": [
20,
500
],
"size": [
180,
60
]
},
{
"id": "expand",
"type": "backend",
"label": "Expand or revise",
"sublabel": "Keep a manual path",
"pos": [
20,
620
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "choose",
"to": "coach",
"label": "Prepare"
},
{
"id": "flow-1",
"from": "coach",
"to": "canary",
"label": "support pilot"
},
{
"id": "flow-2",
"from": "canary",
"to": "accept",
"label": "Verify"
},
{
"id": "flow-3",
"from": "accept",
"to": "feedback",
"label": "learn"
},
{
"id": "flow-4",
"from": "feedback",
"to": "expand",
"label": "decide"
},
{
"id": "feedback-loop",
"from": "expand",
"to": "coach",
"label": "Review revision",
"variant": "dashed",
"fromSide": "right",
"toSide": "right"
}
]
}
@@ -0,0 +1,139 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Learn before expanding",
"output": "static/diagrams/strategy-adoption/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "choose",
"type": "backend",
"label": "Choose workflow",
"sublabel": "Department outcome",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "coach",
"type": "backend",
"label": "Coach people",
"sublabel": "Verify + recover",
"pos": [
260,
20
],
"size": [
180,
60
]
},
{
"id": "canary",
"type": "backend",
"label": "Run bounded canary",
"sublabel": "Qualified skill + client",
"pos": [
260,
150
],
"size": [
180,
60
]
},
{
"id": "accept",
"type": "backend",
"label": "Accept real work",
"sublabel": "Independent review",
"pos": [
20,
150
],
"size": [
180,
60
]
},
{
"id": "feedback",
"type": "backend",
"label": "Review feedback",
"sublabel": "Usefulness + non-use",
"pos": [
20,
280
],
"size": [
180,
60
]
},
{
"id": "expand",
"type": "backend",
"label": "Expand or revise",
"sublabel": "Keep a manual path",
"pos": [
260,
280
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "choose",
"to": "coach",
"label": "Prepare"
},
{
"id": "flow-1",
"from": "coach",
"to": "canary",
"label": "support pilot"
},
{
"id": "flow-2",
"from": "canary",
"to": "accept",
"label": "Verify"
},
{
"id": "flow-3",
"from": "accept",
"to": "feedback",
"label": "learn"
},
{
"id": "flow-4",
"from": "feedback",
"to": "expand",
"label": "decide"
},
{
"id": "feedback-loop",
"from": "expand",
"to": "coach",
"label": "Review revision",
"variant": "dashed",
"fromSide": "right",
"toSide": "right"
}
]
}
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Independent approval",
"output": "static/diagrams/strategy-governance-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "owner",
"type": "security",
"label": "Owner proposes",
"sublabel": "Existing accountable team",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "review",
"type": "security",
"label": "Independent review",
"sublabel": "Quality + risk evidence",
"pos": [
20,
140
],
"size": [
180,
60
]
},
{
"id": "canary",
"type": "security",
"label": "Bounded canary",
"sublabel": "Qualified client path",
"pos": [
20,
260
],
"size": [
180,
60
]
},
{
"id": "approve",
"type": "security",
"label": "Approve revision",
"sublabel": "Exact digest + scope",
"pos": [
20,
380
],
"size": [
180,
60
]
},
{
"id": "publish",
"type": "security",
"label": "Publish bundle",
"sublabel": "Data & AI catalog",
"pos": [
20,
500
],
"size": [
180,
60
]
},
{
"id": "distribute",
"type": "security",
"label": "Verify effective state",
"sublabel": "Platform & IT",
"pos": [
20,
620
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "owner",
"to": "review",
"label": "submit"
},
{
"id": "flow-1",
"from": "review",
"to": "canary",
"label": "qualify"
},
{
"id": "flow-2",
"from": "canary",
"to": "approve",
"label": "Accept"
},
{
"id": "flow-3",
"from": "approve",
"to": "publish",
"label": "record approval"
},
{
"id": "flow-4",
"from": "publish",
"to": "distribute",
"label": "Deliver"
}
]
}
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Independent approval",
"output": "static/diagrams/strategy-governance/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "owner",
"type": "security",
"label": "Owner proposes",
"sublabel": "Existing accountable team",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "review",
"type": "security",
"label": "Independent review",
"sublabel": "Quality + risk evidence",
"pos": [
260,
20
],
"size": [
180,
60
]
},
{
"id": "canary",
"type": "security",
"label": "Bounded canary",
"sublabel": "Qualified client path",
"pos": [
260,
150
],
"size": [
180,
60
]
},
{
"id": "approve",
"type": "security",
"label": "Approve revision",
"sublabel": "Exact digest + scope",
"pos": [
20,
150
],
"size": [
180,
60
]
},
{
"id": "publish",
"type": "security",
"label": "Publish bundle",
"sublabel": "Data & AI catalog",
"pos": [
20,
280
],
"size": [
180,
60
]
},
{
"id": "distribute",
"type": "security",
"label": "Verify effective state",
"sublabel": "Platform & IT",
"pos": [
260,
280
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "owner",
"to": "review",
"label": "submit"
},
{
"id": "flow-1",
"from": "review",
"to": "canary",
"label": "qualify"
},
{
"id": "flow-2",
"from": "canary",
"to": "approve",
"label": "Accept"
},
{
"id": "flow-3",
"from": "approve",
"to": "publish",
"label": "record approval"
},
{
"id": "flow-4",
"from": "publish",
"to": "distribute",
"label": "Deliver"
}
]
}
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Skills before authority",
"output": "static/diagrams/strategy-journey-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "skills",
"type": "backend",
"label": "Govern skills",
"sublabel": "Owner + pinned revision",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "prove",
"type": "backend",
"label": "Prove quality",
"sublabel": "Independent evaluation",
"pos": [
20,
140
],
"size": [
180,
60
]
},
{
"id": "pilot",
"type": "backend",
"label": "Pilot with people",
"sublabel": "Qualified local clients",
"pos": [
20,
260
],
"size": [
180,
60
]
},
{
"id": "distribute",
"type": "backend",
"label": "Verify distribution",
"sublabel": "Canary + rollback",
"pos": [
20,
380
],
"size": [
180,
60
]
},
{
"id": "coordinate",
"type": "backend",
"label": "Coordinate delivery",
"sublabel": "One logical SDLC agent",
"pos": [
20,
500
],
"size": [
180,
60
]
},
{
"id": "expand",
"type": "backend",
"label": "Expand by evidence",
"sublabel": "Department outcomes",
"pos": [
20,
620
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "skills",
"to": "prove",
"label": "qualify"
},
{
"id": "flow-1",
"from": "prove",
"to": "pilot",
"label": "coach"
},
{
"id": "flow-2",
"from": "pilot",
"to": "distribute",
"label": "Verify"
},
{
"id": "flow-3",
"from": "distribute",
"to": "coordinate",
"label": "prove recovery"
},
{
"id": "flow-4",
"from": "coordinate",
"to": "expand",
"label": "Justify"
}
]
}
+130
View File
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Skills before authority",
"output": "static/diagrams/strategy-journey/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "skills",
"type": "backend",
"label": "Govern skills",
"sublabel": "Owner + pinned revision",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "prove",
"type": "backend",
"label": "Prove quality",
"sublabel": "Independent evaluation",
"pos": [
260,
20
],
"size": [
180,
60
]
},
{
"id": "pilot",
"type": "backend",
"label": "Pilot with people",
"sublabel": "Qualified local clients",
"pos": [
260,
150
],
"size": [
180,
60
]
},
{
"id": "distribute",
"type": "backend",
"label": "Verify distribution",
"sublabel": "Canary + rollback",
"pos": [
20,
150
],
"size": [
180,
60
]
},
{
"id": "coordinate",
"type": "backend",
"label": "Coordinate delivery",
"sublabel": "One logical SDLC agent",
"pos": [
20,
280
],
"size": [
180,
60
]
},
{
"id": "expand",
"type": "backend",
"label": "Expand by evidence",
"sublabel": "Department outcomes",
"pos": [
260,
280
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "skills",
"to": "prove",
"label": "qualify"
},
{
"id": "flow-1",
"from": "prove",
"to": "pilot",
"label": "coach"
},
{
"id": "flow-2",
"from": "pilot",
"to": "distribute",
"label": "Verify"
},
{
"id": "flow-3",
"from": "distribute",
"to": "coordinate",
"label": "prove recovery"
},
{
"id": "flow-4",
"from": "coordinate",
"to": "expand",
"label": "Justify"
}
]
}
@@ -0,0 +1,141 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Maintain trust over time",
"output": "static/diagrams/strategy-maintenance-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "monitor",
"type": "backend",
"label": "Monitor skills",
"sublabel": "Usefulness + safety",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "triage",
"type": "backend",
"label": "Triage changes",
"sublabel": "Owner + risk review",
"pos": [
20,
140
],
"size": [
180,
60
]
},
{
"id": "correct",
"type": "backend",
"label": "Correct and test",
"sublabel": "Independent regression",
"pos": [
20,
260
],
"size": [
180,
60
]
},
{
"id": "decision",
"type": "backend",
"label": "Approve or hold",
"sublabel": "Exact revised bundle",
"pos": [
20,
380
],
"size": [
180,
60
]
},
{
"id": "promote",
"type": "backend",
"label": "Promote safely",
"sublabel": "Verify state + monitor",
"pos": [
20,
500
],
"size": [
180,
60
]
},
{
"id": "observe",
"type": "backend",
"label": "Quarantine / rollback",
"sublabel": "Revoke unsafe revision",
"pos": [
20,
620
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "monitor",
"to": "triage",
"label": "Detect"
},
{
"id": "flow-1",
"from": "triage",
"to": "correct",
"label": "scope correction"
},
{
"id": "flow-2",
"from": "correct",
"to": "decision",
"label": "Prove"
},
{
"id": "flow-3",
"from": "decision",
"to": "promote",
"label": "authorize"
},
{
"id": "unsafe",
"from": "triage",
"to": "observe",
"label": "Unsafe",
"variant": "security",
"fromSide": "right",
"toSide": "right"
},
{
"id": "review-loop",
"from": "observe",
"to": "correct",
"label": "Requalify",
"variant": "dashed"
}
]
}
@@ -0,0 +1,141 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Maintain trust over time",
"output": "static/diagrams/strategy-maintenance/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "monitor",
"type": "backend",
"label": "Monitor skills",
"sublabel": "Usefulness + safety",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "triage",
"type": "backend",
"label": "Triage changes",
"sublabel": "Owner + risk review",
"pos": [
260,
20
],
"size": [
180,
60
]
},
{
"id": "correct",
"type": "backend",
"label": "Correct and test",
"sublabel": "Independent regression",
"pos": [
260,
150
],
"size": [
180,
60
]
},
{
"id": "decision",
"type": "backend",
"label": "Approve or hold",
"sublabel": "Exact revised bundle",
"pos": [
20,
150
],
"size": [
180,
60
]
},
{
"id": "promote",
"type": "backend",
"label": "Promote safely",
"sublabel": "Verify state + monitor",
"pos": [
20,
280
],
"size": [
180,
60
]
},
{
"id": "observe",
"type": "backend",
"label": "Quarantine / rollback",
"sublabel": "Revoke unsafe revision",
"pos": [
260,
280
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "monitor",
"to": "triage",
"label": "Detect"
},
{
"id": "flow-1",
"from": "triage",
"to": "correct",
"label": "scope correction"
},
{
"id": "flow-2",
"from": "correct",
"to": "decision",
"label": "Prove"
},
{
"id": "flow-3",
"from": "decision",
"to": "promote",
"label": "authorize"
},
{
"id": "unsafe",
"from": "triage",
"to": "observe",
"label": "Unsafe",
"variant": "security",
"fromSide": "right",
"toSide": "right"
},
{
"id": "review-loop",
"from": "observe",
"to": "correct",
"label": "Requalify",
"variant": "dashed"
}
]
}
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Evidence before claims",
"output": "static/diagrams/strategy-measurement-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "collect",
"type": "backend",
"label": "Collect evidence",
"sublabel": "Task / CI / incident",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "validate",
"type": "backend",
"label": "Validate sources",
"sublabel": "Joins + missingness",
"pos": [
20,
140
],
"size": [
180,
60
]
},
{
"id": "calculate",
"type": "backend",
"label": "Calculate measures",
"sublabel": "16 exact contracts",
"pos": [
20,
260
],
"size": [
180,
60
]
},
{
"id": "balance",
"type": "backend",
"label": "Read balanced signals",
"sublabel": "Quality / flow / risk",
"pos": [
20,
380
],
"size": [
180,
60
]
},
{
"id": "weigh",
"type": "backend",
"label": "Weigh benefit and cost",
"sublabel": "Outcomes / cost / people",
"pos": [
20,
500
],
"size": [
180,
60
]
},
{
"id": "decide",
"type": "backend",
"label": "Continue or change",
"sublabel": "No causal ROI claim",
"pos": [
20,
620
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "collect",
"to": "validate",
"label": "Check"
},
{
"id": "flow-1",
"from": "validate",
"to": "calculate",
"label": "apply definitions"
},
{
"id": "flow-2",
"from": "calculate",
"to": "balance",
"label": "compare"
},
{
"id": "flow-3",
"from": "balance",
"to": "weigh",
"label": "consider together"
},
{
"id": "flow-4",
"from": "weigh",
"to": "decide",
"label": "decide"
}
]
}
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Evidence before claims",
"output": "static/diagrams/strategy-measurement/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "collect",
"type": "backend",
"label": "Collect evidence",
"sublabel": "Task / CI / incident",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "validate",
"type": "backend",
"label": "Validate sources",
"sublabel": "Joins + missingness",
"pos": [
260,
20
],
"size": [
180,
60
]
},
{
"id": "calculate",
"type": "backend",
"label": "Calculate measures",
"sublabel": "16 exact contracts",
"pos": [
260,
150
],
"size": [
180,
60
]
},
{
"id": "balance",
"type": "backend",
"label": "Read balanced signals",
"sublabel": "Quality / flow / risk",
"pos": [
20,
150
],
"size": [
180,
60
]
},
{
"id": "weigh",
"type": "backend",
"label": "Weigh benefit and cost",
"sublabel": "Outcomes / cost / people",
"pos": [
20,
280
],
"size": [
180,
60
]
},
{
"id": "decide",
"type": "backend",
"label": "Continue or change",
"sublabel": "No causal ROI claim",
"pos": [
260,
280
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "collect",
"to": "validate",
"label": "Check"
},
{
"id": "flow-1",
"from": "validate",
"to": "calculate",
"label": "apply definitions"
},
{
"id": "flow-2",
"from": "calculate",
"to": "balance",
"label": "compare"
},
{
"id": "flow-3",
"from": "balance",
"to": "weigh",
"label": "consider together"
},
{
"id": "flow-4",
"from": "weigh",
"to": "decide",
"label": "decide"
}
]
}
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Risk-tiered qualification",
"output": "static/diagrams/strategy-quality-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "risk",
"type": "security",
"label": "Classify risk",
"sublabel": "R1 / R2 / R3",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "plan",
"type": "security",
"label": "Agree evaluation",
"sublabel": "Task mix + thresholds",
"pos": [
20,
140
],
"size": [
180,
60
]
},
{
"id": "trial",
"type": "security",
"label": "Repeat trials",
"sublabel": "Candidate vs approved",
"pos": [
20,
260
],
"size": [
180,
60
]
},
{
"id": "verify",
"type": "security",
"label": "Verify artifacts",
"sublabel": "Independent checks",
"pos": [
20,
380
],
"size": [
180,
60
]
},
{
"id": "gate",
"type": "security",
"label": "All gates pass?",
"sublabel": "Safety cannot be traded",
"pos": [
20,
500
],
"size": [
180,
60
]
},
{
"id": "promote",
"type": "security",
"label": "Promote or hold",
"sublabel": "Owner decision",
"pos": [
20,
620
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "risk",
"to": "plan",
"label": "Scope"
},
{
"id": "flow-1",
"from": "plan",
"to": "trial",
"label": "freeze plan"
},
{
"id": "flow-2",
"from": "trial",
"to": "verify",
"label": "Assess"
},
{
"id": "flow-3",
"from": "verify",
"to": "gate",
"label": "review evidence"
},
{
"id": "flow-4",
"from": "gate",
"to": "promote",
"label": "decide"
}
]
}
+130
View File
@@ -0,0 +1,130 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Risk-tiered qualification",
"output": "static/diagrams/strategy-quality/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "risk",
"type": "security",
"label": "Classify risk",
"sublabel": "R1 / R2 / R3",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "plan",
"type": "security",
"label": "Agree evaluation",
"sublabel": "Task mix + thresholds",
"pos": [
260,
20
],
"size": [
180,
60
]
},
{
"id": "trial",
"type": "security",
"label": "Repeat trials",
"sublabel": "Candidate vs approved",
"pos": [
260,
150
],
"size": [
180,
60
]
},
{
"id": "verify",
"type": "security",
"label": "Verify artifacts",
"sublabel": "Independent checks",
"pos": [
20,
150
],
"size": [
180,
60
]
},
{
"id": "gate",
"type": "security",
"label": "All gates pass?",
"sublabel": "Safety cannot be traded",
"pos": [
20,
280
],
"size": [
180,
60
]
},
{
"id": "promote",
"type": "security",
"label": "Promote or hold",
"sublabel": "Owner decision",
"pos": [
260,
280
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "risk",
"to": "plan",
"label": "Scope"
},
{
"id": "flow-1",
"from": "plan",
"to": "trial",
"label": "freeze plan"
},
{
"id": "flow-2",
"from": "trial",
"to": "verify",
"label": "Assess"
},
{
"id": "flow-3",
"from": "verify",
"to": "gate",
"label": "review evidence"
},
{
"id": "flow-4",
"from": "gate",
"to": "promote",
"label": "decide"
}
]
}
@@ -0,0 +1,110 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Evidence-gated rollout",
"output": "static/diagrams/strategy-roadmap-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "foundation",
"type": "backend",
"label": "1 \u00b7 Foundation",
"sublabel": "People + data + baseline",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "pilot",
"type": "backend",
"label": "2 \u00b7 Skills pilot",
"sublabel": "Qualified, useful work",
"pos": [
20,
140
],
"size": [
180,
60
]
},
{
"id": "distribution",
"type": "backend",
"label": "3 \u00b7 Distribution",
"sublabel": "Revocation + recovery",
"pos": [
20,
260
],
"size": [
180,
60
]
},
{
"id": "coordination",
"type": "backend",
"label": "4 \u00b7 Coordination",
"sublabel": "Human takeover proven",
"pos": [
20,
380
],
"size": [
180,
60
]
},
{
"id": "expansion",
"type": "backend",
"label": "5 \u00b7 Departments",
"sublabel": "Outcomes + cost + risk",
"pos": [
20,
500
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "foundation",
"to": "pilot",
"label": "Charter"
},
{
"id": "flow-1",
"from": "pilot",
"to": "distribution",
"label": "quality + coverage"
},
{
"id": "flow-2",
"from": "distribution",
"to": "coordination",
"label": "Controls"
},
{
"id": "flow-3",
"from": "coordination",
"to": "expansion",
"label": "authority drills pass"
}
]
}
+110
View File
@@ -0,0 +1,110 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TO-BE: Evidence-gated rollout",
"output": "static/diagrams/strategy-roadmap/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
}
},
"components": [
{
"id": "foundation",
"type": "backend",
"label": "1 \u00b7 Foundation",
"sublabel": "People + data + baseline",
"pos": [
20,
20
],
"size": [
180,
60
]
},
{
"id": "pilot",
"type": "backend",
"label": "2 \u00b7 Skills pilot",
"sublabel": "Qualified, useful work",
"pos": [
260,
20
],
"size": [
180,
60
]
},
{
"id": "distribution",
"type": "backend",
"label": "3 \u00b7 Distribution",
"sublabel": "Revocation + recovery",
"pos": [
260,
150
],
"size": [
180,
60
]
},
{
"id": "coordination",
"type": "backend",
"label": "4 \u00b7 Coordination",
"sublabel": "Human takeover proven",
"pos": [
20,
150
],
"size": [
180,
60
]
},
{
"id": "expansion",
"type": "backend",
"label": "5 \u00b7 Departments",
"sublabel": "Outcomes + cost + risk",
"pos": [
20,
280
],
"size": [
180,
60
]
}
],
"connections": [
{
"id": "flow-0",
"from": "foundation",
"to": "pilot",
"label": "Charter"
},
{
"id": "flow-1",
"from": "pilot",
"to": "distribution",
"label": "quality + coverage"
},
{
"id": "flow-2",
"from": "distribution",
"to": "coordination",
"label": "Controls"
},
{
"id": "flow-3",
"from": "coordination",
"to": "expansion",
"label": "authority drills pass"
}
]
}
@@ -0,0 +1,51 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {"title": "TO-BE: autonomous SDLC, human direction", "output": "static/diagrams/strategy-target-mobile/index.html", "quality_profile": "showcase", "legend": {"mode": "hidden"}},
"components": [
{"id":"agent","type":"security","label":"Autonomous agent","sublabel":"Human Controlled","pos":[140,200],"size":[360,120]},
{"id":"scope","type":"backend","label":"Scope","sublabel":"01","pos":[100,440],"size":[240,100]},
{"id":"architecture","type":"backend","label":"Architecture","sublabel":"02","pos":[100,660],"size":[240,100]},
{"id":"ui-ux","type":"backend","label":"UI/UX","sublabel":"03","pos":[100,880],"size":[240,100]},
{"id":"planning","type":"backend","label":"Planning","sublabel":"04","pos":[100,1100],"size":[240,100]},
{"id":"delivery","type":"backend","label":"Delivery","sublabel":"05","pos":[100,1320],"size":[240,100]},
{"id":"uat","type":"backend","label":"UAT","sublabel":"06","pos":[100,1540],"size":[240,100]},
{"id":"security","type":"backend","label":"Security","sublabel":"07","pos":[100,1760],"size":[240,100]},
{"id":"releases","type":"backend","label":"Releases","sublabel":"08","pos":[100,1980],"size":[240,100]},
{"id":"code-scope","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,440],"size":[240,100]},
{"id":"code-architecture","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,660],"size":[240,100]},
{"id":"code-ui-ux","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,880],"size":[240,100]},
{"id":"code-planning","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,1100],"size":[240,100]},
{"id":"code-delivery","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,1320],"size":[240,100]},
{"id":"code-uat","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,1540],"size":[240,100]},
{"id":"code-security","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,1760],"size":[240,100]},
{"id":"code-releases","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[400,1980],"size":[240,100]}
],
"connections": [
{"id":"govern-scope","from":"agent","to":"scope","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,490]]},
{"id":"govern-architecture","from":"agent","to":"architecture","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,710]]},
{"id":"govern-ui-ux","from":"agent","to":"ui-ux","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,930]]},
{"id":"govern-planning","from":"agent","to":"planning","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,1150]]},
{"id":"govern-delivery","from":"agent","to":"delivery","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,1370]]},
{"id":"govern-uat","from":"agent","to":"uat","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,1590]]},
{"id":"govern-security","from":"agent","to":"security","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,1810]]},
{"id":"govern-releases","from":"agent","to":"releases","label":"","variant":"security","fromSide":"left","toSide":"left","via":[[60,260],[60,2030]]},
{"id":"stage-1","from":"scope","to":"architecture","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-2","from":"architecture","to":"ui-ux","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-3","from":"ui-ux","to":"planning","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-4","from":"planning","to":"delivery","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-5","from":"delivery","to":"uat","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-6","from":"uat","to":"security","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-7","from":"security","to":"releases","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-8","from":"releases","to":"scope","label":"Repeat indefinitely","variant":"emphasis","fromSide":"bottom","toSide":"top","via":[[220,2140],[680,2140],[680,380],[220,380]],"labelAt":[440,2180]},
{"id":"contribute-scope","from":"code-scope","to":"scope","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"},
{"id":"contribute-architecture","from":"code-architecture","to":"architecture","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"},
{"id":"contribute-ui-ux","from":"code-ui-ux","to":"ui-ux","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"},
{"id":"contribute-planning","from":"code-planning","to":"planning","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"},
{"id":"contribute-delivery","from":"code-delivery","to":"delivery","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"},
{"id":"contribute-uat","from":"code-uat","to":"uat","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"},
{"id":"contribute-security","from":"code-security","to":"security","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"},
{"id":"contribute-releases","from":"code-releases","to":"releases","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right"}
]
}
@@ -0,0 +1,51 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {"title": "TO-BE: autonomous SDLC, human direction", "output": "static/diagrams/strategy-target/index.html", "quality_profile": "showcase", "legend": {"mode": "hidden"}},
"components": [
{"id":"agent","type":"security","label":"Autonomous agent","sublabel":"Human Controlled","pos":[465,450],"size":[270,90]},
{"id":"scope","type":"backend","label":"Scope","sublabel":"01","pos":[510,187.5],"size":[180,75]},
{"id":"architecture","type":"backend","label":"Architecture","sublabel":"02","pos":[780,187.5],"size":[180,75]},
{"id":"ui-ux","type":"backend","label":"UI/UX","sublabel":"03","pos":[780,457.5],"size":[180,75]},
{"id":"planning","type":"backend","label":"Planning","sublabel":"04","pos":[780,727.5],"size":[180,75]},
{"id":"delivery","type":"backend","label":"Delivery","sublabel":"05","pos":[510,727.5],"size":[180,75]},
{"id":"uat","type":"backend","label":"UAT","sublabel":"06","pos":[240,727.5],"size":[180,75]},
{"id":"security","type":"backend","label":"Security","sublabel":"07","pos":[240,457.5],"size":[180,75]},
{"id":"releases","type":"backend","label":"Releases","sublabel":"08","pos":[240,187.5],"size":[180,75]},
{"id":"code-scope","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[510,37.5],"size":[180,75]},
{"id":"code-architecture","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[780,37.5],"size":[180,75]},
{"id":"code-ui-ux","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[1005,457.5],"size":[180,75]},
{"id":"code-planning","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[780,877.5],"size":[180,75]},
{"id":"code-delivery","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[510,877.5],"size":[180,75]},
{"id":"code-uat","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[240,877.5],"size":[180,75]},
{"id":"code-security","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[15,457.5],"size":[180,75]},
{"id":"code-releases","type":"frontend","label":"Code agent","sublabel":"Human-controlled","pos":[240,37.5],"size":[180,75]}
],
"connections": [
{"id":"govern-scope","from":"agent","to":"scope","label":"","variant":"security","fromSide":"right","toSide":"bottom","via":[[750,495],[750,292.5],[600,292.5]]},
{"id":"govern-architecture","from":"agent","to":"architecture","label":"","variant":"security","fromSide":"right","toSide":"bottom","via":[[765,495],[765,345],[870,345]]},
{"id":"govern-ui-ux","from":"agent","to":"ui-ux","label":"","variant":"security","fromSide":"right","toSide":"left"},
{"id":"govern-planning","from":"agent","to":"planning","label":"","variant":"security","fromSide":"right","toSide":"top","via":[[765,495],[765,690],[870,690]]},
{"id":"govern-delivery","from":"agent","to":"delivery","label":"","variant":"security","fromSide":"bottom","toSide":"top"},
{"id":"govern-uat","from":"agent","to":"uat","label":"","variant":"security","fromSide":"left","toSide":"top","via":[[435,495],[435,690],[330,690]]},
{"id":"govern-security","from":"agent","to":"security","label":"","variant":"security","fromSide":"left","toSide":"right"},
{"id":"govern-releases","from":"agent","to":"releases","label":"","variant":"security","fromSide":"left","toSide":"bottom","via":[[435,495],[435,345],[330,345]]},
{"id":"stage-1","from":"scope","to":"architecture","label":"Then","variant":"emphasis","fromSide":"right","toSide":"left"},
{"id":"stage-2","from":"architecture","to":"ui-ux","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-3","from":"ui-ux","to":"planning","label":"Then","variant":"emphasis","fromSide":"bottom","toSide":"top"},
{"id":"stage-4","from":"planning","to":"delivery","label":"Then","variant":"emphasis","fromSide":"left","toSide":"right"},
{"id":"stage-5","from":"delivery","to":"uat","label":"Then","variant":"emphasis","fromSide":"left","toSide":"right"},
{"id":"stage-6","from":"uat","to":"security","label":"Then","variant":"emphasis","fromSide":"top","toSide":"bottom"},
{"id":"stage-7","from":"security","to":"releases","label":"Then","variant":"emphasis","fromSide":"top","toSide":"bottom"},
{"id":"stage-8","from":"releases","to":"scope","label":"Repeat indefinitely","variant":"emphasis","fromSide":"right","toSide":"left","labelAt":[465,170]},
{"id":"contribute-scope","from":"code-scope","to":"scope","label":"Contribute","variant":"dashed","fromSide":"bottom","toSide":"top"},
{"id":"contribute-architecture","from":"code-architecture","to":"architecture","label":"Contribute","variant":"dashed","fromSide":"bottom","toSide":"top"},
{"id":"contribute-ui-ux","from":"code-ui-ux","to":"ui-ux","label":"Contribute","variant":"dashed","fromSide":"left","toSide":"right","labelAt":[990,570]},
{"id":"contribute-planning","from":"code-planning","to":"planning","label":"Contribute","variant":"dashed","fromSide":"top","toSide":"bottom"},
{"id":"contribute-delivery","from":"code-delivery","to":"delivery","label":"Contribute","variant":"dashed","fromSide":"top","toSide":"bottom"},
{"id":"contribute-uat","from":"code-uat","to":"uat","label":"Contribute","variant":"dashed","fromSide":"top","toSide":"bottom"},
{"id":"contribute-security","from":"code-security","to":"security","label":"Contribute","variant":"dashed","fromSide":"right","toSide":"left","labelAt":[220,570]},
{"id":"contribute-releases","from":"code-releases","to":"releases","label":"Contribute","variant":"dashed","fromSide":"bottom","toSide":"top"}
]
}
+26 -3
View File
@@ -1,20 +1,39 @@
---
id: index
title: AI adoption strategy
description: Govern skills first; outcomes before activity; explicit target status.
description: An autonomous SDLC cycle directed, guided and reviewed by humans, supported by governed skills.
slug: /
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## Autonomous SDLC, human direction
<ArchifyDiagram name="strategy-target" title="Autonomous agent executes and governs the SDLC; humans direct, guide and review" story />
An autonomous agent executes and governs every phase. Humans direct, guide and review it; a separate human-controlled code agent contributes to each phase from outside the cycle.
**Solid arrows:** lifecycle · **Dotted spokes:** execution and governance · **Dashed arrows:** contributions.
**Scope → Architecture → UI/UX → Planning → Delivery → UAT → Security → Releases → Scope**
Releases returns to Scope and the cycle repeats indefinitely. Governed skills and measured outcomes support the path toward this target; they are not a substitute for it.
<details>
<summary>Strategy rationale and reading map</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
### Govern skills first, expand authority only with evidence
Eldorado's target is to make AI-assisted work dependable across the organization: useful guidance, clear human ownership, controlled execution and measurable outcomes. The first investment is a governed skills system, not an autonomous replacement for the organization. A skill packages reusable working knowledge, prerequisites and verification steps. It helps an agent perform a task; it does not grant permission or guarantee that the work is correct.
The target combines one logical SDLC coordinating agent with developer choice on local laptops. Copilot, Claude Code and Cline remain client options within a qualified support matrix. They receive the same reviewed portable skill content through client-specific adapters. Repository, CI and release services remain the enforcement points, independently of what any agent says or which local tool produced a change.
The target combines an autonomous agent executing and governing the SDLC with humans directing, guiding and reviewing it. Developer choice on local laptops remains a supporting option: Copilot, Claude Code and Cline can receive reviewed portable skill content through qualified adapters. Repository, CI and release controls support execution; detailed approval policies remain implementation decisions, not new roles established by this strategy.
The strategy describes the intended operating model and the evidence required to introduce it. It does not establish that these controls are installed, that every client is supported, or that AI has improved Eldorado's performance. The current reference is the documented six-department organization. Rollout begins by validating actual clients, responsibilities, data boundaries and available evidence.
@@ -22,7 +41,7 @@ Success means accepted outcomes with maintained quality, controlled risk and und
## Navigate the strategy
- [Target operating model](./target-operating-model.mdx) — One logical coordinator; local client choice; independent authority; all departments.
- [Target operating model](./target-operating-model.mdx) — The autonomous SDLC cycle, with human direction, guidance and review.
- [Skills governance](./skills-governance.mdx) — Contract, lifecycle, decision rights, adapters, locking, exceptions.
- [Skills quality](./skills-quality.mdx) — Risk tiers, independent evaluation, repeated trials, adversarial conformance.
- [Skills adoption](./skills-adoption.mdx) — Workflow-led coaching, client choice, feedback, manual path.
@@ -30,4 +49,8 @@ Success means accepted outcomes with maintained quality, controlled risk and und
- [Skills maintenance](./skills-maintenance.mdx) — Review, drift, deprecation, rollback and incident handling.
- [Roadmap](./roadmap.mdx) — Evidence-gated phases, no promised dates or budgets.
</details>
**Next:** [Explore the autonomous SDLC cycle →](./target-operating-model.mdx)
</div>
+33
View File
@@ -2,11 +2,30 @@
id: measurement
title: Measurement
description: Full KPI contracts, minimal events, illustrative calculations, privacy and limits.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## Is AI-assisted work worth continuing?
Judge accepted outcomes alongside quality, delivery flow, risk, cost and human experience. Validate source coverage before calculating; missing evidence is unknown, not success.
<ArchifyDiagram name="strategy-measurement" title="Collect evidence, validate it, calculate balanced measures and decide" story />
**Illustrative only:** 1 accepted task ÷ 4 matured starts × 100 = **25%** confirmed success. One unresolved task stays in the denominator; known-outcome coverage is **75%**. These are synthetic data, not Eldorado results.
- **16 contracts:** exact definitions below; 9 prototype calculations, 7 explicitly unimplemented metrics.
- **Balanced evidence:** no productivity rankings, composite score or causal ROI claim.
- **Privacy first:** no raw prompts or code by default; protect small cohorts and agree retention before collection.
<details>
<summary>Collection, baseline, event and privacy contracts</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
### Decide what counts before counting
@@ -33,6 +52,11 @@ Many-to-many task/attempt/skill/client associations preserve exact immutable ver
The privacy starting proposal is 30 days for raw structured analytics events and 12 months for aggregated trends, subject to the responsible owners' review. Keep the approved catalog/approval record for the supported revision's lifetime and its required audit period, which must be decided separately. Incident evidence uses a restricted, explicitly authorized hold and deletion schedule, not an indefinite analytics exception. Suppress reports below five people and prohibit drill-down or overlapping cohort slices that reconstruct identities. Five is a proposed minimum, not a guarantee against re-identification. No raw prompts, code, screens, customer cases or secrets are collected by default. Publish the purpose, lawful collection basis, access/deletion route and retention before collecting. Consent is not presumed to be an appropriate employment-law basis.
</details>
<details>
<summary>All 16 KPI contracts — formulas, populations, owners and limits</summary>
## Metric contracts
Each contract is a prospective collection design. No live source or observed baseline is established. N and D refer to the numerator and denominator shown for that metric.
@@ -341,6 +365,11 @@ Independently accepted domain outcomes against a predeclared business rubric, se
| Gaming and limits | Weaken rubric or count drafts as customer benefit; lock rubric and independently audit acceptance. Descriptive signal, not causal AI productivity attribution. Source completeness, task mix and sampling limit inference; report uncertainty. Domain owner signs acceptance: Operations service accuracy; Marketing claims/rights; Finance reconciliation accuracy; HR policy correctness; Product usability/value. Not revenue uplift. |
</details>
<details>
<summary>Run the nine-metric synthetic prototype and inspect omissions</summary>
## Run the synthetic measurement example
**Executed synthetic example — not Eldorado results.** The bundled fixture produces 1 independently accepted task from 4 matured starts: 25% confirmed success. One unresolved task remains in that denominator; known-outcome coverage is 75%. Selection precision and recall are each 1 / 2 = 50%. Allocated synthetic cost is EUR 60 / 1 accepted outcome = EUR 60 per accepted outcome. These deliberately small samples demonstrate arithmetic and missingness, not a baseline, target or ROI claim.
@@ -349,4 +378,8 @@ From the private documentation checkout, run `node scripts/ai-kpi.mjs` and `node
The executable covers validated success, selection precision/recall, change fail and rework rates, escaped quality, policy effects, cost and human experience. Other catalog metrics remain contracts rather than implemented collectors; output lists the omissions. Snapshot inputs are simplified, pre-reconciled records, not a production ingestion system. Conflicting duplicates reject the calculation rather than silently choosing a value.
</details>
**Next:** [Use findings to maintain, quarantine or replace skills →](./skills-maintenance.mdx)
</div>
+21
View File
@@ -2,11 +2,28 @@
id: roadmap
title: Roadmap
description: Evidence-gated phases, no promised dates or budgets.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## What must be true before widening the rollout?
Advance by exit evidence, not promised dates or usage volume. Each stage can hold, narrow or stop; changed client, data or authority boundaries reopen earlier gates.
<ArchifyDiagram name="strategy-roadmap" title="Foundation, pilot, reliable distribution, coordination and departmental expansion have exit gates" story />
- **Start bounded:** named people, lawful data handling and a reproducible baseline precede the pilot.
- **Prove recovery before coordination:** verified versions, revocation and human takeover are prerequisites.
- **Expand by department:** accepted outcomes, guardrails, total cost and experience justify continuation; sensitive decisions remain human.
<details>
<summary>Stage-by-stage entry evidence, work, exit gates and hold conditions</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
### Foundation
@@ -51,4 +68,8 @@ description: Evidence-gated phases, no promised dates or budgets.
There are no invented launch dates, budgets, staffing commitments or guaranteed gains. Phase gates permit narrowing or stopping. Re-evaluate earlier phases when the underlying client, provider, data scope or authority changes.
</details>
**Next:** [Return to the strategy destination →](./index.mdx)
</div>
+21
View File
@@ -2,11 +2,28 @@
id: skills-adoption
title: Skills adoption
description: Workflow-led coaching, client choice, feedback, manual path.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## When should a pilot become a team workflow?
Expand only when a bounded canary produces independently accepted work and useful feedback. Teach people to verify artifacts and recover without AI, not merely invoke a skill.
<ArchifyDiagram name="strategy-adoption" title="Choose a workflow, coach a canary, verify outcomes and improve before expansion" story />
- **Team-led:** the departmental owner defines the outcome; People &amp; Administration Squad supports learning.
- **Choice within support:** qualify the client path instead of promising identical agent behavior.
- **No adoption quotas:** retain a manual path; rejected suggestions and non-use are feedback, not poor performance.
<details>
<summary>Onboarding responsibilities, coaching and feedback safeguards</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
Start with a small set of useful workflows chosen by the existing teams. Product Management and the departmental owner identify the outcome; Data & AI helps turn it into a skill; Quality Engineering establishes acceptance; Platform & IT qualifies the client path; Architecture & Security clears the data boundary. People & Administration Squad coordinates learning and accessible feedback.
@@ -17,4 +34,8 @@ Use short worked examples, peer pairing, office hours and a clear catalog search
No developer rankings, individual productivity scores, minimum invocation quotas or inference of effort from token counts are part of this strategy. Report cohort-level evidence with privacy protection and balanced quality, flow, risk and cost. A participant may reasonably stop using a skill that creates more work or uncertainty.
</details>
**Next:** [Measure accepted outcomes, not activity →](./measurement.mdx)
</div>
+31
View File
@@ -2,11 +2,28 @@
id: skills-governance
title: Skills governance
description: Contract, lifecycle, decision rights, adapters, locking, exceptions.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## Who can approve a skill for use?
The owning team authors the skill; independent reviewers assess it before exact-revision approval. Data &amp; AI maintains the catalog, while Platform &amp; IT verifies distribution and revocation.
<ArchifyDiagram name="strategy-governance" title="An owner proposes; independent review and canary evidence precede approval" story />
- **Separate duties:** the author cannot provide the only approval; higher risk involves Architecture &amp; Security.
- **Pin the whole bundle:** content, adapters and executable dependencies travel together.
- **Keep controls authoritative:** exceptions expire and cannot bypass protected release, payment or identity controls.
<details>
<summary>Ownership, client qualification, exceptions and rollback</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
### A contract that travels, controls that stay authoritative
@@ -33,6 +50,11 @@ A cached verified bundle may support explicitly permitted low-risk work if its m
Rollback restores the approved manifest and dependencies, invalidates affected sessions, revokes unsafe revisions, runs a smoke test and verifies effective state. It cannot undo data disclosure or commands already executed. Those require incident response.
</details>
<details>
<summary>Catalog contract — required fields</summary>
## Catalog contract
| Contract | Definition |
@@ -59,6 +81,11 @@ Rollback restores the approved manifest and dependencies, invalidates affected s
| procedure | Prerequisites, bounded steps, expected artifacts, verification, failure handling, escalation |
</details>
<details>
<summary>Lifecycle transitions and required evidence</summary>
## Promotion and retirement
| Transition | Required evidence |
@@ -70,4 +97,8 @@ Rollback restores the approved manifest and dependencies, invalidates affected s
| any active state → quarantined | Incident or unsafe/unknown provenance; central deny immediately |
| quarantined → experimental | Reviewed correction; new immutable revision; requalify, never auto-restore approval |
</details>
**Next:** [See the evidence needed to qualify a skill →](./skills-quality.mdx)
</div>
+21
View File
@@ -2,11 +2,28 @@
id: skills-maintenance
title: Skills maintenance
description: Review, drift, deprecation, rollback and incident handling.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## What happens when a skill drifts or causes harm?
Monitor usefulness and safety throughout a revision's life. Unsafe behavior triggers containment; a correction returns through independent tests and approval, never automatic reinstatement.
<ArchifyDiagram name="strategy-maintenance" title="Monitor, triage and test corrections; promote safely or contain and roll back" story />
- **Named ownership:** Data &amp; AI coordinates catalog health with the owning teams.
- **Early triggers:** incidents and client, model or dependency changes override the calendar.
- **Recovery is verified:** rollback restores a known-good bundle; it cannot undo disclosure or past effects.
<details>
<summary>Review responsibilities, incident handling and proposed review intervals</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
Every approved skill has an accountable owning team, independent reviewer, review due date, supported client matrix and rollback bundle. Review both usefulness and safety, not just metadata freshness. Proposed maximum review intervals are recorded by risk tier; incidents, dependency changes, model/client drift or repeated failures trigger earlier review.
@@ -25,4 +42,8 @@ Owner ratification is required before adoption. Review earlier after incidents o
| R2 | 60 |
| R3 | 30 |
</details>
**Next:** [Use exit evidence to choose the next rollout stage →](./roadmap.mdx)
</div>
+26
View File
@@ -2,11 +2,28 @@
id: skills-quality
title: Skills quality
description: Risk tiers, independent evaluation, repeated trials, adversarial conformance.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
**TO-BE · Target operating model — not installed controls or company results.**
## What evidence is enough to promote a skill?
Risk determines the evaluation depth, not whether safety checks apply. Independent evidence must show useful outcomes and no failed mandatory gate before promotion.
<ArchifyDiagram name="strategy-quality" title="Classify risk, test independently, then pass every mandatory gate" story />
- **R1:** approved nonsensitive drafting. **R2:** code or customer-impacting material. **R3:** privileged or sensitive effects; human-authorized, outside initial autonomous scope.
- **No averaging away harm:** a critical unauthorized effect blocks promotion.
- **Proposed floors need owner ratification:** missing coverage or acceptance rules means qualification is incomplete.
<details>
<summary>Evaluation design, adversarial cases and interpretation</summary>
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
Quality has four separate questions: was the right skill selected, was the procedure executed safely, did the artifact pass independent checks, and did the workflow produce useful outcomes? A successful invocation answers none of the remaining questions by itself.
@@ -21,6 +38,11 @@ Include adversarial repository text, malicious referenced code, wrong permission
Report denominators, task mix, trial counts, per-client results and uncertainty. A passing benchmark is evidence within a tested envelope, not proof that all future tasks are safe. Material model, client, adapter or dependency changes trigger requalification.
</details>
<details>
<summary>Proposed R1 / R2 / R3 sample sizes and thresholds</summary>
## Proposed qualification floors
These are local design defaults for responsible-owner ratification, not approved service levels or guarantees. All mandatory checks must pass regardless of aggregate score.
@@ -57,4 +79,8 @@ These are local design defaults for responsible-owner ratification, not approved
Artifact success denominator is every planned executed trial, retaining failures and abandonment. Trials of same task are correlated: show per-task and per-client strata; do not inflate independent sample size. Selection floors use independent labels. Report 95% uncertainty intervals clustered by task for outcome comparisons; no regression versus current approved path beyond a preregistered owner-approved margin. Missing margin/precision rule prevents promotion.
</details>
**Next:** [Introduce qualified skills through a bounded pilot →](./skills-adoption.mdx)
</div>
+40 -10
View File
@@ -1,34 +1,53 @@
---
id: target-operating-model
title: Target operating model
description: One logical coordinator; local client choice; independent authority; all departments.
sidebar_label: Target
description: An autonomous agent executes and governs the SDLC; humans direct, guide and review the repeating cycle.
hide_table_of_contents: true
---
import ArchifyDiagram from '@site/src/components/ArchifyDiagram';
<div className="strategy-content">
## Coordination without transferred authority
**TO-BE · Target operating model — the intended strategy, not a deployed system.**
The diagram is an overview; the equivalent delivery path below remains readable on narrow screens. Expand the diagram to inspect its trust boundaries and use its zoom controls for individual relationships.
## Autonomous SDLC, human direction
1. Accountable people authorize the work scope; one logical coordinator routes tasks.
<ArchifyDiagram name="strategy-target" title="Autonomous agent executes and governs the SDLC; humans direct, guide and review" story />
An autonomous agent executes and governs every phase. Humans direct, guide and review it; a separate human-controlled code agent contributes to each phase from outside the cycle.
**Solid arrows:** lifecycle · **Dotted spokes:** execution and governance · **Dashed arrows:** contributions.
**Scope → Architecture → UI/UX → Planning → Delivery → UAT → Security → Releases → Scope**
Each stage follows the previous one. Releases returns to Scope; the cycle repeats indefinitely, with human direction informing the next iteration.
<details>
<summary>Supporting implementation options: trust boundaries and recovery</summary>
## Controls that support autonomous execution
The lifecycle above is the strategic direction. The earlier control design below is a supporting implementation option, not an agreed assignment of approval roles or a claim of installed controls. Detailed approval policy and responsibilities remain to be defined with humans.
1. Humans direct, guide and review; the autonomous agent executes and governs work across the lifecycle.
2. The reviewed registry supplies pinned skills and qualified adapters to coordinator and local clients.
3. Laptop contributors propose changes; independent repository and CI checks verify the exact revision.
4. A human approves that artifact; only the release service holds production credentials.
5. Restricted audit and measurement evidence returns to people and informs the next authorized task.
3. Laptop contributors can participate alongside the agent; independent repository and CI checks verify the exact revision.
4. A separate release service and artifact-scoped approval are possible controls, subject to the policy humans define.
5. Restricted audit and measurement evidence supports human review and the next Scope iteration.
<ArchifyDiagram name="ai-adoption-target" title="TO-BE AI adoption: human accountability, no direct production authority for laptops or coordinator" />
<ArchifyDiagram name="ai-adoption-target" title="Supporting control option, not agreed approval policy: isolated release authority" />
**TO-BE · Target operating model.** Introduction depends on the [roadmap gates](./roadmap.mdx); these pages do not describe installed controls or measured company results.
### One coordination function, distributed contributions
Data & AI owns the coordinating function, with the existing AI Architect function connecting it to Technology leadership. The logical coordinator maintains approved work records, dependencies, evidence requests, bounded retries and escalation. It can summarize, propose work and route decisions. It cannot declare its own work approved, change protected checks, authorize production release or replace the responsible human.
The autonomous agent is more than a task router: it executes and governs the repeating SDLC under human direction, guidance and review. A coordinating function maintains work records, dependencies, evidence requests, bounded retries and escalation. Data & AI and the existing AI Architect function are possible implementation contributors, not newly assigned approval authorities. Autonomous execution does not remove human involvement or allow the agent to redefine its own controls.
One logical coordinator does not mean one fragile process. A durable task ledger, explicit state transitions, leases and idempotency keys allow recovery or multiple replicas without duplicate delivery. Inference outages stop new agent decisions, not the organization's ability to take over. People can resume work through the normal deterministic workflow. Evidence and authorization services fail closed for privileged actions; missing evidence never becomes permission.
The delivery path is: an approved problem and acceptance criteria; an authorized task; local or isolated worker proposals; independently reviewed repository changes; exact-revision CI evidence; a human release decision; execution by the release service; then operational feedback. Product Management accepts the outcome hypothesis and business result. Product Design reviews experience and accessibility. Product Engineering owns the code and maintainability. Quality Engineering assesses quality independently. Architecture & Security assesses risk. Platform & IT operates the delivery boundary. No arrow from a laptop or coordinator goes directly to production authority.
These controls support the sequence Scope → Architecture → UI/UX → Planning → Delivery → UAT → Security → Releases → Scope; they do not replace it with a separate lifecycle. Product, engineering, design, quality, security and platform expertise inform human direction and review. Specific approval assignments and release permissions are implementation decisions still to be defined.
### Trust and authority boundaries
@@ -38,8 +57,15 @@ The registry distributes reviewed immutable content and adapters, not ambient cr
Central controls verify protected-branch review, actual artifact identity, exact commit and policy revision, required checks and a scoped human approval. Candidate changes cannot edit their own authoritative gate or reuse approval for a different artifact. Deployment credentials belong to the release service, not the local agent. Approval expires or is invalidated by changed content. Emergency stop revokes mutation credentials and stops scheduling independently of the model, preserves evidence and enables human takeover.
</details>
<details>
<summary>Candidate contributions and first workflows for all eleven teams</summary>
### Department contributions
The existing team structure provides a starting point. The contributions below are implementation proposals, not settled approval roles or lifecycle gates.
### Product / Product Management
**Contribution and retained human decision** — Own pilot priorities, acceptance criteria and outcome hypotheses; decide product value.
@@ -110,4 +136,8 @@ Product keeps two teams; Technology keeps five; the other four departments keep
See the existing [organization structure](/organization/structure/), [department collaboration](/organization/collaboration/) and [SDLC responsibilities](/organization/sdlc/).
</details>
**Next:** [Decide who owns and approves each skill →](./skills-governance.mdx)
</div>
+8 -1
View File
@@ -15,11 +15,13 @@
"verify:build": "node scripts/verify.mjs --build",
"diagrams:build": "node scripts/build-diagrams.mjs",
"test": "node --test scripts/*.test.mjs",
"test:browser": "node scripts/browser/strategy-story.cjs && node scripts/browser/inline-controls.cjs && node scripts/browser/sdlc-cycle.cjs",
"kpi:example": "node scripts/ai-kpi.mjs"
},
"dependencies": {
"@docusaurus/core": "3.10.2",
"@docusaurus/preset-classic": "3.10.2",
"@docusaurus/theme-common": "3.10.2",
"@easyops-cn/docusaurus-search-local": "0.55.3",
"@fontsource/lato": "5.2.6",
"@mdx-js/react": "3.1.1",
@@ -33,9 +35,14 @@
"@docusaurus/tsconfig": "3.10.2",
"@docusaurus/types": "3.10.2",
"@types/react": "19.1.13",
"playwright": "1.63.0",
"typescript": "5.9.3"
},
"pnpm": {"overrides": {"serialize-javascript": "7.0.5"}},
"pnpm": {
"overrides": {
"serialize-javascript": "7.0.5"
}
},
"browserslist": {
"production": [
">0.5%",
+22
View File
@@ -17,6 +17,9 @@ importers:
'@docusaurus/preset-classic':
specifier: 3.10.2
version: 3.10.2(@algolia/client-search@5.59.0)(@mdx-js/react@3.1.1(@types/react@19.1.13)(react@19.1.1))(@types/react@19.1.13)(postcss@8.5.28)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)(search-insights@2.17.3)(typescript@5.9.3)
'@docusaurus/theme-common':
specifier: 3.10.2
version: 3.10.2(@docusaurus/plugin-content-docs@3.10.2(@mdx-js/react@3.1.1(@types/react@19.1.13)(react@19.1.1))(postcss@8.5.28)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)(typescript@5.9.3))(postcss@8.5.28)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)
'@easyops-cn/docusaurus-search-local':
specifier: 0.55.3
version: 0.55.3(@docusaurus/theme-common@3.10.2(@docusaurus/plugin-content-docs@3.10.2(@mdx-js/react@3.1.1(@types/react@19.1.13)(react@19.1.1))(postcss@8.5.28)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)(typescript@5.9.3))(postcss@8.5.28)(react-dom@19.1.1(react@19.1.1))(react@19.1.1))(@mdx-js/react@3.1.1(@types/react@19.1.13)(react@19.1.1))(postcss@8.5.28)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)(typescript@5.9.3)
@@ -51,6 +54,9 @@ importers:
'@types/react':
specifier: 19.1.13
version: 19.1.13
playwright:
specifier: 1.63.0
version: 1.63.0
typescript:
specifier: 5.9.3
version: 5.9.3
@@ -3962,6 +3968,16 @@ packages:
resolution: {integrity: sha512-Oo/NZcSWccq8KyoG7gLE9fnltgHns+pNCjCAp/WmjsUySi+sX7y4z4Xqu4fVb42CDHzRPl33fjzT15V1wvcyhA==}
engines: {node: '>=16.0.0'}
playwright-core@1.63.0:
resolution: {integrity: sha512-rYCsBF/M5HjUch52bbtVONEFjv6Xu8sm8h72dNlR5bzIE1fvC/bxgspzkjSfU+MweEMmPM8KJebG6nnyxo5mCg==}
engines: {node: '>=20'}
hasBin: true
playwright@1.63.0:
resolution: {integrity: sha512-+7ziBLidS4NaNCdt57SUDT+wYmmd5fmiQejUic/kb+YsYSCPyOOE9sebzMjNmQrsnNpDJqd4WHvV/8lfKfUDUg==}
engines: {node: '>=20'}
hasBin: true
postcss-attribute-case-insensitive@7.0.1:
resolution: {integrity: sha512-Uai+SupNSqzlschRyNx3kbCTWgY/2hcwtHEI/ej2LJWc9JJ77qKgGptd8DHwY1mXtZ7Aoh4z4yxfwMBue9eNgw==}
engines: {node: '>=18'}
@@ -10793,6 +10809,12 @@ snapshots:
pvutils: 1.2.0
tslib: 2.8.1
playwright-core@1.63.0: {}
playwright@1.63.0:
dependencies:
playwright-core: 1.63.0
postcss-attribute-case-insensitive@7.0.1(postcss@8.5.28):
dependencies:
postcss: 8.5.28
+142
View File
@@ -0,0 +1,142 @@
const {chromium} = require('playwright');
const assert = require('node:assert/strict');
const fs = require('node:fs');
(async () => {
const base = process.argv[2] || 'http://127.0.0.1:4173';
const output = `.cache/inline-${process.argv[3] || 'local'}`;
fs.mkdirSync(output, {recursive: true});
const browser = await chromium.launch({headless: true, executablePath: process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE, args: ['--no-sandbox']});
const results = [];
try {
for (const width of [1440, 390, 320]) {
const context = await browser.newContext({viewport: {width, height: 1000}, colorScheme: 'light'});
const page = await context.newPage();
await page.goto(`${base}/eldorado-v1/documentation/strategy/`, {waitUntil: 'networkidle'});
const panel = page.locator('.archify-panel--story');
const iframe = panel.locator(width > 700 ? '.story-desktop' : '.story-mobile');
await iframe.scrollIntoViewIfNeeded();
const frame = await (await iframe.elementHandle()).contentFrame();
const theme = async value => {
await page.waitForFunction(t => document.documentElement.dataset.theme === t, value);
await frame.waitForFunction(t => document.documentElement.dataset.theme === t, value);
};
await theme('light');
for (const id of ['btn-theme', 'btn-preset', 'btn-export']) {
const box = await frame.locator(`#${id}`).boundingBox();
assert(box && box.width >= 40 && box.height >= 44, id);
}
const toolbar = await frame.locator('.toolbar').boundingBox();
const exportButton = await frame.locator('#btn-export').boundingBox();
const diagram = await frame.locator('.diagram-container > svg').boundingBox();
const rightGap = toolbar.x + toolbar.width - exportButton.x - exportButton.width;
assert(Math.abs(rightGap - 8) < 1, `toolbar right padding at ${width}: ${rightGap}`);
assert(diagram.y >= toolbar.y + toolbar.height, 'toolbar must stay above nodes');
const checkMenu = async selector => {
await frame.locator(selector).evaluate(n => Promise.all(n.getAnimations().map(a => a.finished)));
const menu = await frame.locator(selector).boundingBox();
const viewport = await iframe.boundingBox();
const currentToolbar = await frame.locator('.toolbar').boundingBox();
assert(menu && menu.x >= viewport.x - 1 && menu.y >= currentToolbar.y + currentToolbar.height - 1, selector);
assert(menu.x + menu.width <= viewport.x + viewport.width + 1, `${selector} clips horizontally`);
assert(menu.y + menu.height <= viewport.y + viewport.height + 1, `${selector} clips vertically`);
};
const light = await frame.locator('body').evaluate(n => getComputedStyle(n).backgroundColor);
await frame.locator('#btn-theme').click(); await theme('dark');
assert.notEqual(await frame.locator('body').evaluate(n => getComputedStyle(n).backgroundColor), light);
await frame.locator('#btn-theme').click(); await theme('light');
// Mobile portal theme control lives in the navigation drawer.
const portalTheme = async target => {
if (width <= 700) await page.getByRole('button', {name: 'Toggle navigation bar'}).click();
for (let attempt = 0; attempt < 3; attempt++) {
await page.getByRole('button', {name: /Switch between dark and light mode/}).filter({visible: true}).click();
if (await page.locator('html').getAttribute('data-theme') === target) break;
}
if (width <= 700) await page.getByRole('button', {name: 'Close navigation bar'}).click();
};
await portalTheme('dark'); await theme('dark');
await portalTheme('light'); await theme('light');
for (const preset of ['signal-flow', 'blueprint', 'editorial', 'classic']) {
await frame.locator('#btn-preset').click();
await checkMenu('.preset-menu');
await frame.locator(`[data-preset-value="${preset}"]`).click();
assert.equal(await frame.locator('html').getAttribute('data-preset'), preset);
}
// A theme change must not reload the iframe or lose the selected visual preset.
await frame.locator('#btn-preset').click();
await frame.locator('[data-preset-value="blueprint"]').click();
await portalTheme('dark'); await theme('dark');
assert.equal(await frame.locator('html').getAttribute('data-preset'), 'blueprint');
const exports = [];
for (const format of ['png', 'jpeg', 'webp', 'svg', 'svg-light', 'svg-dark', 'webm']) {
await frame.locator('#btn-export').click();
await checkMenu('.export-menu');
if (format === 'webm' && await frame.locator('[data-format="webm"]').isDisabled()) {
exports.push({format, unsupported: true});
await frame.locator('#btn-export').click();
continue;
}
console.log(`Export ${width} ${format}`);
const [download] = await Promise.all([
page.waitForEvent('download', {timeout: 60000}),
frame.locator(`[data-format="${format}"]`).click(),
]);
assert.equal(await download.failure(), null);
const path = `${output}/${width}-${format}-${download.suggestedFilename()}`;
await download.saveAs(path);
const bytes = fs.readFileSync(path);
assert(bytes.length > 1000);
if (format.startsWith('svg')) {
const valid = await page.evaluate(xml => {
const doc = new DOMParser().parseFromString(xml, 'image/svg+xml');
if (doc.querySelector('[data-node-id="humans"], [data-edge-id="human-direction"]')) return false;
if (![...doc.querySelectorAll('[data-node-id="agent"] text')].some(n => n.textContent === 'Human Controlled')) return false;
if (doc.querySelectorAll('[data-node-id]').length !== 17 || doc.querySelectorAll('path[data-edge-id]').length !== 24) return false;
return !doc.querySelector('parsererror') && doc.documentElement.localName === 'svg' && doc.querySelectorAll('text').length > 0 && doc.querySelector('#eldorado-cycle-export')?.textContent.includes('stroke-dasharray: 3 9');
}, bytes.toString());
assert(valid, format);
} else {
const mime = {png:'image/png', jpeg:'image/jpeg', webp:'image/webp', webm:'video/webm'}[format];
const dimensions = await page.evaluate(async ({data, mime}) => {
const media = document.createElement(mime.startsWith('video') ? 'video' : 'img');
const loaded = new Promise((resolve, reject) => {media[mime.startsWith('video') ? 'onloadedmetadata' : 'onload'] = resolve; media.onerror = reject;});
media.src = `data:${mime};base64,${data}`; await loaded;
return [media.videoWidth || media.naturalWidth, media.videoHeight || media.naturalHeight];
}, {data: bytes.toString('base64'), mime});
assert(dimensions.every(n => n > 0), format);
}
exports.push({format, path, bytes:bytes.length});
}
const opener = panel.getByRole('button', {name:/^Expand /});
await opener.click();
let full = await (await panel.locator('dialog iframe').elementHandle()).contentFrame();
await full.waitForFunction(() => document.documentElement.dataset.theme === 'dark');
await full.locator('#btn-theme').click(); await theme('light');
const close = panel.getByRole('button', {name:'Close full-screen diagram'});
assert.equal(await close.innerText(), '×');
await close.click(); assert(await opener.evaluate(n => n === document.activeElement));
await opener.click();
full = await (await panel.locator('dialog iframe').elementHandle()).contentFrame();
await full.waitForFunction(() => document.documentElement.dataset.theme === 'light');
await close.focus(); await page.keyboard.press('Escape');
assert(await opener.evaluate(n => n === document.activeElement));
await iframe.scrollIntoViewIfNeeded();
await page.evaluate(() => scrollTo({top: 0, behavior: 'instant'}));
await page.evaluate(() => new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve))));
await page.screenshot({path:`${output}/${width}.png`, fullPage:true});
await frame.locator('#btn-theme').click(); await theme('dark');
// Exercise keyboard navigation without racing the portal's smooth scroll.
await page.locator('.strategy-content a[href$="/strategy/target-operating-model/"]').filter({visible:true}).focus();
await page.keyboard.press('Enter');
await page.waitForURL('**/strategy/target-operating-model/');
await page.getByRole('heading', {name:'Target operating model', exact:true, level:1}).waitFor();
const next = page.locator(`.archify-panel--story[data-diagram="strategy-target"] > .story-${width > 700 ? 'desktop' : 'mobile'}`);
await next.scrollIntoViewIfNeeded();
await (await (await next.elementHandle()).contentFrame()).waitForFunction(() => document.documentElement.dataset.theme === 'dark');
assert(!await page.evaluate(() => document.documentElement.scrollWidth > innerWidth));
results.push({width, toolbar, rightGap, dropdownsUnclipped:true, themeSync:true, presets:4, exports, fullscreen:true, routeTheme:true});
fs.writeFileSync(`${output}/results.json`, JSON.stringify(results,null,2));
await context.close();
}
console.log(`PASS ${results.length} viewports: bidirectional themes, 4 presets, all supported exports decoded, fullscreen and route persistence`);
} finally {await browser.close();}
})().catch(error => {console.error(error); process.exitCode = 1;});
+77
View File
@@ -0,0 +1,77 @@
const {chromium} = require('playwright');
const assert = require('node:assert/strict');
const fs = require('node:fs');
(async () => {
const base = process.argv[2] || 'http://127.0.0.1:4173';
const output = `.cache/cycle-${process.argv[3] || 'local'}`;
fs.mkdirSync(output, {recursive:true});
const browser = await chromium.launch({headless:true, executablePath:process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE, args:['--no-sandbox']});
const results = [];
try {
for (const width of [1440, 390, 320]) {
const context = await browser.newContext({viewport:{width,height:1000}, colorScheme:'light'});
const page = await context.newPage();
await page.goto(`${base}/eldorado-v1/documentation/`, {waitUntil:'networkidle'});
if (width < 700) await page.getByRole('button', {name:'Toggle navigation bar'}).click();
const nav = page.getByRole('link', {name:'Strategy', exact:true}).filter({visible:true});
assert((await nav.getAttribute('href')).endsWith('/strategy/target-operating-model/'));
await nav.click();
await page.waitForURL('**/strategy/target-operating-model/');
for (const route of ['target-operating-model/', '']) {
await page.goto(`${base}/eldorado-v1/documentation/strategy/${route}`, {waitUntil:'networkidle'});
if (width === 1440) assert.equal(await page.locator('.theme-doc-sidebar-menu .menu__link').first().innerText(), 'Target');
const iframe = page.locator(`.archify-panel--story > .story-${width > 700 ? 'desktop' : 'mobile'}`);
await iframe.scrollIntoViewIfNeeded();
const frame = await (await iframe.elementHandle()).contentFrame();
await frame.locator('svg[role="img"]').waitFor();
const metrics = await frame.evaluate(() => {
const svg = document.querySelector('svg[role="img"]');
const labels = [...svg.querySelectorAll('text[data-node-label]')].map(n => ({text:n.textContent,px:parseFloat(getComputedStyle(n).fontSize)*n.getScreenCTM().a}));
const edges = [...svg.querySelectorAll('path[data-edge-id^="stage-"]')].map(n => [n.dataset.edgeFrom,n.dataset.edgeTo,n.getAttribute('marker-end')]);
const overflow = [...svg.querySelectorAll('[data-node-id]')].flatMap(n => {
const box = n.querySelector('rect').getBoundingClientRect();
return [...n.querySelectorAll('text')].filter(t => {const b=t.getBoundingClientRect();return b.left<box.left||b.right>box.right||b.top<box.top||b.bottom>box.bottom;}).map(t=>t.textContent);
});
const relationships = [...svg.querySelectorAll('path[data-edge-id]')].map(n => ({id:n.dataset.edgeId,from:n.dataset.edgeFrom,to:n.dataset.edgeTo,dash:getComputedStyle(n).strokeDasharray,arrow:n.getAttribute('marker-end')}));
const nodes = [...svg.querySelectorAll('[data-node-id]')].map(n => {const r=n.querySelector('rect').getBoundingClientRect();return {id:n.dataset.nodeId,x:r.x+r.width/2,y:r.y+r.height/2};});
return {labels,edges,overflow,relationships,nodes};
});
const ids = ['scope','architecture','ui-ux','planning','delivery','uat','security','releases'];
assert.deepEqual(metrics.edges.map(e=>e.slice(0,2)), ids.map((id,i)=>[id,ids[(i+1)%ids.length]]));
assert(metrics.edges.every(e=>e[2]?.startsWith('url(')), 'all stages must have arrowheads');
assert.equal(metrics.nodes.length, 17);
assert(!metrics.nodes.some(n=>n.id==='humans'));
assert.equal(await frame.locator('[data-node-id="agent"] text').allTextContents().then(texts=>texts.includes('Human Controlled')), true);
assert.equal(metrics.relationships.length, 24);
const governs = metrics.relationships.filter(e=>e.id.startsWith('govern-'));
const contributions = metrics.relationships.filter(e=>e.id.startsWith('contribute-'));
assert.deepEqual(governs.map(e=>[e.from,e.to]), ids.map(id=>['agent',id]));
assert.deepEqual(contributions.map(e=>[e.from,e.to]), ids.map(id=>[`code-${id}`,id]));
assert(governs.every(e=>e.dash==='3px, 9px' && e.arrow?.startsWith('url(')));
assert(contributions.every(e=>e.dash==='12px, 8px' && e.arrow?.startsWith('url(')));
assert(!metrics.relationships.some(e=>e.id==='human-direction' || e.from==='humans' || e.to==='humans'));
if (width > 700) {
const agent = metrics.nodes.find(n=>n.id==='agent');
const phases = metrics.nodes.filter(n=>ids.includes(n.id));
for (const axis of ['x','y']) assert(Math.abs(agent[axis]-(Math.min(...phases.map(n=>n[axis]))+Math.max(...phases.map(n=>n[axis])))/2)<1);
for (const id of ids) {
const phase=phases.find(n=>n.id===id), code=metrics.nodes.find(n=>n.id===`code-${id}`);
assert(Math.hypot(code.x-agent.x,code.y-agent.y)>Math.hypot(phase.x-agent.x,phase.y-agent.y));
}
}
assert(metrics.labels.every(n=>n.px>=14), JSON.stringify(metrics.labels));
assert.deepEqual(metrics.overflow, []);
assert(!await page.evaluate(()=>document.documentElement.scrollWidth>innerWidth));
await page.evaluate(()=>scrollTo({top:0,behavior:'instant'}));
await page.waitForFunction(()=>scrollY===0);
await page.evaluate(()=>new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve))));
await page.screenshot({path:`${output}/${width}-${route ? 'target' : 'landing'}.png`,fullPage:true});
results.push({width,route,...metrics});
fs.writeFileSync(`${output}/results.json`,JSON.stringify(results,null,2));
}
await context.close();
}
assert.equal(results.length,6);
console.log('PASS 6 cycle routes/viewports: navigation, sidebar order, exact directed loop, arrowheads, >=14px labels, text bounds and no overflow');
} finally {await browser.close();}
})().catch(error=>{console.error(error);process.exitCode=1;});
+46
View File
@@ -0,0 +1,46 @@
const {chromium}=require('playwright');
const assert=require('node:assert/strict');
const fs=require('node:fs');
(async()=>{
const base=process.argv[2]||'http://127.0.0.1:4173';
const label=process.argv[3]||'accepted';
const browser=await chromium.launch({headless:true,executablePath:process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE,args:['--no-sandbox']});
const results=[];fs.mkdirSync(`.cache/story-${label}`,{recursive:true});
try{
for(const width of [1440,390]){
const context=await browser.newContext({viewport:{width,height:1000}});
const page=await context.newPage();
for(const id of ['index','target-operating-model','skills-governance','skills-quality','skills-adoption','measurement','skills-maintenance','roadmap']){
const response=await page.goto(`${base}/eldorado-v1/documentation/strategy/${id==='index'?'':id+'/'}`,{waitUntil:'networkidle'});assert.equal(response.status(),200);
const panel=page.locator('.archify-panel--story');
const iframe=panel.locator(width===390?'.story-mobile':'.story-desktop');await iframe.scrollIntoViewIfNeeded();
const frame=await (await iframe.elementHandle()).contentFrame();await frame.locator('svg[role="img"]').waitFor();
const geometry=await frame.locator('svg[role="img"]').evaluate(svg=>{
const nodes=[...svg.querySelectorAll('[data-node-id]')].map(n=>{const r=n.getBoundingClientRect();return {id:n.id,x:r.x,y:r.y,right:r.right,bottom:r.bottom};});
return {width:innerWidth,height:innerHeight,nodes,svg:svg.getBoundingClientRect().toJSON(),minLabel:Math.min(...[...svg.querySelectorAll('text[data-node-label]')].map(n=>parseFloat(getComputedStyle(n).fontSize)*n.getScreenCTM().a))};
});
assert(geometry.nodes.length>=5 && geometry.nodes.length<=(['index','target-operating-model'].includes(id)?18:7),id);
for(const n of geometry.nodes) assert(n.x>=0 && n.y>=0 && n.right<=geometry.width+1 && n.bottom<=geometry.height+1,`${id} ${width} clipped ${JSON.stringify(n)} / ${geometry.height}`);
const data=await page.locator('.strategy-content').evaluate(el=>({words:el.innerText.trim().split(/\s+/).length,overflow:document.documentElement.scrollWidth>innerWidth,openDetails:el.querySelectorAll('details[open]').length}));
assert(data.words<=200,id);assert(!data.overflow,id);assert.equal(data.openDetails,0,id);
await page.evaluate(()=>scrollTo({top:0,behavior:'instant'}));await page.screenshot({path:`.cache/story-${label}/${width}-${id}.png`,fullPage:true});
const opener=panel.getByRole('button',{name:/^Expand /});await opener.click();
const close=panel.getByRole('button',{name:'Close full-screen diagram',exact:true});await close.waitFor({state:'visible'});
assert.equal(await close.innerText(),'×');assert(await close.evaluate(n=>n===document.activeElement));
const box=await close.boundingBox();assert.equal(box.width,44);assert.equal(box.height,44);
await close.click();assert(await opener.evaluate(n=>n===document.activeElement));
await opener.click();await close.waitFor({state:'visible'});await page.keyboard.press('Escape');await page.waitForFunction(()=>!document.querySelector('.archify-panel--story dialog').open);assert(await opener.evaluate(n=>n===document.activeElement));
const summary=page.locator('.strategy-content > details > summary').first();
await summary.focus();await page.keyboard.press('Enter');
await page.waitForFunction(()=>document.querySelector('.strategy-content > details').open);
await page.keyboard.press('Enter');
results.push({id,width,...data,geometry,modalClick:true,modalEscape:true,focusRestored:true,details:true});fs.writeFileSync(`.cache/story-${label}/results.json`,JSON.stringify(results,null,2));
}
await page.goto(`${base}/eldorado-v1/documentation/strategy/measurement/#validated-task-success`,{waitUntil:'networkidle'});
const heading=page.locator('#validated-task-success');await heading.waitFor({state:'visible'});
assert(await heading.evaluate(n=>n.closest('details').open),'hash should open metric reference');
await context.close();
}
console.log(`PASS ${results.length} desktop/mobile cases, clipping, default word count, details, modal click/Escape/focus and KPI hash navigation`);
} finally {await browser.close();}
})().catch(e=>{console.error(e);process.exitCode=1});
+26 -1
View File
@@ -1,8 +1,11 @@
import {readdirSync, readFileSync, mkdirSync, copyFileSync, renameSync, rmSync} from 'node:fs';
import {readdirSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, renameSync, rmSync} from 'node:fs';
import {join} from 'node:path';
import {execFileSync} from 'node:child_process';
const cli = 'vendor/archify/bin/archify.mjs';
const types = new Set(['architecture','workflow','sequence','dataflow','lifecycle']);
const inlineStyles = readFileSync(new URL('./inline-viewer.css', import.meta.url), 'utf8');
const cycleStyles = readFileSync(new URL('./cycle-viewer.css', import.meta.url), 'utf8');
const themeBridge = readFileSync(new URL('./viewer-theme-bridge.js', import.meta.url), 'utf8');
// This directory is generated-only and ignored by Git. Remove stale artifacts.
rmSync('static/diagrams', {recursive: true, force: true});
mkdirSync('static/diagrams', {recursive: true});
@@ -23,6 +26,28 @@ for (const file of readdirSync('diagrams').sort()) {
run(['validate',type,input,'--quality','showcase','--json']);
run(['deliver',type,input,output,'--quality','showcase','--json']);
run(['check',output,'--json','--require-provenance']);
// Verify the upstream artifact first, then add the scoped portal integration.
let viewer = readFileSync(output, 'utf8');
// Upstream intentionally disables preset selection in gallery embeds. Enable
// only those two guards; fail closed if a future vendor update changes them.
const start = viewer.indexOf('Archify.preset = (function () {');
const end = viewer.indexOf('Archify.theme = (function () {', start);
const preset = viewer.slice(start, end);
const guard = "if (html.getAttribute('data-embed') === 'true') return false;";
if (start < 0 || end < start || preset.split(guard).length !== 3) throw new Error('Archify preset integration drift');
viewer = viewer.slice(0, start) + preset.replaceAll(guard, '') + viewer.slice(end);
if (!viewer.includes('</head>') || !viewer.includes('</body>')) throw new Error(`Invalid viewer: ${output}`);
const storyStyles = ['strategy-target', 'strategy-target-mobile'].includes(name)
? `${name === 'strategy-target' ? ':root {--cycle-label: 27px; --cycle-detail: 21px;}' : ':root {--cycle-label: 38px; --cycle-detail: 28px;}'}${cycleStyles}` : '';
if (storyStyles) {
// Keep typography and relationship styles inside exported standalone SVGs.
const diagramRoot = /<svg\b[^>]*role="img"[^>]*>/g;
if ([...viewer.matchAll(diagramRoot)].length !== 1) throw new Error('Cycle SVG integration drift');
const exportStyles = storyStyles.replaceAll(':root', 'svg[role="img"]').replaceAll('.diagram-container > svg', 'svg[role="img"]');
viewer = viewer.replace(diagramRoot, root => `${root}<style id="eldorado-cycle-export">${exportStyles}</style>`);
}
writeFileSync(output, viewer.replace('</head>', `<style id="eldorado-inline-controls">${inlineStyles}</style><style id="eldorado-cycle-labels">${storyStyles}</style></head>`)
.replace('</body>', `<script>${themeBridge}</script></body>`));
renameSync(`static/diagrams/${name}/index.delivery.json`, `.cache/archify/${name}.delivery.json`);
}
copyFileSync('vendor/archify/LICENSE','static/diagrams/ARCHIFY-LICENSE.txt');
+19
View File
@@ -0,0 +1,19 @@
/* Readable lifecycle story at inline scale, isolated from other diagrams. */
.diagram-container > svg text {
font-family: Arial, sans-serif;
letter-spacing: 0;
font-size: 30px;
}
.diagram-container > svg text[data-node-label] {
font-size: var(--cycle-label);
transform: translateY(-6px);
}
.diagram-container > svg text[data-detail="context"] {
font-size: var(--cycle-detail);
transform: translateY(16px);
}
/* Edge semantics stay in SVG metadata; one page legend avoids repeated labels. */
.diagram-container > svg g[data-edge-id] {display: none;}
.diagram-container > svg path[data-edge-id^="stage-"] {stroke-width: 2.5;}
.diagram-container > svg path[data-edge-id^="govern-"] {stroke-dasharray: 3 9; stroke-width: 3;}
.diagram-container > svg path[data-edge-id^="contribute-"] {stroke-dasharray: 12 8; stroke-width: 3;}
+33
View File
@@ -0,0 +1,33 @@
/* Portal integration only; keep the upstream renderer and export code pinned. */
html[data-embed="true"] .toolbar {
display: flex !important;
position: relative;
inset: auto;
justify-content: flex-end;
height: 52px;
padding: 4px 8px;
box-sizing: border-box;
background: var(--bg);
}
html[data-embed="true"] #btn-present,
html[data-embed="true"] #btn-motion { display: none !important; }
html[data-embed="true"] .diagram-container > svg {
max-height: calc(100vh - 68px);
}
html[data-embed="true"] .toolbar .preset-menu,
html[data-embed="true"] .toolbar .export-menu {
position: fixed;
top: 52px;
left: auto;
right: 0;
width: min(320px, 100vw);
max-width: 100vw;
max-height: calc(100vh - 52px);
overflow-y: auto;
box-sizing: border-box;
}
/* Keep the preset menu in the iframe viewport without moving its capsule. */
html[data-embed="true"] .toolbar .export-wrap { position: static; }
html[data-embed="true"] .toolbar .export-menu { position: absolute; top: 100%; }
html[data-embed="true"] .toolbar .preset-menu button,
html[data-embed="true"] .toolbar .export-menu button { min-height: 44px; }
+51
View File
@@ -0,0 +1,51 @@
import {test} from 'node:test';
import assert from 'node:assert/strict';
import {readFileSync} from 'node:fs';
import {runInNewContext} from 'node:vm';
const read = path => readFileSync(path, 'utf8');
test('both story layouts permit downloads without weakening origin isolation', () => {
const wrapper = read('src/components/ArchifyDiagram/index.tsx');
for (const layout of ['desktop', 'mobile']) {
const iframe = wrapper.split(`<iframe className="story-${layout}"`)[1].split(' />')[0];
assert(iframe.includes('sandbox="allow-scripts allow-downloads"'));
assert(iframe.includes('?embed=1&theme=${initialTheme.current}'));
}
assert(!wrapper.includes('allow-same-origin'));
});
test('build adds maintained embed-only controls without changing pinned vendor', () => {
const build = read('scripts/build-diagrams.mjs');
assert(build.includes("new URL('./inline-viewer.css', import.meta.url)"));
assert(build.includes('eldorado-inline-controls'));
const css = read('scripts/inline-viewer.css');
assert(css.includes('html[data-embed="true"] .toolbar'));
assert(css.includes('display: flex !important'));
assert(css.includes('position: relative'));
assert(css.includes('max-height: calc(100vh - 52px)'));
});
test('theme bridge rejects unrelated senders/values and never echoes parent updates', () => {
const root = {dataset:{theme:'light'}};
let receive, observerCallback, mutations = 0;
const messages = [];
const parent = {postMessage: message => messages.push(message)};
const window = {parent, addEventListener: (type, callback) => {receive = callback;}};
const button = {click: () => {root.dataset.theme = root.dataset.theme === 'light' ? 'dark' : 'light'; mutations++;}};
class MutationObserver {
constructor(callback) {observerCallback = callback;}
observe() {}
takeRecords() {mutations = 0;}
}
runInNewContext(read('scripts/viewer-theme-bridge.js'), {window, document:{documentElement:root, getElementById: () => button}, MutationObserver});
const send = (source, theme) => receive({source, data:{type:'eldorado:set-theme', theme}});
send({}, 'dark'); send(parent, 'invalid');
assert.equal(root.dataset.theme, 'light');
send(parent, 'dark');
assert.equal(root.dataset.theme, 'dark');
assert.equal(mutations, 0);
assert.equal(messages.length, 0);
button.click(); observerCallback();
assert.equal(messages.length, 1);
assert.equal(messages[0].theme, 'light');
});
+10
View File
@@ -65,6 +65,16 @@ test('Archify is pinned, licensed and rebuilt, not a remote embed', () => {
assert(wrapper.includes('aria-hidden="true"'));
assert(read('src/css/custom.css').includes('justify-content: flex-end'));
});
test('full-screen close is cross-only with an accessible name and square touch target', () => {
const wrapper = read('src/components/ArchifyDiagram/index.tsx');
const button = wrapper.match(/<button[^>]*aria-label="Close full-screen diagram"[^>]*>(.*?)<\/button>/s);
assert(button, 'close button retains its accessible name');
assert.equal(button[1], '<span aria-hidden="true">×</span>');
assert(button[0].includes('autoFocus') && button[0].includes('onClick={close}'));
const styles = read('src/css/custom.css').match(/\.archify-modal-toolbar button \{([^}]+)\}/)[1];
assert(styles.includes('width: 44px') && styles.includes('height: 44px'));
assert(styles.includes('padding: 0') && styles.includes('flex-shrink: 0'));
});
test('Product owns two teams and Technology owns five separate teams', () => {
const spec = JSON.parse(read('diagrams/organization-structure.architecture.json'));
const page = read('docs/organization/structure.mdx');
+61
View File
@@ -0,0 +1,61 @@
import {test} from 'node:test';
import assert from 'node:assert/strict';
import {readFileSync} from 'node:fs';
const read = p => readFileSync(p, 'utf8');
const stages = ['Scope', 'Architecture', 'UI/UX', 'Planning', 'Delivery', 'UAT', 'Security', 'Releases'];
test('Strategy opens at the autonomous lifecycle, with a matching direct landing story', () => {
assert.match(read('sidebars/strategy.ts'), /strategySidebar: \['target-operating-model', 'index'/);
assert.match(read('docs/strategy/target-operating-model.mdx'), /^sidebar_label: Target$/m);
for (const id of ['index', 'target-operating-model']) {
const page = read(`docs/strategy/${id}.mdx`);
const primary = page.split('<details>')[0];
assert(primary.includes('name="strategy-target"'));
assert(primary.includes('autonomous agent'));
assert(primary.includes('direct, guide and review'));
assert(primary.includes('Scope → Architecture → UI/UX → Planning → Delivery → UAT → Security → Releases → Scope'));
assert(primary.includes('human-controlled code agent'));
assert(primary.includes('TO-BE'));
assert(!/only routes|People authorize|independent gates protect release/.test(primary));
}
});
test('both target diagrams have eight stages, eight governed phases and eight human-controlled contributors', () => {
for (const suffix of ['', '-mobile']) {
const d = JSON.parse(read(`diagrams/strategy-target${suffix}.architecture.json`));
const ids = stages.map(label => d.components.find(n => n.label === label)?.id);
assert(ids.every(Boolean));
assert.equal(new Set(ids).size, 8);
const flow = d.connections.filter(e => ids.includes(e.from) && ids.includes(e.to));
assert.deepEqual(flow.map(e => [e.from, e.to]), ids.map((id, i) => [id, ids[(i + 1) % ids.length]]));
assert.match(flow.at(-1).label, /Repeat/);
assert(d.components.some(n => n.id === 'agent' && n.label === 'Autonomous agent' && n.sublabel === 'Human Controlled'));
assert(!d.components.some(n => n.id === 'humans' || n.label === 'Humans'));
assert(!d.connections.some(e => e.id === 'human-direction' || e.from === 'humans' || e.to === 'humans'));
assert.equal(d.connections.length, 24);
assert.deepEqual(d.connections.filter(e => e.from === 'agent').map(e => e.to), ids);
const contributors = d.components.filter(n => n.id.startsWith('code-'));
assert.equal(contributors.length, 8);
assert(contributors.every(n => n.label === 'Code agent' && n.sublabel === 'Human-controlled'));
for (const id of ids) {
assert(d.connections.some(e => e.from === `code-${id}` && e.to === id && e.variant === 'dashed'));
assert(d.connections.some(e => e.from === 'agent' && e.to === id && e.variant === 'security'));
}
assert.equal(d.components.length, 17);
if (!suffix) {
const center = n => n.pos.map((v, i) => v + n.size[i] / 2);
const agent = center(d.components.find(n => n.id === 'agent'));
const phaseCenters = ids.map(id => center(d.components.find(n => n.id === id)));
for (const axis of [0, 1]) {
const values = phaseCenters.map(c => c[axis]);
assert.equal(agent[axis], (Math.min(...values) + Math.max(...values)) / 2);
}
for (const code of contributors) {
const phase = d.components.find(n => n.id === code.id.slice(5));
const distance = n => Math.hypot(...center(n).map((v, i) => v - agent[i]));
assert(distance(code) > distance(phase), `${code.id} is exterior`);
}
}
}
});
+48
View File
@@ -0,0 +1,48 @@
import {test} from 'node:test';
import assert from 'node:assert/strict';
import {readFileSync} from 'node:fs';
const read = p => readFileSync(p, 'utf8');
const model = JSON.parse(read('research/ai-adoption/strategy-model.json'));
test('every strategy page leads with a compact diagram story and closes its references', () => {
for (const {id} of model.pages) {
const page = read(`docs/strategy/${id}.mdx`);
const narrative = page.split('<div className="strategy-content">')[1].replace(/<details>[\s\S]*?<\/details>/g, '');
assert.equal((narrative.match(/<ArchifyDiagram /g) || []).length, 1, id);
assert(narrative.includes(' story />'), id);
assert(page.indexOf(' story />') < page.indexOf('<details>'), id);
assert(!/<details\s+open/.test(page), id);
assert.equal((page.match(/<details>/g) || []).length, (page.match(/<\/details>/g) || []).length, id);
assert.equal((narrative.match(/^## /gm) || []).length, 1, id);
assert((narrative.match(/^- /gm) || []).length <= 3, id);
assert(narrative.includes('**Next:**'), id);
assert(!narrative.includes('| ---'), id);
const words = narrative.replace(/<[^>]*>/g, '').trim().split(/\s+/).length;
assert(words <= 200, `${id}: ${words} default narrative words`);
}
});
test('mobile story diagrams preserve the same nodes and directed relationships', () => {
for (const {id} of model.pages) {
const page = read(`docs/strategy/${id}.mdx`);
const name = /<ArchifyDiagram name="([^"]+)"[^>]+ story/.exec(page)[1];
const desktop = JSON.parse(read(`diagrams/${name}.architecture.json`));
const mobile = JSON.parse(read(`diagrams/${name}-mobile.architecture.json`));
assert(desktop.components.length >= 5 && desktop.components.length <= (name === 'strategy-target' ? 18 : 7), name);
const semantic = d => ({nodes:d.components.map(({pos,size,...n})=>n),edges:d.connections.map(({fromSide,toSide,via,labelAt,...e})=>e)});
assert.deepEqual(semantic(desktop), semantic(mobile), name);
assert(desktop.connections.every(e => (e.label || e.id.startsWith('govern-')) && e.from !== e.to), name);
assert.equal(desktop.meta.legend.mode, 'hidden');
}
});
test('all sixteen exact KPI formulas remain reachable in the closed reference', () => {
const page = read('docs/strategy/measurement.mdx');
const contracts = page.split('<summary>All 16 KPI contracts')[1].split('</details>')[0];
assert.equal((contracts.match(/^### /gm) || []).length, 16);
for (const metric of model.kpis) {
const section = contracts.split(`### ${metric.name}\n`)[1]?.split('\n### ')[0];
assert(section, metric.name);
for (const label of ['Numerator','Denominator','Expression','Aggregation','Unit','Eligible population','Exclusions','Events and source','Owner / cadence','Missing evidence','Gaming and limits']) assert(section.includes(`| ${label} |`), `${metric.name}: ${label}`);
}
});
+21
View File
@@ -0,0 +1,21 @@
// Sandboxed viewers have opaque origins: authenticate the sender by WindowProxy,
// not origin. Only exchange a validated theme, never HTML, URLs or commands.
(() => {
if (window.parent === window) return;
let connected = false;
window.addEventListener('message', event => {
if (event.source !== window.parent || event.data?.type !== 'eldorado:set-theme') return;
const theme = event.data.theme;
if (theme !== 'light' && theme !== 'dark') return;
connected = true;
if (document.documentElement.dataset.theme !== theme) {
document.getElementById('btn-theme').click();
// Parent updates are not new user choices; do not echo stale acknowledgements.
observer.takeRecords();
}
});
const observer = new MutationObserver(() => {
if (connected) window.parent.postMessage({type: 'eldorado:theme', theme: document.documentElement.dataset.theme}, '*');
});
observer.observe(document.documentElement, {attributes: true, attributeFilter: ['data-theme']});
})();
+1 -1
View File
@@ -1,2 +1,2 @@
import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
export default {strategySidebar: ['index', 'target-operating-model', 'skills-governance', 'skills-quality', 'skills-adoption', 'measurement', 'skills-maintenance', 'roadmap']} satisfies SidebarsConfig;
export default {strategySidebar: ['target-operating-model', 'index', 'skills-governance', 'skills-quality', 'skills-adoption', 'measurement', 'skills-maintenance', 'roadmap']} satisfies SidebarsConfig;
+49 -5
View File
@@ -1,13 +1,54 @@
import React, {useEffect, useId, useRef, useState} from 'react';
import useBaseUrl from '@docusaurus/useBaseUrl';
import {useLocation} from '@docusaurus/router';
import {useColorMode} from '@docusaurus/theme-common';
export default function ArchifyDiagram({name, title, compact = false}: {name: string; title: string; compact?: boolean}): React.ReactElement {
export default function ArchifyDiagram({name, title, compact = false, story = false}: {name: string; title: string; compact?: boolean; story?: boolean}): React.ReactElement {
if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) throw new Error('Invalid diagram name');
const source = useBaseUrl(`/diagrams/${name}/`);
const mobileSource = useBaseUrl(`/diagrams/${name}-mobile/`);
const dialog = useRef<HTMLDialogElement>(null);
const opener = useRef<HTMLButtonElement>(null);
const headingId = useId();
const [expanded, setExpanded] = useState(false);
const {colorMode, setColorMode} = useColorMode();
const initialTheme = useRef(colorMode);
const desktop = useRef<HTMLIFrameElement>(null);
const mobile = useRef<HTMLIFrameElement>(null);
const fullscreen = useRef<HTMLIFrameElement>(null);
const syncTheme = (frame: HTMLIFrameElement | null) => frame?.contentWindow?.postMessage({type: 'eldorado:set-theme', theme: colorMode}, '*');
useEffect(() => {
for (const frame of [desktop, mobile, fullscreen]) syncTheme(frame.current);
const receiveTheme = (event: MessageEvent) => {
if (!event.source || ![desktop, mobile, fullscreen].some(frame => frame.current?.contentWindow === event.source)) return;
if (event.data?.type !== 'eldorado:theme' || !['light', 'dark'].includes(event.data.theme)) return;
if (event.data.theme !== colorMode) setColorMode(event.data.theme);
};
window.addEventListener('message', receiveTheme);
return () => window.removeEventListener('message', receiveTheme);
}, [colorMode, setColorMode, expanded]);
const {pathname, hash} = useLocation();
useEffect(() => {
if (!story || !hash) return;
let id: string;
try {id = decodeURIComponent(hash.slice(1));} catch {return;}
const frame = requestAnimationFrame(() => {
const target = document.getElementById(id);
if (!target?.closest('.strategy-content')) return;
let detail = target.closest('details');
if (!detail) return;
while (detail) {
if (detail.dataset.collapsed === 'true') {
detail.querySelector<HTMLElement>(':scope > summary')?.click();
} else if (!detail.hasAttribute('data-collapsed')) {
detail.open = true;
}
detail = detail.parentElement?.closest('details') ?? null;
}
target.scrollIntoView();
});
return () => cancelAnimationFrame(frame);
}, [story, pathname, hash]);
useEffect(() => {
if (!expanded) return;
dialog.current?.showModal();
@@ -16,12 +57,15 @@ export default function ArchifyDiagram({name, title, compact = false}: {name: st
return () => {document.body.style.overflow = previousOverflow;};
}, [expanded]);
const close = () => {dialog.current?.close();};
return <section className={`archify-panel${compact ? ' archify-panel--compact' : ''}`} aria-label={title}>
return <section className={`archify-panel${compact ? ' archify-panel--compact' : ''}${story ? ' archify-panel--story' : ''}`} data-diagram={name} aria-label={title}>
<div className="archify-toolbar"><button ref={opener} type="button" className="archify-expand" aria-label={`Expand ${title}`} title="Expand diagram" onClick={() => setExpanded(true)}><svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" aria-hidden="true"><path d="M8 3H3v5M16 3h5v5M21 16v5h-5M8 21H3v-5" /></svg></button></div>
<iframe src={source} title={title} sandbox="allow-scripts allow-downloads" loading="lazy" referrerPolicy="no-referrer" />
{story ? <>
<iframe className="story-desktop" ref={desktop} onLoad={() => syncTheme(desktop.current)} src={`${source}?embed=1&theme=${initialTheme.current}`} title={title} sandbox="allow-scripts allow-downloads" loading="lazy" referrerPolicy="no-referrer" />
<iframe className="story-mobile" ref={mobile} onLoad={() => syncTheme(mobile.current)} src={`${mobileSource}?embed=1&theme=${initialTheme.current}`} title={`${title} — narrow layout`} sandbox="allow-scripts allow-downloads" loading="lazy" referrerPolicy="no-referrer" />
</> : <iframe ref={desktop} onLoad={() => syncTheme(desktop.current)} src={`${source}?theme=${initialTheme.current}`} title={title} sandbox="allow-scripts allow-downloads" loading="lazy" referrerPolicy="no-referrer" />}
<dialog ref={dialog} className="archify-modal" aria-labelledby={headingId} onClose={() => {setExpanded(false); opener.current?.focus();}}>
<div className="archify-modal-toolbar"><strong id={headingId}>{title}</strong><button type="button" onClick={close} autoFocus aria-label="Close full-screen diagram">Close ×</button></div>
{expanded && <iframe src={source} title={`${title} — expanded`} sandbox="allow-scripts allow-downloads" referrerPolicy="no-referrer" />}
<div className="archify-modal-toolbar"><strong id={headingId}>{title}</strong><button type="button" onClick={close} autoFocus aria-label="Close full-screen diagram"><span aria-hidden="true">×</span></button></div>
{expanded && <iframe ref={fullscreen} onLoad={() => syncTheme(fullscreen.current)} src={`${source}?theme=${initialTheme.current}`} title={`${title} — expanded`} sandbox="allow-scripts allow-downloads" referrerPolicy="no-referrer" />}
</dialog>
</section>;
}
+19 -1
View File
@@ -107,13 +107,31 @@ a:focus-visible, button:focus-visible {outline: 3px solid #b88719; outline-offse
.archify-toolbar {display: flex; justify-content: flex-end; padding: 4px; background: var(--surface);}
.archify-panel iframe {width: 100%; height: 720px; border: 0; display: block; background: #f6f6f6;}
.archify-panel--compact > iframe {height: 500px;}
.archify-panel--story {max-width: 740px;}
.archify-panel--story > iframe {height: auto; aspect-ratio: 480 / 408;}
.archify-panel--story > .story-mobile {display: none;}
.archify-panel--story[data-diagram="strategy-target"] > iframe {aspect-ratio: 1620 / 1430;}
.archify-panel--story[data-diagram="strategy-adoption"] > iframe {aspect-ratio: 545 / 408;}
.archify-panel--story[data-diagram="strategy-maintenance"] > iframe {aspect-ratio: 524 / 408;}
.strategy-content > details {margin: .65rem 0; border: 1px solid var(--line); padding: .8rem 1rem; background: var(--surface);}
.strategy-content summary {cursor: pointer; font-weight: 700;}
.strategy-content summary:focus-visible {outline: 3px solid #b88719; outline-offset: 4px;}
.strategy-content > details[open] > summary {margin-bottom: 1rem;}
@media (max-width: 700px) {.archify-panel iframe {height: 650px;}}
@media (max-width: 700px) {
.archify-panel--story > .story-desktop {display: none;}
.archify-panel--story > .story-mobile {display: block; height: auto; aspect-ratio: 240 / 748;}
.archify-panel--story[data-diagram="strategy-roadmap"] > .story-mobile {aspect-ratio: 240 / 628;}
.archify-panel--story[data-diagram="strategy-adoption"] > .story-mobile {aspect-ratio: 305 / 748;}
.archify-panel--story[data-diagram="strategy-maintenance"] > .story-mobile {aspect-ratio: 284 / 748;}
.archify-panel--story[data-diagram="strategy-target"] > .story-mobile {aspect-ratio: 680 / 2340;}
}
.archify-expand {display: grid; place-items: center; width: 44px; height: 44px; border: 0; padding: 0; background: transparent; color: var(--ifm-link-color); cursor: pointer;}
.archify-expand:hover {background: var(--ifm-hover-overlay);}
.archify-modal {position: fixed; inset: 0; margin: 0; padding: 0; width: 100vw; height: 100dvh; max-width: none; max-height: none; border: 0; background: var(--surface); color: var(--ifm-color-content);}
.archify-modal[open] {display: flex; flex-direction: column;}
.archify-modal::backdrop {background: #000b;}
.archify-modal-toolbar {display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 12px 20px; border-bottom: 1px solid var(--line);}
.archify-modal-toolbar button {flex-shrink: 0; padding: 8px 16px; background: var(--gold); color: #14131a; font: inherit; font-weight: 700; border: 0; cursor: pointer;}
.archify-modal-toolbar button {display: inline-flex; align-items: center; justify-content: center; flex-shrink: 0; width: 44px; height: 44px; padding: 0; background: var(--gold); color: #14131a; font: inherit; font-size: 24px; font-weight: 700; border: 0; cursor: pointer;}
.archify-panel .archify-modal iframe {flex: 1; min-height: 0; height: 100%; width: 100%;}
@media (prefers-reduced-motion: reduce) {.start-card {transition: none;} .start-card:hover {transform: none;}}