Delivery platform lessons

The delivery-platform lessons start from the current fos-workbench and sibling fos workflows. The first goal is to label what already exists before making any platform changes.

L00 - Current pipeline map

L00 - Current pipeline map explains:

fos-workbench pull request and main validation;
tutorial/docs publishing to Cloudflare Pages;
sibling fos staging and production application release;
Sandcastle as issue-to-PR and branch automation feeding CI;
Azure as outside the current delivery-platform operating model;
checkpoint questions for CI, CD, gates, artifacts, and environments.

Source lesson: tutorial/delivery-platform/lesson-00-current-pipeline-map.md.

L01 - CI/CD pipeline anatomy

L01 - CI/CD pipeline anatomy explains:

triggers, jobs, steps, gates, artifacts, secrets, environments, deployment jobs, smoke checks, and failure modes;
why editor and serving are validation gates while deploy-docs is the publishing job;
how generated references, snapshots, warehouses, docs bundles, and dashboard bundles move through the fos-workbench graph;
how sibling fos separates pull-request CI from staging and production promotion;
checkpoint questions with expected reasoning about graph failures.

Source lesson: tutorial/delivery-platform/lesson-01-cicd-pipeline-anatomy.md.

L02 - Delivery catalog

L02 - Delivery catalog explains:

how large repos and multirepos become easier to operate when each repo or service declares ownership, build command, test command, artifact, environments, deploy trigger, secrets boundary, and smoke checks;
how to distinguish repo contract, artifact contract, environment contract, and verification contract;
how fos-workbench and sibling fos fit the catalog shape, with snapshot caveats where data is not live-owned by this repo;
how a polished platform could use catalog data for self-service CI/CD without requiring this module to build that platform now;
checkpoint questions that classify a new repo or service into the catalog shape.

Source lesson: tutorial/delivery-platform/lesson-02-delivery-catalog.md.

L03 - Platform patterns

L03 - Platform patterns explains:

how the current fos-workbench and sibling fos setup compares to polished CI/CD platform patterns for large repos, multirepos, and many users;
why adding more YAML is different from building a delivery platform;
how reusable workflows, change detection, build graphs, immutable artifacts, environment promotion, deployment controllers, policy gates, observability, rollback, and self-service templates map back to current repo state;
which realistic next steps fit this repo without adopting a heavy platform tool;
why Azure remains outside the current delivery-platform operating model;
checkpoint questions that ask the reader to choose a pattern for a concrete scenario.

Source lesson: tutorial/delivery-platform/lesson-03-platform-patterns.md.