Experiments · Nobody Writes Code Anymore · Chapter 4
Seven links behind one phone number
Why one small change breaks software
Everything is computed in your browser; nothing is sent anywhere.
About this experiment
A nail salon’s administrator asks for a small change, so that a client can give several phone numbers. The agent is done in about three minutes. It makes room in the database for a second and third number and puts an “add another phone” button in the form. The administrator checks what she can see, the form saves three numbers and opens again, and the change goes live.
Behind that one field the chapter lays out a chain of data schema, migration, business logic, links to other programs, permissions, screens and checks. The agent touched two of the seven. Press “Three weeks later” and the other five tear in the order the chapter tells it. For some clients the old number is gone after the move. Reminders stop reaching a third of the clients, because the reminder service still reads the old cell. The accountant’s export expected one number and will not open. A stylist sees every number and calls a client’s husband. The tests were written for one phone, and if the agent adjusts them until they pass again, nobody sees the breakage.
“The whole change” shows the same request carried through every link. The numbers become a list with one marked main, three thousand old numbers are moved and brought to one format with notes like “call after six” kept, reminders, SMS and the export go to the main number, a stylist sees only that one, and a test covers a client with three numbers.
Fred Brooks split the difficulties of programming into accidental ones and essential ones. Models have nearly abolished the accidental kind, turning a thought into code. The seven links are the essential kind, and the request for one more field does not mention any of them.
From the book
Nobody Writes Code Anymore · Chapter 4
Change One Thing Without Breaking Everything
The result is a chain of seven links: data schema, migration, logic, connections to other programs, permissions, screens, checks. The administrator’s small request touched all seven, and the change the agent made touched two. Any new capability in a program, even the most modest, changes a connected network in which every link is tied to its neighbours, and to change one link without looking at the others is to leave a breakage that will show up later and somewhere else.If this is your team
If agents write code on your team and every fix breaks something next to it, we can go through it on a call. The first consultation is free and takes thirty minutes.
Book a consultation →