docs(milestone): complete v1.13 — Presentation Polish (tag v1.13.0)

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---
This commit is contained in:
Jon Chery
2026-07-29 14:54:53 +00:00
parent 06dea7a176
commit 1536f0427b
2 changed files with 63 additions and 4 deletions
+59
View File
@@ -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 (P56aP65). 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 (P66P70). 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, 34 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 56 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% (35 points) /
Conclusion ~10%. Before/after 2-slide sequence on Problem → North Star.
- **Removed all `<em class="story">` transition lines** — flow now carried
by action headlines + talking points (saved ~1520 words × 17 slides).
- **Bullets ≤12 words, 34 per main slide** (was 56). 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.**
+4 -4
View File
@@ -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",