SkyWaysThe agentic manual

The four methods

The frameworks, and how they merge into P0 to P3

AI-DLC, AIDD, BMAD and spec-driven development on one lifecycle: how they merge into the SkyWays PDLC, every acronym decoded, and where each came from.

Who this page is for, and how to use it
For

Anyone who keeps meeting AI-DLC, AIDD, BMAD, SDD and forty acronyms and wants them placed on one map, and anyone who wants to know how much to trust a number in this manual.

Use it to

Settle three questions fast: which method covers what, what an acronym means here, and where a framework came from. Then carry four pictures in your head.

How
  1. Start with the picture: four methods on one lifecycle. They are not competitors, they cover different phases.
  2. Use the pictures as arguments: each one ends in a rule you can apply tomorrow.
  3. Check the lineage column before you quote a figure: documented, established, or this manual's own default.
Four methodsonthe four phasesThe SkyWays PDLCP0 · FrameP1 · Design & SpecP2 · Build & ProveP3 · Run & LearnSDDestablishedThe spec, not the code, is what youmaintain; code is regenerated from it.a spec sketch,lightly: the painand the ceilingthe spec is theartefact: eightfields, stable IDscode generatedfrom the spec,regenerated onchangelightly: theincident edits thespec firstBMAD MethoddocumentedSkills and five named agents in yourcoding tool; one Build loop, documentsadded as the work grows.the Analyst's brief,or none at allPM, UX andArchitect: PRD,DESIGN.md, thespinea spec and itsstories, then Buildper storyextended here:learn and adjust,into the next briefAI-DLC (AWS)documentedThree phases and bolts of hours or daysreplace sprints; a person approves everyboundary.inception: anintent becomesunits of workmob elaboration,NFRs capturedconstruction inbolts, mobconstructionoperations, runadaptivelyAIDD, the daily craftestablishedHow an engineer works with a codingagent day to day, whichever methodframes it.silentsilentcontext files, storyfiles, a harness inCI, review by risksilentThis manual addsworking methodThe parts none of the methods decide, inthe phase where each belongs.the AI-fit verdict,the autonomyceiling, the valuelinewhat the sign-offneeds: spec, bar,guardrails, and theauthority budgetone unknown perbolt, a lower boundnot a score, theshadow runtwo numbers, drift,the incident as thenext P0sign-off (the hard gate)A filled cell is where the method says something about that phase; a dashed cell is where a team has to bring its own answer. The last row is where this manual'sown devices sit.

Four methods on the four phases

establishedSDDThe spec, not the code, is what you maintain; code is regenerated from it.
  • P0 · Framea spec sketch, lightly: the pain and the ceiling
  • P1 · Design & Specthe spec is the artefact: eight fields, stable IDs
  • P2 · Build & Provecode generated from the spec, regenerated on change
  • P3 · Run & Learnlightly: the incident edits the spec first
documentedBMAD MethodSkills and five named agents in your coding tool; one Build loop, documents added as the work grows.
  • P0 · Framethe Analyst's brief, or none at all
  • P1 · Design & SpecPM, UX and Architect: PRD, DESIGN.md, the spine
  • P2 · Build & Provea spec and its stories, then Build per story
  • P3 · Run & Learnextended here: learn and adjust, into the next brief
documentedAI-DLC (AWS)Three phases and bolts of hours or days replace sprints; a person approves every boundary.
  • P0 · Frameinception: an intent becomes units of work
  • P1 · Design & Specmob elaboration, NFRs captured
  • P2 · Build & Proveconstruction in bolts, mob construction
  • P3 · Run & Learnoperations, run adaptively
establishedAIDD, the daily craftHow an engineer works with a coding agent day to day, whichever method frames it.
  • P2 · Build & Provecontext files, story files, a harness in CI, review by risk
  • Silent in P0, P1 and P3
working methodThis manual addsThe parts none of the methods decide, in the phase where each belongs.
  • P0 · Framethe AI-fit verdict, the autonomy ceiling, the value line
  • P1 · Design & Specwhat the sign-off needs: spec, bar, guardrails, and the authority budget
  • P2 · Build & Proveone unknown per bolt, a lower bound not a score, the shadow run
  • P3 · Run & Learntwo numbers, drift, the incident as the next P0

