docs: [verified] answer the six-month AI Architect assignment
Build and publish Eldorado documentation / build (pull_request) Successful in 1m30s

This commit is contained in:
jarvis-at-skic committed 2026-10-08 16:59:36 +00:00
1 parent 88a4375776
commit 1a2d16bc91
53 files changed
+974 -390

No files matched your search

@@ -81,9 +81,9 @@
{
"id": "expand",
"type": "backend",
"label": "Expand on evidence",
"tag": "Other SDLC phases",
"sublabel": "Later order undecided\nDelivery keeps improving",
"label": "Decide from evidence",
"tag": "Owner; new scope is separate",
"sublabel": "Retain / improve / hold / stop\nExpansion is a new proposal",
"pos": [
60,
1650
+3 -3
View File
@@ -81,9 +81,9 @@
{
"id": "expand",
"type": "backend",
"label": "Expand on evidence",
"tag": "Other SDLC phases",
"sublabel": "Later order undecided\nDelivery keeps improving",
"label": "Decide from evidence",
"tag": "Owner; new scope is separate",
"sublabel": "Retain / improve / hold / stop\nExpansion is a new proposal",
"pos": [
1460,
360
@@ -51,7 +51,7 @@
"type": "external",
"label": "03 Authorize pilot",
"tag": "Owning team approver",
"sublabel": "Qualified; bounded pilot",
"sublabel": "Qualified; pin, load, pilot",
"pos": [
60,
860
@@ -65,9 +65,9 @@
{
"id": "approve",
"type": "backend",
"label": "04 Approve exact scope",
"label": "04 Decide exact scope",
"tag": "Accountable approvers",
"sublabel": "Pilot evidence + digest + expiry",
"sublabel": "Compare pilot: approve / hold",
"pos": [
60,
1230
@@ -115,7 +115,7 @@
"type": "security",
"label": "Withdraw / roll back",
"tag": "Unsafe revision",
"sublabel": "Revoke; restore last-known-good",
"sublabel": "Revoke; restore or remove candidate",
"pos": [
60,
2340
@@ -51,7 +51,7 @@
"type": "external",
"label": "03 Authorize pilot",
"tag": "Owning team approver",
"sublabel": "Qualified; bounded pilot",
"sublabel": "Qualified; pin, load, pilot",
"pos": [
520,
500
@@ -65,9 +65,9 @@
{
"id": "approve",
"type": "backend",
"label": "04 Approve exact scope",
"label": "04 Decide exact scope",
"tag": "Accountable approvers",
"sublabel": "Pilot evidence + digest + expiry",
"sublabel": "Compare pilot: approve / hold",
"pos": [
740,
720
@@ -115,7 +115,7 @@
"type": "security",
"label": "Withdraw / roll back",
"tag": "Unsafe revision",
"sublabel": "Revoke; restore last-known-good",
"sublabel": "Revoke; restore or remove candidate",
"pos": [
80,
1160
@@ -38,7 +38,7 @@
"sublabel": "Useful? Safe? Still needed?",
"pos": [
60,
1970
490
],
"size": [
740,
@@ -70,7 +70,7 @@
"sublabel": "Fitness + regression + client checks",
"pos": [
60,
860
1600
],
"size": [
740,
@@ -86,7 +86,7 @@
"sublabel": "Verify distribution and recovery",
"pos": [
60,
490
1970
],
"size": [
740,
@@ -134,7 +134,7 @@
"sublabel": "Revoke + quarantine + roll back\nNo automatic reinstatement",
"pos": [
60,
1600
860
],
"size": [
740,
@@ -144,195 +144,15 @@
}
],
"connections": [
{
"id": "observe-triage",
"from": "observe",
"to": "triage",
"label": "",
"fromSide": "left",
"toSide": "left",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
20,
230.0
],
[
20,
2080.0
]
],
"labelAt": [
620,
1930
]
},
{
"id": "triage-change",
"from": "triage",
"to": "change",
"label": "Correct",
"fromSide": "right",
"toSide": "right",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
850,
2080.0
],
[
850,
1340.0
]
],
"labelAt": [
780,
1560
]
},
{
"id": "change-validate",
"from": "change",
"to": "validate",
"label": "",
"fromSide": "top",
"toSide": "bottom",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
610,
1135
]
},
{
"id": "validate-release",
"from": "validate",
"to": "release",
"label": "",
"fromSide": "top",
"toSide": "bottom",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
610,
765
]
},
{
"id": "release-observe",
"from": "release",
"to": "observe",
"label": "",
"fromSide": "top",
"toSide": "bottom",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
610,
395
]
},
{
"id": "triage-safe",
"from": "triage",
"to": "safe",
"label": "Safe",
"fromSide": "right",
"toSide": "right",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
824,
2080.0
],
[
824,
2820.0
]
],
"labelAt": [
620,
2670
]
},
{
"id": "triage-retire",
"from": "triage",
"to": "retire",
"label": "Retire",
"fromSide": "bottom",
"toSide": "top",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
610,
2245
]
},
{
"id": "triage-contain",
"from": "triage",
"to": "contain",
"label": "Unsafe",
"fromSide": "top",
"toSide": "bottom",
"route": "straight",
"width": 4,
"variant": "security",
"labelAt": [
610,
1875
]
},
{
"id": "contain-change",
"from": "contain",
"to": "change",
"label": "Reviewed fix",
"fromSide": "top",
"toSide": "bottom",
"route": "straight",
"width": 4,
"variant": "security",
"labelAt": [
610,
1505
]
},
{
"id": "safe-observe",
"from": "safe",
"to": "observe",
"label": "Keep watching",
"fromSide": "left",
"toSide": "left",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
42,
2820.0
],
[
42,
230.0
]
],
"labelAt": [
620,
80
]
}
{"id":"observe-triage","from":"observe","to":"triage","label":"","fromSide":"bottom","toSide":"top","route":"straight","width":4,"variant":"default"},
{"id":"triage-change","from":"triage","to":"change","label":"Correct","fromSide":"right","toSide":"right","route":"straight","width":4,"variant":"default","via":[[824,600],[824,1340]],"labelAt":[640,1190]},
{"id":"change-validate","from":"change","to":"validate","label":"","fromSide":"bottom","toSide":"top","route":"straight","width":4,"variant":"default"},
{"id":"validate-release","from":"validate","to":"release","label":"","fromSide":"bottom","toSide":"top","route":"straight","width":4,"variant":"default"},
{"id":"release-observe","from":"release","to":"observe","label":"","fromSide":"left","toSide":"left","route":"straight","width":4,"variant":"default","via":[[42,2080],[42,230]]},
{"id":"triage-safe","from":"triage","to":"safe","label":"Safe","fromSide":"right","toSide":"right","route":"straight","width":4,"variant":"default","via":[[872,600],[872,2820]],"labelAt":[620,2670]},
{"id":"triage-retire","from":"triage","to":"retire","label":"Retire","fromSide":"right","toSide":"right","route":"straight","width":4,"variant":"default","via":[[850,600],[850,2450]],"labelAt":[620,2300]},
{"id":"triage-contain","from":"triage","to":"contain","label":"Unsafe","fromSide":"bottom","toSide":"top","route":"straight","width":4,"variant":"security","labelAt":[610,795]},
{"id":"contain-change","from":"contain","to":"change","label":"Reviewed fix","fromSide":"bottom","toSide":"top","route":"straight","width":4,"variant":"security","labelAt":[610,1135]},
{"id":"safe-observe","from":"safe","to":"observe","label":"Keep watching","fromSide":"left","toSide":"left","route":"straight","width":4,"variant":"default","via":[[20,2820],[20,230]],"labelAt":[620,80]}
]
}
@@ -28,7 +28,7 @@
"yOffset": -140.0,
"type": "backend",
"label": "Delivery first",
"sublabel": "Human + AI Agent; keep improving.",
"sublabel": "One willing team; keep improving.",
"width": 340,
"height": 240
},
@@ -38,8 +38,8 @@
"col": 0,
"yOffset": 140.0,
"type": "backend",
"label": "Other SDLC phases",
"sublabel": "Expand adoption; order not yet decided.",
"label": "Transfer or stay",
"sublabel": "New scope needs evidence and consent.",
"width": 340,
"height": 240
}
@@ -28,7 +28,7 @@
"yOffset": 0,
"type": "backend",
"label": "Delivery first",
"sublabel": "Human + AI Agent; keep improving.",
"sublabel": "One willing team; keep improving.",
"width": 340,
"height": 240
},
@@ -38,8 +38,8 @@
"col": 1,
"yOffset": 0,
"type": "backend",
"label": "Other SDLC phases",
"sublabel": "Expand adoption; order not yet decided.",
"label": "Transfer or stay",
"sublabel": "New scope needs evidence and consent.",
"width": 340,
"height": 240
}
@@ -50,8 +50,8 @@
"col": 0,
"yOffset": -140.0,
"type": "backend",
"label": "Engineer topology",
"sublabel": "Connect skills, triggers and handoffs.",
"label": "Choose intervention",
"sublabel": "Context, coaching, tooling or skills.",
"width": 340,
"height": 240
},
@@ -83,8 +83,8 @@
"col": 0,
"yOffset": 700.0,
"type": "backend",
"label": "Understand anew",
"sublabel": "Compare with baseline; repeat the loop.",
"label": "Retain or stop",
"sublabel": "Compare burden and outcomes; learn.",
"width": 340,
"height": 240
}
+4 -4
View File
@@ -50,8 +50,8 @@
"col": 2,
"yOffset": -160,
"type": "backend",
"label": "Engineer topology",
"sublabel": "Connect skills, triggers and handoffs.",
"label": "Choose intervention",
"sublabel": "Context, coaching, tooling or skills.",
"width": 340,
"height": 240
},
@@ -83,8 +83,8 @@
"col": 0,
"yOffset": 160,
"type": "backend",
"label": "Understand anew",
"sublabel": "Compare with baseline; repeat the loop.",
"label": "Retain or stop",
"sublabel": "Compare burden and outcomes; learn.",
"width": 340,
"height": 240
}
@@ -2,7 +2,7 @@
"schema_version": 2,
"diagram_type": "workflow",
"meta": {
"title": "Two stages toward Target",
"title": "Proposed six months: test, then decide",
"output": "static/diagrams/strategy-roadmap-mobile/index.html",
"quality_profile": "showcase",
"animation": "none",
@@ -13,7 +13,7 @@
"lanes": [
{
"id": "adoption",
"label": "Two stages toward Target"
"label": "Proposed six-month investment choices"
}
],
"mainPath": [
@@ -27,8 +27,8 @@
"col": 0,
"yOffset": -140.0,
"type": "backend",
"label": "Adopt skills",
"sublabel": "Human + AI Agent in each SDLC phase.",
"label": "Learn and test",
"sublabel": "One willing team; current AI baseline.",
"width": 340,
"height": 240
},
@@ -38,8 +38,8 @@
"col": 0,
"yOffset": 140.0,
"type": "backend",
"label": "Autonomous Agent",
"sublabel": "Future: separately justified authority.",
"label": "Retain or stop",
"sublabel": "Value and upkeep decide any transfer.",
"width": 340,
"height": 240
}
+6 -6
View File
@@ -2,7 +2,7 @@
"schema_version": 2,
"diagram_type": "workflow",
"meta": {
"title": "Two stages toward Target",
"title": "Proposed six months: test, then decide",
"output": "static/diagrams/strategy-roadmap/index.html",
"quality_profile": "showcase",
"animation": "none",
@@ -13,7 +13,7 @@
"lanes": [
{
"id": "adoption",
"label": "Two stages toward Target"
"label": "Proposed six-month investment choices"
}
],
"mainPath": [
@@ -27,8 +27,8 @@
"col": 0,
"yOffset": 0,
"type": "backend",
"label": "Adopt skills",
"sublabel": "Human + AI Agent in each SDLC phase.",
"label": "Learn and test",
"sublabel": "One willing team; current AI baseline.",
"width": 340,
"height": 240
},
@@ -38,8 +38,8 @@
"col": 1,
"yOffset": 0,
"type": "backend",
"label": "Autonomous Agent",
"sublabel": "Future: separately justified authority.",
"label": "Retain or stop",
"sublabel": "Value and upkeep decide any transfer.",
"width": 340,
"height": 240
}
@@ -0,0 +1,249 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "Proposed: first six months as AI Architect",
"output": "static/diagrams/strategy-six-months-mobile/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
},
"viewBox": [
1000,
2950
]
},
"components": [
{
"id": "baseline",
"type": "external",
"label": "Month 1: discover",
"tag": "Architect + CTO + willing teams",
"sublabel": "Current AI workflows + constraints\nPair with developers and reviewers\nChoose an evidenced bottleneck",
"pos": [
200,
40
],
"size": [
740,
300
],
"icon": "none"
},
{
"id": "engineer",
"type": "external",
"label": "Month 2: agree experiment",
"tag": "Architect + partner lead + reviewer",
"sublabel": "One workflow + feasible baseline\nChoose context, coaching or tooling\nSkills only if they fit the problem",
"pos": [
200,
450
],
"size": [
740,
300
],
"icon": "none"
},
{
"id": "qualify",
"type": "security",
"label": "Month 3: pair and pilot",
"tag": "Team agrees time; owner permits scope",
"sublabel": "Independent checks before live work\nCollect accepted work and burden\nUnsafe or unsupported: stop",
"pos": [
200,
860
],
"size": [
740,
300
],
"icon": "none"
},
{
"id": "pilot",
"type": "external",
"label": "Month 4: decide from evidence",
"tag": "Workflow owner + CTO review",
"sublabel": "Compare current practice and pilot\nRetain / change / hold / stop\nIncomplete: bounded extension only",
"pos": [
200,
1270
],
"size": [
740,
300
],
"icon": "none"
},
{
"id": "decide",
"type": "security",
"label": "Month 5: transfer selectively",
"tag": "Willing champion + team lead",
"sublabel": "Only if value and upkeep hold\nTry another team with new baseline\nNo capacity: stay narrow or retire",
"pos": [
200,
1680
],
"size": [
740,
300
],
"icon": "none"
},
{
"id": "maintain",
"type": "external",
"label": "Month 6: hand over or stop",
"tag": "Team owner + CTO investment decision",
"sublabel": "Evidence, costs and limits visible\nOwned workflow or documented stop\nNext quarter is not automatic AI",
"pos": [
200,
2090
],
"size": [
740,
300
],
"icon": "none"
},
{
"id": "reference",
"type": "backend",
"label": "Proposed six-month plan",
"tag": "Solo architect; no team authority",
"sublabel": "Month 6 → 2: revise next question\nMonth 5 → 1: baseline new scope\nProposed, not company commitments",
"pos": [
200,
2500
],
"size": [
740,
300
],
"icon": "none"
}
],
"connections": [
{
"id": "baseline-engineer",
"from": "baseline",
"to": "engineer",
"label": "Problem",
"fromSide": "bottom",
"toSide": "top",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
570,
405
]
},
{
"id": "engineer-qualify",
"from": "engineer",
"to": "qualify",
"label": "Agreement",
"fromSide": "bottom",
"toSide": "top",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
570,
815
]
},
{
"id": "qualify-pilot",
"from": "qualify",
"to": "pilot",
"label": "Evidence",
"fromSide": "bottom",
"toSide": "top",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
570,
1225
]
},
{
"id": "pilot-decide",
"from": "pilot",
"to": "decide",
"label": "Decision",
"fromSide": "bottom",
"toSide": "top",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
570,
1635
]
},
{
"id": "decide-maintain",
"from": "decide",
"to": "maintain",
"label": "Handover",
"fromSide": "bottom",
"toSide": "top",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
570,
2045
]
},
{
"id": "maintain-engineer",
"from": "maintain",
"to": "engineer",
"label": "",
"fromSide": "left",
"toSide": "left",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
145,
2240
],
[
145,
600
]
]
},
{
"id": "decide-baseline",
"from": "decide",
"to": "baseline",
"label": "",
"fromSide": "right",
"toSide": "right",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
980,
1830
],
[
980,
190
]
]
}
]
}
@@ -0,0 +1,271 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "Proposed: first six months as AI Architect",
"output": "static/diagrams/strategy-six-months/index.html",
"quality_profile": "showcase",
"legend": {
"mode": "hidden"
},
"viewBox": [
2400,
1580
]
},
"components": [
{
"id": "baseline",
"type": "external",
"label": "Month 1: discover",
"tag": "Architect + CTO + willing teams",
"sublabel": "Current AI workflows + constraints\nPair with developers and reviewers\nChoose an evidenced bottleneck",
"pos": [
100,
100
],
"size": [
600,
260
],
"icon": "none"
},
{
"id": "engineer",
"type": "external",
"label": "Month 2: agree experiment",
"tag": "Architect + partner lead + reviewer",
"sublabel": "One workflow + feasible baseline\nChoose context, coaching or tooling\nSkills only if they fit the problem",
"pos": [
900,
100
],
"size": [
600,
260
],
"icon": "none"
},
{
"id": "qualify",
"type": "security",
"label": "Month 3: pair and pilot",
"tag": "Team agrees time; owner permits scope",
"sublabel": "Independent checks before live work\nCollect accepted work and burden\nUnsafe or unsupported: stop",
"pos": [
1700,
100
],
"size": [
600,
260
],
"icon": "none"
},
{
"id": "pilot",
"type": "external",
"label": "Month 4: decide from evidence",
"tag": "Workflow owner + CTO review",
"sublabel": "Compare current practice and pilot\nRetain / change / hold / stop\nIncomplete: bounded extension only",
"pos": [
1700,
730
],
"size": [
600,
260
],
"icon": "none"
},
{
"id": "decide",
"type": "security",
"label": "Month 5: transfer selectively",
"tag": "Willing champion + team lead",
"sublabel": "Only if value and upkeep hold\nTry another team with new baseline\nNo capacity: stay narrow or retire",
"pos": [
900,
730
],
"size": [
600,
260
],
"icon": "none"
},
{
"id": "maintain",
"type": "external",
"label": "Month 6: hand over or stop",
"tag": "Team owner + CTO investment decision",
"sublabel": "Evidence, costs and limits visible\nOwned workflow or documented stop\nNext quarter is not automatic AI",
"pos": [
100,
730
],
"size": [
600,
260
],
"icon": "none"
},
{
"id": "reference",
"type": "backend",
"label": "Proposed six-month plan",
"tag": "Solo architect; no team authority",
"sublabel": "Month 6 → 2: revise next question\nMonth 5 → 1: baseline new scope\nProposed, not company commitments",
"pos": [
100,
1270
],
"size": [
2200,
260
],
"icon": "none"
}
],
"connections": [
{
"id": "baseline-engineer",
"from": "baseline",
"to": "engineer",
"label": "Problem",
"fromSide": "right",
"toSide": "left",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
800,
210
]
},
{
"id": "engineer-qualify",
"from": "engineer",
"to": "qualify",
"label": "Agreement",
"fromSide": "right",
"toSide": "left",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
1600,
210
]
},
{
"id": "qualify-pilot",
"from": "qualify",
"to": "pilot",
"label": "Evidence",
"fromSide": "bottom",
"toSide": "top",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
2000,
520
]
],
"labelAt": [
2010,
535
]
},
{
"id": "pilot-decide",
"from": "pilot",
"to": "decide",
"label": "Decision",
"fromSide": "left",
"toSide": "right",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
1600,
840
]
},
{
"id": "decide-maintain",
"from": "decide",
"to": "maintain",
"label": "Handover",
"fromSide": "left",
"toSide": "right",
"route": "straight",
"width": 4,
"variant": "default",
"labelAt": [
800,
840
]
},
{
"id": "maintain-engineer",
"from": "maintain",
"to": "engineer",
"label": "Next question",
"fromSide": "top",
"toSide": "bottom",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
400,
550
],
[
1200,
550
]
],
"labelAt": [
800,
535
]
},
{
"id": "decide-baseline",
"from": "decide",
"to": "baseline",
"label": "New scope",
"fromSide": "bottom",
"toSide": "bottom",
"route": "straight",
"width": 4,
"variant": "default",
"via": [
[
1200,
1150
],
[
60,
1150
],
[
60,
430
],
[
400,
430
]
],
"labelAt": [
620,
1135
]
}
]
}
@@ -33,9 +33,9 @@
{
"id": "engineer",
"type": "external",
"label": "Engineer connected skills",
"label": "Choose an intervention",
"tag": "Owning team + independent reviewer",
"sublabel": "Triggers, inputs and output handoffs\nPinned candidate + client + limits\nDeliver: patch and regression tests",
"sublabel": "Context, coaching, tooling or skills\nPinned candidate + client + limits\nDeliver: patch and regression tests",
"pos": [
200,
450
@@ -115,7 +115,7 @@
"type": "backend",
"label": "Governance + Measurement",
"tag": "Throughout, not one-time gates",
"sublabel": "Named people + controlled authority\nSelected workflow + skill evidence\nKeep populations and gaps explicit",
"sublabel": "Left return: changed revision\nRight return: new scope needs baseline\nSelected evidence; no forced rollout",
"pos": [
200,
2500
+3 -3
View File
@@ -33,9 +33,9 @@
{
"id": "engineer",
"type": "external",
"label": "Engineer connected skills",
"label": "Choose an intervention",
"tag": "Owning team + independent reviewer",
"sublabel": "Triggers, inputs and output handoffs\nPinned candidate + client + limits\nDeliver: patch and regression tests",
"sublabel": "Context, coaching, tooling or skills\nPinned candidate + client + limits\nDeliver: patch and regression tests",
"pos": [
900,
100
@@ -115,7 +115,7 @@
"type": "backend",
"label": "Governance + Measurement",
"tag": "Throughout, not one-time gates",
"sublabel": "Named people + controlled authority\nSelected workflow + skill evidence\nKeep populations and gaps explicit",
"sublabel": "Left return: changed revision\nRight return: new scope needs baseline\nSelected evidence; no forced rollout",
"pos": [
100,
1270