All courses / AI Developer / Module 4 / Chapter 21
Learning objectives
After the lesson the participant can:
- Explain why an assistant can be worked with in a pairing-like way but is not a second person
- Apply five review practices that keep review real when code is generated
- Design a trust ledger and an open log that never rank a named developer
- Draft a team practice agreement and run a blameless retrospective on AI-assisted work
Key concepts
- An assistant is not a pair
- An assistant supplies something like half of a pairing exchange, but it cannot be named, cannot explain a change a month later and cannot help revert it. The difference is the absence of someone who passes Name, Understand and Revert.
- Trust ledger
- A record kept by the team of outcomes by class of work and origin, with dates, showing where the tool was reliable and where it was not. Trust is calibrated, not maximised, and the ledger never ranks a developer.
- The record, the count and the draft
- Three points at which an assistant changes what speaking up risks: searchable prompts and run records, usage counts that developers will manage, and drafted defect reports that say less. Each is a rule a named leader sets.
- The stop right
- Anyone in the team may hold a merge, pause an agent run or ask for a change to be reverted, on a doubt they can state, without penalty if the doubt turns out to be unfounded.
- Team practice agreement
- The written, one-page form of the team's rules, stricter than the delegation profile and never looser, identified by the decision record that adopts it. It contains no clause a leader could use against a named person.
Interactive exercises
Do them here and get feedback at once. Choose a card and then where it belongs, or drag it.
Interactive exercise 1 · Match
Practices of a team that works with assistants
Match each team practice to what the chapter says it is or does.
Interactive exercise 2 · Put in order
A retrospective on AI-assisted work
Put the steps of the chapter's retrospective with a safe way to report defects in order.
Teaching plan
| 10 min | The teacher asks what a human pair gives that an assistant does not, and collects answers under Name, Understand and Revert. |
| 15 min | Lecture on the five review practices and on what a sample of review records should be able to show. |
| 15 min | Input and discussion on trust calibration, the three points of speaking up, safety to ask and the four-part response to shadow AI. |
| 25 min | Exercise: groups run a short retrospective on AI-assisted work in the blameless form and decide one change to practice. |
| 10 min | Each group writes the clause it would add to a team practice agreement and states its limit on data about people. |
Discussion
- A reviewer may return a change as too large to understand. What happens today in your team to someone who says I cannot review this?
- Disclosure of AI involvement is routine and has one purpose. What would make developers stop disclosing, and how would you notice?
- The retrospective closes by asking what the team nearly did not say. Why is that question worth two minutes of silence?
Written exercise
Exercise · 25 minutes
A blameless retrospective on AI-assisted work
In a group of four to six, run the retrospective of the practical guide on a real or invented log of three near misses involving generated code. Open by restating the rule: names are not recorded, nothing said enters an appraisal, and anyone may pause the session. Read each entry without asking who made it. For each, ask what the assistant or agent was given and produced, what the reviewer saw, and what in the path let it through. Update a small trust ledger by class of work. Decide one change to the practice, one owner and a date. Close by asking what the team nearly did not say.
Deliverable: An anonymised log of the entries, an updated trust ledger and one agreed change to the practice with an owner and a date.
Self-test
Choose an answer to see whether it is right, or open the answer below each question.
According to the chapter, what is the one purpose of disclosing in a pull request that an assistant or agent took part?
Show the answer
B. To tell the reviewer where to look harder and to feed the provenance record
Disclosure is routine and has one purpose: it tells the reviewer where to look harder and feeds the provenance record. It is not a mark against the author, and the count of disclosures per person is never reported to anyone.Which of these is part of the chapter's response to shadow AI?
Show the answer
C. A report route that costs nothing for someone who pasted what they should not have
The four parts are an approved route that does the job, a plain rule on what is never pasted, a conversation before any enforcement, and a report route that costs nothing. None is surveillance of individuals.How does the team practice agreement relate to the delegation profile?
Show the answer
A. It is stricter than the profile and never looser
The agreement writes the team's rules on one page, is stricter than the delegation profile and never looser, and is identified by its decision record: AIDR-1121 at Nordvik Region and AIDR-1171 at Hansa Mutual.