Thinking global, living local

How to use delivery-playbook: a field guide for choosing and fixing your software process

October 19, 2026

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

Skip to article content
Text Size

Revised · v1.0.0 · what changed

1self-contained HTML file (62.5 KB, no build step)
14top-level sections
6named process failure modes, each with a fix
4quadrants in the volatility-vs-cost-of-failure fit-finder

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
Not for.
  • 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

RequirementWhyHow to get it
A web browserThe guide is one HTML file; fonts load from Google FontsAny modern browser
git (optional)To clone and edit your own copygit-scm.com, or GitHub's Download ZIP button
An AI assistant (optional)To ask questions about the guide or adapt itClaude, 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:

ToolWhat you needBest for
GitHubFree account to fork or star; git to clone, or the green Code button, then Download ZIP, or open in CodespacesGetting the code and keeping up with updates
Claude CodeClaude subscription or API key; run claude inside the cloned folderLetting the AI read and run the whole repo
Gemini CLIGoogle account; run gemini inside the cloned folderThe same hands-on workflow with Gemini
Claude.ai, Gemini or ChatGPT in the browserA 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 firstEditing and extending the code
git clone https://github.com/herrrickshaw/delivery-playbook.git
cd delivery-playbook
claude      # or: gemini

Install

  1. Clone the repository (or use Download ZIP on GitHub)
    git clone https://github.com/herrrickshaw/delivery-playbook.git
    cd delivery-playbook
  2. 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

MethodHow it works
Read itOpen index.html locally, or read the live version linked from the repo README.
Fork and adaptEdit the single HTML file for your organisation's process, then host it with GitHub Pages or an internal site.
Use as a team workshop promptRun the fit-finder and the failure-mode list in a retrospective and ask which ones apply.
Through an AI assistantGive 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).

Revision history.
  • 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.

Umashankar Triplicane Dwarakanathan
Contact Us
Umashankar Triplicane Dwarakanathan
Investment Promotion & Energy-Sector Leader · Chennai, Tamil Nadu, India
LinkedIn → GitHub → Email +91 78273 81696
How this site works

Data-led analysis of India's trade, currency and industrial policy. Every article is built from primary official sources, and every figure links back to the release, table or filing it came from.

Sources. DGCI&S TradeStat (imports/exports, HSN-wise) · PIB (government press releases, January 2017 to today, refreshed daily) · RBI (circulars, balance of payments) · MoSPI (CPI/WPI, IIP) · PARIVESH (environmental clearances) · CCIL (bond yields) · BIS (policy rates) · SEBI, NSE/BSE and SEC filings for company data.

Interpretation. Figures carry their vintage and retrieval date; estimates and press-reported numbers are labelled as such; where sources disagree, both are shown. Corrections are made visibly, never silently. Articles are written with AI assistance from the cited sources — AI-generated text can misstate figures even when working from real material, so verify any number that matters to a decision against the linked primary source.

footer

Browse all articles by topic

Every piece on this blog, grouped. Or read the full index.

Agriculture & FertilisersAI ToolsChemicalsClimate & CarbonEnergy & FuelsGas & LNGImport SubstitutionIndustrial PolicyMarkets & FinanceMobility & EVPrices & InflationTextilesTrade & Tariffs

Each topic is a live archive page that updates itself as pieces are labelled. It replaces a hand-kept list that had fallen 18 articles behind.