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

@@ -0,0 +1,22 @@
{
"source": {
"file": "AI_Architect_Test_Task.pdf",
"sha256": "12b2406766996056d0a361cf76b2d8fbe4dfdfad6a16c2cc4d5ee03a51a384a5",
"attachment_message": "1557767519748759646",
"authorization_message": "1557786954383368264",
"read_scope": "Full PDF, Format, Context and all four assignment questions, plus assumptions instruction"
},
"requirements": [
{"id":"format","source_section":"Format","requirement":"Live presentation: 50 minutes including Q&A; content over polish","pages":["target-operating-model"],"markers":["35 minutes content + 15 minutes Q&A","Content matters more than visual polish"]},
{"id":"context","source_section":"Context","requirement":"Close to 80 engineering people, around 100 by year end, more than 10 teams; every developer already uses AI unevenly; real output not usage","pages":["target-operating-model","baseline"],"markers":["80 engineers","100 by year end","more than 10 teams","current AI-assisted practice"]},
{"id":"q1","source_section":"Assignment 1","requirement":"Month 1–6 concrete priorities and change starting solo, CTO reporting, no formal team authority","pages":["roadmap","target-operating-model"],"markers":["Month 1","Month 2","Month 3","Month 4","Month 5","Month 6","One active live pilot at a time","no formal authority","monthly CTO review"]},
{"id":"q2","source_section":"Assignment 2","requirement":"Know whether engineering output improves; track meaningful measures and explain misleading signals","pages":["measurement/index","stage-01-skills-adoption","baseline"],"markers":["Review/rework minutes","Escaped defects and severity","Where this misleads","task mix","not a causal ROI claim","source","uncertainty"]},
{"id":"q3","source_section":"Assignment 3","requirement":"Realistic visible month-six changes backed by evidence","pages":["target-operating-model","roadmap"],"markers":["Activities I commit","Contingent visible outcome","one partner team","matured defect follow-up","documented stop"]},
{"id":"q4","source_section":"Assignment 4","requirement":"Role and organization AI use beyond six months","pages":["stage-02-autonomous-agent","target-operating-model"],"markers":["dedicated enablement capacity","deterministic tooling","conditional long-term option","not automatic progression"]},
{"id":"assumptions","source_section":"Final instruction","requirement":"State assumptions where stack, tooling or processes are unknown","pages":["target-operating-model"],"markers":["Assumptions register","PDF fact","Unknown:","Hypothesis:","If false"]},
{"id":"F1","source_section":"Professional audit F1","requirement":"First-revision comparator and recovery without invented prior approved bundle","pages":["skills-quality","skills-governance","skills-maintenance"],"markers":["first-revision","N/A","pinned clean","independent"]},
{"id":"F2-F3","source_section":"Professional audit F2/F3","requirement":"Coherent illustrative packet, inconclusive bounded extension/stop, effort and value","pages":["stage-01-skills-adoption","skills-quality"],"markers":["EXP-01","Entirely fictional","Inconclusive at first review","one two-week evidence-completion extension","Conclusive stop on burden","one-off setup","optional reference designs"]}
],
"verification_sources": ["scripts/assignment.test.mjs","scripts/connected-strategy.test.mjs","scripts/strategy-navigation.test.mjs","scripts/strategy-story.test.mjs","scripts/verify.mjs","scripts/browser/skills-stories.cjs","scripts/browser/strategy-navigation.cjs","scripts/browser/target-midpoints.cjs","scripts/browser/roadmap-timeline.cjs"],
"scope": "Traceability is a review aid, not semantic approval or business evidence. All 28 routes remain in strategy-coverage.json; all 16 canonical contracts retain original checksums, 9 prototypes and 7 unimplemented. Reviewer must cold-read the actual pages and inspect complete exports."
}
+13 -13
View File
@@ -236,12 +236,12 @@
{
"source": "docs/strategy/roadmap.mdx",
"route": "/strategy/roadmap/",
"question": "How do we move toward Target without assuming autonomy?",
"inputs": "Target and current working practices",
"action_or_decision": "Start skills adoption in Delivery; leave later phase order undecided",
"output": "Two-stage direction and within-phase learning loop",
"question": "What does a solo architect do month by month without team authority?",
"inputs": "PDF constraints, current AI practice, willing partners and unknown capacity",
"action_or_decision": "Month 1–6 discovery, bounded experiment, compare, selective transfer and CTO investment decision",
"output": "Proposed six-month plan with dependencies, evidence, capacity and stop choices",
"next_or_feedback": "/strategy/stage-01-skills-adoption/",
"review": "Qualified pilot and separate Stage02 authority now explicit"
"review": "Assignment Q1; six-month native diagrams; no inevitable autonomy"
},
{
"source": "docs/strategy/skills-adoption.mdx",
@@ -286,10 +286,10 @@
{
"source": "docs/strategy/stage-01-skills-adoption.mdx",
"route": "/strategy/stage-01-skills-adoption/",
"question": "How do I begin one repeatable adoption journey?",
"question": "How do I assemble and decide one proportionate experiment?",
"inputs": "Workflow problem, people and current evidence",
"action_or_decision": "Baseline, engineer, qualify, authorize pilot, compare and decide",
"output": "Supported workflow or explicit hold/stop; feedback to baseline/quality",
"action_or_decision": "Baseline, choose intervention, qualify, authorize pilot, compare and decide; EXP-01 illustrative packet",
"output": "Supported workflow or explicit hold/stop; first-revision recovery, bounded extension and cost limits",
"next_or_feedback": "/strategy/baseline/",
"review": "New native dependency story plus evidence handoffs"
},
@@ -306,12 +306,12 @@
{
"source": "docs/strategy/target-operating-model.mdx",
"route": "/strategy/target-operating-model/",
"question": "What operating model are we aiming for?",
"inputs": "Human-directed SDLC target and existing team boundaries",
"action_or_decision": "Distinguish intended execution from current authority",
"output": "Shared destination, no deployed-autonomy claim",
"question": "What six-month strategy answers the AI Architect assignment?",
"inputs": "Full PDF facts; explicitly unknown stack, processes and capacity",
"action_or_decision": "Improve current AI-assisted engineering output with the smallest suitable intervention",
"output": "Realistic month-six scenario, assumptions register and 35+15-minute presentation narrative",
"next_or_feedback": "/strategy/roadmap/",
"review": "Preserved central-agent topology; connected Delivery thread"
"review": "Assignment Q1–4 main entry; preserved target topology subordinated as conditional reference"
}
]
}
+5 -5
View File
@@ -1,7 +1,7 @@
{
"schema_version": "1.0.0",
"status": "proposed-target-not-approved-or-deployed",
"scope": "Strategy documentation and synthetic measurement reference only; no runtime changes authorized.",
"scope": "Six-month assignment-led Strategy with optional legacy governance/target reference; organization model is not PDF evidence. No runtime changes authorized.",
"organization": {
"Product": [
"Product Management",
@@ -30,8 +30,8 @@
"pages": [
{
"id": "target-operating-model",
"title": "Target operating model",
"purpose": "One logical coordinator; local client choice; independent authority; all departments."
"title": "First six months as AI Architect",
"purpose": "Solo CTO-sponsored improvement plan; realistic outcomes, assumptions and presentation; conditional target topology."
},
{
"id": "skills-governance",
@@ -50,8 +50,8 @@
},
{
"id": "measurement",
"title": "Skills Measurement",
"purpose": "Which KPIs to collect during skills adoption, how to calculate them and when to report."
"title": "Measuring real output",
"purpose": "Small feasible starting measures and optional sixteen-contract registry, not mandatory collection."
},
{
"id": "skills-maintenance",