Start Here
You need the right framework that drives the right mindset to use CD and agents correctly
Your Migration Journey
A learning path for migrating to continuous delivery, built on years of hands-on experience helping teams remove friction and improve delivery outcomes.
less than a minute
Start with your problem, not the guide. Not sure what is wrong? Answer a few questions.
New here? Read Start Here or follow a Learning Path for a guided reading sequence.
Diagnose
- Triage - Answer a few questions to find the symptoms that match your situation.
- Dysfunction Symptoms - Observable problems organized by testing, deployment, flow, and visibility.
- Anti-Patterns - Practices that undermine delivery, with steps to fix each one.
Migrate
- Migration Phases - Assess, Foundations, Pipeline, Optimize, Deliver on Demand.
- Improvement Plays - Standalone plays for common delivery challenges. Run any play in isolation or as part of a migration.
- Agentic CD - Constraints and practices for AI agent-generated changes.
Reference
- Reference Section - Practices, metrics, testing, pipeline architecture, glossary, FAQ, and resources.
Learning Paths
Curated reading paths through the CD Migration Guide, organized by role and goal. Follow a path end-to-end or jump in at the step that matches where your team is today.
Triage Your Problems
Identify the delivery problems your team is experiencing - without a facilitator.
Dysfunction Symptoms
Start from what you observe. Find the anti-patterns causing it.
Quality and Delivery Anti-Patterns
Start here. Find the anti-patterns your team is facing and learn the path to solving them.
Migrate to CD
A phased approach to adopting continuous delivery, from assessing your current state through delivering on demand.
Phase 0: Assess
Understand where you are today. Map your delivery process, measure what matters, and identify the constraints holding you back.
Phase 1: Foundations
Establish the essential practices for daily integration, testing, and small work decomposition.
Phase 2: Pipeline
Build the automated path from commit to production: a single, deterministic pipeline that deploys immutable artifacts.
Phase 3: Optimize
Improve flow by reducing batch size, limiting work in progress, and using metrics to drive improvement.
Phase 4: Deliver on Demand
The capability to deploy any change to production at any time, using the delivery strategy that fits your context.
Migrating Brownfield to CD
Already have a running system? A phased approach to migrating existing applications and teams to continuous delivery.
CD for Greenfield Projects
Starting a new project? Build continuous delivery in from day one instead of retrofitting it later.
Improvement Plays
Focused, standalone improvement plays teams can run independently or as part of a larger CD migration.
Agentic Continuous Delivery (ACD)
Extend continuous delivery with constraints, delivery artifacts, and practices for AI agent-generated changes.
Reference
Practice definitions, metrics, glossary, and other reference material.
Team Chatbot
A ready-to-use facilitator chatbot that helps your team diagnose delivery problems and navigate the CD migration journey - works with any LLM.
Credits
Contributors who have helped shape this migration guide.
Changelog
Notable updates to the CD migration guide.
Under Construction
This content is being developed and will be available soon.