A world model at the core of Pipi 9

Mike's Notes

Here are some quick notes for Alex explaining how the first 19" server rack, which is currently being built and commissioned, hosts internal models. As the number of racks grows, more models can be hosted.

This is highly experimental. I shall report on results.

Resources

References

  • Reference

Repository

  • Home > Ajabbi Research > Library >
  • Home > Handbook > 
  • Home > pipiWiki > Industries

Last Updated

16/05/2025

A world model at the core of Pipi 9

By: Mike Peters
On a Sandy Beach: 13/05/2025

Mike is the inventor and architect of Pipi and the founder of Ajabbi.

The problem

The world is not a simple place. Any large complex system becomes dynamic, has emergent properties, and has unintended consequences. They are hell to build and update.

Large IT projects;

  • 15% succeed
  • 25% makes no difference
  • 65% fail
The annual global cost of new IT system failure is $USD 3,500,000,000,000 (the size of France's annual GDP) — IT Revolution.

Solution

Just copy how nature does it. Every living biological cell is incredibly complex and self-managing in response to its environment.

Pipi 9

Pipi maintains many models of the world at all levels of reality.

Autonomous agents

Each Pipi instance contains and is driven by autonomous agents.

Swarm intelligence

Each model is curated by an instance of Pipi, which is adaptive in response. Each instance is uniquely internally named in ASCII after one of the old deities from human history, e.g., "Loki," "Thor," or "Niltsi." This will be easier than remembering internal  IP addresses. If the list of names available runs out, then the names of gods from works of fiction could be added, eg, The Lord of the Rings, Game of Thrones, etc. If even more names are needed, there are always ice cream flavours, rose varieties, racehorse names, etc.

Pipi 9 instances function as swarms, similar to a flock of birds. There can be many swarms, and the swarms can also interact.

World model

The world model contains the laws of physics, properties, and other objective constraints of the real world.

Other models

Models can automatically import human-derived ontologies and standards. Only humans apply the rules and parameters. The models are stateful and keep their histories. The connections between models are fluid and dynamic. Some multiple inheritance is also present, which is too difficult to show here in this simplistic outline. 

Self documentation

All assumptions and configurations will eventually be openly viewable on pipiWiki, GitHub, via API, etc. This is a work in progress as I sort out the self-documentation generated by Pipi 9. The problem is mainly how to automatically present a lot of versioned information in multiple languages on web pages, with the required navigation.

Rendering

Once the first server rack (completely isolated from the internet) is operational, documentation rendered in static HTML can be scheduled, copied to a memory stick (analogue security barrier), and then uploaded by FTP to the pipiWiki website. If I remember to do it, it will be monthly at first. Later, I will automate every process and build a team to help with the work.

How it might look

Below, a crude, simplified outline shows examples of the relationships between internal models in Pipi 9. There is a "kind of" hierarchy of models with updates from above, and bubble-up learning from below, all automated.

  • World Model
    • Aviation Model
    • Education Model
    • Health Model
      • UK Health Model
        • UK NHS Model
          • Birmingham Children's Hospital Model
          • Birmingham Women's Hospital Model
        • Circle Health Group Model
          • Albyn Hospital Model
    • Rail Model
    • Sewerage Model
    • Stormwater Model
    • etc

Summary

The whole setup is designed to be fully automated, autonomous, fluid, dynamic, and ever-evolving, but also lawful, unlike LLMS. This is subject to experimentation, change and has much more detail to come, but you get the rough idea.

Accountability Sinks

Mike's Notes

An excellent article by Martin Sustrick on why accountability is lacking. With lots of examples. A long read and lots of quotes to follow up on.

Resources

References

  • Reference

Repository

  • Home > Ajabbi Research > Library >
  • Home > Handbook > Teams > Culture

Last Updated

13/05/2025

Accountability Sinks

By: Martin Sustrik
250bpm: 22/04/2025

Accountability engineering in institution design

Back in the 1990s, ground squirrels were briefly fashionable pets, but their popularity came to an abrupt end after an incident at Schiphol Airport on the outskirts of Amsterdam. In April 1999, a cargo of 440 of the rodents arrived on a KLM flight from Beijing, without the necessary import papers. Because of this, they could not be forwarded on to the customer in Athens. But nobody was able to correct the error and send them back either. What could be done with them? It’s hard to think there wasn’t a better solution than the one that was carried out; faced with the paperwork issue, airport staff threw all 440 squirrels into an industrial shredder.

[...]

It turned out that the order to destroy the squirrels had come from the Dutch government’s Department of Agriculture, Environment Management and Fishing. However, KLM’s management, with the benefit of hindsight, said that ‘this order, in this form and without feasible alternatives,* was unethical’. The employees had acted ‘formally correctly’ by obeying the order, but KLM acknowledged that they had made an ‘assessment mistake’ in doing so. The company’s board expressed ‘sincere regret’ for the way things had turned out, and there’s no reason to doubt their sincerity.

[...]

In so far as it is possible to reconstruct the reasoning, it was presumed that the destruction of living creatures would be rare, more used as a threat to encourage people to take care over their paperwork rather than something that would happen to hundreds of significantly larger mammals than the newborn chicks for which the shredder had been designed.

The characterisation of the employees’ decision as an ‘assessment mistake’ is revealing; in retrospect, the only safeguard in this system was the nebulous expectation that the people tasked with disposing of the animals might decide to disobey direct instructions if the consequences of following them looked sufficiently grotesque. It’s doubtful whether it had ever been communicated to them that they were meant to be second-guessing their instructions on ethical grounds; most of the time, people who work in sheds aren’t given the authority to overrule the government. In any case, it is neither psychologically plausible nor managerially realistic to expect someone to follow orders 99 per cent of the time and then suddenly act independently on the hundredth instance.

— Dan Davies: The Unaccountability Machine

***

Someone – an airline gate attendant, for example – tells you some bad news; perhaps you’ve been bumped from the flight in favour of someone with more frequent flyer points. You start to complain and point out how much you paid for your ticket, but you’re brought up short by the undeniable fact that the gate attendant can’t do anything about it. You ask to speak to someone who can do something about it, but you’re told that’s not company policy.

The unsettling thing about this conversation is that you progressively realise that the human being you are speaking to is only allowed to follow a set of processes and rules that pass on decisions made at a higher level of the corporate hierarchy. It’s often a frustrating experience; you want to get angry, but you can’t really blame the person you’re talking to. Somehow, the airline has constructed a state of affairs where it can speak to you with the anonymous voice of an amorphous corporation, but you have to talk back to it as if it were a person like yourself.

Bad people react to this by getting angry at the gate attendant; good people walk away stewing with thwarted rage.

— ibid.

***

A credit company used to issue plastic cards to its clients, allowing them to make purchases. Each card had the client’s name printed on it.

Eventually, employees noticed a problem: The card design only allowed for 24 characters, but some applicants had names longer than that. They raised the issue with the business team.

The answer they've got was that since only a tiny percentage of people have names that long, rather than redesigning the card, those applications would simply be rejected.

You may be in a perfectly good standing, but you'll never get a credit. And you are not even told why. There's nobody accountable and there's nobody to complain to. A technical dysfunction got papered over with process.

***

Holocaust researchers keep stressing one point: The large-scale genocide was possible only by turning the popular hatred, that would otherwise discharge in few pogroms, into a formalized administrative process.

For example, separating the Jews from the rest of the population and concentrating them at one place was a crucial step on the way to the extermination.

In Bulgaria, Jews weren't gathered in ghettos or local "labor camps", but rather sent out to rural areas to help at farms. Once they were dispersed throughout the country there was no way to proceed with the subsequent steps, such as loading them on trains and sending them to the concentration camps.

Concentrating the Jews was thus crucial to the success of the genocide. Yet, bureaucrats working on the task haven't felt like they were personally killing anybody. They were just doing their everyday, boring, administrative work.

The point is made more salient when reading about Nuremberg trials. Apparently, nobody was responsible for anything. Everybody was just following the process orders.

To be fair, the accused often acted on their own rather than following the orders. And it turns out that the German soldiers faced surprisingly mild consequences for disobeying unlawful orders. So it's not like the high-ups would be severely hurt if they just walked away or even tried to mitigate the damage.

Yet, the vague feeling of arbitrariness about Nuremberg trials persists. Why blame these guys and not the others? There were literally hundreds of thousands involved in implementing the final solution. The feeling gets even worse when contemplating German denazification trials in 1960's:

Today they bring even 96-year-olds or even centenarians to justice just because they worked somewhere in an office or sat in a watchtower. But if it had been done like that in 1965, more than 300,000 German men and women would have had to be imprisoned for life for aiding and abetting murder. [...] It had to be kept under control and suppressed, because otherwise it would have been impossible to start anew. [...] There was a secretary at the Wannsee Conference and no one considered putting her in jail. And yet all these terrible orders were not typed by those who issued them. They were typed by women.

— Interview with historian Götz Aly (in German)

***

At the first glance, this might seem like a problem unique to large organizations. But it doesn't take a massive bureaucracy to end up in the same kind of dysfunction. You can get there with just two people in an informal setting.

Say a couple perpetually quarrels about who's going to do the dishes. To prevent further squabbles they decide to split the chores on weekly, alternating basis.

Everything works well, until one of the spouses falls ill. The dishes pile up in the kitchen sink, but the other spouse does not feel responsible for the mess. It’s not their turn. And yes, there's nobody to blame.

***

This is what Dan Davies, in his book The Unaccountability Machine: Why Big Systems Make Terrible Decisions — and How the World Lost Its Mind, calls "accountability sinks".

Something that used to be a matter of human judgement gets replaced by a formal process. Suddenly, nobody makes any deliberate decisions. Instead, a formal process is followed. In fact, the process may be executed on a computer, with no human involvement at all. There's nobody to blame for anything. There’s nobody to complain to when the process goes awry. Everybody’s ass is safely covered.

In any organization, incentives to replace human judgement by process are strong. Decisions may be controversial. More often than not someone's interests are at play and any decision is going to cause at least some bitterness, resentment and pushback. Introducing a non-personal process allows the decision to be made in automated manner, without anyone being responsible, without anyone having to feel guilty for hurting other people.

The one most important contribution of Davies' book is simply giving this phenomenon, that we all know and lovehate, a name.

And a name, at that, which highlights the crux of the matter, the crux that all too often goes unsaid: Formal processes may be great for improving efficiency. The decision is made once and then applied over and over again, getting the economies of scale.

Formal processes may improve safety, as when a pilot goes over a check list before the take-off. Are flight controls free and correct? Are all the doors and windows locked? And so further and so on.

Processes also serve as repositories of institutional memory. They carry lessons from countless past cases, often unknown to the person following the process. Problems once encountered, solutions once devised, all of that is encoded into a set of steps.

But in the end, deep in the heart of any bureaucracy, the process is about responsibility and the ways to avoid it. It's not an efficiency measure, it’s an accountability management technique.

***

Once you grasp the idea, it’s hard to unsee it. There's a strange mix of enlightenment and dread. Of course it's about accountability sinks!

All of the popular discontent in the West today is fueled by exactly this: A growing rage at being trapped in systems that treat people not as humans, but as cogs in a machine. Processes, not people, make the decisions. And if the process fails you, there's no one to turn to, no one to explain and no one to take responsibility.

This is why even the well-off feel anxious and restless. We may have democracy by name, but if the systems we interact with, be it the state or private companies, surrender accountability to the desiccated, inhuman processes and give us no recourse, then the democracy is just a hollow concept with no inner meaning.

You can't steer your own life anymore. The pursuit of happiness is dead. Even your past achievements can be taken away from you by some faceless process. And when that happens, there’s no recourse. The future, in this light, begins to feel less hopeful and more ominous.

It’s eerie how much of today’s political unrest begins to make sense through this lens.

The backlash against experts? Understandable. After all, they’re seen as the architects of these inhuman systems. The skepticism toward judges? It fits. They often seem more devoted to procedure than to justice. Even the growing tolerance for corruption starts to look different. Yes, it’s bad, but at least it’s human. A decision made by someone with a name and a face. Someone you might persuade, or pressure, or hold to account. A real person, not an algorithm.

And every time you’re stuck on the phone, trapped in an automated loop, listening to The Entertainer for the hundredth time or navigating endless menus while desperately trying to reach a human being who could actually help, the sense of doom grows a bit stronger.

***

But let's not get carried away.

First, as already mentioned, formal processes are, more often than not, good and useful. They increase efficiency and safety. They act as a store of tacit organizational knowledge. Getting rid of them would make the society collapse.

Second, limiting the accountability if often exactly the thing you want.

Take the institution of academic tenure. By making a scientist essentially unfireable, it grants them the freedom to pursue any line of research, no matter how risky or unconventional. They don’t need to justify their work to college administrators, deliver tangible results on a schedule, or apologize for failure.

The same pattern emerges when looking at successful research institutions such as Xerox PARC, Bell Labs, or DARPA. Time and again, you find a crucial figure in the background: A manager who deliberately shielded researchers from demands for immediate utility, from bureaucratic oversight, and from the constant need to justify their work to higher-ups.

Yet again, venture capital model of funding new companies relies on relaxed accountability for the startup founders. The founders are expected to try to succeed, but nobody holds them accountable if they do not. The risk is already priced in by the VC. Similarly to the role of the Bell Labs manager, the VC firm acts like a accountability sink between the owners of the capital and startup founders.

***

On October 1st, 2017, a hospital emergency department in Las Vegas faced a crisis: A mass shooting at a concert sent hundreds of people with gunshot wounds flooding into the ER at once. The staff managed to handle the emergency in a great way, violating all the established rules and processes along the way:

At that point, one of the nurses came running out into the ambulance bay and just yelled, “Menes! You need to get inside! They’re getting behind!” I turned to Deb Bowerman, the RN who had been with me triaging and said, “You saw what I’ve been doing. Put these people in the right places.” She said, “I got it.” And so I turned triage over to a nurse. The textbook says that triage should be run by the most experienced doctor, but at that point what else could we do?

Up until then, the nurses would go over to the Pyxis, put their finger on the scanner, and we would wait. Right then, I realized a flow issue. I needed these medications now. I turned to our ED pharmacist and asked for every vial of etomidate and succinylcholine in the hospital. I told one of the trauma nurses that we need every unit of 0 negative up here now. The blood bank gave us every unit they had. In order to increase the flow through the resuscitation process, nurses had Etomidate, Succinylcholine, and units of 0 negative in their pockets or nearby.

Around that time the respiratory therapist, said, “Menes, we don’t have any more ventilators.” I said, “It’s fine,” and requested some Y tubing. Dr. Greg Neyman, a resident a year ahead of me in residency, had done a study on the use of ventilators in a mass casualty situation. What he came up with was that if you have two people who are roughly the same size and tidal volume, you can just double the tidal volume and stick them on Y tubing on one ventilator.

— How One Las Vegas ED Saved Hundreds of Lives After the Worst Mass Shooting in U.S. History

As one of the commenters noted: "Amazing! The guy broke every possible rule. If he wasn't a fucking hero, he would be fired on the spot."

***

Once, I used to work as an SRE for Gmail. SREs are people responsible for the site being up and running. If there's a problem, you get alerted and it's up to you to fix it, whatever it takes.

What surprised me the most when I joined the team was the lack of enforced processes. The SREs were accountable to the higher ups for the service being up. But other than that they are not expected to follow any prescribed process while dealing with the outages.

Yes, we used a lot of processes. But these were processes we chose for ourselves, more like guidelines or recommendations than hard-and-fast rules. And in an aftermath of an outage, adjusting the process became as much a part of the response as fixing the software itself.

There is even an explicit rule limiting the accountability of individual SREs. The postmortem, i.e. the report about an outage, should be written in a specific way:

Blameless postmortems are a tenet of SRE culture. For a postmortem to be truly blameless, it must focus on identifying the contributing causes of the incident without indicting any individual or team for bad or inappropriate behavior. A blamelessly written postmortem assumes that everyone involved in an incident had good intentions and did the right thing with the information they had. If a culture of finger pointing and shaming individuals or teams for doing the "wrong" thing prevails, people will not bring issues to light for fear of punishment.

— Site Reliability Engineering, How Google runs production systems

***

On February 1, 1991, a jetliner crashed into a smaller, commuter propeller plane on the runway at Los Angeles International Airport. The impact killed twelve people instantly. The small plane, which was pushing the larger one ahead at a speed of one hundred and fifty kilometers, exploded in the fuel tank and caught fire. Passengers tried to get out of the burning plane, but not everyone succeeded. The death toll eventually rose to thirty-five.

Here's a great article from Asterisk about the event:

At the LAX control tower, local controller Robin Lee Wascher was taken off duty — as is standard practice after a crash. After hearing about the propeller, she knew she must have cleared USAir flight 1493 to land on an occupied runway. As tower supervisors searched for any sign of a missing commuter flight, Wascher left the room. Replaying the events in her mind, she realized that the missing plane was SkyWest flight 5569, a 19-seat Fairchild Metroliner twin turboprop bound for Palmdale. Several minutes before clearing the USAir jet to land, she had told flight 5569 to “taxi into position and hold” on runway 24L. But she could not recall having cleared it for takeoff. The plane was probably still sitting “in position” on the runway waiting for her instructions when the USAir 737 plowed into it from behind. It was a devastating realization, but an important one, so in an act of great bravery, she returned to the tower, pointed to flight 5569, and told her supervisor, “This is what I believe USAir hit.”

[...]

The fact that Wascher made a mistake was self-evident, as was the fact that that mistake led, more or less directly, to the deaths of 35 people. The media and the public began to question the fate of Ms. Wascher. Should she be punished? Should she lose her job? Did she commit an offense?

[...]

Cutting straight to the case, Wascher was not punished in any way. At first, after being escorted, inconsolable, from the tower premises, her colleagues took her to a hotel and stood guard outside her room to keep the media at bay. Months later, Wascher testified before the NTSB hearings, providing a faithful and earnest recounting of the events as she recalled them. She was even given the opportunity to return to the control tower, but she declined. No one was ever charged with a crime.

[...]

If you listen to the tower tapes, you can easily identify the moment Wascher cleared two planes to use the same runway. But if you remove her from the equation, you haven’t made anything safer. That’s because there was nothing special about Wascher — she was simply an average controller with an average record, who came into work that day thinking she would safely control planes for a few hours and then go home. That’s why in interviews with national media her colleagues hammered home a fundamental truth: that what happened to her could have happened to any of them. And if that was the case, then the true cause of the disaster lay somewhere higher, with the way air traffic control was handled at LAX on a systemic level.

When you read the report of the investigation, your perspective suddenly changes. Suddenly, there is no evil controller Wascher who needs to be publicly punished. Instead, there is a team of controllers who, despite all the broken radars, poor visibility and distracting duties, heroically ensure that planes do not collide day in, day out.

And if the result of Washer giving a honest report about the incident is that a second ground radar is purchased, that the interfering lights are relocated, or that various less important auxiliary tasks are not performed by the flight controller in charge, the effect on air traffic safety is a much bigger than what could be achieved by firing Wascher. Quite the opposite: Punishing her would have a chilling effect on other experienced controllers. At least some of them would be unwilling to take responsibility for things beyond their control and would eventually leave just to be replaced by less experienced ones.

***

Some of my former colleagues at Google were part of the effort to save Obamacare after the website that people were supposed to use to subscribe to the program turned out not be working. Here's Wikipedia:

The HealthCare.gov website was launched on the scheduled date of October 1, 2013. Although the government shutdown began on the same day, HealthCare.gov was one of the federal government websites that remained open through the events. Although it appeared to be up and running normally, visitors quickly encountered numerous types of technical problems, and, by some estimates, only 1% of interested people were able to enroll to the site in the first week of its operations.

Suddenly, a website was in the center of attention of both the media and the administration, even the president himself. As Jennifer Pahlka writes in her excellent book Recoding America: Why Government Is Failing in the Digital Age and How We Can Do Better:

If the site failed, Obama’s signature policy would likely go down with it. With this threat looming, suddenly the most important policy of the administration would live or die by its implementation. It was the first time the highest priority of the White House was the performance of a website.

Having the support from the highest places, the people in what was to become US Digital Service, outlined a plan:

He had a straightforward two-step plan. Step one was to recruit a small team of technologists with relevant experiences and skills [to fix the website]. Through a trusted network, he reached out to a set of remarkable individuals who signed up to jump into the fire with him. Step two was to win the trust of CMS—an agency [responsible for implementation of the website] that, like all other agencies, really, was highly skeptical of people from outside and resistant to their interference. The situation was tense, but Todd made it clear that he and everyone who came with him were not there to assign blame. They were there to help. The result was the opposite of the usual response to failure. Instead of the hardening that tends to come with increased oversight—of the kind Weaver would later experience working on satellite software, further limiting what he could do—the CMS team suddenly found themselves with something they hadn’t realized they needed: a group of smart nerds they could trust. Like most other agencies, they knew how to acquire technology and technology services; after all, they’d issued those sixty separate contracts for healthcare.gov alone. But now they had people on their team who could look at the code, not the contract terms. That, it turned out, made all the difference.

— ibid.

Again, sidestepping accountability had a beneficial effect. It managed to cut through the seemingly unsolvable internal hurdles and unstuck a stuck system.

***

Dominic Cummings, chief advisor to Boris Johnson during the COVID crisis, recounts:

At the peak of COVID craziness in March 2020, on the day itself that the PM tested positive for CoVID, a bunch of people come into Number 10 sit around the table and we have a meeting and it’s about supplies of PPE to the NHS.

They say, “None of this PPE that we’ve ordered is going to be here until the summer.”

“But the peak demand is over the next three to four weeks.”

“Sorry, Dominic, but it’s not going to be here.”

“Why not?”

“Well, because that’s how long it takes to ship from China.”

“Why are you shipping from China?”

“Well, because that’s what we always do. We ship it from China.”

But A, we need it now and B, all of the airlines are grounded. No one’s flying anything.

“So call up the airlines, tell them that we’re taking their planes, we’re flying all the planes to China, we’re picking up all our shit, we’re bringing it back here. Do that now. Do that today. Send the planes today.”

We did that. But only the Prime Minister could actually cut through all the bureaucracy and say, Ignore these EU rules on Blah. Ignore treasury guidance on Blah. Ignore this. Ignore that. “I am personally saying do this and I will accept full legal responsibility for everything.”

By taking over responsibility, Johnson loosened the accountability of the civil servants and allowed them to actually solve the problem instead of being stuck following the rigid formal process.

***

Finally, consider the mother of all accountability sinks: The free market.

We want government to enforce the rule of law, to enforce the contracts and generally make sure that the market operates freely. But we also explicitly don’t want government interference in the day-to-day workings of the market beyond ensuring compliance with the law and taxes.

Much has been written about how markets act as information-processing machines, how they gather dispersed data from across society and use it to optimize the allocation of scarce resources.

Much less is known about how the lack of accountability gives entrepreneurs the ability to take huge risks. If your company fails, the blame is yours and yours only. No one will come after you. There’s no need to play it safe.

While ignoring the law of supply and demand may have been the primary cause for the failure of communist economies, the fact that the management of every company was accountable to the higher-ups and eventually to the communist party must have meant that they tried to avoid any risks at any cost, which eventually led to terrible performance in implementation of new technologies — even if they were discovered by the scientists — and business practices and to the overall economic stagnation.

***

By now, you probably have a few ideas of your own about how accountability sinks can be creatively incorporated into institutional design.

But before I wrap up, let me make a few basic observations:

  1. Formal processes are mostly beneficial and they’re not going anywhere. Any complex modern society would collapse without them.
  2. Not every formal process is an accountability sink. A process you design and impose upon yourself doesn’t absolve you of responsibility when things go wrong. You remain accountable. On the other hand, a process imposed upon you from above often incentivizes blind adherence, even when it’s hurting the stated goals.
  3. Not every accountability sink leads to rigidity and cover-ups. A process can be designed in such a way as to shield those affected from the accountability, but at the same time not to impose any pre-canned solutions upon them. (E.g. blameless postmortems.)

On The Death of Daydreaming

Mike's Notes

I love daydreaming. It's how I create. We all need to daydream more.

Resources

References

  • The Extinction of Experience: Being Human in a Disembodied World.

Repository

  • Home > Ajabbi Research > Library >
  • Home > Handbook > Teams > Daydreaming

Last Updated

12/05/2025

On The Death of Daydreaming

By: Christine Rosen
After Babel: 05/05/2025

Christine Rosen is a senior fellow at the American Enterprise Institute, a columnist and podcast host for Commentary magazine, and a fellow at the Institute for Advanced Studies in Culture at the University of Virginia.

What we lose when phones take away boredom and interstitial time



Intro from Jon Haidt:

When I was nearly finished writing The Anxious Generation in the summer of 2023, I realized that I had left a gap. The book focused on the collapse of mental health, attention, and socialization of Gen Z—but again and again, older readers and friends would tell me: “this is happening to me too.” I realized that the global transition to a phone-based life is transforming everyone’s consciousness. But how? What exactly is happening to us?

I thought back to my first book, The Happiness Hypothesis, which explored ten ancient ideas about how to live a good life—ideas found across continents and millennia. I began to see that the phone-based life, and social media in particular, push us to live in ways that are directly contrary to those recommended by nearly every ancient religious and philosophical tradition. These traditions tell us to be slow to judge and quick to forgive. They offer practices like meditation to quiet the mind and open the heart to deeper truths and greater communion.

In The Anxious Generation, I explored six of these contradictions in Chapter 8. A simple summary of that chapter is this: the phone-based life diminishes our humanity. Compared to the life we once lived, it degrades us morally, spiritually, socially, and cognitively.

Since writing that chapter, I’vebeen on the lookout for others who can express this loss of humanity better than I can. Here’s my short list: L.M. Sacasas for his Substack The Convivial Society; Nicholas Carr, for The Shallows and his more recent book Superbloom; and Christine Rosen, for her 2024 book The Extinction of Experience. (For a Gen Z perspective, see Freya India—especially the post we co-wrote “On The Degrading Effects of Life Online.”)

Today’s post is by Christine Rosen. Christine holds a Ph.D. in history with a focus on American intellectual history. She is a senior fellow at AEI, and she was my discussion partner when I gave a talk on The Anxious Generation at AEI soon after the book launched. That was when I learned about her book project, The Extinction of Experience: Being Human in a Disembodied World.

So when her publisher invited me to consider reading an early draft and offering an endorsement, I was glad to say yes. I loved the book, and I hope the blurb I wrote captures its urgency and depth:

Rosen shows us that we are embodied creatures who are rapidly losing the analog world in which our bodies and minds evolved. She shows us that many of the technologically aided advances in convenience and efficiency exact a cost in our humanity, our civility, and ultimately our ability to live together in a democratic society. This is an extremely important book; its message is all the more urgent as AI threatens to make everything effortless and frictionless.

I invited Christine to present a section or idea from her book for After Babel. She chose one of my favorites: the loss of “interstitial time.” Interstices are the gaps between things, as with the cells in your body or the spaces between architectural columns. When applied to time, it means the many bits of time scattered throughout the day such as the five minutes that students have in between classes, or the unknown number of seconds that pass while you are waiting for an elevator. These moments used to be given over to silent reflection or conversation with whoever is around. Now, for most of us, nearly all of them are grabbed by our phones.

Christine traces out the profound consequences of losing those interstitial moments, for our creativity and for our humanity. She shows why it is so important to guard those moments for daydreaming.

- Jon


On The Death of Daydreaming

By Christine Rosen

Can you remember the last time you daydreamed? Or coped with boredom without reaching for your phone? Before the era of mobile technology, most of us had no choice but to wait without stimulation, and often, that meant being bored.

But today we need never be bored. We have an indefatigable boredom-killing machine: the smartphone. No matter how brief our wait, the smartphone promises an alleviation for our suffering.

Yet the smartphone’s triumph over boredom might prove a Pyrrhic victory. As Jonathan Haidt showed in The Anxious Generation, the rapid adoption of smartphones and social media, particularly by the young, led to many negative unintended consequences such as increased rates of depression, anxiety, loneliness, and self-harm. So, too, our efforts to vanquish boredom have had deleterious impacts such as on our ability to let our minds wander, to cultivate patience, and to experience anticipation.

As a member of Generation X, I took boredom for granted. Without access to any kind of mobile technology more sophisticated than a Speak and Spell game, my generation was expected to fill our empty hours in other ways, which usually meant going outside and doing things with our friends. Some kids stayed inside and watched television, of course, but the options for programming were limited. Boredom was part of life, and we accepted and adjusted to this reality. Several decades later, raising my own sons in the age of mobile technology, I saw how quickly expectations had changed for how to spend one’s free time. With access to an iPad or a smartphone, children in the twenty-first century never had to be bored; in fact, everything about the platforms and apps that targeted children habituated them to the idea that they ought never to be bored. I worried about how this might change their expectations and ability to deal with delay, frustration, and empty time as adults.

Boredom has a purpose. To understand and harness it, we need to give our minds more opportunities to experience it. In the rest of this post, I will explore the many ways our efforts to conquer boredom through technology have produced unintended consequences, including the near-total capture of our attention, the death of daydreaming, and the end of a healthy sense of anticipation in our daily lives.

We Used to Just Stare Out the Window

“Shepherds do it, cops do it, stevedores and merchants in their shops do it,” technology critic Marshall McLuhan observed in Understanding Media when discussing Greek men’s use of komboloi, or worry beads. The beads, which look like amber-­colored rosaries, were used throughout the day to pass the time, a secular version of praying the rosary. Their use of worry beads also reflects the deeply felt human need to fill interstitial time. We all engage in these weird little rituals: Some people doodle or fidget, others knit, a lot of people used to smoke. The late Psychologist Mihaly Csikszentmihalyi called these “the ‘microflow’ activities that help us negotiate the doldrums of the day.” These “small automatic games woven into the fabric of everyday life help reduce boredom … but add little to the positive quality of experience.”

Though the experience of boredom is deeply human, what we reach for when we experience it is socially structured, unique to our moment in time. The worry beads and cigarettes of previous eras have given way to smartphones. Ours is a less carcinogenic but more commodified distraction, with long-term impacts which we’re only beginning to fathom.

According to Pew Research, nine out of ten Americans own a smartphone, and 95 percent of teenagers have access to one. A 2024 Pew survey of teens ages 13-17 found that half said they were online “almost constantly.” The average person spends the vast majority of his or her free moments looking at a screen. For decades, Americans have spent a considerable amount of their leisure time watching television; what has declined significantly is the amount of free time they spend with other people. One recent study found an increase in social isolation and significant declines in social engagement with family and friends as well as shared leisure time. We spend more of our free time alone, staring at screens, which habituates us to reach for our phones whenever we have a moment alone to ourselves. Screens have become the dominant means for us to alleviate boredom, whether during long stretches of time alone or in fleeting moments throughout the day.

This is not just a challenge for the young. Pew Research found that Americans over the age of sixty “now spend more than half of their daily leisure time. . . in front of screens.”

Lately I’ve seen more people in their cars thwarting stoplight boredom—­that is, unable to sit unmediated for even the few moments that it takes a red light to turn green, they reach for their smartphones. Kids post on social media about boredom throughout the school day (#bored). The space between the time when they experience boredom and when they broadcast it has disappeared.

A World That Never Lets You Be Still

What happens when we replace boredom with constant distraction and stimulation? Warnings about the harmful effects of too much stimulation are nothing new. “For a living organism, protection against stimuli is an almost more important function than the reception of stimuli,” Sigmund Freud observed. But given the range and speed of stimuli at our disposal, we might need a new way of thinking about their effects. Stimulation seems too quaint a word.

It is a reasonable human impulse to seek distraction from the uncomfortable experience of boredom. What is new about our present moment is that the method we have chosen to alleviate boredom in the short term has negative long-term impacts on our attention spans and our ability to practice patience. We have created a machine for stimulation far beyond anything imaginable in Freud’s time. We might believe that our attempts to fill our interstitial time with mediated distractions qualify as an effort to optimize our experiences under less-than-optimal conditions. But in fact, we have become more like gambling addicts, habituated to the temporary escape our digital technologies provide.

A fascinating study of machine gambling in Las Vegas notes that “flow,” that state of being in which someone is so involved in an activity “that nothing else seems to matter,” as Csikszentmihalyi describes it, is precisely the state gamblers seek and attain at the machines, and precisely what machine designers seek to exploit when people initiate play. Yet, while gamblers are experiencing flow, they are not having the kind of optimal long-­term experiences psychologists had in mind when they advocated pursuing activities that put you “in the zone.”

In a less intense way, we all enter this less-than-optimal state when we turn to our devices to alleviate the experience of boredom. The distractions we seek don’t only consume our time, however. They also degrade many habits of mind that require time and patience to form, such as empathy, awareness, and emotional regulation.

When Idleness Became a Problem to Solve

In a letter Aldous Huxley wrote to George Orwell in 1949 he argued, “I feel that the nightmare of 1984 is destined to modulate into the nightmare of a world having more resemblance to that which I imagined in Brave New World.” What did Huxley believe would bring about this dystopia? Not a global world order or a charismatic despot: “The change will be brought about as a result of a felt need for increased efficiency.”

Huxley’s warning has merit. We enjoy the efficiencies and distractions technology brings, but they leave us less skilled at patience. They teach us to value efficiency above all and to be suspicious of idle time, when we should see idle moments as opportunities for reflection and renewal.

Today you rarely see the word “idle” except when used as a pejorative; to be idle is to be wasteful, and several of the most popular Internet startup companies have targeted underutilized resources such as idle cars (Turo, ZipCar), household equipment (SnapGoods), or empty bedrooms (Airbnb), allowing people to make use of them by renting them out when they aren’t in use.

Some technologists have set their sights higher. Max Levchin, a cofounder of PayPal and investor in many Silicon Valley technology companies, gave a speech at a conference in Munich in which he lamented, “The world of real things is very inefficient.” Harnessing the network effects of big data, he foresees a future where we can more efficiently do many things: “We will definitely see dynamically priced queues for confession-­taking priests and therapists,” he said.

Moments of idleness and daydreaming used to be prized for the unexpected pleasure they brought. As Wordsworth wrote, “For this one day we’ll give to idleness . . . One moment now may give us more than fifty hours of reason.” He advocated straying about “voluptuously” through rural fields, asking “no record of the hours given up to vacant musing.” We might not spend our free time lolling about rural glens, but idleness of this variety is the opposite of the instrumental, practical use that our culture encourages us to make of our time. Technologists like Levchin would have us hire out our voluptuous spare time on TaskRabbit. To borrow an image from Wordsworth’s rural fields, we should embrace this fallow time. To be fallow is not the same thing as to be useless; it is to let rest so that cultivation can occur in the future. When mediated experiences co-opt our idle time, we are left with fewer and fewer of these fallow moments, moments that are central to the experience of being human.

With rates of anxiety rising in the U.S., particularly among teens, it is also worth considering how the frenetic pace of the online world, where so many of us spend so much of our time, contributes to our sense of feeling overwhelmed and out of control. Reclaiming our idle time and reorienting ourselves away from screens is one of many small yet radical acts that have the potential to improve the quality of our daily experiences.

The Unfortunate Death of Daydreaming

A culture without boredom, focused on efficiency, also undermines the act of daydreaming, another thing interstitial time used to be given over to. Daydreaming seems a fusty term in an age when productivity and usefulness are prized. But as psychologists and neurologists have found, a wandering mind––often the first signal of impending boredom––is also a creative mind. In the 1960s, psychologist Jerome Singer, the grandfather of daydreaming studies, identified three kinds of mind-­wandering: the productive, creative “positive constructive daydreaming,” obsessive “guilty–­dysphoric daydreaming,” and “poor attentional control.” Singer believed daydreaming was a positive adaptive behavior—­a bold departure from the conventional wisdom at the time, which linked daydreaming to other psychopathologies such as excessive fantasizing. As one student of Singer’s noted, Singer’s work found strong associations between daydreaming and the personality trait “openness to experience,” which demonstrates sensitivity, curiosity, and willingness to explore new ideas and feelings.

Since then, researchers have found numerous positive effects of a wandering mind. Psychologist Scott Barry Kaufman summarized them:

“self-awareness, creative incubation, improvisation and evaluation, memory consolidation, autobiographical planning, goal driven thought, future planning, retrieval of deeply personal memories, reflective consideration of the meaning of events and experiences, simulating the perspective of another person, evaluating the implications of self and others’ emotional reactions, moral reasoning, and reflective compassion.”

Daydreaming is also a prompt to memory. As Stefan Van der Stigchel argues in Concentration: Staying Focused in Times of Distraction, “When you are daydreaming (or mind-wandering, as it is referred to within scientific circles), memories that you thought were lost forever can come to the surface again.” He adds, “The neural activity that can be observed when you are daydreaming is very similar to that found in the ‘default network,’ a network of regions in the brain that are active during periods of rest.”

It can be a challenge to find those periods of rest throughout our day, and when we do, if we are habituated to the stimulation technology provides, it is difficult to quiet our minds. As Moshe Bar argues in Mindwandering, “the greater challenge is freeing ourselves from the distractions within, which disrupt our attention and intrude on the quality of our experience even when we are in a perfectly quiet place." In other words: we must cultivate habits that allow for mindwandering and daydreaming. We must, every day, try to reclaim the time that technology has colonized.

Why? Anecdotally, history provides many examples of scientific breakthroughs—­“aha!” moments—­that arose during moments of daydreaming or downtime: René Descartes in bed staring at a fly on the ceiling and coming up with coordinate geometry; Albert Einstein’s glimpse of the Bern tower on a streetcar ride prompting the theory of special relativity; the walk in the woods that prompted Nikola Tesla to devise alternating electrical current.

Unstructured, unmediated time is especially important for the development of creativity in children. “In the space between anxiety and boredom was where creativity flourished,” wrote Po Bronson and Ashley Merryman in their examination of declining scores on the Torrance Test for creativity among American children. They hypothesize that one of the reasons creativity scores might be declining is children’s increased use of screen-­based technologies during downtime. Rather than being left to their own imaginative devices, their wandering minds are often captured by devices—­smartphones and other screens that grasp their attention and, in the process, prevent all other possible uses of those moments of idle time.

No More Anticipation

Now that we have so many ways to fill even the smallest fragments of time, a subtle shift in our psychology of expectation also follows. We are more likely to experience waiting as an unpleasant delay rather than as anticipation. Waiting has become a problem to be solved, rather than a normal human experience. When we are accustomed to easily filling time, opportunities for anticipation, like opportunities for daydreaming, disappear.

Anticipation is a kind of preparation for the future. Actively embracing anticipation is also important for one’s emotional health. Neuroscientist Antonio Damasio calls this practice the “imagination response,” and in many ways it resembles daydreaming in its power to prepare the mind for new experiences. Damasio describes an unusual patient, Elliot, who could rationally think through positive and negative likely outcomes for his behavior and could experience happiness or disappointment once something happened to him. What Elliot couldn’t do was imagine or preview those future feelings. Without a functioning imagination response, he could think about the future rationally, but he couldn’t feel it emotionally. As a result, he was usually indecisive and impulsive, which caused him unhappiness.

Try Being Bored

Does it matter if we no longer tolerate boredom, let our minds wander, cultivate a sense of anticipation, and practice patience? Our demand for immediate answers is voracious, and not entirely a bad thing. It drives innovation and commerce and has allowed for communication on a scale barely imaginable a century ago. But living a full meaningful human life means coping with the liminal, those in-­between moments of life when we must endure uneasy or uncomfortable experiences, from boredom during a meeting to bearing witness to another’s illness, to simply being stuck on a bus. In everyday life, we can all try, however modestly, to shift our individual perceptions and behavior by embracing a more generous sense of anticipation and a healthier attitude about delay, by reframing waiting as an opportunity for daydreaming and idle time rather than an excuse for distraction, and by trying to be more patient with one another. Such advice does at least have a long pedigree. Aristotle is said to have warned, “Patience is bitter, but its fruit is sweet.”

Parents have a crucial role to play in teaching children how to deal with boredom, and it can be as easy and as old-school as simply telling them: “Go outside and play.” Instead of handing a child a slot machine of distraction, encourage them to come up with their own game or activity. Rather than structuring and organizing an activity for your children, let them figure that out for themselves, or with their peers. Children are extraordinarily creative when given the space and time to indulge their wandering minds, but this often requires first overcoming the immediate challenge of handling their frustration and boredom. Placing the burden of alleviating one’s boredom back on a child isn’t a punishment; it’s an opportunity for them to find creative solutions to their discomfort and, as they mature into adults, to identify and cope with feelings of frustration.

As well, parents should model better behavior by resisting the temptation to pick up our phones whenever we are bored. Try this experiment: For one day, do not pick up your smartphone during small breaks in your routine, such as waiting for the train, or sitting in your car at a stoplight. If you find yourself in a doctor’s waiting room, or waiting for a friend at a restaurant, don’t pick up your phone to fill those few minutes. Pay attention to what is around you, or let your mind wander. This sounds like a simple experiment, but as someone who repeatedly tries and often fails to do this, it is revealing of our own bad habits and a useful prompt for thinking more critically about how we spend our time. Reaching for the phone every time is the easy fix, but it is one that has damaging long-term consequences for individuals and for society.

In other words: a bit of boredom is good for us, so the next time you have a minute to spare, instead of reaching for your phone, be rebellious: Daydream.

Sandy Beach is being reformated

Mike's Notes

Sorry, people, there will be a temporary disruption for a few days.

Resources

References

  • Reference

Repository

  • Home > Ajabbi Research > Library >
  • Home > Handbook > 

Last Updated

18/05/2025

Sandy Beach is being reformatted

By: Mike Peters
On a Sandy Beach: 11/05/2025

Mike is the inventor and architect of Pipi and the founder of Ajabbi.

As mentioned on April 6, all of the posts on this blog are being reformatted in preparation for Pipi 9 going into production. 

The content will still be created by a human, but will eventually be stored and accessed via a workflow from a Pipi CMS database. The Pipi CMS will assemble the posts, including references and metadata. The pool of references can then be shared, reducing the work required. The content can then also be shared via newsletters, etc.

Many posts have been converted, and the rest will be altered over the next few days. It mainly affects older material written before February of this year.

I will also let Grammarly loose on anything I previously wrote.

Today, there are 331 posts and 12 pages. Here is a list of things I need to keep track of for the conversion project.

Pages

  • 12/12 Completed

Posts

  • 2013 1/1 Completed
  • 2014 2/2 Completed
  • 2015 3/3 Completed
  • 2016 1/1 Completed
  • 2017 1/1 Completed
  • 2018 2/2 Completed
  • 2019
    • Jan 1/1 Completed
    • Feb 1/1 Completed
    • Mar 3/3 Completed
    • Apr 16/16 Completed
    • May 13/13 Completed
    • Oct 1/1 Completed
  • 2020 2/2 Completed
  • 2021 2/2 Completed
  • 2022 4/4 Completed
  • 2023
    • Aug 1/1 Completed
    • Sep 1/1 Completed
    • Dec 14/14 Completed
  • 2024
    • Jan 4/4 Completed
    • Feb 5/5 Completed
    • Apr 3/3 Completed
    • May 6/6 Completed
    • Jun 30/30 Completed
    • Jul 31/31 Completed
    • Aug 31/31 Completed
    • Sep 0/30 Completed
    • Nov 1/1 Completed
    • Dec 31/31 Completed
  • 2025
    • Jan 31/31 Completed
    • Feb 28/28 Completed
    • Mar 30/30 Completed
    • Apr 30/30 Completed
    • May 11/11 Completed

The template below has been added to the top of each post or page. Sometimes, it duplicates what's already there and is removed by hand. Otherwise, it is filled in and becomes part of the post or page as metadata.


Mike's Notes

Note

Resources

  • Resource

References

  • Reference

Repository

  • Home > Ajabbi Research > Library >
  • Home > Handbook > 

Last Updated

20/04/2025

Article

By: Mike Peters
On a Sandy Beach: 20/04/2025

Mike is the inventor and architect of Pipi and the founder of Ajabbi.

words

Code

snippit

Elevate Your Engineering Culture: The Power of Documenting Architecture Decisions

Mike's Notes

This article by Karol gives a worked example of an Architectural Decision Record (ADR). Another type of technical documentation.

Resources

References

  • Reference

Repository

  • Home > Ajabbi Research > Library >
  • Home > Handbook > 

Last Updated

10/05/2025

Elevate Your Engineering Culture: The Power of Documenting Architecture Decisions

By: Karol Galanciak
Modern Engineering Leader 07/04/2025

CTO & Co-Founder at Smily | Helping you become a Modern Engineering Leader.

Learn why clear, accessible decision logs can enable collaboration and learning.

Imagine this scenario: Your team’s been heads-down for months on a new initiative - refactoring an aging monolith into microservices. The architecture discussions were epic. You debated everything from data persistence strategies to synchronous vs. asynchronous communication. Yet six months down the line, a new team member asks, “Why are we using Kafka again?” Everyone shrugs. The conversation is hazy in everyone’s memory, and hours are lost retracing those original decisions. Sounds familiar?

This is exactly where Architecture Decision Records (ADRs) come in. They capture and preserve the context, rationale, and trade-offs for the most critical decisions you make, ensuring knowledge isn’t lost and that your team can move forward confidently. By writing architecture decisions down, you create a durable knowledge asset that will outlive the project itself.

In this article, we’ll explore how documenting architecture decisions can transform your engineering organization from one that’s plagued by constant rehashing of old debates to one that runs like a well-oiled, knowledge-sharing machine.

What is Architecture Decision Record?

An Architecture Decision Record (ADR) is a concise document that captures an important design choice and the context around it. Think of it as a single-page summary of a pivotal decision: the motivation, the alternatives considered, the trade-offs, and the consequences. Each ADR is typically stored in a repository, creating a living log of how and why your architecture evolved.

Instead of relying on memory or long-forgotten meeting notes, you can pull up an ADR to see exactly what led your team to adopt technology X or design pattern Y.

Why Documenting Architecture Decisions Matters

1. A Single Source of Truth

Think of ADRs as a time capsule for your architecture’s evolution. They provide a single source of truth that any current - or future - team member can consult. No more searching through Slack threads or email chains to figure out why something was done a certain way.

2. Better Onboarding and Cross-Team Collaboration

ADRs remove guesswork for new hires or teams that need to integrate with your system. When decisions are explicitly documented, teams can quickly grasp design intentions, constraints, and trade-offs. This accelerates onboarding and prevents siloed knowledge.

3. Encourage Thoughtful, Data-Driven Decisions

Writing an ADR forces you to articulate your thought process. You must consider alternatives, articulate the rationale, and understand the implications. This type of deliberate, data-driven approach elevates the quality of architectural discussions.

4. Simplify Architecture Evolution

Architectures evolve and that’s normal. When you deprecate, change, or supersede a decision, referencing and updating the original ADR clarifies the historical context. It’s a lightweight but powerful way to manage the living, breathing entity that is your system architecture.

A Simple ADR Template

Below is a straightforward example (based on this template) you can start using today. Keep it simple. The goal is to document the most important aspects of each architectural decision - no need to write anything elaborate and long as this could discourage from writing ADRs in the long run.


## Title

<Short title describing what this ADR is about>

## Status

<Accepted | Superseded by ADR-xx>

## Date

<Date>

## Context

<Describe the nature of the problem that requires a decision and all relevant context around it.>

## Decision

<Describe briefly the decision that was made.>

## Rationale

<Explain the reasoning behind the decision and its trade-offs and why it is consider the preferred option.>

## Implications

<Describe the side-effects of this decision, both technical and not-technical one. Include both positive and negative implications>

## Alternatives Considered

<Describe any alternative solutions that were considered as a potential solution and why they were not chosen.>

## References

<Optional. Include any links to resources that influenced the decision or might be helpful in understanding the subject of the decision in depth>


Example: Migrating from Synchronous HTTP API to Kafka

Here’s a fictional - but very plausible - example you might see in an Architecture Decision Repository.


## Title

Migrating from Synchronous HTTP API to Kafka

## Status

Accepted

## Date

2025-03-10

## Context

Our microservices currently communicate via synchronous HTTP APIs, causing latency issues and occasional disruptions when one service is unavailable. Also, the cost to handle the entire traffic is very high. Most of the communication, especially reads, don't require synchronous flow. We also anticipate a need to handle significantly higher  request volumes in the near future. To increase resiliency, scalability and cost-efficiency, an asynchronous communication would be preferred.

## Decision

We will transition from synchronous HTTP API calls to a Kafka-based event-driven architecture for communication between our microservices.

## Rationale

  • Scalability: Kafka’s event-driven model allows simple horizontal scaling of consumers, which is critical for our anticipated traffic growth and is also very cost-efficient.
  • Resilience: Asynchronous messaging decouples microservices, so one service’s downtime doesn’t cascade throughout the system, which is especially important for writes/commands. That will allow us to take advantage of Saga pattern.
  • Cost-efficiency: A simple proof of concept indicates that just 3 Kafka consumers can read the equivalent amount of data as 25 Sidekiq workers reading from HTTP API. Also, it implies that we will be able to scale down web workers of the upstream service by 40% as we won't be reading this data from the HTP API.

## Implications

  • Operational Overhead: We need to maintain a Kafka cluster, which introduces new complexity for monitoring, alerting, and administration. Amazon MSK service can be a great solution here.
  • Kafka Learning Curve: Engineers will need to gain familiarity with event-driven design patterns and Kafka itself.
  • Deployment and Migration Plan: We’ll roll out event streams incrementally to avoid a “big bang” migration. Secondary microservices will be adapted first, followed by the more critical ones.

## Alternatives Considered

  1. Continue with Synchronous HTTP: Would be simpler to maintain, but scalability, resiliency and cost-efficiency trade-offs are not acceptable in the long run.
  2. Use a Different Message Broker (e.g.RabbitMQ): While viable, Kafka’s persistence and proven track record with large-scale event processing made it more appealing.

## References


When to Write (and When Not to Write) an ADR

ADRs are meant to capture key decisions that have long-term implications for your system or organization. If a decision introduces a new dependency, alters fundamental data flows, or significantly affects architecture and team processes, it likely requires an ADR.

On the other hand, minor decisions - like tweaking a library version or refactoring a single function usually don’t need an official record.

Use your judgment: if it’s significant enough that others might question later or that will be difficult to undo, document it. Otherwise, don’t let the process become an administrative burden.

Recommendations for Organizing ADRs

Once you start adopting ADRs, having a clear organizational strategy is essential. Many teams keep their ADRs in a dedicated folder within their source control (like docs/adrs), ensuring everything is versioned alongside the code.

For those who prefer a more dynamic knowledge base, solutions like Notion can be excellent for storing and collaborating on ADRs. You can create a Notion database, tag each ADR with relevant topics (e.g., “Security,” “Scalability,” “Data Layer”), and link out to related discussions or artifacts.

The key is to pick a system that fits your team’s workflow - something both discoverable and easy to maintain. By keeping ADRs well-organized and centrally accessible, you amplify their impact and make it far more likely your team will actually reference and update them over time.

Wrapping up

ADRs are not meant to add bureaucratic overhead. Rather, they serve as lightweight documentation that captures the heart of each major technical decision - protecting your team from knowledge loss, rehashing old arguments, and misalignments. By inroducing ADRs into your engineering culture, you will enable stronger collaboration, make more informed decisions, and onboard new team members with ease.

The next time your architecture evolves, don’t leave your decisions to chance or memory. Make them transparent, searchable, and future-proof by documenting them in an Architecture Decision Record. You’ll thank yourself the next time someone inevitably asks, “Wait, why did we choose this again?”