docs(P51): full presentation rework — scope, story arc, visuals, appendix
acdl-ci / Lint (push) Successful in 9s
acdl-ci / Test (push) Successful in 29s
acdl-ci / Platform check-only (offline) (push) Successful in 10s

Major rework of both presentation decks based on leadership feedback.
Addresses: story arc, concept clarity, scope clarification, more visuals,
appendix for detail-heavy slides, and a complete Road to the North Star.

6 new mermaid diagrams:
- platform-works-03-scope-boundary (Upstream → Contract → ACDL → AWS)
- developer-experience-01b-scope-boundary (both consumer paths + scope)
- platform-works-04-confidence-signal (6 inputs → score → gate → decision)
- platform-works-05-attestation-flow (deploy → gate → approver → evidence)
- developer-experience-04-promotion-journey (dev → qa → prod → dr)
- road-to-north-star (v1.0 demo → v1.9 → v1.10 → v2.0 → North Star)

Both Marp decks restructured to 10 main + 6 appendix slides:

PW deck (17 slides):
1. Title
2. The Problem & The North Star (anti-goals moved to slide 3)
3. Where ACDL Sits in Your World (NEW — scope boundary, infra only)
4. The Contract-Driven Model (image: removed, infra inputs instead)
5. The End-to-End Flow
6. Zero-Trust by Default
7. Safety is Computed (NEW confidence signal diagram)
8. Security by Construction
9. Accountability & Audit (NEW attestation flow diagram, QA clarification,
   badge reclassification: dev=Testing, qa/prod/dr=Planned)
10. Testing vs. Planned (summary, full inventory in appendix)
11. The Vision Realized
+ Appendix: TOC, Platform-Managed Environments, Observability, Road to
  North Star, Full Inventory, Glossary

DX deck (16 slides):
1. Title
2. Where ACDL Sits in Your World (REPLACES Two Consumer Surfaces — scope
   boundary with both consumer paths)
3. The Contract — The Entire Consumer Surface (image: removed)
4. The Developer Feedback Loop
5. Versioned, Predictable Releases
6. Friendly Onboarding
7. Safe Promotion Path (NEW promotion journey diagram, rising bar
   annotated: dev=Testing, qa/prod/dr=Planned)
8. Safe Decommission
9. Self-Service Module Catalog
10. The Desired Outcomes
+ Appendix: TOC, Citizen Developer Experience, No Platform Code, Local
  Reproducibility, Road to North Star, Glossary

Story arc: every slide has an italic 'Story beat' line connecting it to
the narrative progression.

Scope clarification: ACDL is infrastructure only. Upstream is anything
(IDE, agentic SDLC, citizen dev vibe coding). ACDL provisions and governs
AWS resources; application deployment is upstream. Contract examples now
show infrastructure inputs (cpu, memory, desired_count, port) not image:.

QA attestation reclassification: 'Design tested' → 'Planned'. QA attests
to infrastructure readiness (contract + Terraform plan + evidence), not
application code. Dev is autonomous (Testing); qa/prod/dr are Planned.

Road to the North Star: phased timeline (v1.0 → v1.9 → v1.10 → v2.0 →
North Star), annotated 'proposed phasing, not formally planned.'

Also: scripts/sync_to_gl.sh added (GitLab mirror sync utility).

---ci---
phase: 51
milestone: v1.9
status: complete
requirements:
  covered: []
  partial: []
