All courses / The Transformed Security Architect / Module 3 / Chapter 13
Learning objectives
After the lesson the participant can:
- Describe the five agent roles of a security architecture team with what each writes, its mode, identity and default level.
- Write a mandate manifest with a level per action, a list of what no agent may ever do, budgets, escalation rules and a stop path.
- Explain the seven containment measures for the architect's own agents and why control artefacts stay out of their reach.
- Assess whether an organisation has the capacity to supervise an agent team, using the staged introduction and Nordvik's decision to defer.
Key concepts
- Narrow agents
- Agents triggered by events in the architecture repository, each needing only what its task requires. One general assistant would need the union of all permissions; narrow agents can be bounded and stopped one at a time.
- Mandate manifest
- The written mandate of the architect's agents, kept as code and not a prompt. The identity provider, the policy decision point, the egress gateway and the branch rules read it, and where it disagrees with the containment profile the narrower one wins.
- Agents draft; humans approve
- A property of the repository, not a habit: branch protection requires review by code owners, the code-owner file lists only named architects, and the merge is always performed by a person. No agent approves its own output or another agent's.
- Disagreement without arbitration
- When the pipeline detects conflicting agent outputs on a pull request, it labels it, places both outputs side by side and requests review from the code owner of the affected path, who decides and records the rationale. No agent arbitrates and there is no vote.
- Agents that read people's work
- A review agent sees who wrote what, so agent output attaches to the change, not the person; the manifest prohibits per-person metrics and performance evaluation, and review-quality measures are reported at team level as agreed with employee representatives.
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
What the agent team may do, and at what level
Sort each action under the level Hansa Mutual's mandate manifest MND-HM-01 gives it.
Interactive exercise 2 · Scenario
Two agents disagree
Apply the chapter's rule for conflict between agents on the same pull request.
Teaching plan
| 15 min | Lecture on the step from assistants to an agent team and the five roles; participants explain why the researcher has no repository access and why the evidence collector is a Mode 5 agent. |
| 15 min | Read MND-HM-01: the levels per action, the never list, budgets, escalation rules and the personal-data section. |
| 10 min | Case discussion: the policy author's mirror rule and the threat modeller's objection in autumn 2026, and why the decision was the architect's. |
| 35 min | Exercise: participants write a mandate manifest for a two-agent team or, where capacity is lacking, a decision record to defer with review triggers. |
| 15 min | Debrief on the three-stage introduction and on consultation with employee representatives before agents read people's work in production. |
Discussion
- The chapter warns that a falling rejection rate may mean reviewers have stopped looking. What evidence would you require before granting an agent a higher autonomy level?
- Nordvik's reasons for deferring an agent team concern capacity, not technology. Which of its review triggers would have to be met in your organisation before a team makes sense?
- A review agent on an architecture repository holds all three legs of the lethal trifecta by default. How would you break the trifecta for each agent in a team you might run?
Written exercise
Exercise · 35 minutes
Write a mandate manifest for an agent team
Design a small architecture agent team for your organisation, starting with a reviewer and a threat modeller, or decide to defer. If you proceed, follow the chapter's seven steps: state purpose and scope with named repositories and no wildcard scopes; give each agent its own identity with a named owner and operators; list each action with a level, and an explicit list of what no agent may ever do; set data limits and budgets; write the escalation rules, the containment profile reference and the stop path with its holder by role; record personal data and its prohibited uses; set review and expiry. If you defer, write the decision record with the options rejected and the conditions that would reopen the question.
Deliverable: A mandate manifest in the form of MND-HM-01 for at least two agents, or a decision record in the form of AIDR-0503 with rejected options and review triggers.
Self-test
Choose an answer to see whether it is right, or open the answer below each question.
Which is the only action that runs at Level 3 Bounded in Hansa Mutual's architecture agent team?
Show the answer
B. The evidence collector refreshing an evidence link within an approved playbook
Only maintenance of the evidence record, which describes the architecture and does not change it, may run at Level 3 Bounded: the evidence collector's refresh of an evidence link, which keeps the previous link and changes no control.How is the work of the agent team orchestrated, according to the chapter?
Show the answer
D. By a deterministic pipeline; no agent assigns work or decides which outputs reach the architect
The orchestration is a deterministic pipeline, not a manager agent. No agent assigns work to another or decides which outputs reach the architect, and conflicts are placed side by side for the code owner.Why did Nordvik Region reject option A, building a five-agent team, in AIDR-0503?
Show the answer
A. One architect cannot supervise a team and there is no second reviewer
Option A was rejected because one architect cannot supervise a team and there is no second reviewer. Option B, a supplier's service, was rejected over hosting; option C extended MND-NR-01 with a research skill at Level 0 Advisory.