SkyWaysThe agentic manual

The agentic PDLC for QA: how to test probabilistic software

"It works" stops being a yes or a no. Your job becomes the number that says how often it works, and whether that number is proof.

6 minutesIntermediateLesson 6 of 9Updated By

On this page
  1. Sound familiar?
  2. What changes for QA?
  3. Your eight steps
  4. What is yours, and what is not
  5. How to use a model in this role
  6. Where you'll use it
  7. Why it matters
  8. Try it
  9. Key takeaways
  10. FAQ
  11. Apply it in your role
  12. Sources and credits
All lessonsStart here

Getting started

  1. What is the agentic PDLC?
  2. How this tutorial works

Agentic PDLC fundamentals

  1. The evolution of the PDLC
  2. Why agentic AI projects fail
  3. P0 · Frame
  4. P1 · Design & Spec
  5. The one hard gate
  6. P2 · Build & Prove
  7. P3 · Run & Learn
  8. The eight loops
  9. The evidence pack

Methods decoded

  1. AI-DLC vs AIDD vs agentic SDLC
  2. What is AI-DLC?
  3. What is AIDD?
  4. What is the BMAD Method?
  5. What is spec-driven development?
  6. One lifecycle for every method
  7. How much process a change needs

Running delivery

  1. How to run an agentic AI project
  2. Bolts vs sprints
  3. A board for agentic work
  4. Cut delivery from months to weeks
  5. Review AI code by risk
  6. How accurate must an agent be?
  7. Prove the agent meets its bar
  8. Shadow mode and cut-over
  9. Why the AI bill is 4× the estimate
  10. Guardrails that hold
  11. The five governance gates
  12. Catch AI drift
  13. AI incident postmortems

By role

  1. For product managers
  2. For program managers
  3. For solution architects
  4. For engineers
  5. For forward-deployed engineers
  6. For QA
  7. For DevOps and platform
  8. For business sponsors
  9. For executives

Teams and organisation

  1. Team structure for agentic AI
  2. Measuring AI productivity
  3. The maturity model
  4. Rolling it out in 90 days

Practice

  1. The SkyWays case study
  2. The operating rhythm
  3. The workbench
  4. Twelve exercises

Interviews and careers

  1. What is an FDE?
  2. Six answer frameworks
  3. AI PM interview questions
  4. FDE interview questions
  5. GenAI engineer questions
  6. Agentic engineer questions
  7. AWS GenAI questions

In short

In the agentic PDLC the QA lead decides what proof each kind of step owes, curates the golden set by slice, and reports the lower bound rather than the score. The QA lead matches a checker to each kind of work, runs the injection suite as a regression, compares the shadow run with the people doing the job, and watches for drift. The QA lead owns the behaviour and expansion gates.

The QA leadacross the four phasesP0FrameOne question: what will right mean, and who says so?P1Design & Spec1 · Definethe proof each step owes2 · Curatethe golden set, by sliceP2Build & Proveyours to lead3 · Checkthe checker fits thework4 · Harnessevery change, in CI5 · Measurelower bound, notscore6 · Attackinjection, as aregression7 · Shadowbeside the deskP3Run & Learn8 · Watchdrift, and incidents into controlsQA gains a veto that is arithmetic rather than opinion: a slice whose lower bound is below its bar does not pass.

The QA lead across the four phases

P0Frame
  • One question: what will right mean, and who says so?

P1Design & Spec
  • 1 · Definethe proof each step owes
  • 2 · Curatethe golden set, by slice

P2Build & Proveyours to lead
  • 3 · Checkthe checker fits the work
  • 4 · Harnessevery change, in CI
  • 5 · Measurelower bound, not score
  • 6 · Attackinjection, as a regression
  • 7 · Shadowbeside the desk

P3Run & Learn
  • 8 · Watchdrift, and incidents into controls

QA gains a veto that is arithmetic rather than opinion: a slice whose lower bound is below its bar does not pass.

In this lesson you'll learn:

  • the QA lead's eight steps, from one question in P0 to the drift watch in P3;
  • the three kinds of step and the three kinds of proof they owe;
  • why the gates QA owns are arithmetic, and how to keep them that way.

Sound familiar?#

  • You are asked to sign off a demo, and the demo is the only evidence there is.
  • An accuracy figure goes into the board pack without a sample size, and nobody objects.
  • The injection tests passed at launch and have not been run since.

The skills are the same; the object has changed. Software that is right a share of the time needs proof that is a number, with a width, per slice.

What changes for QA?#

You stop signing off on a demo, and start reporting a lower bound. Exact work still gets exact tests. But best-guess work (ranking, drafting, classifying) can only be measured as a share, against a bar, on a sample; and a share from a sample is an estimate, not a fact. QA's new authority is arithmetic rather than opinion: a slice whose lower bound is below its bar does not pass, whoever wants it to.

Your eight steps#

P0 · Frame: one question#

Ask what right will mean, and who says so. That is all P0 needs from you, and it is the question the rest of your work depends on.

P1 · Design & Spec#

1 · Define the proof each kind of step owes: exact work a unit test, green or red; best-guess work a measured share against a derived bar; consequential work a gate and a test that it refuses. 2 · Curate the golden set from real cases (fifty to start, five hundred to trust), each tagged by slice. SkyWays' first fifty took an afternoon, and twenty-four failed.

overall 84%easy, 89%the risky one, 77%
Mental model The average hides the slice that matters

P2 · Build & Prove: the phase you lead#