A filled cell is where the method says something about that phase; a dashed cell is where a team has to bring its own answer. The last row is where this manual's own devices sit.

Not competitors. Each method speaks to part of the lifecycle. The decision that matters is not which method but how deep to go on this change.

Four methods, one lifecycle: where each one sits

They are not competitors. Each speaks to part of the lifecycle, and the decision that matters is not which method to adopt but how deep to go on this change. A filled cell is where a method says something about that phase; a dashed cell is where you bring your own answer.

MethodWhat it isWhere it sitsWhen to use it
SDD
Spec-driven development
The spec, not the code, is what you maintain. Code is generated from it and regenerated on change.P1 and P2 mainly; lightly in P0 and P3Always. It is the backbone.
BMAD
Breakthrough Method of Agile AI-Driven Development
Skills in your coding tool: five named agents, one Build loop, and documents (a brief, a PRD, a spine, a spec, stories) added around it as the work grows.P0 to P2, sized to the change; extended here into P3, as learn and adjustComplex, multi-team, audited work. Its project path is six documents before any code; its own docs send a small change straight to Build.
AI-DLC
AI-Driven Development Life Cycle (AWS)
Adaptive: run only the lifecycle stages a given change actually needs.A principle across all four phasesWhen the depth of a change is unknown up front. The architect judges depth per change.
AIDD
AI-driven development
The day-to-day craft: context files, story files, editor agents, review by risk, cost habits.P2 mostlyEvery day, by everyone who writes code.

How the four methods merge into the SkyWays PDLC

Each method gives the part it does best. The SkyWays PDLC puts those parts in one order, with one owner for each phase. It also adds four things no method carries: the hard gate (the sign-off before anything is built), a pass mark for each kind of case, a limit on what the agent may do alone, and the report that starts the next round.

What the SkyWays PDLC adds
  • One hard gate: the signed spec, before anything is built
  • A bar per slice, derived from money at risk
  • An authority budget for every step the agent takes
  • The two-number report that starts the next P0
Four methodsmerge intoone loopP0 · FrameThe brief and the PRDBMAD · the Analyst and PMagentsDepth judged per changeAI-DLC · adaptive: only thestages this change needsIntent written before codeSDD · the spec starts here,lightlyThe autonomy ceiling, decidedbefore anything is builtP1 · Design & SpecThe spec is what youmaintainSDD · code is generated from itArchitecture and storiesBMAD · the spine and thespec's storiesOnly the stages that areneededAI-DLC · the architect judgesdepthA bar per slice and an authoritybudget, signed before the buildP2 · Build & ProveCode regenerated from thespecSDD · on every change, notpatchedBuild per story, reviewedBMAD · one unit at every sizeContext files and editoragentsAIDD · the day-to-day craftReview by risk, cost habitsAIDD · who signs, what it costsProve the bar first: a lowerbound, never a score, beforetrafficP3 · Run & LearnOperate, then re-enter atdepthAI-DLC · the next change picksits own stagesLearn and adjust, into thenext briefBMAD · extended: the trail runsone hand-off furtherCache, route, traceAIDD · cost habits that survivelaunchThe spec learns fromproductionSDD · updated, thenregeneratedThe two-number report thatstarts the next P0sign-off (the hard gate)What the SkyWays PDLC adds, and none of the four carriesOne order, one owner per phase, one sign-off. The parts keep their names; the four phases keep them in order.

Four methods merge into one loop

P0Frame
  • The brief and the PRDBMAD · the Analyst and PM agents
  • Depth judged per changeAI-DLC · adaptive: only the stages this change needs
  • Intent written before codeSDD · the spec starts here, lightly

The SkyWays PDLC adds: the autonomy ceiling, decided before anything is built

P1Design & Spec
  • The spec is what you maintainSDD · code is generated from it
  • Architecture and storiesBMAD · the spine and the spec's stories
  • Only the stages that are neededAI-DLC · the architect judges depth

