diff --git a/docs/presentations/README.md b/docs/presentations/README.md index 06b6074..a8bbb49 100644 --- a/docs/presentations/README.md +++ b/docs/presentations/README.md @@ -115,7 +115,7 @@ Distill the source of truth (Step 1) into presenter-ready cues, indexed by the Marp deck (Step 2) slide structure: - **One section per Marp slide** — `## Slide N — Title`, matching the Marp - deck's 10 main + 7 appendix slide structure exactly. The Marp deck + deck's 10 main + Appendix TOC + appendix slide structure exactly. The Marp deck provides the indexing and context (what the audience sees); the source markdown provides the content (the speaker notes, the detail, the nuance). - **3-6 talking point bullets per slide** — punchy, actionable cues distilled @@ -145,37 +145,49 @@ and re-distill. docs/presentations/ ├── README.md ← this file ├── how-the-platform-works.md ← Step 1: full source of truth -├── how-the-platform-works-marp.md ← Step 2: Marp deck (10 main + 7 appendix) +├── how-the-platform-works-marp.md ← Step 2: Marp deck (10 main + TOC + 8 appendix = 19) ├── how-the-platform-works.html ← Step 3: rendered HTML (committed) -├── how-the-platform-works-talking-points.md ← Step 4: presenter cues (16 sections) +├── how-the-platform-works-talking-points.md ← Step 4: presenter cues (19 sections) ├── the-developer-experience.md ← Step 1: full source of truth -├── the-developer-experience-marp.md ← Step 2: Marp deck (10 main + 7 appendix) +├── the-developer-experience-marp.md ← Step 2: Marp deck (10 main + TOC + 7 appendix = 18) ├── the-developer-experience.html ← Step 3: rendered HTML (committed) -├── the-developer-experience-talking-points.md ← Step 4: presenter cues (16 sections) +├── the-developer-experience-talking-points.md ← Step 4: presenter cues (18 sections) └── assets/ ├── puppeteer-config.json ← no-sandbox config for mmdc ├── mmd/ ← mermaid source files (Step 2 input) │ ├── sp-theme.json ← S&P Red/Black/White theme (mermaid-cli --configFile) │ ├── platform-works-01-contract-driven.mmd + │ ├── platform-works-02-frictions.mmd │ ├── platform-works-02-end-to-end-flow.mmd + │ ├── platform-works-03-north-star.mmd │ ├── platform-works-03-scope-boundary.mmd │ ├── platform-works-04-confidence-signal.mmd │ ├── platform-works-05-attestation-flow.mmd + │ ├── platform-works-07-zero-trust.mmd │ ├── developer-experience-01b-scope-boundary.mmd │ ├── developer-experience-02-what-dev-does.mmd │ ├── developer-experience-03-no-cloning.mmd │ ├── developer-experience-04-promotion-journey.mmd + │ ├── developer-experience-05-catalog.mmd + │ ├── developer-experience-07-decommission.mmd + │ ├── developer-experience-08-semver.mmd │ └── road-to-north-star.mmd └── png/ ← rendered PNGs (embedded in Marp) ├── platform-works-01-contract-driven.png + ├── platform-works-02-frictions.png ├── platform-works-02-end-to-end-flow.png + ├── platform-works-03-north-star.png ├── platform-works-03-scope-boundary.png ├── platform-works-04-confidence-signal.png ├── platform-works-05-attestation-flow.png + ├── platform-works-07-zero-trust.png ├── developer-experience-01b-scope-boundary.png ├── developer-experience-02-what-dev-does.png ├── developer-experience-03-no-cloning.png ├── developer-experience-04-promotion-journey.png + ├── developer-experience-05-catalog.png + ├── developer-experience-07-decommission.png + ├── developer-experience-08-semver.png └── road-to-north-star.png ``` @@ -183,12 +195,14 @@ docs/presentations/ ### Appendix structure -Each Marp deck has **10 main slides + 6 appendix slides** (17 total). The +Each Marp deck has **10 main slides + an Appendix TOC + appendix slides**. The main 10 are the presentation; the appendix is for deep dives and Q&A backup. +The platform-works deck has 8 appendix slides (A1–A8); the developer-experience +deck has 7 appendix slides (A1–A7). Both include an Appendix TOC slide. - **Main slides** (1-10): the story arc, high-impact, minimal text, visual-heavy. These are what the audience sees during the talk. -- **Appendix slides** (A1-A5 + TOC): detail-heavy slides moved out of the +- **Appendix slides** (TOC + A1..An): detail-heavy slides moved out of the main 10 to preserve the narrative flow. The appendix starts with a TOC slide listing the contents, followed by detail slides and a glossary. - **The Road to the North Star** is a required appendix slide in both decks @@ -331,5 +345,5 @@ attachments to the Gitea release. | Deck | Source of truth (Step 1) | Marp deck (Step 2) | Rendered HTML (Step 3) | Talking points (Step 4) | Slides | Audience | |---|---|---|---|---|---|---| -| How the Platform Works | `how-the-platform-works.md` | `how-the-platform-works-marp.md` | `how-the-platform-works.html` | `how-the-platform-works-talking-points.md` | 10 main + 7 appendix | CTO, Head of Cloud, Head of Infra, Head of DevOps | -| The Developer Experience | `the-developer-experience.md` | `the-developer-experience-marp.md` | `the-developer-experience.html` | `the-developer-experience-talking-points.md` | 10 main + 7 appendix | CTO, Head of Cloud, Head of Infra, Head of DevOps | \ No newline at end of file +| How the Platform Works | `how-the-platform-works.md` | `how-the-platform-works-marp.md` | `how-the-platform-works.html` | `how-the-platform-works-talking-points.md` | 10 main + TOC + 8 appendix (19) | CTO, Head of Cloud, Head of Infra, Head of DevOps | +| The Developer Experience | `the-developer-experience.md` | `the-developer-experience-marp.md` | `the-developer-experience.html` | `the-developer-experience-talking-points.md` | 10 main + TOC + 7 appendix (18) | CTO, Head of Cloud, Head of Infra, Head of DevOps | \ No newline at end of file diff --git a/docs/presentations/how-the-platform-works-talking-points.md b/docs/presentations/how-the-platform-works-talking-points.md index 735fc0e..4e3f2da 100644 --- a/docs/presentations/how-the-platform-works-talking-points.md +++ b/docs/presentations/how-the-platform-works-talking-points.md @@ -1,6 +1,6 @@ # How The Platform Works — Talking Points -> **Companion to:** `how-the-platform-works-marp.md` (10 main + 8 appendix = 18 slides) +> **Companion to:** `how-the-platform-works-marp.md` (10 main + Appendix TOC + 8 appendix = 19 slides) > **Content source:** `how-the-platform-works.md` (full source of truth with speaker notes) > **Purpose:** Presenter-ready cues — 3-6 talking points per slide + the one key takeaway the audience should remember. > **Audience:** Senior Leadership — CTO, Head of Cloud, Head of Infrastructure, Head of DevOps diff --git a/docs/presentations/how-the-platform-works.md b/docs/presentations/how-the-platform-works.md index 0fac2cd..88d0be6 100644 --- a/docs/presentations/how-the-platform-works.md +++ b/docs/presentations/how-the-platform-works.md @@ -2,7 +2,7 @@ > **Subtitle:** Agentic Cloud Delivery Platform > **Audience:** Senior Leadership, CTO, Head of Cloud, Head of Infrastructure, Head of DevOps -> **Length:** ~15 minutes · 10 main + 8 appendix = 18 slides +> **Length:** ~15 minutes · 10 main + Appendix TOC + 8 appendix = 19 slides > **Purpose:** Sell the platform's value to tech leadership — zero-trust, security, observability, auditability, and the shift from "operators guess" to "the platform computes safety." > **Maturity framing:** "Testing" = works internally, dev pilot-ready. "Planned" = on the roadmap, not yet implemented. "Agentic" = involves AI agents or autonomous decision-making. > **Re-verification (2026-07-29):** Every "Testing" claim in this deck was re-verified in v1.10 Phase 54 (D-093) and again in v1.11 via the pipeline-driven lifecycle tests (P59–P62). The headline E2E (contract → resolver → adapter → terraform init/validate/plan) passes against the live AWS account; the local emulating tier (Phase 53) runs the full E2E with no cloud credentials. **22/22 auto-verifiable capabilities Verified** (CAP-013 fixed in v1.12 P67 — the adapter's multi-resource L1 dedup defect is closed; CAP-017/018 probe bugs fixed). The v1.11 lifecycle pipeline ran apply→modify→destroy against live AWS and was then torn down to zero-cost (D-096). See `.ciagent/CAPABILITY_INVENTORY.md` and `.ciagent/PRE_MORTEM.md`. diff --git a/docs/presentations/the-developer-experience-talking-points.md b/docs/presentations/the-developer-experience-talking-points.md index 2917819..a492f55 100644 --- a/docs/presentations/the-developer-experience-talking-points.md +++ b/docs/presentations/the-developer-experience-talking-points.md @@ -1,6 +1,6 @@ # The Developer Experience — Talking Points -> **Companion to:** `the-developer-experience-marp.md` (10 main + 7 appendix = 17 slides) +> **Companion to:** `the-developer-experience-marp.md` (10 main + Appendix TOC + 7 appendix = 18 slides) > **Content source:** `the-developer-experience.md` (full source of truth with speaker notes) > **Purpose:** Presenter-ready cues — 3-6 talking points per slide + the one key takeaway the audience should remember. > **Audience:** Senior Leadership — CTO, Head of Cloud, Head of Infrastructure, Head of DevOps diff --git a/docs/presentations/the-developer-experience.md b/docs/presentations/the-developer-experience.md index 3d43e85..3eee593 100644 --- a/docs/presentations/the-developer-experience.md +++ b/docs/presentations/the-developer-experience.md @@ -2,7 +2,7 @@ > **Subtitle:** Agentic Cloud Delivery Platform > **Audience:** Senior Leadership, CTO, Head of Cloud, Head of Infrastructure, Head of DevOps -> **Length:** ~15 minutes · 10 main + 7 appendix = 17 slides +> **Length:** ~15 minutes · 10 main + Appendix TOC + 7 appendix = 18 slides > **Purpose:** Sell the developer experience and the citizen developer experience to tech leadership — velocity without sacrificing safety, and security/observability/compliance as platform defaults rather than per-team effort. > **Maturity framing:** "Testing" = works internally, dev pilot-ready. "Planned" = on the roadmap. "Agentic" = involves AI agents or autonomous decision-making. > **Re-verification (2026-07-29):** Every "Testing" claim in this deck was re-verified in v1.10 Phase 54 (D-093) and again in v1.11 via the pipeline-driven lifecycle tests (P59–P62). The headline E2E (contract → resolver → adapter → terraform init/validate/plan) passes against the live AWS account; the local emulating tier (Phase 53) runs the full E2E with no cloud credentials. **22/22 auto-verifiable capabilities Verified** (CAP-013 fixed in v1.12 P67 — the adapter's multi-resource L1 dedup defect is closed). The v1.11 lifecycle pipeline ran apply→modify→destroy against live AWS and was then torn down to zero-cost (D-096). See `.ciagent/CAPABILITY_INVENTORY.md` and `.ciagent/PRE_MORTEM.md`.