8

Evolve, don't rebuild

Module 3 · Structure. After this lesson you can: distinguish between complexity that signals a flaw and complexity that encodes memory, and apply that distinction to avoid costly rebuilds.

Consider a team reviewing a system that has been running for a year. It has accumulated complexity: special cases, exception handlers, rules that only make sense if someone remembers the incident that produced them. Looking at the accumulation, a familiar impulse arises: the case for a clean restart becomes compelling. Build it right this time, knowing everything learned so far. Start fresh.

That reasoning has a structural flaw. The complexity of a long-running system is largely composed of memory. Each odd exception exists because something real happened. Each unusual check exists because a default behavior once produced a bad outcome. When a rebuild replaces all of that, it does not produce a cleaner system. It produces an amnesiac one, which will relearn every lesson the original system already learned, paying the full cost of each mistake again.

The practice of iteration offers a different path: find the piece that is genuinely wrong, change that piece, and leave the scars that are still doing their jobs. This is less immediately satisfying than a complete rebuild. It is also more effective over time. A system that evolves accumulates memory. A system that gets rebuilt discards it and must recreate it through the same difficult process.

The same principle governs responses to repeated AI failures. When an AI keeps producing the same wrong output, the instinct is often to restate the instruction more emphatically. Repetition applied to a structural mismatch rarely resolves the mismatch. The more effective move is to change what the AI can see: clearer rules, better examples, cleaner data, one source of truth. When the right behavior becomes the path of least resistance, the repeating failure stops. The intervention is structural, not a matter of restating the same thing more forcefully.

This applies equally to how designs should be held. A design is a current best guess, not a commitment. When evidence pushes back, the productive response is to update the guess. Defending a design that evidence has questioned costs more than updating it: it delays the correction, erodes confidence in the system, and usually requires a larger fix later. The goal is to defend the system and hold the design loosely.

When anything in a working setup resists, the diagnostic question is: which piece is genuinely wrong, and which piece is merely unfamiliar or inconvenient? The genuinely wrong piece warrants a targeted change. The inconvenient piece often warrants investigation to understand what it may be protecting before deciding whether to remove it.

Stop here. Sit with this before continuing.

What would you rebuild from scratch right now, and what might the complexity actually be protecting?

Try this nowUnder 30 minutes
  1. Find the bonfire. Identify the thing most tempting to scrap and redo from zero: a project, a document, a routine, a system, or a tool configuration.
  2. Interrogate the complexity with your AI. "Here is the thing I want to rebuild. Help me list what each annoying part might be protecting." Write down three things the current complexity might actually encode.
  3. Evolve exactly one piece. The one that is genuinely wrong, not merely unfamiliar or inconvenient. Change it. Leave the scars that are doing their jobs.
  4. Notice the impulse to keep going. If the urge to continue rebuilding persists after the first piece is changed, pause. Iteration is a practice, not an event.

Two questions before you go

Last ones. Answer, then say whether you were sure or guessing.

Where you are now

After Lessons 0 through 8, the foundational capabilities of Modules 1 through 3 are in place.

Those capabilities span three modules: understanding what an AI system is and is not (Module 1), working reliably with one (Module 2), and building structure that holds quality without depending on daily re-setup (Module 3). The Shelf holds templates and rules of thumb from every lesson in this program, including a starter standing instructions document. Take what is useful.

The surest test of whether these lessons have been internalized is to teach the same material to someone else. Gaps in explanation reveal gaps in understanding, and working through those gaps is its own lesson.

Module 4 (Lessons 9 through 12) covers operating skills: coordinating multiple AI agents, managing longer-running workflows, and maintaining quality at scale. It builds on everything in Modules 1 through 3. Start Module 4: Lesson 9.