The SkyWays PDLC adds: a bar per slice and an authority budget, signed before the build

sign-off (the hard gate)

P2Build & Prove
  • Code regenerated from the specSDD · on every change, not patched
  • Build per story, reviewedBMAD · one unit at every size
  • Context files and editor agentsAIDD · the day-to-day craft
  • Review by risk, cost habitsAIDD · who signs, what it costs

The SkyWays PDLC adds: prove the bar first: a lower bound, never a score, before traffic

P3Run & Learn
  • Operate, then re-enter at depthAI-DLC · the next change picks its own stages
  • Learn and adjust, into the next briefBMAD · extended: the trail runs one hand-off further
  • Cache, route, traceAIDD · cost habits that survive launch
  • The spec learns from productionSDD · updated, then regenerated

The SkyWays PDLC adds: the two-number report that starts the next P0

One order, one owner per phase, one sign-off. The parts keep their names; the four phases keep them in order.

Merged, not stacked. Each method keeps the part it does best; the SkyWays PDLC gives the parts one order, one owner per phase and one sign-off.

Traditional versus agentic: what changes when the product decides

A traditional lifecycle decides everything once, up front. When part of the product is right a share of the time rather than always, three things move: a bar per slice, an authority budget, and one hard gate before anything is built. Production then feeds the next frame instead of ending the story.

Try it in the workbench
Traditional PDLCvsAgentic PDLCTraditionalone decision perstage, then buildDiscoveryinterviews,adjectivesPRDthirty pages,approvedDesignarchitecture,onceBuildtwo-weeksprintsTestacceptance, atthe endReleasethen a metricEvery decision is made once, by a person, before the build starts.Quality is a demo and a checklist, and both come at the end.Breaks when the product contains somethingthat decides: nobody wrote how right it must be,or what it may do alone.Agentic PDLCfour phases, onesign-off, one loopbackP0 · Framethe pain in cases,minutes and moneypain registerAI-fit verdictP1 · Design &Speceight fields, a barper sliceeight-field specauthority budgetP2 · Build &Provebolts, a harness inCI, the shadow rungolden setshadow runP3 · Run & Learntwo numbers, drift,the incidenttwo-number reportdrift readoutsign-off (the hard gate)the incident is the next briefThe sign-off halts P1 until three things are signed: thespec, the bar and the guardrails.The other three crossings are soft: they can cross with aplaceholder, a named owner and a date.

Traditional PDLC vs Agentic PDLC

Traditionalone decision per stage, then build
  • 1Discoveryinterviews, adjectives
  • 2PRDthirty pages, approved
  • 3Designarchitecture, once
  • 4Buildtwo-week sprints
  • 5Testacceptance, at the end
  • 6Releasethen a metric

Every decision is made once, by a person, before the build starts. Quality is a demo and a checklist, and both come at the end.

Breaks when the product contains something that decides: nobody wrote how right it must be, or what it may do alone.

Agentic PDLCfour phases, one sign-off, one loop back

The sign-off halts P1 until three things are signed: the spec, the bar and the guardrails.

The other three crossings are soft: they can cross with a placeholder, a named owner and a date.

What changes. A traditional lifecycle decides everything once, before the build. The agentic one adds a bar per slice, an authority budget and one sign-off (the hard gate), and brings production back to the next frame.

Gate by risk, never by size

Size measures typing. Four hundred lines of help text cannot move money; three lines in a refund cap can. The band a change sits in comes from what it touches, and the band decides who reviews it and whether a person signs before it ships.

Gate by risknever by sizeWhat it touchesThe checkAt the airlineR1 · Reversible draftA draft in a sandboxnothing real changesReview at the endthe reader owns the outcomeDraft the passengermessageR2 · ReversiblechangeReal work, undoablea change with an undoOne reader before mergea second pair of eyesSearch flights, rank optionsR3 · Hard to reverseSmall blast radiusone customer, one bookingApprove firsta person before the actionRebook onto a new flightR4 · Money, identity,policyConsequentialthe ledger or the lawA named approver, everytimeand a cap in the tool signatureRefund, capped at $400R5 · Irreversible orsafety-criticalCannot be undoneor somebody gets hurtNot delegated at alla person does itChange a passenger'sidentityA change inherits the band of whatever it touches: three lines in a refund cap are R4;four hundred lines of help text are R1.Size measures typing. Risk measures what a mistakecosts and whether it can be undone.

