AI Developer · Module 2 · The Craft of Developing

Steward the Release: CI/CD, Change and Operating What You Build

The lesson treats D5 Steward at the point where a change becomes a release. Its claim is that when AI takes part in a change, the release path must contain at least one gate the change cannot alter and a named owner who can revert from outside the pipeline. Participants cover progressive delivery, the four properties of such a gate, change approval by class, the limits of the delivery metrics, and the Revert test in practice.

Lesson 11 of 33Chapter 1190 minutes

Read the chapterThe whitepaperThe slides

All courses / AI Developer / Module 2 / Chapter 11

Learning objectives

After the lesson the participant can:

Key concepts

A gate the change cannot alter
A gate with four properties: its definition is out of reach of the change, it executes out of band, its oracle is independent of the generator, and it is shown to work by dated seeded faults. A pipeline file in the same repository does not qualify.
Progressive delivery
Exposing a change to a growing share of users or systems while measuring its effect, with the ability to stop and revert at each step: feature flags, canaries and rings, and rollback. A flag is a production change in its own right.
Approve classes, not items
A class that is low in blast radius, reversible and covered by a strong gate can be approved once, with an expiry. Human judgement is reserved for what is irreversible or security-critical, and a model may score a change but not approve it.
Change volume per owner is a budget
The number and size of changes a team can understand and run is finite. You build it, you run it survives rising volume only if the owner is in the ownership record before the change and the generator is never the sole responder to its own failure.
The Revert test in practice
Authority: the owner or deputy may use the stop without asking. Access: the stop works when the pipeline does not. Time: the rehearsed time to restore is shorter than the time in which harm accrues. A revert not exercised in the last 90 days is marked not tested.

Interactive exercises

Do them here and get feedback at once. Choose a card and then where it belongs, or drag it.

Interactive exercise 1 · Sort

Can the change alter this control

Sort each release-path control by whether a change can alter it, following the reasons in Table 11.1.

Interactive exercise 2 · Put in order

Adding a gate and a rehearsed revert

Put these steps of the practical guide for one service's release path in order.

Teaching plan

15 minLecture on what AI changes in the volume and size of changes, and on progressive delivery with the Knight Capital and CrowdStrike cases as the chapter reports them.
15 minParticipants sort the controls of Table 11.1 into those a change can and cannot alter, then compare with the chapter's reasons.
15 minThe teacher walks through the two change records CHG-NR-2030-0212 and CHG-HM-2030-0415, reading each as a checklist.
30 minExercise: groups add a generator-independent gate and a rollback rehearsal to the release path of one service.
15 minDiscussion of the delivery metrics and the measures the book suggests beside them, with evidence ages.

Discussion

  1. What cannot be rolled back in your own services, and how is that marked before the change is approved?
  2. Deployment frequency rises when a team ships many small generated changes, whether or not they matter. Which of your reported metrics would move without anything improving?
  3. Nordvik Region has a contract and a small platform team; Hansa Mutual has a platform, a policy repository and an agent mandate. How does each put the same control in place?

Written exercise

Exercise · 30 minutes

A gate the change cannot alter and a rehearsed revert

For one service you know, or the citizen portal of Nordvik Region, draw the release path from commit to production and mark each control as inside or outside the reach of a change. Say where the gate definition should move so that contributors cannot edit it. Name the oracle for the change class and its owner. Choose three faults to seed that the gate must catch: a failing contract, a boundary case and a policy violation. Define the rings and promotion conditions. Write the revert in two forms, through the pipeline and by a stop path outside it, and plan a rehearsal with a target in minutes and an expiry for the evidence.

Deliverable: An annotated release path with gate location, oracle owner, three seeded faults, rings, two revert forms and a rehearsal plan with target and expiry.

Self-test

Choose an answer to see whether it is right, or open the answer below each question.

  1. Which control does Table 11.1 class as one the change can alter?

    Show the answer

    B. The pipeline definition file in the same repository
    A change can edit the file that defines its own checks when the pipeline definition sits in the same repository. The other three lie outside the change's write permissions or are owned by someone else.

  2. How does the chapter say a revert that has not been exercised in the last 90 days should be recorded?

    Show the answer

    D. As not tested, a legitimate entry that is not the same as passed
    Rehearsal is the evidence for the Revert test. A revert not exercised within the period the book recommends is marked not tested, which is honest and distinct from passed.

  3. Why does the class approval in CHG-HM-2030-0415 expire on the delegation profile's review date?

    Show the answer

    A. So that the class approval does not outlive the evidence behind it
    The class approval for patch-level dependency updates is valid until 2031-03-30, the profile's review date. The chapter gives the reason directly: the class should not outlive its evidence.