A single-file HTML guide to SDLC models, the Agile family, DevOps, a fit-finder for picking a process, named anti-patterns, computer-science theory applied to products, DDD and TOGAF. This post shows what is inside and how to read it, adapt it or hand it to an AI assistant.
Open-Source Tools · How-To · Dev & ops tools
How to use delivery-playbook: a field guide for choosing and fixing your software process
Revised
· v1.0.0 · what changed
Code: github.com/herrrickshaw/delivery-playbook
Watch the walkthrough
Watch on YouTube: youtu.be/2VlrR-dwpCQ
Why it is useful
- Team leads, product managers and students get one page that compares Waterfall, V-Model, Spiral, Scrum, Kanban, XP and DevOps side by side, instead of reading seven separate sources.
- It replaces the usual 'which methodology should we use?' meeting with a two-question fit-finder: how often requirements change, and how costly a mistake is once shipped.
- The six named failure modes (Scrummerfall, Zombie Scrum, Watermelon status, Cargo-cult DevOps, Dark agile, Spec-driven paralysis) give a team shared words for process problems, each paired with a concrete fix.
- Evidence from the review: the committed index.html has 14 sections and 28 sub-headings, is a single file with no dependencies, and its further-reading list was link-checked by the author on 17 October 2026. This post did not run any code; it read the committed file.
What it is for
delivery-playbook is the versioned source for a reference page on how software gets delivered. It covers classic SDLC models, the Agile family, DevOps and continuous delivery, practices that hold whatever the model, a fit-finder, failure modes, an applied section, computer-science theory (Conway's Law, Little's Law, CAP theorem and others) applied to product decisions, Domain-Driven Design, TOGAF's ADM cycle and a testing playbook.
You use it by reading it in a browser, by forking the single HTML file and editing it for your own organisation, or by giving it to an AI assistant and asking questions against it.
Who it is for
- Engineering managers and tech leads choosing or fixing a delivery process
- Product managers and analysts who need to speak the same language as engineering
- Students and career-changers learning how SDLC, Agile, DevOps, DDD and TOGAF relate
- Anyone who wants a worked example of a self-contained, no-build reference page
- A certification syllabus: it is a field guide, not an official Scrum, SAFe or TOGAF text; the repo links the primary sources instead
- Legal, compliance or safety-critical process sign-off
- A runnable software library; there is no code to install
What you need
| Requirement | Why | How to get it |
|---|---|---|
| A web browser | The guide is one HTML file; fonts load from Google Fonts | Any modern browser |
| git (optional) | To clone and edit your own copy | git-scm.com, or GitHub's Download ZIP button |
| An AI assistant (optional) | To ask questions about the guide or adapt it | Claude, Gemini, ChatGPT, or an IDE assistant |
Get the code and an AI assistant
You do not have to be a programmer. Get the repository, give it to an AI assistant, and ask in plain language. Any of these routes works:
| Tool | What you need | Best for |
|---|---|---|
| GitHub | Free account to fork or star; git to clone, or the green Code button, then Download ZIP, or open in Codespaces | Getting the code and keeping up with updates |
| Claude Code | Claude subscription or API key; run claude inside the cloned folder | Letting the AI read and run the whole repo |
| Gemini CLI | Google account; run gemini inside the cloned folder | The same hands-on workflow with Gemini |
| Claude.ai, Gemini or ChatGPT in the browser | A chat account; upload README.md and the files you care about (or paste the output of git ls-files) | Understanding the project and asking questions without installing anything |
| Other tools (Copilot Chat, Cursor, Codex CLI) | Open the cloned folder in the tool and point it at README.md first | Editing and extending the code |
git clone https://github.com/herrrickshaw/delivery-playbook.git
cd delivery-playbook
claude # or: gemini
Install
- Clone the repository (or use Download ZIP on GitHub)
git clone https://github.com/herrrickshaw/delivery-playbook.git cd delivery-playbook - Open the page. There is nothing to install or build.
open index.html # macOS; on Linux use xdg-open, on Windows double-click the file
Quick start: commands and what you should see
List the sections of the guide from the command line (not run in the demo as a shipped command; this is a one-line check you can run yourself)
grep -o '<h2[^>]*>[^<]*' index.html
One line per section: Lineage, Classic SDLC models, The Agile family, DevOps & continuous delivery, Practices that hold regardless of model, Fit finder, Failure modes worth naming, Applied, Computer science theory applied, Domain-Driven Design, TOGAF, From your own library, Essential approaches for building tools, The software testing playbook.
Use the fit-finder: place your project on two axes
# In the browser, go to the 'Fit finder' section.
# 1. How often do requirements really change? (stable / volatile)
# 2. How costly is a mistake once shipped? (low / high)
You land in one of four quadrants, each with a recommendation (see the sample outputs below).
Sample outputs
Real output from a run on the date shown in the sources line; trimmed to fit.
Section outline extracted from index.html (read from the committed file, run 19 October 2026)
python3 -I extract_headings.py index.html # a 10-line helper that prints h2/h3 text
Lineage
Classic SDLC models
The Agile family
DevOps & continuous delivery
Practices that hold regardless of model
Fit finder
Failure modes worth naming
Scrummerfall Agile
Zombie Scrum Agile
Watermelon status Any model
Cargo-cult DevOps DevOps
Dark agile Scaled agile
Spec-driven paralysis Plan-driven
Applied: a three-lens stack from two of my repos
Computer science theory, applied
Domain-Driven Design
TOGAF: enterprise architecture
The software testing playbook
Ice-cream-cone Inverted pyramid
Coverage theater Metric gaming
Flaky-test tolerance Any suite
Testing implementation, not behavior Over-coupling
Mocking everything Zero real integration
Trimmed: sub-headings under 'Practices that hold regardless of model' and some testing items omitted.
The fit-finder's four recommendations (text of the Fit finder section)
(read in the browser; text copied from the section)
High stakes, known scope -> V-Model or Waterfall. The cost of a wrong turn justifies planning it out first.
High stakes, unclear scope -> Spiral. Spend the first loops on prototypes and risk, not the full build.
Low stakes, known scope -> Incremental or Kanban. Don't pay for ceremony the risk doesn't justify.
Low stakes, unclear scope -> Scrum, XP, Lean Startup. Optimise for the speed of the feedback loop.
DevOps discipline runs underneath all four quadrants; it is not a fifth option.
Layout flattened to plain text.
One failure mode with its fix
(Failure modes worth naming section)
Zombie Scrum (Agile)
All four ceremonies happen, on schedule, every sprint, and nothing anyone says in them ever changes what happens next.
Fix: every retro item gets a named owner and a deadline, tracked exactly like a bug.
Verbatim from the committed page apart from line breaks.
Ways to use it
| Method | How it works |
|---|---|
| Read it | Open index.html locally, or read the live version linked from the repo README. |
| Fork and adapt | Edit the single HTML file for your organisation's process, then host it with GitHub Pages or an internal site. |
| Use as a team workshop prompt | Run the fit-finder and the failure-mode list in a retrospective and ask which ones apply. |
| Through an AI assistant | Give the file to an assistant and ask it to map your current process onto the guide. |
Sample prompts for your AI assistant
Copy, paste and edit the parts in [brackets].
- Read index.html in this repo and summarise the six failure modes in a table: name, symptom, fix.
- Here is how my team works: [describe]. Using the Fit finder section, which quadrant are we in and which model does the guide suggest? Tell me where our current process differs.
- Which of the ten computer-science-theory items in this guide (Conway, Little, CAP, Amdahl and others) is most relevant to a team with long code-review queues? Quote the relevant passage.
- Turn the testing-playbook section into a one-page checklist I can paste into a pull-request template.
- List the primary sources linked in the further-reading section and tell me which claims in the guide each one supports.
- Adapt this guide for a 5-person data-science team: which sections would you cut and what would you add?
Limits and honest caveats
- No code was executed for this post: the repo is a document. Everything shown was read from the committed index.html.
- It is a field guide with the author's opinions, not an official standard. For Scrum, TOGAF or SAFe, check the primary sources the guide links.
- The repo's own README notes that the SAFe framework site returned HTTP 403 to the author's link check, so that source was not verified.
- The live claude.ai copy is republished separately from this repo and the two are not auto-synced, so they can differ.
- Fonts load from Google Fonts, so the page looks plainer offline.
- Not legal, compliance or professional-certification advice.
Sources: the delivery-playbook README and index.html, read on 19 October 2026 from the local clone (no code run).
- v1.0.0 — 27 October 2026 — first published.
About this article: Researched, written and edited by Umashankar Triplicane Dwarakanathan, with AI research assistance; every figure is meant to trace to the primary source cited. See the Editorial Policy for how sourcing, AI use and corrections work.