Gate by risk never by size

R1 · Reversible draft
  • What it touchesA draft in a sandboxnothing real changes
  • The checkReview at the endthe reader owns the outcome
  • At the airlineDraft the passenger message
R2 · Reversible change
  • What it touchesReal work, undoablea change with an undo
  • The checkOne reader before mergea second pair of eyes
  • At the airlineSearch flights, rank options
R3 · Hard to reverse
  • What it touchesSmall blast radiusone customer, one booking
  • The checkApprove firsta person before the action
  • At the airlineRebook onto a new flight
R4 · Money, identity, policy
  • What it touchesConsequentialthe ledger or the law
  • The checkA named approver, every timeand a cap in the tool signature
  • At the airlineRefund, capped at $400
R5 · Irreversible or safety-critical
  • What it touchesCannot be undoneor somebody gets hurt
  • The checkNot delegated at alla person does it
  • At the airlineChange a passenger's identity

A change inherits the band of whatever it touches: three lines in a refund cap are R4; four hundred lines of help text are R1.

Size measures typing. Risk measures what a mistake costs and whether it can be undone.

Gate by risk. The band belongs to what the change touches, and the check follows the band: from a review at the end to a named approver every time.

Why long chains of steps fail, and what to do about it

Every step that is only probably right multiplies. Four chained steps at 90 percent succeed 66 percent of the time, and they fail fluently, with no error to catch. Two defences, in order: keep chains short, then put an independent checker after the steps that are costly and easy to miss.

6 stepsat90% each=53% end to endStep 1right 90% ofthe time90%end to endStep 2right 90% ofthe time81%end to endStep 3right 90% ofthe time73%end to endStep 4right 90% ofthe time66%end to endStep 5right 90% ofthe time59%end to endStep 6right 90% ofthe time53%end to endMultiply, never average. Four steps each right 90% of thetime are right 66% of the time end to end, and they failfluently: no error, a confident wrong answer.Best defences, in order1.Keep chains short: fewer probabilistic steps per case2.Put an independent checker after the steps that are costly and easy to miss3.Make exact steps exact code: a calculator behind an agent is a provable step madeprobabilistic

6 steps at 90% each = 53% end to end

  1. 1Step 1: right 90% of the time90% right end to end
  2. 2Step 2: right 90% of the time81% right end to end
  3. 3Step 3: right 90% of the time73% right end to end
  4. 4Step 4: right 90% of the time66% right end to end
  5. 5Step 5: right 90% of the time59% right end to end
  6. 6Step 6: right 90% of the time53% right end to end

Multiply, never average. Four steps each right 90% of the time are right 66% of the time end to end, and they fail fluently: no error, a confident wrong answer.

Best defences, in order
  1. Keep chains short: fewer probabilistic steps per case
  2. Put an independent checker after the steps that are costly and easy to miss
  3. Make exact steps exact code: a calculator behind an agent is a provable step made probabilistic
Why length is the enemy. Every probabilistic step multiplies. The bars show what survives to the end; the list is what to do about it.

The acronym decoder

Every short form this manual uses, what it means here, and where it came from.

