Back to AI/ML Overview
🧭 Knowledge Site · Feature-as-Product Delivery · One Worked Example

From the ask to the releaseCoding agents shortened the build. They did not shorten the impact analysis.

A business ask arrives as one line — “add step-up verification at login.” Behind it sit nine services, six API consumers, two partners, a data migration, a security control, and a release train. This site follows that one line all the way to production twice: the traditional path, meeting by meeting, and the path where one owner who has operated the architecture drafts the epic brief, the impact map, the API contract, the per-team notes, and a clickable mock before the first meeting — so the meeting reviews a document instead of starting from a question.

🎯Why this exists

Writing a detailed brief, the breakdown, the dependency and impact analysis, the epic-to-story fan-out, the release plan and the stakeholder notes was always the analyst's craft. With AI-assisted coding it has also become the bottleneck: a team can now build the wrong thing quickly, and the debt that leaves behind is the expensive kind. Doing that analysis well needs someone who understands the system architecture — the services, the data, the DevOps pipeline, the release train — not only the process.

🔑The stance
This is not a case against business analysts or product managers. They write the artifacts a release train depends on. The claim is that someone who has operated the architecture can draft those artifacts before discovery, so the first meeting reviews a document instead of starting from a one-line ask. Every lane stays: the owner drafts, teams confirm, security signs, the Product Owner accepts.

🗺️What is inside

The traditional path, counted

A real swimlane — horizontal role lanes, time left to right — of how the ask travels today: intake, discovery per team, the BRD, review cycles, architecture and security review, the late DB and partner questions. Hand-offs and waits counted (illustrative).

One owner, feature as product

The same lanes, front-loaded: epic brief → impact map → consumer matrix → OpenAPI contract + Postman collection → clickable mock → per-team one-pagers → stories → acceptance → metric. Who still signs what.

The worked example, filled

Every artifact for step-up verification at login, actually filled in: the brief with a baseline and a target, the additive-vs-versioned decision record, the controls and non-functional requirements, ten stories with Given/When/Then, the disagreement and how it was resolved, the traceability chain, and a clickable prototype.

Epic to release train, and the templates

How Agile, Scrum and the release train relate; the work hierarchy; user, enabler, QA, DevOps stories and spikes; staggered QA as a constraint; one epic across many sprints; every meeting in order; release readiness. Nine copy-ready templates, each shown blank and filled. A glossary that drills down from every page.

🖱️How to read it

  • Every diagram is clickable — a box opens what it is and what it looks like in the example.
  • A ? badge means a glossary term is attached; terms drill down into each other.
  • Every abbreviation is expanded in a key directly under the diagram. No decoding required.
  • Chapter 5 is the page to forward. Chapters 1–4 explain why it looks the way it does.