From de1657394ea556c4391ea9ca0410849f392439c8 Mon Sep 17 00:00:00 2001 From: Jon Chery Date: Wed, 29 Jul 2026 14:54:53 +0000 Subject: [PATCH] =?UTF-8?q?docs(milestone):=20complete=20v1.13=20=E2=80=94?= =?UTF-8?q?=20Presentation=20Polish=20(tag=20v1.13.0)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update config.json (active milestone v1.12 -> v1.13, ship_tag v1.13.0) and ROADMAP.md (add v1.13 summary line + full v1.13 section documenting P71, the 6 new diagrams, the story-arc restructure, and the review outcome). NFR milestone — final patch (v1.13.0) IS the deliverable. No separate milestone tag. ---ci--- project: acdl phase: 0 milestone: v1.13 status: complete ---/ci--- --- .ciagent/ROADMAP.md | 59 ++++++++++++++++++++++++++++++++++++++++++++ .ciagent/config.json | 8 +++--- 2 files changed, 63 insertions(+), 4 deletions(-) diff --git a/.ciagent/ROADMAP.md b/.ciagent/ROADMAP.md index 30034fa..cc55d80 100644 --- a/.ciagent/ROADMAP.md +++ b/.ciagent/ROADMAP.md @@ -24,6 +24,7 @@ - **v1.10.2 (complete, tag `v1.10.2`):** contract surface redesign + rename + .yml repo-wide + deck polish. Breaking contract schema change: new top-level fields `id`/`name`/`infrastructure`; dropped `uses:`/`module:`/`inputs:`. All 44 `.yaml` → `.yml`. Code review: 3 P0 auto-fixed, 2 P1+ flagged. 494 tests pass. Gitea release id 237. - **v1.11 (complete, tag `v1.11.0`):** RESTART — stateless adapter + pipeline-driven module lifecycle testing. Closes G-005 (CAP-017..022 deploy-unverified) and G-008 (no cost docs) via a corrected architecture, not the failed v1.11 first attempt (which produced 4 drifted VPCs, ran terraform apply from Python, and had no module lifecycle tests). The restart branches off `v1.10.2` and rebuilds v1.11 on three corrections: (1) the terraform adapter becomes a stateless assembler — each L1 module ships a real `terraform/` module dir (variables/locals/main/outputs) owning its resource shape, nested blocks, and defaults; the adapter deletes `TYPE_MAP`/`INPUT_MAP`/`OUTPUT_MAP` and all 39 type-specific branches, becoming a ~80-line assembler that emits `module "x" { source = ... }` blocks; (2) lifecycle is owned by terraform via the shell orchestrator (`run_platform.sh --apply`/`--destroy`), never by Python — `verify_deploy_microservice.py` is deleted; (3) testing is pipeline-driven — a `modules-lifecycle` pipeline (Gitea + GitHub, byte-identical) matrix-runs each L1 module's `examples/{simple,complex}.yml` contracts through apply→modify→destroy against live AWS; no per-module Python. A single platform VPC (`terraform/platform`) is shared by all stacks via `data` source — no per-contract VPC. State keys are deterministic and env-aware (`spike/{id}/{env}/terraform.tfstate`), stable across lifecycle changes. 13 phases (P56a–P65). See the v1.11 section below for the phase breakdown. - **v1.12 (complete, tag `v1.12.0`):** Presentation Refinement — the leadership decks synced to the v1.11-verified reality (22/22 Verified, stateless adapter, lifecycle pipeline, cost figures, pre-mortem). Includes the CAP-013 adapter dedup fix + 2 probe fixes (required to make the deck claims true) + the ACDL_LIFECYCLE_MODE CI flag (lifecycle tests default to plan-only, full on override). 6 phases (P66–P70). See the v1.12 section below. +- **v1.13 (complete, tag `v1.13.0`):** Presentation Polish — both leadership decks polished across all 4 pipeline layers (source .md → -marp.md → .html → -talking-points.md). Action headlines replace category names; story-arc restructure (Intro ~10% / Body ~80% / Conclusion ~10%); removed all transition story lines; bullets ≤12 words, 3–4 per main slide; larger fonts (body 26px, h1 40px, h2 32px); 6 new mermaid diagrams (frictions 2×2, north-star before/after, zero-trust flow, catalog primitives→modules, decommission gates, semver timeline). Code review: 0 P0, 2 P1 auto-fixed (slide-count metadata + README directory layout). 522 tests pass. Docs-only NFR patch. 1 phase (P71). See the v1.13 section below. - **v1.0 demo URL:** https://git.cloudinit.dev/continuous-intelligence/acdl-evidence/raw/branch/main/index.html --- @@ -960,3 +961,61 @@ lifecycle pipeline defaults to plan-only. The v1.10 "deploy-unverified Ship tag at milestone COMPLETE: `v1.12.0` (v1.11.0 → v1.12.0; feature milestone — includes the adapter fix + lifecycle flag). **DONE.** + +## v1.13 (complete — Presentation Polish, tag `v1.13.0`) + +The v1.13 milestone polishes both leadership decks for clarity, impact, and +storytelling best practices. It is a docs-only NFR patch — no code, no +capability claims changed, no schema changes. + +**Why.** The v1.12 decks were factually correct but rhetorically flat: +category-name headlines ("The Contract-Driven Model", "Zero-Trust by +Default"), dense 5–6 bullet slides, formulaic italic transition lines on +every slide, and body fonts at 22px (below the 24pt readability floor). +v1.13 applies the storytelling + design best practices the leadership +audience requires. + +**What changed.** Both decks (`how-the-platform-works` + `the-developer-experience`) +across all 4 pipeline layers (source `.md` → `-marp.md` → `.html` → +`-talking-points.md`): + +- **Action headlines** replace category names — each slide title states the + takeaway, not the topic ("One YAML file. The platform owns everything + else." not "The Contract-Driven Model"). +- **Story-arc restructure** — Intro ~10% / Body ~80% (3–5 points) / + Conclusion ~10%. Before/after 2-slide sequence on Problem → North Star. +- **Removed all `` transition lines** — flow now carried + by action headlines + talking points (saved ~15–20 words × 17 slides). +- **Bullets ≤12 words, 3–4 per main slide** (was 5–6). Cut parentheticals, + sub-clauses, redundant restatements. +- **Larger fonts** — body 22→26px, h1 34→40px, h2 26→32px, blockquote + 20→24px. High contrast preserved, no animations, maturity badges intact. +- **6 new mermaid diagrams** → PNGs: + - `platform-works-02-frictions` (2×2 quadrant of the four frictions) + - `platform-works-03-north-star` (before/after: today's queue vs. ACDL) + - `platform-works-07-zero-trust` (OIDC + ABAC flow) + - `developer-experience-05-catalog` (primitives → composed modules) + - `developer-experience-07-decommission` (6-node gate flow with 2 SRE gates) + - `developer-experience-08-semver` (floating/pinned/major-only timeline) +- **Appendix expanded** — "Security by Construction" (formerly a dense main + slide) moved to appendix A3; platform deck now 10 main + TOC + 8 appendix + (19 slides); developer deck 10 main + TOC + 7 appendix (18 slides). + +**Phases:** + +- **P71 — deck polish (single phase).** Restructured both decks across all + 4 layers. Created 6 new `.mmd` + 6 new `.png` files. Re-rendered both + HTML. Re-distilled both talking-points to match the new slide structure. + Multi-persona code review: 0 P0, 2 P1 auto-fixed (slide-count metadata in + source `.md` headers + `README.md` directory layout drifted — both + synced). 522 tests pass. No code files touched. + +**Outcome:** the decks now read as a story (problem → solution → evidence), +each slide has one idea with an action headline, the body is scannable in +2 seconds, and the visuals carry the mechanism where bullets undersold it. +22/22 Verified framing, badge statuses, and capability claims preserved +verbatim from v1.12. No factual drift. + +Ship tag at milestone COMPLETE: `v1.13.0` (v1.12.0 → v1.13.0; docs-only NFR +patch — final patch IS the deliverable, no separate milestone tag). +**DONE.** diff --git a/.ciagent/config.json b/.ciagent/config.json index bc2cc88..ae808ec 100644 --- a/.ciagent/config.json +++ b/.ciagent/config.json @@ -4,11 +4,11 @@ { "slug": "acdl", "name": "Agentic Cloud Delivery Platform", - "milestone": "v1.12", + "milestone": "v1.13", "status": "complete", - "milestone_branch": "milestone/v1.12-presentation", - "milestone_base": "v1.11.0", - "ship_tag": "v1.12.0" + "milestone_branch": "milestone/v1.13-deck-polish", + "milestone_base": "v1.12.0", + "ship_tag": "v1.13.0" } ], "active_project": "acdl",