ShortLongWhat it means hereFrom
ADRArchitecture decision recordOne decision with its context, consequences and what it rejected, versioned next to the code. Written only at a trade-off point.Nygard, 2011
AI-DLCAI-Driven Development Life CycleRun only the lifecycle stages a change needs.AWS
AIDDAI-driven developmentThe craft of building software with coding agents.No single owner
ATAMArchitecture Tradeoff Analysis MethodWhere utility trees and sensitivity points come from.Kazman, Klein, Clements, SEI, 2000
BMADBreakthrough Method of Agile AI-Driven DevelopmentSkills and five named agents, one Build loop, a document per decision.BMad Code
EARSEasy Approach to Requirements SyntaxWHEN a trigger AND a condition THE SYSTEM SHALL a behaviour, within a measure.Mavin et al., Rolls-Royce, 2009
MCPModel Context ProtocolOne plug so any AI client can use your tools and data. Turns M apps x N systems into M + N.Specification
NFRNon-functional requirementWritten as a six-part scenario so it can be tested, ranked and traded off.Bass, Clements, Kazman
PDLCProduct development lifecycleHere: P0 Frame, P1 Design & Spec, P2 Build & Prove, P3 Run & Learn.Stage-gate, Cooper 1990
R1 to R5The risk ladderReversible draft, reversible change, hard to reverse, money/identity/policy, irreversible.this manual
RACIResponsible, accountable, consulted, informedOne accountable name per artefact, never a committee.No single source
SDDSpec-driven developmentMaintain the spec; regenerate the code.No single owner
TCOTotal cost of ownershipThree years, with the people counted, usually the larger number.Gartner, 1987
p^nChained probabilitySteps multiply. Four steps at 90% is 66%. Length is the enemy.Basic probability

Where each framework came from, and how much to trust it

Every framework in this manual carries a lineage pill. Check it before you quote a figure: a vendor's documentation is dated, a published practice is named, and this manual's own defaults are there to tune on your own traffic, not to cite.

The three pills
  • documented a vendor’s published documentation, dated
  • established a named, published practice
  • working method this manual’s own default, to tune on your own traffic
FrameworkWhat it isLineageConfidence
The four phases, P0 to P3Four phases every method walks: frame, specify, build and prove, run and learn.Stage-gate systems (Cooper, 1990). The phase names are this manual's.working method
The requirements chainDiscover, credit, consolidate, constrain, candidates, trees, workshop, ratify, name the sensitivity points.ATAM utility trees (SEI, 2000); six-part scenarios. The chain is this manual's.working method
The ADR at the trade-off pointA record is written only where two quality attributes pull against each other.ADRs (Nygard, 2011); ATAM sensitivity points.established
The exact and best-guess mapWhich steps are computed in code and which are drafted by a model, with the proof each owes.This manual's construction.working method
Autonomy by the cost of a mistakeThe level follows what a wrong action costs and whether it can be undone.One-way and two-way doors (Bezos, 2015).working method
The acceptance barbar = damage / (damage + saving), per slice. A hold lowers the damage and so the bar.This manual's construction.working method
Hard and soft gatesA decision halts the phase or runs alongside it, settled by four questions.Stage gates (Cooper, 1990). The four questions are this manual's.working method
The risk ladder R1 to R5The check grows with the band. A change inherits the band of whatever it touches.Least privilege (Saltzer and Schroeder, 1975).working method
Bolts and the walking skeletonOne risk per bolt, the skeleton first, the shadow run as the milestone.Walking skeleton (Cockburn, 2004); the bolt from AWS AI-DLC.working method
Prove the bar, then earn the trafficA score is reported with its lower bound; a cut-over widens on live evidence.Wilson (1927); stratified sampling (Neyman, 1934); canary release.established
Review by risk bandTwo readers, one, or the harness alone, set by what a change touches.Little's law (Little, 1961). The banding is this manual's.working method
The cache break-evenCaching pays once reuse outweighs the write premium. Break-even is the second use.Prompt-caching pricing as documented by Anthropic and Amazon Bedrock, read September 2026.documented
Decompose the billFour signatures in the per-call log, four factors that multiply, fix order (factor − 1) ÷ days.FinOps unit economics. The decomposition is this manual's.working method
The missing-control postmortemEvery layer is enforced, a request, or absent. The enquiry ends at the control that would have made it impossible.Layered defences (Reason, 1990); blameless postmortems (Beyer et al., 2016).established
The two-number reportPerson-days saved and tokens spent, always together, with the rows that keep both honest.Paired indicators (Grove, 1983); Goodhart's law (1975).working method
The model gatewayA facade, a retry, a fallback and routing in front of every model call, with a per-call log.Facade and circuit-breaker patterns; LiteLLM as the named example.documented

The full sources page

Seen where the methods sit. The method page draws the lifecycle they sit on.