Volume 3 — Integration Automation and CI Orchestration
Typed Configurations as the Contract Between Orchestrations and Jobs
About this volume
The orchestration layer is structurally distinct from the job layer, and the thesis that unifies the portfolio's integration story is
typed configurations as the contract between orchestrations and jobs. Volumes 1, 2, 4, 5 and 6 all refer to Part IV ("Workflow
Across Environments"), because profiles are how you eliminate os.environ.get('CI') branches across a codebase. This is the headline
volume of the series and its largest non-AI volume.
Who it is for
Platform engineers, DevOps and QA infrastructure engineers running multi-step pipelines that need to provision, run, observe and tear down across multiple machines and configurations. Also any Python engineer who wants a development workflow that scales from a local laptop to a nightly full sweep without rewriting code at any boundary.
Source material
codecraftai-taskplus— the task model and the FlowEnginecodecraftai-configuration,codecraftai-credentials— the typed configuration categories and credential handling- Parts of
codecraftai-this-app,codecraftai-landscapingandcodecraftai-provisioning
Contents
| Part | Chapters | Theme |
|---|---|---|
| I — The Discipline | Foreword + 1, 2, 3 | The orchestration-vs-jobs layered model; the six-category contract |
| II — Configuration Categories | 4, 5, 6, 7, 8 | Specifications, Landscapes, Topologies, Runtimes, Data Profiles |
| III — Credential Management | 9, 10, 11, 12 | Vocabulary, resolution discipline, in-flight lifecycle, environment spanning |
| IV — Workflow Across Environments | 13, 14, 15, 16, 17 | The four-environment ladder, profile composition, local-dev tax cancellation, CI-failure replay, profile promotion |
| V — taskplus + FlowEngine | 18, 19, 20, 21, 22, 23 | Task model, built-in tasks, YAML grammar, info-passing contract, flow control, extension recipe |
| VI — Real-World Wiring | 24, 25, 26, 27 | CI-vendor shim, bridges to other volumes, case-study capstone, honest scoping |
- Foreword
- Chapter 1 — What Integration-Level Automation Is
- Chapter 2 — Why Most CI YAML Grows Monstrously
- Chapter 3 — The Contract: Six Typed Configuration Categories
- Chapter 4 — Specifications
- Chapter 5 — Landscape Files
- Chapter 6 — Topology Files
- Chapter 7 — Runtime Files vs Environment Variables
- Chapter 8 — Data Profiles
- Chapter 9 — Credential Vocabularies
- Chapter 10 — Credential Resolution
- Chapter 11 — Credentials in Flight
- Chapter 12 — Credentials Across Environments
- Chapter 13 — The Development-Environment Ladder
- Chapter 14 — Configuration Profiles as a Discipline
- Chapter 15 — The Local-Dev Tax and How Typed Configs Cancel It
- Chapter 16 — Reproducing CI Failures Locally
- Chapter 17 — Profile Promotion
- Chapter 18 — The taskplus Task Model
- Chapter 19 — Built-in Task Types
- Chapter 20 — Workflow YAML Grammar
- Chapter 21 — Passing Information to Jobs
- Chapter 22 — Flow Control as Data
- Chapter 23 — Extending the Task Model
- Chapter 24 — Wiring to a Real CI Vendor
- Chapter 25 — Bridges to Other Layers
- Chapter 26 — Case Study: Porting a Real Pipeline
- Chapter 27 — Where This Approach Is Not the Right Fit
Part of The Code Craft AI Books.