# 5.5 Iterate: change the part that failed (/managing-ai-workers/the-four-part-brief/iterate)

---
type: Document
title: "5.5 Iterate: change the part that failed"
description: "How to read a weak result, find the part of the brief that caused it, and change only that part."
status: stable
order: 205.5
ksor:
  owner: team:panaversity
  audience: [ public ]
  approval:
    by: process:panaversity
    at: 2026-10-06T13:16:37Z
chapter: "05"
part: II
expert_status: required
concepts: [ "5.5" ]
last_verified: 2026-10-06
sources:
  - id: v1-ai-prompting
    title: "AI Prompting in 2026 (Panaversity, first edition, verified 2026-10-06)"
    resource: https://agentfactory.panaversity.org/docs/ai-prompting-2026
generated:
  at: 2026-10-06T13:16:37Z
  by: esl-rewrite/1.2.0+ksor.1
trust_tier: unverified
build_id: sha256:c93b28093c2f70c60faae2645a693d881b657ff94d00f7dd9f8c06427ff61c87
dirty: true
ksor_version: 0.0.60
---

**In everyday life.** A recipe came out too salty. You cut the salt next time, not every ingredient.

To iterate is to improve a brief round by round. Read the first result as a test of your brief. Find its biggest problem, then ask whether your brief covered it. Say the worker used policy version 2, and your brief never named a version. That is a gap in the inputs. The table shows which part to change for each kind of problem.

| What you see | The part to change | For example, add |
| --- | --- | --- |
| It made the wrong thing, or too much of it | Outcome | "Pay covers invoices due on or before October 30." |
| The content is right, but the shape or the destination is wrong | Format | "A proposal CSV, one row per open invoice." |
| A wrong fact, an old rule, or a source it should not have used | Inputs | "Use AP policy version 3 for every rule." |
| It decided something it should have asked about, or kept asking about small things | Autonomy | "List for Dave anything the policy does not cover." |

Change that one part, run the brief again, and compare the two results. Changing everything at once hides what worked.[^v1-ai-prompting] If the brief is good and the work is still weak, the brief is not the problem. Try a stronger model, if your app lets you choose one, or split the work into smaller stages. Chapter 11 shows how to find the cause of failed runs.

Save your brief as a file, so you can reuse it. Then write each lesson into the saved brief. Maria's next version of the brief says "terms from the vendor record" because the last run taught her that. Stop iterating when another round changes little and finishing by hand would be faster.

[^v1-ai-prompting]: AI Prompting in 2026, Panaversity, first edition.
