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:
@@ -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 `<em class="story">` 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.**
|
||||
|
||||
@@ -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",
|
||||
|
||||
Reference in New Issue
Block a user