Building places where every kind of intelligence in the room can think well together. A companion to the Agile Manifesto, written for the era in which the place we build in has acquired a second kind of inhabitant.
Something has changed about the rooms we build software in. The work was always more than typing — it was understanding held in people's heads, decisions argued into shape, a shared sense of why the system is the way it is. Now there is a new kind of collaborator in that room: tireless, fluent, generating faster than anyone can read. The question is no longer whether it belongs. It does. The question is how we build a place — for the people and the agents both — where everyone can think well together and the understanding that keeps a system alive does not quietly leak away.
Habitat Thinking treats that whole place — the people, the agents, the relationships between them, and the code, conventions, and feedback loops they share — as a habitat, and asks the oldest question habitability ever posed: is this a good place to live? Through doing this work, and helping others do it, we have come to value:
The whole cognition in the room over the code on the screen
Sustained human understanding over the throughput of the place
The living theory the inhabitants hold over the artefacts that embody it
Designing the collaboration over directing the tool
Orientation that outlives the tools over tactics tuned to today's models
Judgment that compounds over volume that impresses
Accountability that rests with people over assurance manufactured by the place
That is, while there is real value in the items on the right — a habitat that neglects them is no habitat at all — we value the items on the left more.
The habitat is the whole room, not the repository. Code is one artefact in it. The place is the people and the agents, the relationships between them, the understanding they share, and the way they think together. Design for the room, and the code takes care of more than you expect; design only for the code, and the room slowly stops being one.
Optimise for orientation that outlives the tools. Models, harnesses, and vendors will turn over faster than anyone can keep up with. The compass must not: how you keep people understanding the system, accountable for it, and at home in it is the part worth carrying across every tool generation. Tactics are rented; orientation is owned.
Understanding is a deliverable, not a bottleneck. The instinct to route the human out of the loop treats comprehension as friction to be designed away. But a place that ships working software while its people grow steadily more ignorant has not succeeded — it has become a house no one can find their way around in the dark.
Agents keep understanding cheap; people stay accountable. An agent can and should own the labour that keeps a human's mental model affordable to sustain — surfacing decisions, writing the choice story, capturing surprise, flagging drift. But answerability must terminate in a human or an organisation. An agent made accountable for human understanding is an accountability sink: a way of laundering answerability into part of the habitat that structurally cannot hold it.
Protect the friction that makes minds update. Understanding is a model in a mind that only changes when that mind predicts and reality corrects it. An agent that holds the theory on your behalf does not reduce cognitive debt; it hides it. Keep the inhabitants in the loop often enough that their hunches still fire when an unfamiliar incident wakes them at three in the morning.
Tend the place deliberately, and often. The best dwellings are not monuments designed from above; they grow to serve the people who live in them. At regular intervals the inhabitants examine not only the output but the place itself — its constraints, its observability, the rooms where thinking has outrun tooling or tooling has outrun thinking — and adjust the habitat accordingly.
The Habitat Thinking Manifesto © 2026 Russ Miles is licensed under CC BY-SA 4.0. You are free to share and adapt this work, even commercially, as long as you give appropriate credit and license your adaptations under the same terms. See LICENSE for the full text.
This is a living document, and disagreement argued in good faith is how it stays alive. See CONTRIBUTING.md for how to propose changes, and our Code of Conduct for the standards we hold the conversation to.