---/ci---
This commit is contained in:
Jon Chery
2026-07-27 14:46:05 +00:00
parent 00762c1256
commit a4481e20de
22 changed files with 1981 additions and 509 deletions
@@ -1,7 +0,0 @@
flowchart LR
A["Technical developer"] --> C["Contract YAML"]
B["Citizen developer<br/>(non-technical)"] --> D["Declares intent<br/>in natural language"]
D --> E["Agent produces<br/>the contract"]
C --> F["Same platform:<br/>resolve → check → plan →<br/>policy → confidence → apply"]
E --> F
F --> G["Same safety guarantees,<br/>same audit trail"]
@@ -0,0 +1,21 @@
flowchart LR
subgraph UP ["Upstream — anything"]
direction TB
A["Technical dev\n(app code + contract)"]
B["Citizen dev\n(intent → AI agent\n→ contract)"]
end
subgraph ACDL ["ACDL — infrastructure only"]
C["Same contract\nSame pipeline\nSame safety"]
D["Provision\nAWS resources"]
E["Evidence\nhash-chained"]
end
subgraph DOWN ["Downstream"]
F["AWS resources\nrunning"]
G["Consumer pipeline\ndeploys image"]
end
A --> C
B --> C
C --> D
C --> E
D --> F
F --> G
@@ -0,0 +1,8 @@
flowchart LR
A["dev\n≥ 0.50\nautonomous"] -->|promotion| B["qa\n≥ 0.75\nQA attests"]
B -->|promotion| C["prod\n≥ 0.90\nSRE attests"]
C -->|promotion| D["dr\n≥ 0.95\nSRE + DR drill"]
A -.->|"Testing\n(pilot-ready)"| A
B -.->|"Planned"| B
C -.->|"Planned"| C
D -.->|"Planned"| D
@@ -0,0 +1,25 @@
flowchart LR
subgraph UP ["Upstream — anything"]
direction TB
A["IDE / IDE + AI\n(dev writes contract)"]
B["Agentic SDLC\n(agent writes contract)"]
C["Citizen dev\n(vibe codes → AI agent\n→ contract)"]
end
subgraph ACDL ["ACDL — infrastructure only"]
D["Contract\nvalidated"]
E["Resolve → Plan\nSecurity + Policy checks\nConfidence signal"]
F["Provision\nAWS resources"]
G["Evidence\nhash-chained"]
end
subgraph DOWN ["Downstream"]
H["AWS resources\nrunning"]
I["Consumer pipeline\ndeploys image"]
end
A --> D
B --> D
C --> D
D --> E
E --> F
E --> G
F --> H
H --> I
@@ -0,0 +1,15 @@
flowchart LR
subgraph IN ["6 weighted inputs"]
direction TB
A["Policy\nconformance"]
B["Validation"]
C["Freshness"]
D["Source\nprovenance"]
E["History"]
F["NFRs"]
end
IN --> G["Weighted sum\n→ Confidence score"]
G --> H{"Threshold\ngate"}
H -->|Meets threshold| I["Proceed"]
H -->|Below threshold| J["Halt +\nexplainable reason"]
H -->|Critical finding| J
@@ -0,0 +1,13 @@
flowchart LR
A["Deployment arrives\nat env gate"] --> B["Confidence signal\ncomputed"]
B --> C{"Meets\nthreshold?"}
C -->|No / Critical| D["Halt —\nexplainable reason"]
C -->|Yes| E{"Human attestation\nrequired?"}
E -->|No — dev| F["Autonomous\nproceed"]
E -->|Yes — qa/prod/dr| G["Approver reviews:\ncontract + plan + evidence"]
G --> H{"Approver\ndecides"}
H -->|Approve| I["Attestation recorded\n(identity + state)"]
H -->|Reject| J["Halt — rejection\nextends audit chain"]
I --> K["Deployment\nproceeds"]
F --> K
K --> L["Evidence written\nRPO=0"]
@@ -0,0 +1,11 @@
flowchart LR
A["v1.0\nDEMO\ncomplete"] --> B["v1.1v1.8\nPLATFORM BUILD\ncomplete"]
B --> C["v1.9\nPRESENTATIONS + PATCHES\ncomplete"]
C --> D["v1.10\nNEXT\nHITL wiring\nall-runner OIDC\nregulatory ledger"]
D --> E["v2.0\nFUTURE\ncompliance milestone\nself-service\ndynamic modules\nengine adapters"]
E --> F["North Star\nREALIZED\nfull autonomy (lower)\nattested (higher)\ncitizen dev live\nevidence regulatory-grade"]
A -.->|"stub-driven proof"| A
B -.->|"IR + OIDC + ABAC +\nmodule catalog +\nencryption + decommission"| B
C -.->|"10-slide decks +\ntalking points +\nS&P theme"| C
D -.->|"proposed phasing\nnot formally planned"| D
E -.->|"proposed phasing\nnot formally planned"| E
Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB