Project Ariadne.

Lexicon

The book's own words

A book that coins its own terms owes you a glossary. These are the ones Project Ariadne uses as if you already knew them — each with the chapters where it is coined or earns its keep. Every one of them is a story compressed into a name.

The thread #

The book’s own metaphor and the name of each chapter’s closing paragraph: not a map of the labyrinth — there is none — but a set of principles to hold onto when you’re lost.

Introduction, Epilogue

Ariadne #

The sports-betting platform this book is named after: five teams that became nine, three stacks, millions spent, scrapped and restarted from scratch. The labyrinth the thread was for.

Introduction, Part IV opener, Chapters 8, 18–21

The day of nothing #

A full working day, at Ariadne’s peak, producing zero, because everything I could touch was waiting on someone who would not decide.

Introduction, Chapter 20

The database admin #

The one person allowed to touch Ariadne’s database; a queue of one that set the speed of the whole platform.

Chapters 8, 19

Stefan #

The colleague who has quietly become a single point of failure: leaves on good terms, with cake, and eleven pages that answer nothing. Every team has one; on a long enough project, everyone becomes one.

Chapter 16

The five percent / code blindness #

When something is familiar you stop seeing it; you see maybe five percent and your memory paints the rest. A guess, not a measurement, and the reason a newcomer can find in a week what four seniors missed for three years.

Chapters 5, 26

The five-second rule #

Open a function. If a competent developer can’t tell you what it does in five seconds, it’s clever, and clever is the problem.

Chapter 1

Do we need this now? #

The four-word question, asked out loud before any piece of work.

Chapter 1

The twenty-line rule #

A function should fit in one glance. Held with ninety percent firmness.

Chapter 2

The cabinet, the junk drawer, the newspaper rule #

Names nested like labeled drawers; utils as the drawer that means “I didn’t decide“; the most important thing at the top of every file.

Chapter 2

Why-comments #

The only comment worth writing: what the code cannot say — the incident, the ticket number, the cliff someone already drove off.

Chapter 3

The boy-scout rule / leave it better #

Every file you pass through, a little better than you found it; kaizen at the scale of a file.

Chapter 4

The health grade, the confusion log, the direction map #

Three instruments against blindness: an A-to-F per module argued over twice a year; everything that confused the newcomer, read by the team at day thirty; one page of where the architecture is heading, checked against reality each quarter.

Chapters 4, 5, 13

Step nineteen #

The runbook step that was wrong for two releases and nobody noticed until the substitute deployed on a beach day. Any human step standing between a team and production.

Chapter 7

Every change is releasable #

The main branch is always in a state you’d ship.

Chapter 7

Cost of delay #

Finished work sitting unshipped is value already paid for and not collected — and learning already earned and not received.

Chapter 6

The pin #

The question the machine chapters leave standing: if any change can ship any afternoon, what is the sprint for?

Chapters 7, 9, 17

The sticky note #

“Deployments are painful,” which attended thirty retrospectives and changed nothing. A doer would have needed one.

Chapter 9

Keep the appointments, kill the liturgy #

The test for any recurring meeting: did the machine improve because we held it?

Chapters 9, 12

The collective brain #

A team is one brain distributed across several skulls; its intelligence is the parts times the bandwidth between them; trust is the protocol.

Chapter 10

The pit stop #

Specialists moving as one organism on trust that was drilled, not hoped for.

Chapter 10

The North Star / VTFM #

A direction clear enough to steer by, laddered down — Vision, Themes, Focus areas, Metrics — until it touches the ticket.

Chapter 11

FIKA, the GSD day, the innovation week, the happiness index #

The rituals: agenda-less hours on the calendar; a monthly day for papercuts; a week in seven to build what you want; a crude score whose only value is its trend.

Chapter 12

The welcoming buddy, the 90-day plan, the guide #

One named human for the newcomer; a one-page path through the fog; the prophet who knows everything and wants to spread it, proud of becoming unnecessary.

Chapter 13

The one rule #

Nobody yells at anybody. The only rule in the book held with one hundred percent firmness.

Chapter 14

The chimp #

The fast, ancient thinker that answers first when a review comment lands wrong. Embrace it; never let it publish.

Chapter 14

Whiteboard prices #

The same disagreement costs a sentence at the whiteboard, a meeting mid-implementation, and a relationship at the review.

Chapter 14

The beer test #

Would you choose to spend an unpaid hour with this person? Chemistry’s crudest measure, and its trap when it comes to mean “looks like us.”

Chapter 15

The Code Vault #

One known place for the team’s externalized memory: question-shaped answers, demand-grown, reader-repaired, small and alive.

Chapter 16

The red sprint #

The sprint that ends in failure, and what the organization does about it — the tell.

Chapter 18

The four deaths #

One login feature that died four ways: the dependency, the undefined requirement, the late veto, the cross-team collision. None had a Scrum solution.

Chapter 18

"Done" meant five things #

Five teams, five sincere definitions, one word. The reason is people.

Chapter 18

The decision void / the sawn-in-half chair #

Nobody whose job is to decide; ownership handed down while authority stays up.

Chapter 20

The engineer in a suit #

The best engineer you have, promoted into a job he is bad at and hates, and lost twice.

Chapter 21

The heresy #

The product owner should be a senior developer.

Chapter 21

No dogma #

Every principle in this book is a default, not a doctrine — including that one.

Chapters 2, 22, Interlude IV

The why-station #

The question no pipeline asks: what problem does this solve, for whom, and how will we know?

Chapter 23

Never trust the client #

Distrust the data, distrust the stated solution, trust the lived problem absolutely. Never trust the keyboard; trust the Tuesday.

Chapter 25

Psychic weight #

Every open loop occupies a sliver of attention continuously; the cure is capture you can trust.

Chapter 28

Monday vision, Friday reflection; the five-year game #

Ten minutes at each end of the week; once a year, five years forward and five back across the sections of a life.

Chapter 29

The booklet of hope #

A store of the why and the good, kept outside yourself for the days you can’t generate it.

Chapter 31


These forty-one are the back matter of the printed book, reproduced here because a glossary is a hypertext object that has spent its whole life printed flat. Three chapters are free to read, and the terms in them link back here.