3 · Check: an exact check in code for arithmetic and rules, an independent judge for drafted text, calibrated against human labels. 4 · Harness: build → exact checks → golden slice → judge → per-slice score → merge or reject, on every change. 5 · Measure: the lower bound, never the score. 412 of 500 is 82.4%, and its lower bound of 79.1% does not prove an 80% bar. 6 · Attack: the injection suite, every entry point against every gated tool, weekly. 7 · Shadow: agreement per slice over a fixed window, money actions reported separately. Prove the bar

P3 · Run & Learn#

8 · Watch the output mix against two thresholds, with a breach wired to the release gate; and turn every incident into an enforced control plus new golden cases. Drift

What is yours, and what is not#

Yours to ownNot yours
The behaviour gate: does it meet the spec, per slice, with the lower bound?The bar itself: the PM derives it; you make it executable
The expansion gate: have we earned wider use?The intent and plan gates. You are consulted
The golden set: which cases count, what each expects, its sliceThe fix: you name the defect and the proof it owes
The checker per kind of step, and the judge's measured accuracyModel, temperature, prompt wording: you assert on behaviour
The injection suite and its weekly run; the drift chart and its alert

How to use a model in this role#

Use a model for the volume, never for the verdict. It will turn a redacted ticket export into three hundred candidate cases, cluster forty shadow disagreements into four themes, and write the harness that runs them. It must not decide what counts as right, or grade its own family's outputs and hand you the number unlabelled: a judge is a measuring instrument with an unknown error until you calibrate it against people.

Where you'll use it#

  • At the behaviour gate, where no score leaves your hands without its sample size and lower bound.
  • At every prompt, model or tool change, where the harness and the injection suite run again.
  • Every week in production, on the drift chart.

Why it matters#

In an agentic system QA is the only role whose gates are arithmetic. That makes QA the brake nobody can argue with, and the reason a launch can be defended afterwards, because "it passed" means a lower bound cleared a derived bar on a sample someone can inspect.

Try it#

A developer reports: "The new prompt improves accuracy from 80% to 85% on our 100-case test set." What do you ask before accepting it?

Show the answer

Per slice, lower bound, and the judge. Which slices moved, and did any fall? An overall rise can hide a drop on the slice that matters. What is the lower bound: on 100 cases, 85% has a Wilson lower bound of about 77%, so against a bar above that it proves nothing yet. And how was "accurate" judged: by an exact check, or by a model judge calibrated against human labels? Then run it through the harness rather than accepting the report.

Key takeaways#

  1. Three kinds of step owe three kinds of proof: a unit test, a measured share, a refusal test.
  2. Report the lower bound, never the score, per slice, with the sample size beside it.
  3. QA owns behaviour and expansion, and keeps the injection suite and the drift watch running.

FAQ#

How do you test an AI agent?#

Split its steps: exact steps get unit tests; best-guess steps are measured as a share on a golden set of real cases, per slice, against a bar derived from what a mistake costs; consequential actions get tests that prove their limits refuse. Then run an injection suite on every change, a shadow run before launch, and a drift watch after.

What does a QA lead do in an AI project?#

Defines the proof each kind of step owes, curates the golden set by slice, chooses and calibrates the checkers, runs the evaluation harness and the injection suite, measures lower bounds rather than scores, compares the shadow run with the people doing the job, and owns the behaviour and expansion gates.

How big should an AI test set be?#

Fifty real cases per important slice to start finding problems, and around five hundred to prove a bar with confidence, and more when the score sits close to the bar, because the cases needed grow with the square of the gap.

Can an LLM grade another LLM?#

Yes, as a judge for drafted text, provided it is independent of the model being judged and you have measured how often it agrees with human labels on a held-back sample. An uncalibrated judge is another unproven score.

Apply it in your role#

If you are…Do thisThe AI-augmented shortcut
A forward-deployed engineerAt a customer you are often the QA lead too: build the golden set from their data with their labels, and report lower bounds from the first run.Have a model draft candidate cases from redacted tickets, then let the customer's experts label them, never the model.
A product manager or FDPMAsk QA for the lower bound per slice before any launch conversation. "It works" is a number with a width.Have a model restate QA's report for the steering committee without dropping the sample sizes.
A GenAI or agentic AI engineerGive QA a checker for each kind of step, and calibrate any model judge against human labels before trusting it.Ask a coding agent for a judge-agreement report: the judge against people, on a held-back sample.

Across the enterprise. A shared evaluation practice (one harness, judge calibration, golden-set standards) lets QA leads in every team produce evidence a governance board can compare.

The ten-minute workflow. Find out whether your judge can be trusted:

Here are 50 cases, each with the agent's answer, a human label (correct or incorrect) and the judge
model's label: <table>. Compute the judge's agreement with the people, its false-pass and false-fail
rates, and whether its errors cluster in any slice. Say whether the judge is fit to gate merges, and
on which slices it is not.

Sources and credits#

IdeaOriginSource
The QA lead's eight steps, owns and not-yoursOriginal: this manualQA lead, end to end · Role: QA lead
The Wilson score intervalBorrowedWilson, E. B. (1927). JASA 22(158)
Prompt injection as the top LLM riskBorrowedOWASP (2025). Top 10 for LLM Applications 2025
The SkyWays examplesIllustrative: a fictional airlineJourney: QA lead

Prefer GitHub? This track is on the wiki, and this lesson is markdown. Found a mistake? Edit this lesson, or say so.