A field guide · October 2026

The Librarian

100 principles for organising knowledge
by Mat Siems
Part I

First Principles

What a library is for, and why it decays.

Chapter 1 · Part I

Knowledge Is Not Information

Welcome. This is a field guide to organising what you know, written for people who have a laptop full of folders called misc, a notes app with four thousand untitled entries, and a growing suspicion that the AI assistant they just hired is as lost in their files as they are. It has a hundred short chapters. Each one is meant to teach you a single thing you can do this week, ideally before the kettle has finished.

Start with a distinction that sounds pedantic and turns out to be the whole game. Information is what you store. Knowledge is what you can act on. A PDF of your pension terms is information. Knowing that you can move the money without penalty after a certain birthday, and remembering to do it, is knowledge. The first sits in a folder. The second changes what you do on a Tuesday.

Most personal and team systems are built as if the two were the same. We save, bookmark, export, screenshot and forward, and the pile grows, and because the pile grows we feel informed. Then someone asks a simple question, what did we decide about the supplier contract, and the answer is somewhere in a thread, a call recording, two documents and a colleague's head. The information exists. The knowledge, in the sense of something you can act on within a minute, does not.

A librarian is a machine for turning things that were kept into things that can be used.

That is the job this book describes, and it is older than any software you own. The librarian's work has always been conversion: taking material that arrived in whatever shape it pleased and making it findable, understandable and trustworthy at the moment someone needs it. The tools have changed from card catalogues to search boxes to language models that will cheerfully summarise your entire drive. The conversion has not become optional. If anything, a machine that can read everything makes the difference sharper, because it will act on whatever it finds, including the stale draft you meant to delete in March.

Here is the exercise for this week. Write down five things you believe you know about your own work: a process, a decision, a password policy, a client preference, the reason a particular system is configured the way it is. Then, for each, ask whether you could act on it tomorrow without asking anyone and without searching for more than a minute. Mark the ones that pass. Most people find two. The other three are information you own but cannot use, which is a polite description of clutter.

Do not panic about the ratio. It is normal, and it is the starting line rather than a verdict. The rest of the book is about moving items from the second column to the first, cheaply and repeatably, so that what you have kept becomes something you can rely on. Storage is a fact. Knowledge is a habit.

Kept versus usable FIVE THINGS YOU THINK YOU KNOW A process how we onboard A decision supplier contract A password policy rotation rules A client preference calls, not email A config reason why it is set so The one-minute test Act tomorrow? no rework needed Without asking? nobody's head Found in < 1 min? no digging Knowledge usable · ~2 of 5 Information kept · ~3 of 5 pass fail Storage is a fact. Knowledge is a habit: move items from the bottom box to the top one.
Fig 1 · Knowledge Is Not Information. Five things you think you know pass the one-minute test; usually only two do.
Chapter 2 · Part I

The DIKW Ladder

There is an old diagram that information scientists draw on whiteboards when they want to look wise. It is a pyramid with four layers: data at the bottom, then information, then knowledge, then wisdom at the narrow top. It is often mocked for being too tidy, and it is too tidy. It is also the most useful single picture of what organising actually does.

Data is raw marks. A column of numbers, a log file, a recording of a meeting, four hundred photos of a whiteboard. Information is data with a frame around it: these are last quarter's sales, by region, in pounds. Knowledge is information connected to other information and to purpose: sales in the north fell because the distributor changed, and the new one ships on Thursdays. Wisdom, if we must use the word, is knowing what to do about it, and when not to bother.

Notice what happens as you climb. Each rung has less volume than the one below and more value. A day of logs becomes one paragraph; a year of paragraphs becomes three decisions. Organising is nothing more than the discipline of climbing, and every tool you use either helps you climb or helps you pile up more data at the bottom. Cloud storage, on its own, is a very efficient way of building a larger ground floor.

The ladder also explains a familiar frustration. You save something, it feels productive, and months later it is useless. That is because saving is a ground-floor act. Nothing has been framed, connected or decided. The item has been moved from one pile to another, and the second pile happens to be yours. Real progress up the ladder always involves writing something in your own words: a title that says what the thing is, a sentence about why it matters, a link to the decision it informs.

Every rung you climb, you throw away more than you keep. That is the point.

AI tools are tempting here because they appear to climb the ladder for you. Point a model at a folder and it will summarise, and a summary looks like information or even knowledge. Sometimes it is. But the model can only frame what it has, and it does not know which questions you will ask next month. It can carry the material up a rung. It cannot decide which rung matters to you, which is the part that turns information into knowledge in the first place.

Try this on one messy folder. Sort its contents into the four rungs. Most of it will be data: drafts, exports, attachments you never opened. Some will be information. A little may be knowledge, usually a document someone wrote to explain something. Then write one paragraph at the top of the folder saying what it all adds up to. That paragraph is the most valuable file in the folder, and it took you ten minutes. The pyramid is a cliché because it is true. Climb it anyway.

The DIKW ladder Wisdom what to do act on the north Knowledge connected to purpose north fell: new distributor Information data with a frame Q3 sales by region, in £ Data raw marks logs, recordings, photos value volume Every rung you climb, you throw away more than you keep.
Fig 2 · The DIKW Ladder. Each rung up the ladder has less volume and more value than the one below.
Chapter 3 · Part I

Tacit Versus Explicit

Most of what you know is not in your files. It is in your hands, your habits and your sense of when something looks wrong. You know which client needs a phone call rather than an email. You know that the build fails on Mondays because of a timezone quirk. You know how to calm a particular stakeholder. None of this is written down, and if you left tomorrow, most of it would leave with you.

Knowledge researchers call this tacit knowledge, the kind you have but cannot easily say, and contrast it with explicit knowledge, the kind that has been put into words, diagrams or procedures. The distinction is useful because the two behave so differently. Explicit knowledge can be copied, searched, shared and handed to an AI agent. Tacit knowledge can only be demonstrated, imitated or slowly absorbed by working alongside someone.

Writing is the bridge. It is not a perfect bridge, because some skills resist words, and you will never fully describe how you know a bad estimate when you see one. But writing gets much further than people expect. The trick is to describe cases rather than principles. Be careful with the payments service is useless. Last spring we deployed on a Friday, the retry queue doubled every charge, and we spent the weekend refunding people, so we no longer deploy payments after Wednesday is knowledge someone else can use.

If it only exists in your head, it is not knowledge the team has. It is a dependency on you.

This matters more now than it did five years ago, because a growing share of the work is done by agents that have no hands, no habits and no memory of last spring. An AI assistant can only use what has been made explicit. If your team's real rules live in people's heads, the agent will follow the written rules instead, and the written rules are usually the optimistic version. The gap between what is written and what is true becomes a gap between what the agent does and what you wanted.

So here is the week's exercise, and it is uncomfortable on purpose. Pick one skill you use regularly and have never documented. Write three hundred words explaining it to a capable stranger. Use examples. Say what you check first, what you ignore, and what makes you stop. Notice where the words refuse to come. Those are the spots where your knowledge is genuinely tacit, and they are worth marking with a note that says, in effect, ask me, or watch me do it.

You will not convert everything, and you should not try. But each paragraph you write moves a piece of your judgement from a place where only you can reach it to a place where others, human or otherwise, can. Writing is slow. Forgetting is faster.

Writing is the bridge Tacit have it, cannot say it Client wants a call Monday build failures Calming a stakeholder Explicit words, diagrams, steps Copied and shared Searched Handed to an agent Writing cases, not principles Ask me / watch me where words refuse PRINCIPLE (useless) “Be careful with payments” CASE (usable) Friday deploy doubled charges: no payments after Wed If it only lives in your head, it is a dependency on you.
Fig 3 · Tacit Versus Explicit. Writing concrete cases moves tacit know-how into explicit, shareable knowledge.
Chapter 4 · Part I

Findability Beats Storage

A hoard you cannot search is not a library. It is a landfill with good intentions. This is the most important principle in the book, and it has a convenient property: it reduces every organising decision to a single question. Will future-you, or a colleague, or an agent, actually find this again?

Storage used to be the hard part. Paper took space, filing cabinets were expensive, and a library's first problem was where to put things. That problem has been solved so thoroughly that it now creates the opposite difficulty. You can keep everything, forever, at almost no marginal cost, and so everything is kept, and the cost moves silently to the moment of retrieval. Every extra item makes every future search slightly worse.

Think about what finding requires. You need to remember that the thing exists, or at least suspect it might. You need a route to it: a name you can search for, a folder you would think to open, a link from somewhere you already visit. And when you arrive, you need to recognise it as the thing, which means it must say what it is. A file named scan0034.pdf in a folder named stuff fails on all three. It is stored perfectly. It is found never.

The test of a system is not what goes in. It is what comes back out, when asked.

The findability question is useful because it cuts through arguments that otherwise go on for ever. Should you use folders or tags? Whichever you will actually use when looking. Should notes be long or short? Whichever size returns a useful answer when searched. Should you keep the fourth draft? Only if someone will ever need it and could tell it apart from the fifth. Every structural debate in this book is, underneath, a debate about findability. Notice that the question also covers machines. An AI agent searching your drive needs exactly the same three things you do, and it is less forgiving of vague names, because it cannot shrug and ask the person at the next desk.

Make this concrete. Pick something you know you saved in the last year but have not looked at since: a contract, a recipe, the slides from a talk. Time yourself finding it. If it takes more than a minute, do not just find it; fix the reason it was hard. Rename it, move it, or add a line to an index you already use. Then, the next time you save something important, ask the question before you press save, not after. Where will I look for this? Put it there, and call it that.

It feels like a small habit, and it is. Most good systems are a stack of small habits held for long enough. Keep less, find more. The landfill does not need another bag.

What finding requires Remember it exists, or might Route name · folder · link Recognise it says what it is Need a question Found < 1 minute TEST CASE stuff/scan0034.pdf ✗ forgotten ✗ no route ✗ unlabelled Before you press save, ask: Where will I look for this? Put it there, and call it that. The test of a system is what comes back out, when asked.
Fig 4 · Findability Beats Storage. Finding needs three steps: remember it exists, have a route, and recognise it.
Chapter 5 · Part I

The Cost of Organising

Organising always costs something, and the cost always lands at one of two moments. You can pay at capture, by filing carefully, naming precisely, tagging and linking. Or you can pay at retrieval, by searching, scrolling, opening things and asking around. There is no third option where the cost disappears. There is only the choice of when to pay, and how much.

People get this wrong in both directions. The tidy temperament overpays at capture: elaborate folder trees, twelve tags per note, a template for everything. Their systems are beautiful and slightly paralysing, and they quietly stop saving things because saving has become a chore. The untidy temperament overpays at retrieval: everything goes into one heap, and every search is an archaeological dig. Both are making an unexamined bet about which moment is cheaper.

The right answer depends on how often something will be retrieved and how painful a failed retrieval is. A receipt you will need once, at tax time, deserves almost no effort at capture beyond a sensible name and a single folder. A procedure your team runs every week deserves real care: a clear title, a canonical home, an owner, a date. A passing thought deserves nothing more than a line in an inbox. Match effort to expected use and you will spend far less time overall than either the hoarder or the perfectionist.

Filing is a loan from the present to the future. Do not lend to people who will never collect.

Search has shifted the balance, and AI has shifted it further. When full-text search arrived, the value of elaborate folder structures fell, because you could find a document by its contents. Now that a model can read a pile of documents and answer a question across them, the value of capture-time effort has shifted again. It has not vanished. It has moved. The things worth doing at capture are the things search cannot reconstruct: what this is, where it came from, whether it is current, and what it is for. A machine can find the word invoice. It cannot know that this invoice was disputed and superseded unless somebody wrote that down.

This week, look at the last ten things you saved and estimate, honestly, how often each will be retrieved. Then look at how much effort you spent on each at capture. You will almost certainly find a mismatch: careful filing of things you will never need, careless dumping of things you will need often. Adjust the next ten. Spend thirty seconds more on the frequent ones and thirty seconds less on the rare ones.

There is no virtue in organising for its own sake. Tidiness is pleasant, but it is not the goal. The goal is the lowest total cost of having knowledge available when needed. Pay where it is cheapest, and pay once.

Pay where it is cheapest effort matches use OVERPAY AT CAPTURE OVERPAY AT RETRIEVAL Perfectionist 12 tags, unused note Hoarder weekly doc in a heap Tax receipt name + one folder Weekly procedure title · home · owner Passing thought one inbox line How often it will be retrieved → rare often Effort at capture → Filing is a loan from the present to the future.
Fig 5 · The Cost of Organising. Capture effort should rise with how often an item will actually be retrieved.
Chapter 6 · Part I

Everything Is a Collection

Books on a shelf, files on a drive, contacts in a phone, tabs in a browser, recipes in a drawer, memories in your head and messages in a team channel. They look like different problems. They are the same problem wearing different coats. Every collection, whatever it holds, faces four questions, and most organising trouble comes from answering only one of them.

The first is selection: what is in it? A collection is defined as much by what it excludes as what it includes. A browser with ninety open tabs has no selection policy; it has accumulated rather than collected. The second is arrangement: how is it ordered? Alphabetical, chronological, by subject, by project, by frequency of use. Some order is always present, even if it is only the order things happened to arrive. The third is access: who can reach it, and how? A shared drive with the wrong permissions is a private collection in disguise, and a private notebook nobody can read after you leave is a collection with a single, mortal user. The fourth is departure: when do things leave? This is the question almost nobody answers, which is why almost every collection grows until it is unusable.

Thinking in these four terms is clarifying because it lets you diagnose problems quickly. A team wiki that nobody trusts usually has an arrangement problem and a departure problem: pages are hard to find and old pages are never removed. A photo library that overwhelms you has a selection problem: you kept every burst shot. A downloads folder is all four problems at once, which is why it is the most frightening folder on most computers.

A pile becomes a collection the moment someone decides what does not belong in it.

The framing also helps when you hand a collection to a machine. If you ask an AI agent to work with your project documents, it will face exactly these questions. What is in scope? How is it ordered? Can it reach it? Which of these are obsolete? An agent with no answers will treat a three-year-old draft as equal to yesterday's decision. You will have to answer the questions eventually; it is cheaper to answer them before the agent does something confident with the wrong file.

Pick one collection this week, preferably a small, annoying one. Your downloads folder is ideal. Write down, in one line each, your answer to the four questions. What belongs here? How should it be ordered? Who needs to reach it? When should things leave? Then act on the fourth answer, because that is the one you have been avoiding. Delete or move anything older than a month.

You will notice something pleasant. Once you have answered the four questions for one collection, the answers transfer. Your inbox, your notes and your team's shared drive have the same shape. Learn the shape once. Recognise it everywhere.

Four questions every collection faces Selection what is in? Arrangement what order? Access who can? Departure when out? Team wiki nobody trusts it Photo library every burst shot Browser tabs ninety open Private notebook one mortal user Downloads the scary one ● = unanswered question, the source of the trouble A pile becomes a collection once someone decides what does not belong.
Fig 6 · Everything Is a Collection. Diagnose any collection by which of its four questions has gone unanswered.
Chapter 7 · Part I

The Librarian's Oath

Librarianship has no formal oath, but if it had one it would contain three verbs: preserve, describe, provide access. Those three duties predate computers by a couple of thousand years. They described the work in ancient libraries, in monastery scriptoria, in Victorian reading rooms and in today's research collections. They survive every technology shift because they are about people, not tools.

Preserve means keeping things intact and available over time. It is not the same as hoarding. A preserved item is protected from loss, corruption and silent change. For your purposes, that means backups, version history and a refusal to keep the only copy of anything important on one laptop. It also means preserving context, because a document without its surrounding explanation is only partly preserved, like a letter without the envelope that tells you who sent it. Describe means saying what a thing is, so that someone who has never seen it can decide whether it is what they need. Titles, summaries, dates, authors, subjects and status are all description. Description is what allows finding without opening, and it is the duty most personal systems neglect, because describing feels like admin and saving feels like progress. Every chapter in Part Three of this book is a chapter about description.

Provide access means getting the right thing to the right person at the right time, and no further. Access has two edges. Too little, and knowledge is trapped: the only person who knows how the deployment works is on holiday. Too much, and knowledge leaks: the salary spreadsheet is shared with the whole company because someone clicked the wrong button. A good librarian is generous and careful at once.

Preserve, describe, provide access. If a tool does not help with one of the three, it is decoration.

The oath is a useful filter for the endless supply of new tools. Every few months a product arrives promising to transform your knowledge, and some of them genuinely help. Ask which of the three duties it serves. A sync tool preserves. A tagging assistant describes. A search layer provides access. An AI that answers questions across your documents provides access in a remarkable new way, but only if the description underneath is decent and the preservation is trustworthy. A tool that serves none of the three is a hobby, which is fine, provided you know that is what it is.

Try a small audit. Take your most important collection, the one you would most hate to lose, and score it on each duty out of five. Is it preserved: backed up, versioned, with more than one copy? Is it described: could a stranger tell what each item is without opening it? Is it accessible: can the people who need it reach it, and only them? The lowest score is this month's project.

Libraries outlived scrolls, codices, printing presses and microfilm. The duties came through untouched. They will survive the current wave too. Tools change. The oath does not.

Preserve, describe, provide access A collection you can rely on the payoff Preserve intact over time Backups Version history Keep context Sync tool Describe say what it is Title, summary Date, author Status Tagging assistant Provide access right person, no further Too little: trapped Too much: leaks Generous + careful Search layer AI Q&A across documents: needs all three underneath If a tool helps with none of the three, it is decoration.
Fig 7 · The Librarian's Oath. Preserve, describe and provide access hold up a collection, and each has its tools.
Chapter 8 · Part I

Entropy Is the Default

No system stays organised on its own. This is not a moral failing; it is physics, or at least the office equivalent. Every hurried save, every file named new document, every tag invented on the spot because the right one did not come to mind, nudges the collection towards disorder. Nobody ever decides to make a mess. The mess arrives one reasonable shortcut at a time.

People respond to this in a predictable way. They let the mess grow until it becomes unbearable, then declare a great reorganisation. A weekend is lost to new folder structures, colour-coded tags and a fresh notes app. For a few weeks everything is lovely. Then the shortcuts resume, and within months the new system has decayed to roughly the state of the old one, except that it now contains two incompatible structures layered on top of each other.

The lesson is that the initial design matters much less than the maintenance loop. A modest system maintained weekly will beat a brilliant system maintained never. This is true of gardens, codebases and teeth, and it is true of knowledge. The question to ask of any organising scheme is not how elegant it is on day one. It is how much effort it takes to keep it elegant on day three hundred, and whether you will actually spend that effort.

Design is a single event. Maintenance is a habit. Only one of them is still there next year.

A good maintenance loop has three properties. It is small, so that skipping it feels silly rather than reasonable. It is scheduled, so it does not depend on your noticing the mess. And it is specific, with a short list of things to do rather than a general intention to tidy. Something like: empty the inbox, rename anything called untitled, merge any duplicate tags, archive anything finished. Fifteen minutes on a Friday afternoon. Part Seven returns to this ritual in more detail, because it turns out to be the habit that separates people with a knowledge system from people with a folder.

Machines help with entropy and also accelerate it. An AI agent can do much of the weekly tidy for you: suggest names for untitled files, spot duplicates, flag stale pages. It can also generate a startling volume of new material, from meeting summaries to drafts to research notes, each of which arrives with no particular home. Agents are a faster shovel. Whether the shovel moves the pile or builds a bigger one depends on the loop you put around it.

This week, do not reorganise anything. Instead, write down a fifteen-minute maintenance routine with no more than five steps, put it in your calendar as a recurring appointment, and do it once. Next week, do it again. Resist the urge to redesign. Most systems do not fail because they were badly designed. They fail because nobody swept up.

Design is an event, maintenance a habit mess time → great reorg great reorg weekly 15-min loop Friday loop small, scheduled, specific Empty the inbox Rename untitled Merge dup tags Archive finished Agents: a faster shovel move the pile or grow it? The loop decides which put agents inside the loop Most systems fail because nobody swept up.
Fig 8 · Entropy Is the Default. Big reorganisations decay back to mess; a small weekly loop keeps it low.
Chapter 9 · Part I

Organise for the Question

The most common mistake in organising is to sort things by what they are rather than by how they will be asked for. People arrange their files the way a museum arranges exhibits: by type, by origin, by some property of the object. Then they need something, and the question they ask has nothing to do with any of those properties. The shelf is beautiful and answers nothing.

Consider a freelancer who files everything by document type: contracts in one folder, invoices in another, briefs in a third, correspondence in a fourth. It looks orderly. But the question they actually ask, over and over, is what is going on with this client? Answering it requires opening four folders and mentally reassembling the story. A structure built around the question, one folder per client with everything inside, answers it in one click. The objects are the same. The questions decide the shelf.

This principle scales up to teams and down to single notes. A team wiki organised by department reflects the org chart, which is the structure people inside the company already know and therefore the one they least need help with. A wiki organised around the questions newcomers ask, how do I get access, who approves spending, how do we ship, is far more useful, even though it cuts across departments untidily. A single note can be organised the same way: lead with the answer to the question someone will bring to it, then the supporting detail.

Shelves are answers to questions. Make sure they are the questions someone actually asks.

How do you find out which questions matter? Listen to them. For a fortnight, keep a running list of every question you or your team asks that requires looking something up. Not the answers, just the questions. Where is the brand logo? What did we agree on pricing for the renewal? How do I reset the staging database? After two weeks you will have a list of perhaps thirty questions, and you will notice that about a third of them come up repeatedly. Those repeated questions are your real taxonomy. Design the shelves, folder names, index pages and templates around them.

The same thinking applies when you prepare material for an AI agent. Agents arrive with questions too: where is the code for this feature, what are the conventions, what must I never touch. A project whose structure answers those questions directly, with a clear index and plainly named sections, will be navigated well. A project organised around its own internal history will be navigated by guesswork, and guesswork from an agent is fast, confident and expensive.

Do not try to anticipate every possible question. That way lies a taxonomy committee. Organise around the dozen questions that come up most, accept that rare questions will need search, and revisit the list every few months. Objects are what you have. Questions are why you have them.

Shelve by the question asked BEFORE: BY DOCUMENT TYPE AFTER: BY CLIENT Contracts /contracts Invoices /invoices Briefs /briefs Correspondence /letters Reassemble the story 4 folders opened Client: Acme /acme contract invoices brief emails Client B Client C 1 click The recurring question: “What is going on with this client?” The objects are the same. The questions decide the shelf.
Fig 9 · Organise for the Question. Filing by document type scatters each client; filing by client answers in one click.
Chapter 10 · Part I

A Library Is an Argument

Every way of arranging knowledge is a claim about what matters. Put two things on the same shelf and you are saying they belong together. Put one at eye level and another in the basement and you are saying one is more important. There is no neutral shelf. Choosing an order is choosing a worldview, and the only question is whether you choose it deliberately or inherit it from whoever set up the folder before you.

Librarians learned this the hard way, and Part Two tells some of those stories. The great classification schemes of the nineteenth century reflected the assumptions of the people who designed them: which religions got whole sections and which got a single number, which countries were subdivided in detail and which were lumped together, which subjects were considered serious. None of this was malicious, exactly. It was simply the view from where the designers stood, frozen into a structure that outlived them by a century.

Your own systems make arguments too, smaller but no less real. A project folder with subfolders called Strategy and Admin has decided which work is strategic. A team wiki whose home page lists engineering docs first has decided whose knowledge is central. A tagging scheme with forty tags for technical topics and one for people has an opinion about what kind of knowledge counts. Newcomers read these arguments instantly, even if nobody ever stated them.

The structure tells everyone what you think matters, whether or not you meant to say it.

This is not a call for paralysis. You have to pick some order, and a reasonable one held consistently is far better than an endless debate about the perfect one. It is a call for awareness. When you design a structure, ask what it makes easy to see and what it makes easy to miss. Ask who would arrange it differently and why. Occasionally, the answer will reveal a blind spot worth fixing: the customer support knowledge that has no home because the wiki was designed by engineers, or the decisions that are never recorded because there is no shelf called decisions.

AI models make this sharper rather than softer. When an agent searches your documents, it inherits your arrangement. If your structure buries a category of knowledge, the agent will under-weight it. If your structure gives pride of place to old material, the agent will treat it as current. You are not just organising for human readers any more. You are writing the briefing that machines will act on.

This week, look at the top level of your main knowledge collection, whether a drive, a wiki or a notes app, and write one sentence describing the argument it makes. This collection believes that the most important thing is... If the sentence surprises you, that is useful. If it embarrasses you, that is more useful. Every shelf is an opinion. Make sure it is yours.

Every shelf is an opinion Team knowledge top level Engineering listed first Strategy “the real work” Admin “the rest” Support no home yet 40 tech tags 1 tag: people Decisions This collection believes the most important thing is … write the sentence; dashed boxes are the blind spots it reveals The structure says what you think matters, meant or not.
Fig 10 · A Library Is an Argument. A folder tree makes claims about what matters, and reveals shelves that are missing.
Part II

Classification

Lessons from two centuries of real librarians.

Chapter 11 · Part II

Dewey and His Ghosts

In 1876 a young American librarian named Melvil Dewey published a scheme that pressed the whole of human knowledge into ten numbered classes. Philosophy in the hundreds, religion in the two hundreds, social sciences in the three hundreds, and so on, each class divided into ten divisions and each division into ten sections, with decimals allowing infinite subdivision beyond. It was brilliant. It is still used in a great many libraries around the world. And it is the best possible introduction to why every taxonomy you build will one day embarrass you.

The brilliance is worth appreciating first. Before schemes like Dewey's, many libraries shelved books by fixed location: this book lives on shelf four, position twelve, for ever. Add a new book on the same subject and it went wherever there was space. Dewey's insight was relative location. A book's number describes its subject, not its position, so new books on the same subject can always be inserted beside their neighbours. The shelves can grow without the order breaking. That idea, that an address should describe content rather than position, underlies every good filing scheme since.

The embarrassment comes from the ten classes themselves. They encoded the worldview of an educated American in the 1870s. The religion class, for instance, gave most of its numbers to Christianity and squeezed the rest of the world's faiths into a small remainder. Subjects that barely existed in 1876 had to be wedged into whatever gap was available. The scheme has been revised many times, and its editors have worked hard to correct these imbalances, but the original shape still shows through, like a ghost in the wallpaper.

Every taxonomy is a photograph of its author's era. It starts fading the day it is printed.

You will build your own Dewey, whether you mean to or not. The folder structure you set up when you started a job reflects what seemed important in your first month. The tags you chose for your notes reflect the interests you had when you began. Five years later, the categories that mattered have shrunk, new subjects have no natural home, and you are wedging things into gaps just as Dewey's successors did.

The response is not to avoid structure. It is to build structure that expects to be revised. Keep top-level categories few and broad, so that new subjects can find room beneath them. Prefer descriptive addresses to positional ones: a file named for its content can move between folders without losing its meaning. And schedule a review, perhaps yearly, where you ask which categories have grown too crowded and which are now ghost towns.

This week, look at your oldest surviving folder structure and find one category that no longer fits how you think. Do not rebuild the whole tree. Rename or split that one category, and note the date you did it. Dewey's scheme survived a century and a half by being revised constantly. Yours can survive a few years the same way. No scheme is timeless. The good ones are merely well maintained.

Relative location, and its ghosts BEFORE DEWEY Fixed location shelf 4, position 12, for ever 1876 Relative location the number describes the subject TEN CLASSES, EACH SPLIT INTO TEN 000 100 200 300 400 500 600 700 800 900 200 religion: mostly one faith the 1870s view, frozen in 1876 scheme published revisions editors rebalance new subjects wedged into gaps today ghost still shows Your Dewey: few broad classes · descriptive names · a yearly review Every taxonomy is a photograph of its author's era.
Fig 11 · Dewey and His Ghosts. Dewey swapped fixed shelf spots for subject numbers, but froze an 1870s worldview.
Chapter 12 · Part II

Faceted Classification

In the 1930s an Indian mathematician turned librarian, S. R. Ranganathan, looked at the great tree-shaped classification schemes and saw a structural flaw. They forced every item down a single branch. A book about the history of cotton weaving in nineteenth-century Lancashire had to be filed under history, or textiles, or economics, or geography, and whichever branch you chose, the other perspectives were lost. His answer was faceted classification, and it is one of the most useful ideas a modern knowledge worker can borrow.

The idea is simple. Instead of placing an item at one point in a tree, describe it along several independent axes, called facets. Ranganathan proposed a set of fundamental ones, roughly: the main subject, the material or kind, the activity or process, the place, and the time. Our cotton book becomes textiles, weaving, Lancashire, nineteenth century. Each facet is a separate, short list of values. Combine them and you can describe a vast number of items precisely without building an enormous tree.

You already use faceted systems constantly, even if nobody called them that. Every online shop that lets you filter shoes by size, colour, brand and price is running faceted classification. A spreadsheet with columns for client, project, type and date is faceted. The power comes from independence: you can slice the collection along any facet, or any combination, without having decided in advance which slice matters most.

A tree asks where a thing lives. Facets ask what a thing is, several times over.

For personal and team knowledge, facets are the cure for the agonising question of which folder something belongs in. The answer is that it does not have to belong to only one. Give your notes or documents a small number of facets, recorded as fields in frontmatter, document properties or a database column, and let the folder structure handle only one of them. A common pattern is to use folders for the facet that changes least, usually project or area, and fields for the others: type, status, date, audience.

Facets also suit AI tools unusually well. A model asked to find all decisions about pricing from last quarter has a much easier time if documents carry a type: decision field, a topic: pricing field and a date, than if it must infer all three from prose. Structured facets turn fuzzy semantic search into a precise filter followed by a fuzzy search, which is both faster and more trustworthy.

The temptation, once you discover facets, is to invent twenty of them. Resist. Each facet is a question someone must answer every time they save. Choose three or four that correspond to questions you genuinely ask, and keep the value lists short and controlled. Ranganathan's schemes became famously complex. The principle underneath them is gloriously simple. Describe things along the axes people search by, and stop pretending each thing has only one home.

Describe along several axes Cotton weaving book one item Subject textiles Process weaving Place Lancashire Time 19th century Kind book In your notes one facet is the folder folder: project type: decision status: active date: 2026-10-07 audience: team Filter, then search type=decision topic=pricing + fuzzy text A tree asks where a thing lives; facets ask what it is.
Fig 12 · Faceted Classification. One item described on five independent facets, with only one facet used as a folder.
Chapter 13 · Part II

Tree Versus Graph

A tree gives every item exactly one location. A graph lets an item live in many contexts at once, connected to whatever it relates to. Folders are trees. Links, tags and backlinks are graphs. Most real knowledge is graph-shaped, and most of us store it in trees, which is why so much of it gets quietly mangled.

Consider a single meeting note about choosing a new payments provider. It belongs to the payments project. It also concerns a specific supplier, involves the finance team, informs a decision about budget, references a security review and will matter again when the contract renews. In a folder tree, it lives in one of those places, probably the project folder, and the other five connections are lost unless someone remembers them. In a graph, it can link to all six, and each of those can link back.

Trees have real virtues, which is why they persist. They are easy to understand at a glance. They give you a mental map: you know roughly where things are because you can picture the branches. They make browsing possible, and they make permissions simple, since access can follow the branches. A pure graph, by contrast, can become a hairball where everything connects to everything and nothing has an obvious starting point.

Trees are for finding your way. Graphs are for finding the connections. You need both.

The practical answer, which Part Four develops, is a shallow tree with a rich graph laid over it. Use a small number of folders to give every item a home and a rough address, then use links and tags to express all the other relationships. The folder answers where does this live? The links answer what else does this touch? Neither has to carry the whole load.

AI agents navigate graphs surprisingly well, provided the links are explicit. When a model reads a note that links to three related notes by stable names or IDs, it can follow those links and assemble context much as a person would. When the relationships exist only implicitly, in the fact that two files happen to sit in adjacent folders, the agent has to guess. Explicit links are a gift to every future reader, human or otherwise.

Here is the habit to build this week. Whenever you write or update a note, add at least one link to something related that lives somewhere else in the tree. A decision note links to the project it affects and the person who made it. A meeting note links to the decision it produced. It takes a few seconds and it compounds. After a few months you will have a graph laid over your tree, and you will start finding things through their neighbours rather than through their address. A file has one location. An idea has many relatives.

One location, many relatives TREE: ONE HOME Projects Payments Website Meeting note provider choice 5 other connections lost GRAPH: MANY CONTEXTS Meeting note provider choice Payments Supplier Finance team Budget call Security Renewal Best of both: a shallow tree for the home, links for every relative Trees are for finding your way; graphs for finding connections.
Fig 13 · Tree Versus Graph. A tree gives a meeting note one home; a graph links it to all six of its contexts.
Chapter 14 · Part II

Controlled Vocabulary

If you tag one document invoice, another bill and a third receipt, you have not created three helpful labels. You have created three broken searches, each of which returns about a third of what you wanted. This is the synonym problem, and librarians solved it more than a century ago with a deceptively dull tool called controlled vocabulary.

A controlled vocabulary is simply a fixed list of approved terms. For each concept, one term is preferred and the others are recorded as pointers to it. Bill and receipt are listed, but marked use invoice. When a cataloguer describes a document, they must choose from the approved list. When a reader searches, they find everything under the single preferred term. Large libraries maintain vast vocabularies of subject headings for exactly this purpose, and the principle is the same at any scale.

The alternative, letting everyone tag freely, has a name too: folksonomy. Free tagging is lovely at capture, because you never have to stop and consult a list. It is miserable at retrieval, because the same idea ends up scattered across spellings, plurals, abbreviations and moods. One person writes ML, another machine-learning, a third AI, and a fourth, on a bad day, robots. Search becomes guesswork about what other people might have typed.

One concept, one term. Everything else is a pointer.

You do not need a committee to adopt this. A personal or team controlled vocabulary can be a single page listing the tags in use, each with a one-line definition and any synonyms that should map to it. Keep it short: thirty to fifty terms is plenty for most teams. Put it somewhere obvious and link to it from wherever people tag things. When someone proposes a new term, the question is whether an existing term already covers it. Usually one does.

This matters doubly for AI. A language model is good at understanding that bill and invoice are related, which tempts people to think vocabulary no longer matters. But models are also very good at being consistently inconsistent: ask one to tag a thousand documents without a list and it will invent a plausible, sprawling taxonomy of its own. Give it your controlled vocabulary in its instructions, and it becomes the most disciplined cataloguer you have ever employed. It will use the approved terms tirelessly, which is more than can be said for most humans.

This week, export or list every tag you currently use in your main notes or documents system. Sort them alphabetically and look for clusters of synonyms. Choose a preferred term for each cluster, merge the others into it, and write the result on a single page. The first pass will take an hour and will feel like housekeeping. It is. Every future search will be better for it. Vocabulary is the cheapest infrastructure you will ever build.

One concept, one term FREE TAGS (FOLKSONOMY) bill receipt invoices Invoice use → invoice preferred term SAME IDEA, FOUR TAGS ML machine-learning AI robots search finds a quarter of it Vocabulary page 30–50 terms, one page invoice requests payment use for: bill, receipt meeting scheduled talk use for: mtg, call decision a choice made use for: agreed, ruling pricing what we charge use for: rates, fees Give an AI the list and it becomes your most disciplined cataloguer.
Fig 14 · Controlled Vocabulary. Synonym tags all point to one preferred term listed on a single vocabulary page.
Chapter 15 · Part II

The Granularity Problem

How big should a unit of knowledge be? A whole report, a section, a paragraph, a single claim? This sounds like a technicality and is actually one of the decisions that most determines whether your system works. Get it wrong in one direction and nothing is reusable. Get it wrong in the other and everything is fragmented. Librarians call this granularity, and the right answer is surprisingly consistent across very different tools.

Too coarse looks like this. Every project has one giant document containing the brief, the research, the decisions, the meeting notes and the final deliverable. It is easy to save into, since there is only one place to put things. But when you want to reuse a single decision or reference one piece of research in another project, you have to send someone a forty-page file and say it is in there somewhere. The knowledge exists, but it cannot be addressed.

Too fine looks like the opposite. Every thought is its own note, every note is three lines long, and understanding anything requires opening fifteen of them and assembling the meaning yourself. The system is wonderfully modular and almost impossible to read. Each fragment makes sense only in the context of others, which you no longer have.

The right unit is the smallest chunk that still makes complete sense standing alone.

That test, standing alone, is the useful one. A unit should answer a question without requiring the reader to have read something else first. A decision record that states the decision, the reasons, the alternatives considered and the date passes. A note that says agreed with the above fails. A meeting summary that lists actions with owners passes. A single bullet copied from that summary, without its context, usually fails.

This principle has become newly important because of how AI retrieval works. Systems that answer questions over your documents typically split them into pieces and retrieve the pieces that seem relevant. If your documents are written as standalone units, each retrieved piece carries its own meaning. If they are written as long, flowing narratives where meaning depends on earlier pages, the retrieved fragments will be confidently incomplete. Writing in self-contained units is, quite literally, writing for retrieval.

Try this with one long document you own, perhaps a project brief or a team handbook. Read through it and mark the natural units: places where a reader could stop and still have a complete answer to a question. Give each unit a clear heading that says what it answers. You may find some units need a sentence of context added at the start; add it. You may find some sections are only meaningful together; merge them. The document will not get shorter. It will get addressable, which is better. Size is not the point. Standing alone is.

The smallest chunk that stands alone coarse fine Too coarse one 40-page project doc “it is in there somewhere” Too fine three-line fragments open fifteen to understand Right grain answers one question needs nothing else first PASSES THE STANDALONE TEST Decision record Summary with owners FAILS “Agreed with the above” A bullet, no context AI retrieval splits docs into pieces standalone = complete narrative = partial Size is not the point. Standing alone is.
Fig 15 · The Granularity Problem. The right unit sits between one huge doc and fragments: it answers alone.
Chapter 16 · Part II

Genus and Difference

More than two thousand years ago, Aristotle described a method for defining things that remains the most useful definition machine ever invented. Name the general class the thing belongs to, its genus, then name what distinguishes it from the other members of that class, its difference. A human is an animal (genus) that reasons (difference). An invoice is a document (genus) that requests payment for goods or services already supplied (difference). Two parts, and you have said both what a thing is and what it is not.

The method is ancient, but it solves a very modern problem. Most confusion in shared knowledge comes from terms that nobody ever defined. Teams argue for weeks about whether something is a project or an initiative, whether a customer is active, whether a document is a spec or a proposal, and the argument persists because the words carry different meanings in different heads. Genus and difference forces a decision. A project is a piece of work with a defined end date. An initiative is a piece of work without one. Agree, write it down, move on.

The difference is the part people skip, and it is the part that does the work. Saying that a policy is a document about how we do things is a genus with no difference; it describes every document in the company. The useful definition says what distinguishes a policy from a guideline, a procedure or a suggestion: perhaps that it is mandatory, owned by a named person, and reviewed annually. Now you can tell, for any given page, whether it is a policy or not.

If a definition does not exclude anything, it is not a definition. It is a mood.

Defined terms are the foundation of a controlled vocabulary, a sensible folder structure and any metadata scheme worth the name. They also make an enormous difference to AI agents. A model given a glossary that says a customer is active if they have logged in during the last thirty days will apply that definition consistently across a thousand records. A model given only the word active will apply its own sense of the word, which will be reasonable, plausible and not quite yours.

This week, start a glossary for your team or your own work, if you do not have one. Choose the five terms that cause the most confusion. For each, write a single sentence in the form a [term] is a [genus] that [difference]. Then test each definition against two or three real examples, including at least one borderline case. If the borderline case is ambiguous under your definition, sharpen the difference until it is not.

Keep the glossary short and keep it somewhere everyone, and every agent, will see it. A good glossary of twenty terms will prevent more arguments than any number of meetings about alignment. Aristotle did not have a wiki. He would have been unbearable with one.

A [term] is a [genus] that [difference] Term the word = Genus the general class + Difference what it excludes Invoice document requests payment for supply Project piece of work has a defined end date Initiative piece of work has no end date Active customer customer logged in, last 30 days Policy document mandatory, owned, yearly review Policy document “about how we do things” Without a difference it is not a definition. It is a mood.
Fig 16 · Genus and Difference. A definition names a genus and the difference that excludes everything else.
Chapter 17 · Part II

Emergent Versus Imposed

There are two ways to arrive at a taxonomy. You can design it first, deciding on categories before anything is filed, and then make everything fit. Or you can let it emerge, filing freely and noticing which groupings form, then naming them once they exist. Both work. Both fail. Knowing when to use each is most of the skill.

Imposed taxonomies have one great advantage: they onboard newcomers fast. When someone joins a team with a well-designed structure, they can learn it from a single page and start filing correctly on their first day. Imposed structures are predictable, which makes them good for shared spaces, for compliance, and for anything where many people must agree on where things go. Their weakness is that they are designed in advance, by people who did not yet know what would be collected. They fit the plan, not the reality.

Emergent taxonomies fit reality almost by definition, because they are built from it. The categories reflect what was actually collected and how people actually think about it. Many personal knowledge systems work this way: notes accumulate, links form, clusters appear, and eventually you notice that you have twenty notes about pricing and give them a hub. The weakness is that emergence is slow, idiosyncratic and hard to explain. An emergent structure often makes perfect sense to the person who grew it and almost none to anyone else.

Impose structure where many people must agree. Let it emerge where one person must think.

The good practice is a hybrid, applied at different layers. Impose the top layer, the handful of broad categories that everyone needs to agree on, because predictability matters most there. Let the lower layers emerge, because that is where real content lives and where rigid categories cause the most friction. Then, periodically, harvest the emergent structure: when a cluster of notes or a recurring tag becomes clearly important, promote it into the imposed layer with a proper name and definition.

AI tools have made emergence much cheaper. You can ask a model to read a few hundred documents and propose the groupings it sees, which is a fast way to discover the taxonomy hiding in your collection. Treat its proposal as a first draft, not a verdict. Models are good at spotting clusters and less good at knowing which clusters matter to your work. Part Ten returns to this idea at a larger scale.

This week, look at one area where you have been struggling to decide on categories in advance. Stop trying. File things with minimal structure for a month, perhaps only a date and a rough tag. Then sit down, review what accumulated, and name the categories that actually formed. You will probably find two or three you would never have predicted, and one or two of your planned categories that nothing ever went into. Reality has opinions. Let it vote.

Impose the top, let the bottom emerge Imposed layer few broad categories everyone agrees on Emergent layer clusters, hubs, recurring tags Raw filing date + a rough tag, for a month harvest promote spot clusters IMPOSED: fast onboarding, predictable, fits the plan EMERGENT: fits reality, slow, makes sense to one person Reality has opinions. Let it vote.
Fig 17 · Emergent Versus Imposed. Impose the top layer, let lower layers emerge, then promote clusters upward.
Chapter 18 · Part II

Polyhierarchy Is Honest

Is a tomato a fruit or a vegetable? Botanically, a fruit. In the kitchen, a vegetable. Any classification system that forces you to pick one will be lying to half its users every day. The honest answer is that the tomato has two legitimate parents, and a system that allows this, called polyhierarchy, is telling the truth about the world.

Polyhierarchy simply means that a concept can sit beneath more than one broader concept at the same time. A course on data visualisation belongs under design and under statistics. A document about hiring engineers belongs under recruitment and under engineering. A client might be both a customer and a supplier. Strict trees forbid this, which forces filers to make arbitrary choices that searchers then have to guess.

Folders are strict trees, which is the root of a familiar frustration. You save a file into one folder, and six months later you look for it in the other one, because the other one is where you would naturally look today. You were not wrong either time. The thing genuinely belonged in both places, and the system made you choose. Many people respond by making copies, one in each folder, and this creates a worse problem, which Part Eight discusses under the heading of duplicates.

When a system forces one parent, it forces a guess. Guesses become lost files.

There are better ways to express multiple parents. Tags are the simplest: one item, several tags, each acting as a parent. Links work too: a note can link up to several broader topics. Some tools allow aliases or shortcuts, where the item lives in one folder but appears in another without being copied. Databases and spreadsheets handle it naturally with multi-value fields. The key principle is one item, one canonical copy, many routes to it.

Polyhierarchy is also how modern AI models naturally think. A model's sense of a concept is not a single location in a tree but a position among many related ideas, closer to some and further from others. When you describe your knowledge with multiple parents, you are working with the grain of how these tools represent meaning. When you force it into a single tree, you are throwing away information the model would happily have used. The caution is that unlimited parents become no parents at all. If everything is tagged with twelve broad categories, the categories stop discriminating. A sensible rule is that most items need one primary home, expressed by a folder or a main topic, and up to two or three secondary parents expressed by tags or links. That captures the honest ambiguity of most knowledge without dissolving the structure.

This week, find one item you have filed in the wrong place at least once, the one you always look for in the other folder. Leave it where it is, and add a link, shortcut or tag that puts it in the second place too. Then notice how often you use that second route. The tomato never cared what you called it. Your search should not either.

One item, many parents, one copy Fruit botany Vegetable kitchen Tomato one canonical copy Design field Statistics field Data viz course primary: design SOLID = PRIMARY HOME (FOLDER) DASHED = TAG, LINK OR SHORTCUT Copies in two folders two versions drift apart see Part Eight: duplicates Rule of thumb 1 primary home + 2 or 3 secondary parents When a system forces one parent, it forces a guess.
Fig 18 · Polyhierarchy Is Honest. Items can have several parents: one folder as home, extra parents as tags or links.
Chapter 19 · Part II

The Miscellaneous Shelf

Every classification scheme needs a bin for the things that do not fit. Libraries have them; filing cabinets have them; your drive certainly has one, called misc, other, stuff or, for the more literary, odds and ends. There is nothing wrong with the miscellaneous shelf. It is a pressure valve that lets people save things without stopping to invent a category. But it is also the single best diagnostic instrument in your entire system, and almost nobody reads it.

The rule of thumb is simple. Watch the size of miscellaneous relative to the whole collection. A small miscellaneous shelf is healthy: a few genuinely odd items that do not justify a category of their own. When the bin grows past roughly a tenth of the collection, something is wrong, and the something is almost never the items. It is the categories. A large miscellaneous section means your scheme no longer describes what you actually collect.

The bin tells you how it is wrong if you look inside. Usually you will find clusters: a dozen documents about a subject you did not have when you designed the structure, or a recurring type of item, such as contracts or receipts, that was never given a home. Each cluster is a category waiting to be born. Sometimes you will find items that belong in existing categories but were dumped in miscellaneous because the right category was hard to find or named confusingly. That is a naming problem, and Part Three deals with it.

The miscellaneous shelf is where your taxonomy confesses its mistakes.

Tags have their own version of this. The tag called todo, interesting or read-later that collects hundreds of items is a miscellaneous shelf in disguise. So is the untagged pile in a notes app. So, in a team, is the channel called general. Wherever things accumulate without description, you have a bin, and wherever a bin grows, there is a structural lesson waiting.

AI agents produce their own miscellaneous problem. When you ask an assistant to file, summarise or tag a large batch of material, it will often create catch-all categories for things it cannot confidently place. Do not let these grow silently. Ask the agent, explicitly, to report what it put in the catch-all and why, and to propose new categories for any cluster of more than a handful of items. You will learn more from that report than from the tidy categories it filled.

This week, open your largest miscellaneous folder, tag or channel and spend twenty minutes with it. Count roughly how many items it contains compared with the collection as a whole. Look for clusters of three or more similar items and either create a home for them or move them to an existing one. Then delete anything that is genuinely rubbish. The bin will never be empty, and it should not be. It just needs reading.

Read the miscellaneous shelf SHARE OF THE COLLECTION Projects Clients Reference Misc healthy misc ends here (~10%) misc now ~23% OPEN IT UP Cluster: contracts 12 items new category Cluster: receipts 9 items new category Belongs elsewhere misfiled rename the shelf Genuinely odd a few leave in misc Rubbish dupes, junk delete Bins in disguise #read-later #interesting untagged pile #general agent catch-all Misc is where your taxonomy confesses its mistakes.
Fig 19 · The Miscellaneous Shelf. When misc passes about a tenth of the collection, its clusters become new categories.
Chapter 20 · Part II

Classification Is Power

Whoever decides the categories decides what is visible. This is the uncomfortable lesson at the end of every history of librarianship. Things that are not named cannot be searched for. Things filed under a dismissive heading are found only by people who already think dismissively. Things buried in a subcategory of a subcategory are effectively hidden from anyone browsing the top. Classification looks like neutral administration. It is a form of authority.

Librarians have argued about this openly for decades. Subject headings in major library catalogues have periodically been challenged for using outdated, offensive or simply partial terms for groups of people, and some headings have been revised after long campaigns by working librarians who noticed that the words were making certain books harder to find or framing them unfairly. The details of each case vary. The common thread is that a label chosen by a small group shaped what a very large group could find, and how they first encountered it.

In your own organisation, the same dynamic plays out on a smaller stage. Whoever sets up the shared drive decides which teams get top-level folders. Whoever designs the wiki decides whether customer support knowledge is a section of its own or a page under operations. Whoever writes the ticket categories decides which problems get counted and which disappear into other. These decisions are rarely discussed, because they look technical. They quietly decide whose work is legible.

What has no name has no shelf. What has no shelf has no readers.

There is a practical point here as well as an ethical one. Knowledge that is hard to find is underused, and underused knowledge is wasted money. The engineering team that cannot find the support team's notes on common customer complaints will build the wrong things. The new hire who cannot find the reasoning behind a policy will either break it or follow it blindly. Fair classification is not only kinder; it is more efficient, because it makes more of what the organisation already knows available to the people who need it.

AI systems inherit and amplify these choices. A model answering questions over your documents will favour material that is well described, clearly categorised and easy to retrieve. Knowledge that lives under awkward labels or in neglected corners will be cited less, summarised less and, in effect, forgotten faster. If you want a team assistant to represent everyone's knowledge fairly, the classification underneath has to do so first.

This week, ask one person from a different team or role to look at your shared knowledge structure and tell you where their work lives. Listen carefully if the answer is nowhere obvious or under miscellaneous. Then give it a name and a shelf. You will have done something small and administrative, and also something that decides who gets found. Neutral shelves do not exist. Fair ones can be built.

Whoever names the shelves decides what is found Shelf designer Structure Reader Team AI names top-level folders support notes → ops/misc searches “support” nothing obvious indexes what is well named cites support knowledge less Fix: name it, give it a shelf ask another team where their work lives What has no name has no shelf; no shelf, no readers.
Fig 20 · Classification Is Power. A naming choice upstream decides what readers and the team AI can later find.
Part III

Names and Metadata

Filenames, frontmatter, IDs and tags.

Chapter 21 · Part III

The Name Is the Index

Most retrieval never reaches the search box. It happens by scanning: you open a folder, glance down a list of names, and recognise the one you want. Or you fail to recognise it, open three wrong files, sigh, and search. The filename is the first and often the only description anyone reads, which makes it the cheapest and highest-value metadata you will ever write.

A good filename is a one-line abstract. It tells a reader what the thing is without opening it. 2026-09-14-supplier-contract-acme-signed.pdf says the date, the type, the counterparty and the status. Contract (2) FINAL.pdf says that someone, at some point, felt a fleeting sense of completion. The first takes perhaps five seconds longer to type. It saves those five seconds every single time anyone looks at the folder, for the life of the file.

The elements of a good name are consistent across almost every kind of document. A date, if time matters. A subject or counterparty, so you know what it concerns. A type, so you know what kind of thing it is: invoice, notes, draft, decision, slides. And sometimes a status or version, if the file will exist alongside siblings. Not every file needs all four. Most need at least two. A name that contains only one, such as notes or budget, is relying on its folder to supply the rest, and folders are not always there when the file travels.

A filename should still make sense after it has been emailed to a stranger.

That travel test is worth taking seriously. Files leave their folders constantly: attached to emails, uploaded to tools, dropped into chats, downloaded into somebody else's downloads folder where they sit beside four hundred others. In each of those places, the name is all the context the file carries. A file called proposal.docx in a client's inbox is indistinguishable from every other proposal they have received this year, which is a poor way to be remembered.

Names matter to AI agents for the same reason, only more so. When an agent explores a folder, it usually reads the list of filenames before deciding what to open, much as you would. Descriptive names let it go straight to the right file. Vague names force it to open many files to find out what they contain, which is slower, costs more, and fills its limited working memory with irrelevant material. A well-named folder is, in effect, a well-written table of contents for every reader at once.

This week, pick the folder you open most often and rename every file in it to pass the travel test. It will feel tedious for about fifteen minutes. Then write down the naming pattern you used, in one line, and stick it somewhere you will see it, perhaps in a README in the folder itself. From now on, name new files to the pattern at the moment you save them, which is the only moment naming is cheap. The name is the index. Write it like one.

Anatomy of a filename 2026-09-14 date supplier-contract type acme counterparty signed status .pdf A ONE-LINE ABSTRACT VERSUS Contract (2) FINAL.pdf says only that someone felt finished THE TRAVEL TEST: STILL CLEAR WHEN IT LEAVES THE FOLDER Your folder context: folder Email context: subject? Chat upload context: none Their downloads beside 400 more Agents read the filename list first, then decide what to open. The name is the index. Write it like one.
Fig 21 · The Name Is the Index. A good filename carries date, type, counterparty and status wherever it travels.
Chapter 22 · Part III

Date-First Filenames

Prefix a filename with a date in the form year, month, day, as in 2026-10-07, and something quietly wonderful happens. Your file list sorts itself into chronological order, forever, on every operating system, in every tool, with no database, no plugin and no effort beyond the typing. This format is an international standard, ISO 8601, and it is the closest thing the filing world has to a free lunch.

The magic is in the order of the parts. Because the largest unit comes first, alphabetical sorting and chronological sorting become the same thing. Every tool on earth can sort alphabetically. So every tool on earth can now sort your files by date, without relying on the file's modification time, which changes whenever someone opens and saves it, or its creation time, which changes whenever it is copied. The date in the name is the date you meant, and it stays put.

Compare the alternatives. A name like 7 Oct notes sorts with every other file beginning with 7, regardless of month or year. A name like 10-07-2026 sorts by month first, so October of every year clumps together. A name like notes October sorts alphabetically by month name, which puts April first and September last for no reason anyone can defend. Only year-month-day, with leading zeros, behaves correctly in all cases.

Year, month, day. Biggest first. Your folder becomes a timeline for free.

Not everything needs a date. A reference document that is continuously updated, such as a team handbook or a glossary, should not be date-prefixed, because its date would be wrong tomorrow. Dates belong on things that represent a moment: meeting notes, reports, decisions, invoices, photographs of whiteboards, drafts sent to someone on a particular day. A useful rule is to date-prefix anything you would describe using the word when.

Date-first names also help machines in a specific way. An AI agent asked about the most recent version of something, or what happened in a given month, can answer from filenames alone if they carry ISO dates. Without them, it must open files and hunt for dates in the text, which is slow and error-prone, or rely on file system timestamps, which may reflect when a file was last synced rather than when it was written. A date in the name is a fact the agent can trust at a glance.

This week, adopt the format for one recurring kind of document, perhaps meeting notes or weekly reports. Use the date as the first element, followed by a short slug describing the subject. If you have a backlog of such files, rename the last month's worth so the new habit has company. Within a few weeks the folder will read as a timeline, and you will wonder how you ever navigated it any other way. Some conventions are fashions. This one is arithmetic.

Only year-month-day sorts as time 7 Oct notes format SORTED A→Z 1 Mar notes 12 Jan notes 7 Oct notes 9 Feb notes ✗ sorts by day 10-07-2026 format SORTED A→Z 01-15-2027 03-01-2026 10-07-2025 10-07-2026 ✗ months clump notes October format SORTED A→Z notes April notes February notes October notes September ✗ April first 2026-10-07 format SORTED A→Z 2025-10-07 2026-01-12 2026-03-01 2026-10-07 ✓ a timeline Date-prefix anything you would describe with “when” meetings, reports, decisions, invoices · not the living handbook or glossary Biggest unit first: alphabetical becomes chronological.
Fig 22 · Date-First Filenames. Of four date formats, only ISO year-month-day sorts alphabetically into a timeline.
Chapter 23 · Part III

Slugs, Not Sentences

A slug is a name written for machines that humans can still read: lowercase words joined by hyphens, with no spaces, no punctuation and no surprises. supplier-review-acme is a slug. Supplier Review (ACME) – Draft #2!.docx is a sentence with ambitions. The slug survives every tool that will ever touch the file. The sentence survives most of them, until one day it does not.

The trouble with spaces and punctuation is that many tools treat them as special. Spaces in a filename can break shell commands and scripts unless every reference is carefully quoted. Ampersands, question marks and hash signs have special meanings in web addresses. Brackets and apostrophes confuse some sync tools. Accented characters and emoji are represented differently on different systems, so a file can appear to exist on one computer and vanish on another. Capital letters create ambiguity on systems that treat Report and report as the same file and those that treat them as different.

Each of these problems is rare, which is what makes them dangerous. You can use sentence-style names for years without trouble, and then a file refuses to sync, a script fails at two in the morning, or a link in a shared document quietly points to nothing. When you investigate, the cause turns out to be a bracket. Slugs avoid the entire category of failure at the cost of looking slightly austere.

Name files as if a script will read them, because one eventually will.

That last point is more true than it used to be. A growing share of the readers of your files are not people but programs: sync services, backup tools, search indexers and, increasingly, AI agents that run commands on your behalf. An agent working in your project folder will often reference files by name in shell commands. Every space and odd character is a small chance of a quoting mistake, and agents, like people, make those mistakes occasionally. A folder of clean slugs removes the opportunity.

The usual objection is readability. Slugs are perfectly readable for anything that will be scanned in a list, which is most files. Where you need a proper human title, put it inside the document, in its first heading or its metadata. The filename is the address; the title is the label on the front. They do not have to be the same, and it is often better if they are not, because you can change a title freely without breaking every link to the file.

This week, set yourself a slug rule and apply it to new files: lowercase, hyphens between words, letters and numbers only, a date prefix where it applies. Rename the files in one active project to match. If you work with others, put the rule in the folder's README so they follow it too. It is a small, slightly fussy discipline. So is wearing a seatbelt.

From sentence to slug Supplier Review (ACME) – Draft #2!.docx lowercase Report = report? hyphens no spaces a-z, 0-9 drop ( ) # ! & date first where it applies 2026-10-07-supplier-review-acme-draft-2.docx WHAT EACH CHARACTER CAN BREAK space shell commands & ? # web addresses ( ) ' sync tools é ✨ other systems Caps one file or two? Title lives inside the doc; the filename is only the address. Name files as if a script will read them. One will.
Fig 23 · Slugs, Not Sentences. A sentence-style name passes through four rules and becomes a script-safe slug.
Chapter 24 · Part III

Frontmatter as Contract

Frontmatter is a small block of structured fields at the top of a document, typically written in a simple format and fenced off from the prose beneath. A few lines saying the title, the date, the tags, the status and perhaps the owner. It looks like a minor technical convention. It is actually the device that turns a folder of loose notes into a database, without anyone having to run a database.

Here is the mechanism. Once every note in a folder carries the same few fields, any tool that can read those fields can query the collection. Show me all notes with status active. Show me everything tagged pricing from the last quarter. Show me decisions owned by the platform team. Many notes apps can do this directly, static site generators use it to build websites, and a five-line script can do it for anything else. The prose stays prose. The fields make it addressable.

The word contract is deliberate. Frontmatter works only if everyone agrees on which fields exist, what they are called and what values they may contain. If one note says status: done, another Status: Complete and a third state: finished, the query finds a third of what it should. The fields are a promise between whoever writes a note and whoever, later, reads the collection as data. Break the promise and the database dissolves back into a pile.

A note with a typed header is a record. A note without one is a rumour.

Keep the contract short. Four to six fields is plenty for most purposes. A typical set is a title, a date, a type such as note or decision or meeting, a status, and a list of tags from your controlled vocabulary. Write the contract down in a template so new notes start with the fields already in place, and in a single-page description of what each field means and which values are allowed.

Frontmatter is one of the most valuable things you can give an AI agent. A model reading a note with a clear header knows immediately what the note is, how current it is and whether it is still in force, before reading a word of the body. It can filter a collection by fields precisely rather than guessing from the prose. Many agent tools also read frontmatter to decide what a file is for, which is why so many instruction and configuration files for AI assistants use exactly this pattern.

This week, choose one collection of notes or documents and define a minimal frontmatter contract for it: no more than five fields, each with allowed values. Add the header to your template, then add it to the ten most important existing items. Run one query, even a simple search for status: active, and see what it returns. That is the first moment your notes behave like a database. It will not be the last.

A typed header turns notes into records --- title: Pricing review date: 2026-10-07 type: decision status: active tags: [pricing] --- Prose stays prose The contract 4–6 fields, fixed values Query status: active Notes app views Site generator 5-line script AI agent filter BROKEN CONTRACT: A THIRD OF THE RESULTS status: done Status: Complete state: finished A note with a typed header is a record. Without one, a rumour.
Fig 24 · Frontmatter as Contract. Agreed header fields let any app, script or agent query notes like a database.
Chapter 25 · Part III

Provenance Fields

Where did this come from? Who said it? When? How sure are we? These four questions are provenance, and knowledge without provenance cannot be audited, corrected or trusted at any real scale. Archivists treat provenance as sacred. The rest of us tend to treat it as optional, right up to the moment someone asks where did that number come from? and nobody knows.

The problem is familiar. A figure appears in a slide deck. It is copied into a strategy document, then into a board report, then into a proposal. Each copy drops a little context. By the fourth appearance it has become a fact, cited confidently, with no visible source. When someone finally checks, it turns out the original was an estimate from a single conversation two years ago, offered with the caveat roughly, and do not quote me. Everyone quoted it.

Provenance fields stop this decay at the point of capture. When you record a fact, a decision or a claim worth keeping, attach a few short fields: the source, ideally as a link; the date it was true; who stated it or decided it; and a confidence level, even something as simple as confirmed, reported or guess. These take seconds to write. They give every future reader the means to decide how much weight the claim can bear.

A fact without a source is a rumour that has been to a good school.

This matters enormously in a world where AI generates a great deal of text. Models are fluent, and fluency feels like authority. When an assistant summarises your documents, drafts a report or answers a question, it will often blend material from several sources into smooth prose. If the sources carried provenance, a well-instructed agent can cite them, and you can check. If they did not, the summary inherits all the confidence and none of the accountability, and errors travel faster than ever.

Provenance also lets you correct things. When a fact changes, a well-sourced collection lets you find everything that depended on it: every note citing that report, every decision that relied on that estimate. A collection without provenance offers no such trail. You fix the original and the copies continue to circulate, each one a small, cheerful falsehood.

This week, introduce a source field into whatever you use for recording important facts and decisions. If you use frontmatter, add source: and confidence:. If you use a spreadsheet, add two columns. If you take notes by hand, adopt a habit of writing the source in brackets after any number. Then go back to one important document, perhaps a plan or a forecast, and add sources to its five most important claims. Some you will find quickly. Some you will not find at all, and that discovery is the point. Trust is not a feeling. It is a field.

How an estimate becomes a fact Conversation “roughly” Slide deck no caveat Strategy doc cited once Board report “the figure” Proposal no source CONTEXT CARRIED → SHRINKS AT EVERY COPY Provenance fields seconds to write at capture source: link to the call note date: 2024-06-12 by: who said or decided confidence: confirmed | reported | guess Audit and correct find every doc that relied on it AI summaries can cite fluency with accountability A fact without a source is a rumour that went to a good school.
Fig 25 · Provenance Fields. An estimate loses its caveat at each copy; provenance fields keep it auditable.
Chapter 26 · Part III

Tag Hygiene

Tags multiply silently. You add meeting one day and meetings the next. Someone else adds mtg. A month later there is 1-1, one-on-one and 1on1. Nobody decided to create seven tags for two concepts. They accumulated, one reasonable moment at a time, and now a search for any of them returns a fraction of what it should. Without regular cleaning, every tagging system drifts towards a cloud of near-duplicates.

The cure is a regular, slightly boring pass of merging and killing. Once a month, list every tag in use, sorted alphabetically, with a count of how many items carry each. Alphabetical sorting puts spelling variants and plurals next to each other, where they are easy to spot. The counts reveal the long tail: tags used once or twice, usually invented in a hurry and never used again.

Then apply three operations. Merge synonyms into the preferred term from your controlled vocabulary, so that mtg and meetings become meeting. Kill orphans, tags used only once or twice that add no searchable value, by removing them or folding them into a broader tag. And split overloaded tags, those used on so many items that they no longer discriminate, into two or three more specific ones. A tag applied to half your collection is not a tag; it is a description of the collection.

Tags are like weeds and roses at once. Without a gardener, the weeds win.

Most tools make this easier than people realise. Many notes apps let you rename a tag across every item in one action, which merges it into another automatically. If yours does not, a search and replace across plain-text files does the job. In shared spaces, tag hygiene also has a social component: the person who invents a new tag should check the vocabulary first, and someone, ideally a named someone, should own the monthly pass.

AI assistants are excellent tag gardeners when given clear rules. Ask an agent to list all tags with counts, propose merges based on your controlled vocabulary and flag any tag used fewer than three times, and you will get a draft clean-up plan in moments. Review the proposals rather than accepting them wholesale, because the agent cannot always tell that two similar tags mean different things in your context. But the tedious part, finding the candidates, is exactly the kind of work machines do well.

This week, do the first pass. Export or list your tags with counts. Merge every obvious synonym, kill every tag with a single use that does not deserve to exist, and update your controlled vocabulary page to match. Put a recurring monthly reminder in your calendar for the next pass. The first one will take an hour. The second will take ten minutes, because there will be so much less to do. Hygiene is boring. So is the alternative, only for longer.

The monthly merge, kill and split ALL TAGS, A→Z, WITH COUNTS 1-1 6 merge 1on1 3 merge docs 212 split meeting 41 meetings 17 merge mtg 9 merge one-on-one 12 pricing 28 zz-temp 1 kill Merge synonyms → preferred term Kill orphans used once or twice Split tags on half the collection Sort A→Z and the duplicates sit side by side.
Fig 26 · Tag Hygiene. Listing tags with counts exposes what to merge, which orphans to kill, what to split.
Chapter 27 · Part III

Status Over Folders

A common way to show that something is finished is to move it: from Current to Done, from Drafts to Published, from Active to Archive. It feels satisfying, like putting a book back on the shelf. It is also one of the more fragile habits in personal and team knowledge management. A status field does the same job better, because it is queryable, instantly reversible and visible right where the item already lives.

Consider the costs of status-by-folder. Every move breaks something: links that pointed to the old location, bookmarks, references in other documents, scripts that expected the file at a certain path. Every move also requires a decision, so things linger in the wrong folder because nobody got round to moving them. And when something needs to go back, a project revived or a draft reopened, it has to be moved again, breaking the links a second time.

A status field avoids all of this. The item stays in one place, its canonical home. A single field records whether it is a draft, active, paused, done, archived or dead. Changing the status is a one-word edit that breaks nothing. Querying by status is trivial if you use frontmatter or a database. And because the field is visible on the item, anyone who opens it knows its state instantly, rather than having to infer it from which folder they happened to find it in.

Location answers where a thing lives. Status answers what state it is in. Do not make one field do both jobs.

Keep the list of statuses short and defined, in the spirit of controlled vocabulary. Four or five values cover almost every need. One useful set is draft, active, done and archived, with perhaps superseded for documents replaced by newer versions. That last one is particularly valuable, because superseded documents are the ones most likely to mislead. A clear superseded status, ideally with a link to the replacement, stops people and machines from quoting the old version.

AI agents benefit from status fields more than almost any other kind of metadata. An agent asked about your current pricing policy will happily read every document mentioning pricing, including three obsolete ones, and blend them into an answer. If each document carries a status, you can instruct the agent to ignore anything not marked active, and it will. Status is the cheapest possible guardrail against the most common failure of AI retrieval: confidently citing something that used to be true.

This week, add a status field to one active collection. Assign a status to every item. Notice how many you had been treating as current that are actually done, superseded or dead. Then stop moving files to signal completion. Change the word instead. You will break fewer links and tell more truth. Status is metadata. Folders are geography.

Change the word, not the folder draft work in progress active in force done finished archived kept, inactive superseded link → replacement revived: one-word edit, no links break ONE CANONICAL HOME; ONLY THE STATUS FIELD CHANGES Moving files to signal state breaks links, lingers, moves twice Agent rule ignore anything not status: active Status is metadata. Folders are geography.
Fig 27 · Status Over Folders. Documents stay put while a status field moves from draft to active, done or superseded.
Chapter 28 · Part III

The Permanent Identifier

Give every important item an identifier that never changes, even when its title does. Libraries do this with catalogue numbers, publishers with ISBNs, the web with persistent links, and software with database keys. The principle is the same everywhere: links built on stable IDs survive renames, moves and reorganisations, while links built on names die quietly and without warning.

Names change constantly, and for good reasons. A project gets rebranded. A document's scope widens and its title is updated to match. A folder structure is reorganised. Each change is sensible on its own. But every link, bookmark and reference that relied on the old name now points at nothing. You discover this months later, when a crucial link in an onboarding guide leads to a page that says not found, and nobody remembers what it used to point to.

An identifier separates two things that names conflate: what something is called and which thing it is. A permanent ID is a label that refers to exactly one item for as long as the item exists. It can be a number, a short code or a timestamp. It does not need to be meaningful, and it is often better if it is not, because meaningful IDs tempt people to change them when the meaning drifts.

Titles are for people. Identifiers are for links. Never let the first do the second's job.

Plenty of tools already provide IDs, though people often ignore them. Most wikis and document platforms give each page an underlying ID in its address that persists when the title changes; linking via that address is safer than linking via a title-based path. Issue trackers number every ticket. Some note-taking methods, notably the slip-box approach in Part Four, assign each note a unique ID at creation. Where your tool offers no ID, a date-and-time stamp in the filename or frontmatter works well: it is unique in practice and never needs to change.

Stable identifiers matter more as AI agents do more of your linking and referencing. An agent that cites a document by its title can be wrong if the title has changed or if two documents share similar names. An agent that cites by ID cannot be confused in the same way. When you ask an assistant to maintain an index, a decision log or a set of cross-references, instruct it to use IDs rather than titles. Its links will still be working long after the titles have been renamed twice.

This week, find out how your main tool identifies items underneath their names. Look at a page's address, a file's properties or a note's metadata. Then, for your most-linked document, update the links that point to it so that they use the stable ID rather than the title or path. Next time you rename that document, notice that nothing breaks. Names are how we talk about things. IDs are how things stay findable.

Rename twice, link once THE SAME DOCUMENT OVER TIME Q3 launch plan month 1 Atlas launch plan month 4 Atlas go-to-market month 9 id: 20260114 never changes Link by title /docs/q3-launch-plan ✓ ✗ ✗ 404: not found Link by ID /docs/20260114 ✓ ✓ ✓ Where IDs already hide wiki page address · ticket number · slip-box note id · timestamp Titles are for people. Identifiers are for links.
Fig 28 · The Permanent Identifier. A link built on the title dies at the first rename; a link built on an ID survives.
Chapter 29 · Part III

Metadata Is Not Free

After several chapters praising metadata, here is the necessary correction. Every field you add is a field somebody must fill in, accurately, every time, for ever. Metadata has a cost, it compounds, and it is paid mostly by people who were not in the room when the schema was designed. Design the minimum schema that answers your actual questions, then refuse everything else.

The failure mode is familiar to anyone who has used a corporate document system. Each document must be saved with fifteen required fields: department, sub-department, document type, sub-type, confidentiality, retention class, project code, client, region, language and so on. People comply grudgingly at first, then start choosing the first value in every dropdown to get through the form. Within a year, the metadata is technically complete and practically useless, because nobody trusts it.

The principle that avoids this is to work backwards from questions. List the questions you will actually ask of the collection. Which documents are current? Which belong to this project? Which were decided by whom? Each question justifies at most one or two fields. Any field that does not answer a question someone actually asks is overhead, and overhead in metadata degrades the quality of the fields that do matter, because attention is finite.

Every field is a tax on every save. Levy only the ones you will spend.

There is a second cost that is easy to miss: maintenance. A field like owner is cheap to fill in at creation and expensive to keep accurate as people change roles. A field like review date creates an obligation to actually review. Fields that describe the present, such as status or owner, decay; fields that describe the past, such as creation date or source, do not. Prefer the stable kind, and add the decaying kind only when you are willing to maintain it.

AI changes the calculation somewhat. Models can now infer many fields automatically: topic, type, a summary, even probable tags. This lowers the human cost of metadata and tempts people to add more. Be careful. Inferred metadata is a guess, and a guess presented as a field looks like a fact. A reasonable compromise is to let machines fill fields that are cheap to be wrong about, such as topic tags, and keep humans responsible for fields that carry weight, such as status, owner and source.

This week, review the metadata in one system you use: the fields in a template, the properties on a page, the columns in a tracker. For each, ask which question it answers and when anyone last used it to answer that question. Remove at least one field that answers nothing. If someone objects, ask them what they would search for using it. A short schema filled honestly beats a long one filled with defaults. Less is not only more. Less is true.

Levy only the fields you will spend STABLE (describes the past) DECAYS (describes the present) ANSWERS A QUESTION ANSWERS NOTHING Keep date, source cheap, stays true Keep and maintain status, owner only if someone will Cut quietly sub-type, region harmless but a tax Cut first review date, nobody rots and misleads Machines fill cheap-to-be-wrong fields (topic tags); humans own status, owner, source. Every field is a tax on every save.
Fig 29 · Metadata Is Not Free. Keep fields that answer real questions and stay true; cut the rest first.
Chapter 30 · Part III

Naming as Thinking

You cannot name what you have not understood. This is why naming things is so often hard and why the struggle is worth more than it seems. When you sit staring at a document trying to decide what to call it, you are not procrastinating. You are discovering, possibly for the first time, what the document is actually about.

Everyone has experienced the vague file. You write a page of notes after a meeting and save it as notes or thoughts, because the meeting covered several things and none of them felt like the headline. A week later the file is useless, not because the notes are bad but because they never resolved into a point. If you had been forced to name it properly, you would have had to decide what the point was. Often that decision is the most valuable output of the whole meeting.

Writers know this trick. Many good editors will tell a struggling author to write the title first, or at least the one-sentence summary, and to keep rewriting it until it is true. A title you can state clearly is a sign of an idea you understand clearly. A title you cannot state is a sign that the work is not finished, however many pages it already has.

If you cannot name it, you do not know what it is yet. That is not a filing problem. It is a thinking problem.

This makes naming a powerful diagnostic tool for knowledge work. When a document resists a good name, ask why. Sometimes it is about two things and should be two documents. Sometimes it has no conclusion and needs one. Sometimes it is a pile of raw material that has not yet been worked into anything, in which case it should be named honestly as such, 2026-10-07-raw-notes-pricing-call, and kept somewhere you will return to.

AI tools are very good at suggesting names, and you should use them, but with care. A model can read your notes and propose a perfectly reasonable title in seconds. Sometimes the title will reveal a point you had not quite articulated, which is genuinely useful. Sometimes it will produce a smooth, generic name that covers up the fact that the document has no point at all. Discussion of Pricing Considerations is the kind of title that sounds like understanding and is actually a shrug. If the machine's suggestion feels vague, the document probably is.

This week, take five of your recently saved files with weak names and rename them properly. For each one, write a title that states the main point or purpose in a phrase. Notice which ones resist. For those, open the document and work out why: is it two things, or no thing yet? Fix the document if you can. Then name it. The ten minutes you spend will clarify more than the filenames. A good name is a small act of understanding. A bad one is a small act of avoidance.

When a name resists, ask why Try to name it one phrase, the point Can you state the point? yes Name it the point, as a title no THEN IT IS A THINKING PROBLEM, NOT A FILING ONE About two things? split into two docs No conclusion? write one Raw material? name it honestly 2026-10-07-raw-notes-pricing AI TITLE SMELL: “Discussion of Pricing Considerations” A good name is a small act of understanding.
Fig 30 · Naming as Thinking. A name that will not come signals two topics, no conclusion, or unworked raw notes.
Part IV

Structure

Folders, tags, notes, wikis and one true home.

Chapter 31 · Part IV

Folders Versus Tags

Few arguments in personal knowledge management have run as long or as fruitlessly as folders versus tags. Folders give every item one home and give you a mental map of the whole. Tags give every item many views and give you no map at all. Each side has evangelists, and each side is half right. Nearly every system that lasts uses shallow folders plus genuinely useful tags, and the trick is knowing which job belongs to which.

Folders are good at three things. They give you somewhere to put an item without thinking too hard, because there is usually an obvious answer to which project is this for? They give you browsing, the ability to open a container and see everything in it at a glance. And they give you boundaries, which matter for permissions, for sharing and for moving a whole body of work at once. Folders are bad at expressing anything that cuts across them: a theme that spans projects, a type of document that appears everywhere, a status that changes.

Tags are good at exactly those cross-cutting things. A tag for decision can pull every decision out of every project. A tag for a client can gather material from sales, delivery and finance folders alike. Tags let an item belong to several groupings without being copied. Their weakness is that they offer no overview. A list of two hundred tags tells you very little about what the collection contains, and a tag is only as good as the discipline with which it was applied.

Folders answer where a thing lives. Tags answer what a thing is about. Ask each the question it is good at.

The durable pattern is therefore a division of labour. Use folders for one stable facet, usually the project or area of responsibility, and keep them shallow, two or three levels at most. Use tags, or frontmatter fields, for the facets that cut across: type, topic, status, people. The folder gives everything a single address. The tags give everything several routes to it. When you are unsure where something goes, choose the folder by asking what it is for, and choose the tags by asking how you might look for it.

AI tools work well with this pattern, and badly with its extremes. An agent dropped into a single folder of ten thousand untagged files has no map and must search blindly. An agent faced with a tree twelve levels deep wastes effort descending into empty branches. A shallow tree with consistent tags lets it orient quickly from the folder names, then filter precisely by the tags.

This week, look at your main collection and identify which facet your folders actually encode. If the answer is several, inconsistently, choose one, usually project or area, and move the other facets into tags or fields. Do not flatten everything at once; start with one branch and see how it feels. The argument between folders and tags was never really an argument. It was a job description that nobody had written down.

Folders give a home, tags cut across Website /folder Report /folder Acme deal /folder Hiring /folder FOLDER = PROJECT one stable facet #decision #client-acme #meeting #status-active TAGS = type, topic, status, people Folder: what is it for? Tags: how might I look for it? Shallow folders, two or three levels; useful tags.
Fig 31 · Folders Versus Tags. Shallow project folders give each item a home while tags cut across all of them.
Chapter 32 · Part IV

The PARA Method

PARA is a structure popularised by the productivity writer Tiago Forte, and it is worth knowing even if you never adopt it, because it embodies one powerful idea. Instead of sorting your material by subject, sort it by how actionable it is. Four top-level buckets: Projects, Areas, Resources and Archive. That is the whole scheme, and its simplicity is the point.

Projects are short-term efforts with a goal and an end: launch the website, finish the report, move house. Areas are ongoing responsibilities with a standard to maintain but no end date: health, finances, a team you manage, a product you own. Resources are topics of interest that might be useful one day: design inspiration, notes on negotiation, recipes. Archive is everything inactive from the other three: finished projects, areas you no longer own, resources that stopped being interesting.

The effect is that your workspace shows what is live and hides what is not. When you open your notes or files, the Projects bucket contains only the things you are currently trying to finish. You are not wading through the history of everything you ever cared about to find this week's work. And because items move between buckets as their status changes, the structure naturally expresses the passage of time: projects finish and go to the archive, resources become relevant and feed a new project.

Sort by what you will do with it, not by what it is about.

PARA has critics, and some criticisms are fair. Moving things between buckets has the link-breaking costs described in the previous part, which is why some practitioners combine PARA folders with status fields, or move whole project folders only once, at the end. The boundary between an area and a resource can be fuzzy. And the scheme is designed for an individual; teams usually need something more explicit about ownership. None of this undermines the central insight, which is that actionability is a better top-level sort than subject for most working people.

The structure also suits AI assistance surprisingly well. An agent helping with your current work can be pointed at the Projects bucket and told to ignore the Archive unless asked, which keeps its context focused on the present. A periodic review, where an agent lists projects untouched for a month and suggests archiving them, is exactly the kind of maintenance chore machines do well and people postpone.

This week, try the PARA lens without reorganising anything. Make a list of your current projects, things with an end, and your areas, things you maintain indefinitely. Count them. Most people discover they have more open projects than they realised, and several that are quietly dead. Archive the dead ones. Then decide whether the full method is worth adopting. Even if it is not, you now know which work is live. That knowledge was the whole point of the structure.

Sort by what you will do with it Projects goal + end date launch the site Areas standard, no end finances, a team Resources might be useful negotiation notes Archive inactive finished, dropped MOST ACTIONABLE LEAST project finishes → archive resource feeds a new project CAVEATS Moves break links pair with a status field Area vs resource the line can blur Agent scope work in Projects only The workspace shows what is live and hides what is not.
Fig 32 · The PARA Method. PARA sorts work by actionability; items flow on to the Archive as they finish.
Chapter 33 · Part IV

The Slip-Box

The German sociologist Niklas Luhmann kept a slip-box, a Zettelkasten, of index cards over several decades, eventually filling it with tens of thousands of notes. He credited it with much of his remarkable productivity: dozens of books and hundreds of articles. The slip-box has since become something of a cult among knowledge workers, and much of the cult is overexcited. But underneath the enthusiasm are three genuinely useful principles, and you can borrow them without buying a single index card.

The first principle is atomicity. Each note contains one idea, written fully enough to make sense on its own. Not a page of mixed thoughts from a meeting, but a single claim, observation or argument, stated in a few sentences in your own words. This is the granularity principle from Part Two, applied with discipline.

The second is addressing. Every note has a unique, permanent identifier. Luhmann used a branching numbering scheme, so a note that continued a thought on note 21 might become 21a, and a further branch 21a1. You do not need his scheme; a timestamp works perfectly well. What matters is that each note can be referred to precisely and permanently, as Part Three argued. The third, and the heart of the method, is linking. Each new note is connected to existing notes it relates to, with a short explanation of why. Over time, the links form a dense web, and structure emerges from the connections rather than from a predetermined hierarchy. When you want to write about a subject, you do not start from a blank page; you start from a cluster of linked notes that already contain the argument in pieces.

The value of a slip-box is not in the notes. It is in the reasons you wrote for linking them.

The common failure is to adopt the form without the substance. People create thousands of atomic notes, each linked to a few others, and find that nothing emerges, because the notes are copied highlights rather than their own thinking and the links are automatic rather than reasoned. The slip-box works when every note is an act of understanding and every link is an argument. It fails when it becomes an elaborate place to store other people's sentences.

The method has a modern echo in how AI systems use knowledge. Small, self-contained, well-linked units are exactly what retrieval systems handle best, and the explanatory links give an agent a reason to follow one note to the next. A personal slip-box is, unintentionally, an excellent knowledge base for an assistant.

This week, try the method in miniature. Pick a subject you are learning. Write five atomic notes, each one idea in your own words, each with a timestamp ID. Link each to at least one other, with a sentence explaining the connection. Read the five together and notice whether a thought appears that none of them contains alone. If one does, the method is working. Index cards are optional. Thinking is not.

Atomic notes, permanent IDs, reasoned links 21 Pricing anchors one idea, own words 21a Anchors fade one idea, own words 21a1 Re-anchor each year one idea, own words 22 Churn is quiet one idea, own words 20261007 Discounts teach one idea, own words “explains why churn hides” “discounts reset anchors” A new essay starts from the cluster Atomicity one idea per note Addressing id never changes Linking a reason for each link The value is in the reasons you wrote for the links.
Fig 33 · The Slip-Box. Slip-box notes hold one idea each, carry permanent IDs, and link with stated reasons.
Chapter 34 · Part IV

Depth Is Expensive

Every level of nesting in a folder structure is two costs. At save time, it is a decision: which of these subfolders does this belong in? At find time, it is a guess: which of these subfolders did I put it in? One level of decisions is easy. Two is manageable. Beyond three, something predictable happens. People stop filing correctly and start dumping things wherever is nearest, and the beautiful deep tree fills up with misfiled items and empty branches.

Deep structures appeal to a certain kind of tidy mind, because they look thorough. Clients, then client name, then year, then project, then phase, then document type, then version. Every item has a precise place. The trouble is that precision at save time requires knowing all seven facets of every item, and in practice people often know only two or three. The others get guessed, and guesses made at save time are rarely the same guesses made at find time months later.

Deep trees also hide things. When you open the top level, you see only the first layer of categories. Everything else is behind clicks, and things behind several clicks are effectively invisible for browsing purposes. This is how teams end up with three copies of the same template in different branches: each person searched the parts of the tree they knew, failed to find it and made a new one.

Each folder level is a question you must answer twice. Ask fewer questions.

The alternative is a shallow structure with richer description. Keep folders to two or three levels, usually area or project at the top, and push the remaining facets into filenames and metadata. A shallow folder with fifty well-named files is far easier to scan than a deep tree with fifty files spread across twenty subfolders. Date-first names give you chronological order within a folder. Tags and fields give you every other slice. Search does the rest.

AI agents are notably affected by depth. An agent exploring a deep tree must list directories level by level, often several calls deep, before reaching anything useful, and every listing consumes part of its working memory. A shallow structure lets it see most of the collection in one or two glances. If you want an assistant to navigate a project efficiently, a flat-ish layout with good names is worth more than any elaborate hierarchy.

This week, find the deepest path in your main collection, the folder you have to click into the most times to reach. Ask whether each level is earning its keep. Could two levels be merged? Could one be replaced by a word in the filename? Flatten one branch to three levels or fewer and see whether anything becomes harder to find. Usually nothing does, and several things become easier. Depth feels like order. Mostly it is just distance.

Each level is a question asked twice DEEP: SEVEN DECISIONS TO SAVE, SEVEN GUESSES TO FIND Clients Acme 2026 Rebrand Phase 2 Contracts v3 file.pdf misfiled items, empty branches, three copies of one template SHALLOW: TWO LEVELS, THE REST IN THE NAME Clients Acme 2026-03-02-contract-rebrand-p2-v3.pdf Depth feels like order. Mostly it is distance.
Fig 34 · Depth Is Expensive. A seven-level path costs seven decisions; two levels plus a good filename cost two.
Chapter 35 · Part IV

Maps of Content

Search is powerful but indifferent. It returns everything that matches, ranked by a formula, with no opinion about which result is actually good. The human counterweight is a map of content: a handwritten index note that links to the best material on a subject, arranged in an order that makes sense, with a sentence or two explaining each link. The name comes from the personal knowledge management community, but the idea is as old as the annotated reading list.

A map of content is curated, which means it reflects judgement. Out of forty notes on pricing, it links to the eight that matter and says why. It is opinionated, which means it can say start here, this one is out of date but historically important, or this is the decision; everything else is background. And it is current, because you maintain it, adding new material when it earns a place and removing material that no longer deserves one.

This makes maps of content the solution to a problem every growing collection faces. Once a subject has more than a dozen notes, search starts returning too much. You know the good material exists, but finding it means scanning past drafts, fragments and duplicates. A map gives you a single entry point that cuts straight to the good stuff. It also tells you what you do not have: a map with an obvious gap is a reminder of what to write next.

Search tells you what exists. A map tells you what matters.

Maps work at every scale. A personal map might cover a hobby or a research topic. A team map might cover a product area: the current spec, the key decisions, the architecture overview, the runbook, the people to ask. At the top of a large wiki, a map of maps can serve as a home page that actually orients newcomers, rather than an alphabetical list of every space.

Maps of content are also one of the best things you can give an AI agent. An agent dropped into a large collection and asked a question will search, and search will return a mix of good and stale material. An agent that first reads a map knows where the authoritative documents are and which to ignore. Part Nine returns to this as the agent's catalogue, but the principle starts here: a short, curated index makes every subsequent query sharper, for people and machines alike.

This week, write one map. Choose the subject you look things up about most often. Create a single note with a clear title, list the five to fifteen best items on that subject as links, and write one line after each saying what it is and why it matters. Put the most important link first. Then link to the map from wherever you usually start. Updating it will take a minute each time you add something worthwhile. Being lost is slower.

Search says what exists, a map what matters SEARCH “PRICING”: 40 RESULTS, RANKED BY FORMULA ■ the 8 that matter, scattered Map: Pricing curated · opinionated · current 1 Pricing decision 2026 start here: the decision 2 Tier model how the tiers work 3 Competitor scan background 4 2023 price change stale, historically key 5 Discount rules what sales may offer ? Churn analysis gap: write this next Agent reads the map first knows what is authoritative and what to ignore Write one map for the subject you look up most. 5–15 links, one line each, most important first
Fig 35 · Maps of Content. A map of content picks the eight good notes out of forty results and says why.
Chapter 36 · Part IV

The Inbox Pattern

Every reliable system has one place where everything lands unsorted, and a regular ritual for emptying it. This is the inbox pattern, and its two halves depend on each other completely. Without the inbox, filing friction kills capture: if every new thing must be placed correctly at the moment it arrives, you will capture less. Without the ritual, the inbox becomes a landfill: everything lands and nothing leaves.

The inbox half is about removing decisions from the moment of capture. When something arrives, a thought, a document, a link, a photograph of a whiteboard, it goes to one place, with at most a rough name. You do not decide where it belongs, how it should be tagged or whether it is worth keeping. You just get it in. This matters because capture usually happens at awkward moments, between meetings or in the middle of something else, when you have neither the time nor the attention for good filing decisions.

The ritual half is about making those decisions later, in batches, when you can give them proper attention. Once a day or once a week, you open the inbox and process every item. For each, you choose: file it properly, act on it, turn it into a task, or delete it. The goal is an empty inbox, or close to it, at the end of each session. Batching works because deciding is a mode of thought, and switching into that mode once for twenty items is far cheaper than switching twenty times.

An inbox without a ritual is a bin with a nicer name.

The most common failure is having too many inboxes. Email is one, the downloads folder is another, the notes app has its own, chat apps have saved messages, the browser has a reading list and the desk has a physical tray. Each is processed on a different schedule or never. The fix is to reduce the number of inboxes you must check, perhaps by forwarding several into one, and to give each remaining inbox an explicit processing rhythm.

AI agents are well suited to the ritual half. An assistant can read your inbox, propose a name, a destination and tags for each item, and flag anything that looks like an action. You review and approve in a fraction of the time it would take to do it all yourself. The decisions remain yours, but the clerical work of drafting each decision is delegated. This is one of the most immediately useful things an agent can do for a personal knowledge system.

This week, count your inboxes, every place where unsorted things accumulate. Write them down. Then choose one main inbox for notes and documents, and route as many of the others into it as you can. Set a recurring appointment, fifteen minutes, to empty it. Do it twice before deciding whether it works. Capture fast. Decide later. Never skip the later.

Capture fast, decide later, never skip later Email Downloads Notes app Chat saves Reading list Desk tray One inbox rough name only The ritual 15 min, batched agent drafts File it name, home, tags Act on it two minutes Make a task into the list Delete most things TOO MANY INBOXES? ROUTE THEM INTO ONE, GIVE EACH LEFT A RHYTHM An inbox without a ritual is a bin with a nicer name.
Fig 36 · The Inbox Pattern. Many sources feed one inbox; a short batched ritual sends each item to one of four fates.
Chapter 37 · Part IV

Notes Versus Wikis

A note and a wiki page can look identical: a title, some text, a few links. They are different species, and treating one as the other is the source of much confusion. A note is a record of thinking, written for its author, valid at the moment it was written. A wiki page is shared reference, written for others, expected to be true now. Notes are allowed to be wrong, partial and personal. Wiki pages are not.

Notes are cheap and plentiful by design. You write them to work something out, to capture what happened in a meeting, to save an idea before it evaporates. They carry a date, explicit or implied, and that date is part of their meaning: this is what I thought on that day. Nobody expects last year's meeting notes to be updated when the decision changes. They are history, and their value is precisely that they record what was believed at the time.

Wiki pages are expensive and few by design. They describe how things are: how to deploy, what the expense policy says, who owns which system, what the product does. Their promise is currency. Readers assume a wiki page is true today, and when it is not, the damage is real. A stale wiki page is worse than no page at all, because it tells people the wrong thing with the authority of an official source.

Notes record what was thought. Wikis promise what is true. Do not let one pretend to be the other.

The trouble starts when the two blur. A team pastes meeting notes into the wiki, and now the wiki contains many dated, partial records that look like reference. Or someone writes a careful explanation of a system in their personal notes, and the team never sees it. The healthy flow is from notes to wiki: you think in notes, and when a conclusion stabilises and matters to others, you promote it into a wiki page, written fresh for the reader, with an owner and a review date. The notes stay where they are as the record of how you got there.

AI makes this distinction more important. An agent searching across notes and wiki together will treat everything it finds as potentially authoritative unless told otherwise. If your meeting notes from two years ago say one thing and your wiki says another, the agent may cite either. Mark the difference clearly, by location, by a type field or both, and instruct the agent to prefer the wiki for questions about how things are and the notes for questions about how things came to be.

This week, look at your team's wiki and find three pages that are really notes: dated records of a meeting or a discussion, pretending to be reference. Either rewrite them into proper reference pages with an owner, or move them to a notes or archive space. Then look in your own notes for one conclusion that others need, and promote it. Notes are for thinking. Wikis are for trusting.

Notes record thought; wikis promise truth Notes for the author valid on its date may be wrong 2026-03 kickoff dated record 2026-05 debate dated record 2026-06 settled dated record Wiki for everyone true now stale = harmful How we price owner + review date written fresh promote when it stabilises Pasted meeting notes look like reference: move out AGENT RULE: wiki for how things are · notes for how they came to be Do not let one pretend to be the other.
Fig 37 · Notes Versus Wikis. Dated notes stay as history; a settled conclusion is promoted to an owned wiki page.
Chapter 38 · Part IV

One Canonical Home

Every piece of knowledge that matters needs exactly one authoritative location: the single source of truth. Copies are fine. Summaries, excerpts and links are fine. What destroys a system is ambiguity about which copy is currently true. When the pricing sheet exists in a shared drive, a slide deck, two email attachments and a wiki page, and they disagree, nobody knows what the price is, and everybody acts as if they do.

The principle sounds obvious and is violated constantly, because copies are so easy to make. Someone downloads a file to edit it offline, then emails the edited version. Someone pastes a table into a presentation, then the original table changes. Someone creates a new document because they could not find the existing one. Each act is reasonable. Together they produce a small family of near-identical documents, each slightly wrong in a different way.

The fix has two parts. First, decide and declare the canonical home for each important kind of knowledge. The product roadmap lives in this tool. Policies live on this wiki space. Customer contracts live in this folder. Write these declarations down in one place, often the team's main index page, so that nobody has to guess. Second, link rather than copy whenever possible. If a presentation needs the current pricing, it links to the canonical sheet, or it includes a clear note saying copied on this date; check the source for current figures.

Copies are fine. Confusion about which copy is true is not.

A canonical home also needs an owner. Someone must be responsible for keeping the canonical version accurate and for noticing when copies start drifting from it. Without an owner, the canonical version decays like any other, and people sensibly stop trusting it, and start keeping private copies, and the problem returns in a new form.

AI agents both need and threaten single sources of truth. They need them because an agent asked a factual question will search, find several versions and have to choose, often by recency or by how confidently the text is phrased, neither of which reliably identifies the true version. They threaten them because agents generate copies freely: summaries, drafts, reformatted versions, each of which can be mistaken for a source later. Tell your agents where the canonical homes are, instruct them to cite those homes, and mark anything they generate as derived.

This week, choose one piece of knowledge that exists in several places and causes confusion: a price list, a contact sheet, a process, a project status. Decide which copy is canonical. Update it so it is correct. Replace the other copies with links to it, or mark them clearly as superseded. Then write down where the canonical home is, somewhere your team will see. It takes an afternoon. The confusion it prevents has no end date.

One true copy, many links BEFORE: WHICH PRICE IS TRUE? Drive sheet £40 Slide deck £42 Email v2 £45 Wiki page £40 Offline edit £38 AFTER: ONE HOME, OWNED Pricing sheet owner: Priya canonical Slide deck links, no copy Wiki page links, no copy Proposal links, no copy Agent answer links, no copy Declare homes on the index page; mark agent output as derived Copies are fine. Confusion about which is true is not.
Fig 38 · One Canonical Home. Five drifting copies give five prices; one owned home with links gives one.
Chapter 39 · Part IV

Structure Follows Team

A solo system can be as idiosyncratic as you like. If you file tax documents under boring and client work under the names of birds, and you can find everything, nobody has any right to object. A team system is different. The moment a second person files something, predictability matters more than cleverness, and convention beats ingenuity every time.

The reason is that shared structures are read by people who did not design them. Every idiosyncrasy that made sense to its creator is a puzzle to everyone else. A clever folder scheme that requires explanation will be misused by everyone who did not receive the explanation, which, after a few months of staff turnover, is everyone. Conventions that are boring, obvious and written down survive; conventions that are elegant and unwritten erode.

Good team structures share some recognisable features. Top-level names are plain and predictable: Clients, Projects, Policies, not The Engine Room. Naming patterns are written down in one place and followed. There is a clear answer to where does this go? for the common cases, and a clear person to ask for the uncommon ones. And the structure reflects how the team actually works, not the org chart from two reorganisations ago.

In a team, the best system is the one a new hire can follow on their first Tuesday.

Teams also need explicit ownership in a way individuals do not. Someone owns the folder structure, the wiki's top level, the tag vocabulary. Not as a gatekeeper who approves every change, but as the person who notices drift, tidies up, and makes the call when two conventions conflict. Ownerless shared spaces degrade faster than personal ones, because everyone assumes someone else is keeping them tidy.

AI agents are, in effect, the newest team members, and they join your team constantly, with no memory of yesterday's onboarding. Every session, an agent must learn your structure from scratch, from whatever it can read. A team whose conventions are written down and followed is easy for an agent to work in. A team that runs on habit and memory forces the agent to guess, and an agent's guesses tend to follow general conventions rather than yours. Writing your conventions down for new humans and writing them down for agents turn out to be the same job.

This week, write a one-page guide to your team's main shared structure, if one does not exist. Where do things go? How are they named? Who owns what? Keep it short enough to read in three minutes. Put it at the top of the shared space, and ask the next person who joins, human or otherwise, to tell you which part was confusing. Fix that part. Then fix the next. Clever structures impress. Conventional ones get used.

Convention beats ingenuity SOLO: ANYTHING GOES boring/ kestrel/ The Engine Room/ TEAM: PLAIN AND PREDICTABLE Clients/ Projects/ Policies/ One-page guide read in three minutes Where things go How they are named Who owns what Who to ask New hire first Tuesday Returning colleague after six months AI agent every session, no memory Ask the next reader what confused them. Fix that part.
Fig 39 · Structure Follows Team. A one-page guide to plain team conventions serves new hires and AI agents alike.
Chapter 40 · Part IV

The Self-Describing Folder

The best structure is one a stranger can navigate without asking anybody. The simplest tool for achieving this is a small text file, conventionally called README, placed at the top of a folder, that explains what the folder is for, what is in it, how things are named and who to ask. Software developers have used READMEs for decades. Everyone else should borrow the habit immediately.

A good README answers a handful of questions in a few short paragraphs. What is this folder, and what is it for? What is in it, and how is it organised? What are the naming conventions? What is canonical here and what is a copy or an archive? Who owns it, and who should you ask if something is unclear? When was this README last checked? None of these takes long to answer. Together they turn a folder from a puzzle into a place.

The value appears at the moments when tacit knowledge usually fails. When someone joins the team. When someone returns to a project after six months. When a folder is handed over because its owner has moved on. When a new tool or agent is pointed at the folder for the first time. In each case, the alternative to a README is asking around, guessing or giving up. A README makes all three unnecessary.

A folder that explains itself never has to wait for the person who understands it.

READMEs have become even more important with AI agents, because agents tend to look for them. Many agent tools read README files, and similar instruction files, as one of the first steps in understanding a project. An agent that finds a clear README at the top of a folder knows what the folder is for, which files matter and which conventions to follow, before it opens anything else. Part Nine develops this into the idea of a README written for two readers, human and machine, but the habit starts here, with any folder that matters.

Keep READMEs short and current. A README that is three pages long will not be read. A README that describes a structure that changed a year ago is worse than none, because it actively misleads. Put a date on it, keep it under a page, and review it whenever the folder's structure changes. If a README needs to be long, it probably means the folder is doing too many jobs and should be split.

This week, write a README for the shared folder you most often have to explain to people. Answer the questions above in under three hundred words. Then, the next time someone asks you about that folder, send them the README instead of explaining, and ask what it failed to answer. Add that. Within a few rounds you will have a folder that explains itself better than you could. That is not a loss of status. It is a holiday you can actually take.

A folder that explains itself client-onboarding/ README.md 2026-checklist.md templates/ archive/ contacts.csv What the README answers What is this for? purpose in one line What is in it? how it is organised How are things named? the pattern What is canonical? vs copies and archive Who owns it? and who to ask Last checked? a date, under a page READ WHEN: someone joins · returns · takes over · an agent arrives It never has to wait for the person who understands it.
Fig 40 · The Self-Describing Folder. A short dated README at the top of a folder answers six questions for any newcomer.
Part V

Capture and Intake

Getting things in without drowning.

Chapter 41 · Part V

Capture Beats Curate

The idea you failed to write down cannot be organised later. This is the uncomfortable starting point of every good intake system. No amount of clever structure, careful naming or AI-assisted retrieval can recover a thought that was never captured. So the first priority, before tidiness, before taxonomy, before anything this book has said so far, is getting things in.

This sounds like it contradicts the earlier chapters, which praised selection and warned against hoarding. It does not, quite. The distinction is between capture and keeping. Capture is the act of getting something out of your head or your day and into a trusted place. Keeping is the decision, made later, about whether it deserves a permanent home. A good system makes capture nearly frictionless and keeping deliberate. A bad system makes both hard, or both easy.

When capture is hard, people lose ideas without noticing. The thought about a better approach to the client problem arrives on a walk, there is no quick way to record it, you resolve to remember it, and by the time you are back at your desk it has gone. You do not even know it has gone, which is the cruelty of the thing. Lost captures leave no trace. You never miss the idea you cannot remember having.

You can always throw away what you captured. You can never recover what you did not.

The practical consequence is to accept mess as the price of completeness. Your inbox will contain half-formed thoughts, duplicates, dead ends and things that turn out not to matter. That is fine. The processing ritual from Part Four exists precisely to deal with them. A messy inbox that catches everything is far more valuable than a tidy one that catches half, because the processing step can remove the junk, but nothing can restore what never arrived.

AI has made capture much cheaper in several ways. Voice notes can be transcribed automatically. A photo of a whiteboard can be turned into text. A meeting can be recorded and summarised. Each of these lowers the cost of getting things in, and that is genuinely good. But it also raises the volume, sometimes dramatically, and volume without processing is just a faster route to a landfill. The more your tools capture automatically, the more your processing ritual matters.

This week, notice the moments when you have a thought worth keeping and no easy way to keep it. Write down where you were and what was in your hands: walking, driving, in a meeting, in the shower. For each situation, find a capture method that works there, perhaps a voice memo, a notes widget on your phone's lock screen or a pocket notebook. You do not need a perfect system. You need a reliable net. Organise later. Catch first.

Catch first, organise later WHERE THOUGHTS ARRIVE Walking voice memo Driving voice assistant Meeting pocket notebook Shower remember one word Capture frictionless net Inbox messy, complete Keep deliberate Throw away cheap, later Never captured gone, and leaves no trace AI LOWERS CAPTURE COST, RAISES VOLUME: THE SIEVE MATTERS MORE You can throw away what you caught, never what you missed.
Fig 41 · Capture Beats Curate. Catch every thought in a messy inbox; deciding what to keep comes later.
Chapter 42 · Part V

The Two-Second Rule

If capturing a thought takes longer than a couple of seconds to start, you will skip it exactly when it matters most: mid-conversation, mid-walk, mid-crisis, mid-argument. These are the moments when good ideas and important details tend to arrive, and they are also the moments when you have the least spare attention. Every second of friction between noticing and recording is a filter, and it filters out the most valuable material.

Consider what usually stands between you and a captured thought. Unlock the phone. Find the right app. Wait for it to open. Navigate to the right notebook. Create a new note. Perhaps choose a title or a folder. Only then start typing. Each step is small, and together they take long enough for the thought to lose its shape, or for the conversation to move on, or for you to decide it was not that important after all. Most of the time that decision is wrong; it is just friction disguised as judgement.

The goal is to reduce the time from I should write that down to actually writing it to almost nothing. That usually means a dedicated capture tool, separate from your main notes system, designed for speed rather than organisation. A widget on the home or lock screen that opens straight into a blank note. A keyboard shortcut on your computer that pops up a capture box from any application. A voice assistant that records a note when you speak. A pocket notebook and pen, which remain surprisingly hard to beat.

The best capture tool is the one you can reach before the thought escapes.

Whatever you choose, it must feed your inbox automatically or with minimal effort. A capture tool that creates a separate, unprocessed pile is merely a new inbox, and Part Four warned about having too many of those. The ideal is that anything captured lands in the one place you process regularly, ready for the ritual.

Voice capture deserves special mention because it has improved so much. Speaking a note while walking takes no more effort than talking to yourself, and transcription is now good enough that the result is usually readable without correction. An AI assistant can also tidy the transcript, pull out any action items and propose a title, so that what lands in your inbox is closer to a usable note than a raw ramble. It is one of the most practical everyday uses of these tools.

This week, time yourself. Next time you want to capture something on your phone, count the seconds from deciding to capture to typing the first word. If it is more than a few, fix it: install a capture widget, set up a shortcut, or put a notebook in your pocket. Then test it in a situation where you would normally skip capture. You will catch at least one thing you would otherwise have lost. That one thing is the whole argument. Friction is a filter. Make sure it filters the right things.

Friction is a filter 0s 2s 4s 6s 8s 10s 12s 14s 16s after ~2s the thought loses its shape Usual route 16 seconds unlock find app open notebook new title Capture widget 1 second typing the first word FAST ROUTES, ALL FEEDING THE ONE INBOX Lock-screen widget Global shortcut Voice note + AI tidy Pocket notebook The best tool is the one you reach before the thought escapes.
Fig 42 · The Two-Second Rule. Six small steps add up to sixteen seconds; a capture widget gets you typing in one.
Chapter 43 · Part V

Split Capture From Filing

Noticing that something exists and deciding where it belongs are completely different mental activities. Noticing is fast, open and reactive. Deciding is slow, deliberate and comparative. When you try to do both at the same moment, both get worse: you capture less, because filing feels like effort, and you file badly, because you are in the wrong frame of mind to make careful decisions.

You can see this in how people use most notes apps. A thought arrives. They open the app and are immediately faced with a choice of notebook, a title field and perhaps a set of tags. The thought now has to compete with a small classification problem. Either the person makes a hasty choice, putting the note in whatever notebook is open, or they defer the capture altogether until they have time to file properly, which in practice means never.

The solution is to treat capture and filing as separate stages that happen at different times. Capture goes straight to the inbox with no decisions beyond, perhaps, a rough title. Filing happens later, in a batch, during your processing ritual. During capture, your only job is to get the thing down accurately. During filing, your only job is to decide where each item goes, how it should be named and whether it deserves to be kept.

Capture is a net. Filing is a sieve. Do not try to be both at once.

Batching the filing step makes it faster in a way that surprises people. When you process twenty items in one sitting, you build momentum. Patterns become visible: three items about the same project, two that duplicate each other, one that suggests a new category. You make better decisions because you can see items in relation to one another, which is impossible when filing each one alone at the moment of capture. The total time spent filing usually goes down, not up.

This split is also the natural point to involve an AI assistant. Capture is something only you can do, because only you notice the thought. Filing is clerical work with a judgement component, and an agent can do most of the clerical part. Give it your inbox, your folder structure and your naming conventions, and ask it to propose a filename, destination and tags for each item. You review the proposals in a batch, accepting most and correcting a few. The agent never has to capture anything, and you never have to file from scratch.

This week, remove every decision from your capture step. If your capture tool asks for a notebook or tags, find a way to skip that, or switch to a tool that does not ask. Let everything land in the inbox raw. Then schedule two short filing sessions in the week and process the inbox in batches. Notice whether you captured more than usual and whether filing felt easier. Separate the jobs and each one gets lighter. Combine them and both get skipped.

A net, then a sieve You: capture any moment, no decisions Inbox raw, rough title Filing batch twice a week thought Mon thought Mon thought Tue thought Wed 4 items waiting Agent proposes name, home, tags You approve most yes, few fixes Filed in context Combine the jobs and both get skipped.
Fig 43 · Split Capture From Filing. Capture lands raw in the inbox any time; filing happens later in batches, agent-assisted.
Chapter 44 · Part V

Progressive Summarisation

Progressive summarisation is a technique, also associated with Tiago Forte, for distilling material in layers over time rather than all at once. On a first read, you save the source. When you return to it later, you highlight the passages that seem important. On a later return, you bold the most important parts of those highlights. Later still, you write a short summary in your own words at the top. Each pass compresses only what survived the previous one.

The clever part is the timing. You do not summarise everything as it arrives. Most captured material is never used again, and summarising it upfront would waste effort on things that turn out to be irrelevant. Instead, you add a layer of distillation only when you return to a note for some reason, because returning is evidence that the note is useful. Effort concentrates naturally on the material that has proved its worth.

This turns your collection into a gradient. Many notes are raw, captured and untouched. Some are highlighted, visited once and found worth marking. A few are bolded, visited repeatedly. A very few have a summary at the top, the distilled essence of something you keep coming back to. When you search, the layered notes are much faster to use, because you can skim the summary or the bold passages and know within seconds whether this is what you need.

Do not summarise everything once. Summarise the things that keep coming back.

The method has a weakness that its critics point out, and it is worth taking seriously. Highlighting and bolding other people's words is not the same as understanding them. A note with beautifully layered highlights can still be a note you have never thought about. The final layer, the summary in your own words, is where understanding happens, and it is the layer most often skipped. The highlights are scaffolding. The summary is the building.

AI has changed this technique more than almost any other in this part. A model can produce a summary of any document instantly, which seems to make the layering unnecessary. In one sense it does: you no longer need to highlight a long report just to remember its main points. But the machine's summary is generic. It tells you what the document says, not what it means to you. The valuable final layer is still the one only you can write: why this matters for your work, and what you will do differently because of it.

This week, pick three notes or documents you have returned to more than once recently. For each, add one layer of distillation you have not yet added: highlights if it is raw, bolding if it is highlighted, a summary in your own words if it is bolded. Keep the summary to three sentences. Next time you need one of them, notice how much faster you find what you need. Distil where you return. Leave the rest raw.

Distil only where you return Layer 0: raw source saved, untouched ~400 notes Layer 1: highlighted returned once ~60 notes Layer 2: bolded returned again ~15 notes Layer 3: own summary keeps coming back ~4 notes AI summary what it says: generic Yours: why it matters, what changes highlights are scaffolding the summary is the building Summarise the things that keep coming back.
Fig 44 · Progressive Summarisation. Each return visit adds one layer, so only the few notes you reuse get a summary.
Chapter 45 · Part V

Quote With Context

A saved quote without its surrounding argument becomes a misquote within a year. You remember the striking sentence but not the sentence before it, which qualified it, or the one after, which reversed it. You remember that someone said it but not whether they were stating their own view or describing a view they went on to demolish. The quote survives. The meaning does not.

This is one of the most common ways that personal knowledge collections mislead their owners. A highlight captured from an article or a book looks authoritative in your notes. It is in the author's own words, after all. But words lifted from an argument carry only part of the argument, and the missing part is often the part that mattered. Most projects fail because of unclear goals reads very differently when the full sentence was it is often claimed that most projects fail because of unclear goals, but the evidence for this is thin.

The fix is a simple habit at the moment of capture. When you save a quotation or a claim, save three things alongside it. The claim itself, in its original words. The reason or evidence the author gave for it, briefly. And enough frame to reconstruct the context: who said it, where, when, and whether they were arguing for it or against it. A sentence of context is usually enough. It costs a few seconds and preserves the meaning for years.

A quote is a fragment of an argument. Keep enough of the argument to know which fragment.

Context also includes provenance, the subject of Part Three, but goes a little further. Provenance tells you where a quote came from. Context tells you what it meant there. Both are needed if you are going to rely on the quote later, especially if you might repeat it to others. A misattributed or decontextualised quote, repeated confidently, damages your credibility far more than not quoting at all.

AI systems make this habit more valuable rather than less. When an assistant retrieves a fragment from your notes to answer a question, it sees only the fragment. If you saved a qualified claim without its qualification, the assistant will present it unqualified, with all the fluency and confidence models bring to everything. If you saved the context too, it can present the claim accurately. The model can only be as careful as your notes allow it to be.

This week, look back at the last ten quotes or highlights you saved. For each, ask whether you could explain, without reopening the source, what the author was arguing and why. For any you cannot, either go back to the source and add a line of context, or delete the quote. Then, from now on, never save a quote without a sentence of frame. Words travel. Meaning needs a passport.

Keep enough of the argument THE SAVED FRAGMENT “Most projects fail because of unclear goals.” WHAT THE AUTHOR WROTE “It is often claimed that most projects fail … but the evidence is thin.” CAPTURE THREE THINGS Claim original words most projects fail … Reason evidence given “the evidence is thin” Frame who, where, when author, essay, 2025 Stance for or against? arguing against An agent retrieves only the fragment: it will be as careful as your note allows Words travel. Meaning needs a passport.
Fig 45 · Quote With Context. A saved quote keeps its claim, reason, frame and stance, or it reverses its meaning.
Chapter 46 · Part V

Write Your Own Sentence

A highlight is the author's thinking. A sentence in your own words is yours. Only the second one becomes knowledge you can actually use later, because only the second one passed through your understanding on the way to the page. This is perhaps the most important single habit in personal knowledge management, and it is the one most often skipped, because highlighting is easy and writing is not.

The difference shows up when you return to your notes. A collection of highlights reads like a collection of other people's good ideas, which it is. You recognise them, you agree with them, and you are not quite sure what to do with them. A collection of your own sentences reads like a record of your thinking. Each one says what you understood, what you concluded and often what you planned to do about it. You can act on it directly.

Writing in your own words is also a test. If you cannot restate an idea simply, you have not understood it yet. The effort of finding your own words exposes gaps: the step in the argument you skimmed, the term you did not quite grasp, the example that did not really support the claim. Highlighting never exposes these gaps, because copying requires no understanding at all. This is why your own sentence is worth ten highlights.

Copying is storage. Rephrasing is understanding. Only one of them shows up when you need it.

The habit does not have to be elaborate. After reading something worthwhile, write one to three sentences at the top of your note answering a simple question: what is the point, and why does it matter to me? Not a summary of everything, just the core idea and its relevance. If you cannot write those sentences, that tells you something important. Perhaps the material was not worth saving, or perhaps you need to read it again.

AI tools tempt us to skip this step, because a model can paraphrase anything instantly. Ask it to summarise an article and it will produce clear sentences in plain language. But those sentences are the model's understanding, not yours. They may be accurate. They have not changed anything in your head. The research on learning, which Part Seven discusses, is clear that generating your own words is what builds memory and understanding. Delegating that step to a machine is like paying someone to go to the gym for you.

There is a sensible middle way. Let the machine summarise when you need to know what something says. Write your own sentence when you need to know what it means for you. The first is retrieval; the second is thinking. This week, for every item you save, write at least one sentence in your own words before filing it. Notice which items resist. Those are the ones you did not really understand. Your notes should sound like you. Otherwise they are someone else's notes that you happen to own.

Copying is storage, rephrasing understanding SOMEONE ELSE'S WORDS YOUR WORDS What it says retrieval What it means thinking Highlight / AI summary fast, exposes no gaps Plain restatement tests if you understood Borrowed conclusion someone else's “so what” Your sentence the point, and why it matters Let the machine say what it says; write what it means for you, 1–3 sentences Your notes should sound like you.
Fig 46 · Write Your Own Sentence. Highlights and AI summaries record what a text says; your sentence, what it means.
Chapter 47 · Part V

Capture the Question

When you look something up, save the question that made you look, not just the answer you found. Answers go stale: prices change, policies update, software gets new versions, facts are revised. Questions age far better. A good question, saved alongside its answer, lets you regenerate the search when the answer changes and reminds you why you cared in the first place.

Consider a typical note: Visa processing takes about six weeks. A year later you find it. Is it still true? Six weeks for what kind of visa, for which country, as of when? Why did you need to know? The answer alone is close to useless, because you cannot judge whether it still applies. Now consider the same note with its question: How long does a work visa for the UK take to process, for a contractor starting in March? Answer as of October: about six weeks, per the official guidance page. You can immediately see whether the question still applies to you, and if it does, you know exactly what to search for to get a current answer.

Questions also reveal patterns that answers hide. If you save the questions you look up, you will notice the same ones recurring. Recurring questions are a signal that you need a permanent reference: a wiki page, a checklist, a note you keep updated. Answers scattered across notes conceal this pattern. Questions make it obvious.

Answers expire. Questions keep. Save both, and lead with the question.

This habit also improves the quality of your thinking. Writing down the question forces you to clarify what you are actually trying to find out. Many unproductive searches start with a vague sense of curiosity and end with a pile of loosely related pages. A precise question at the start leads to a precise answer, or at least a precise understanding of why the answer is not available.

Questions are particularly valuable when you work with AI assistants. The quality of an assistant's answer depends heavily on the quality of the question you ask. If you save your good questions, the ones that produced useful answers, you build a personal library of prompts that work. When the answer needs refreshing, you can ask the same question again and compare. When a colleague faces a similar problem, you can share the question as well as the answer, and they get the reasoning, not just the conclusion.

This week, adopt a simple format for any note that records something you looked up. Start with the question, in one line, marked clearly. Then the answer, with its source and the date. Do this for every lookup worth keeping. At the end of the week, read through the questions and look for any that appear more than once. Turn the most frequent one into a permanent reference. Answers are what you know today. Questions are how you find out tomorrow.

Answers expire, questions keep Q UK work visa: how long for a contractor starting in March? A About six weeks src official guidance page as of 2026-10 answer alone: “six weeks” for what? when? why? Question saved, kept Search ask again Answer dated, sourced Goes stale prices, policies SEEN TWICE? MAKE IT PERMANENT Recurring question Wiki page or checklist Prompt library questions that worked Save both, and lead with the question.
Fig 47 · Capture the Question. A note led by its question can be re-asked when the answer goes stale.
Chapter 48 · Part V

Intake Rate Limits

You can only process what you can review. If you save articles faster than you read them, bookmark pages faster than you revisit them, or record meetings faster than you act on them, you are not building a library. You are building a debt, and like most debts, it compounds quietly until it becomes oppressive.

The symptoms are familiar. A read-later list with hundreds of unread articles, each saved with good intentions. A notes inbox that has not been processed in months. A folder of downloaded reports, papers and slide decks with titles you no longer recognise. A podcast queue measured in days. Each item was saved because it seemed valuable, and many of them probably were. Together they are a weight that makes you less likely to engage with any of them.

The principle is to match your intake to your processing capacity. If you can genuinely read and process five articles a week, saving fifty is not ambitious; it is self-deception. The extra forty-five are not knowledge in waiting. They are noise that makes the five harder to find. A smaller intake, chosen more carefully, gives you more knowledge, not less, because you actually process what you take in.

If you save faster than you read, you are not collecting. You are accruing.

There are practical ways to impose a limit. Cap your read-later list at a fixed number of items, and when it is full, you must read or delete something before saving anything new. Unsubscribe from sources that consistently send more than you process. Set an expiry rule: anything unread after a month is deleted automatically, on the reasonable assumption that if it mattered, you would have read it. None of these is comfortable at first, because each requires admitting that you will not read everything. That admission is the beginning of a working system.

AI tools both help and hurt here. They help because a model can triage a backlog quickly, summarising each saved item in a sentence so you can decide which deserve a full read. They hurt because they make capture so cheap that intake can explode. Automatic meeting notes, auto-saved research, AI-generated summaries of everything you skim: each adds to the pile. An automated intake with no automated limit is a firehose pointed at your inbox. Use machines to process more, not merely to collect more.

This week, count your backlog. How many unread items in your read-later list, unprocessed notes in your inbox, unwatched videos in your queue? Then estimate how many you genuinely process in a typical week. Divide the first number by the second. That is how many weeks of debt you carry. If it is more than four, declare bankruptcy on the oldest portion: archive or delete everything older than a month, and set a cap going forward. Intake is easy. Attention is the bottleneck.

Intake is easy, attention the bottleneck Intake 50 saves / week Backlog 300 items the debt Processed 5 / week Weeks of debt 300 ÷ 5 = 60 weeks over 4: declare bankruptcy LIMITS THAT CLOSE THE TAP Cap the list read or delete first Unsubscribe sources you never read Expire unread after a month AI triage one-line summary each Save faster than you read and you are not collecting, you are accruing. use machines to process more, not merely to collect more
Fig 48 · Intake Rate Limits. Fifty saves in and five processed out leaves a backlog that only limits can drain.
Chapter 49 · Part V

The Source Ledger

Keep one list of every source you regularly draw from, whether newsletters, feeds, podcasts, colleagues, websites or channels, and rate each by how often it actually earned its place. Most people follow dozens of sources and genuinely use a handful. The ledger makes this visible, and visibility is usually enough to change behaviour.

A source ledger is simple. A note or a spreadsheet with one row per source. A column for what kind of source it is, a column for how often it delivers, and a column for how often something from it ended up in your notes, your work or a decision. You do not need precise numbers. A rough rating of often, sometimes or rarely is plenty. The aim is not measurement; it is honesty.

When people build their first ledger, they almost always discover the same pattern. A small number of sources produce most of the useful material. A large middle group produces occasional value. And a long tail contributes nothing except volume, items that are skimmed, saved and forgotten. The tail is often the bulk of the intake. Cutting it costs almost nothing in value and frees a remarkable amount of attention.

The question is not whether a source is good. It is whether it is good for you, often enough to deserve your attention.

The ledger also helps with trust. When a source produces something you rely on, note it. When a source produces something that turns out to be wrong, note that too. Over time, you build a rough sense of reliability for each source, which is exactly what you need when deciding how much weight to give a new claim. Provenance, discussed in Part Three, tells you where a fact came from. The ledger tells you how much that origin is worth.

This habit has become more important as the volume of generated content grows. Many sources now publish material that is partly or wholly produced by AI, of varying quality. Some of it is excellent; much of it is fluent filler. A source ledger lets you track which sources consistently provide original, reliable material and which have drifted into volume for its own sake. The judgement is yours, but the ledger gives it something to stand on.

This week, start your ledger. List every source you follow regularly: subscriptions, feeds, channels, the colleagues you ask. Rate each one honestly on how often it produced something you actually used in the last three months. Unsubscribe from at least three of the lowest-rated, without guilt. Put a reminder in your calendar to review the ledger every quarter. Notice how much lighter your intake feels. Sources are not obligations. They are employees, and some of them have not done any work for months.

Sources are employees SOURCE KIND DELIVERS USED TRUST Ana (colleague) person weekly often reliable Industry newsletter email weekly often reliable Research feed feed daily sometimes mixed Trade podcast audio weekly rarely mixed Viral roundup email daily rarely filler AI news digest site hourly never unknown A FEW SOURCES DO MOST OF THE WORK; THE LONG TAIL IS MOSTLY VOLUME Quarterly review unsubscribe from the bottom three Some have not done any work for months.
Fig 49 · The Source Ledger. A ledger rates each source by how often it was used; the long tail gets cut.
Chapter 50 · Part V

Capture as Commitment

Saving something is a promise to your future self. Every bookmark says I will read this. Every saved note says I will use this. Every recorded meeting says I will act on what was said. Make these promises deliberately, or you will inherit a hundred obligations you never really agreed to, and the weight of them will make you less likely to keep any.

Most people do not think of capture this way. Saving feels like the opposite of a commitment: a way of deferring a decision, keeping options open, avoiding the risk of losing something. But each saved item creates an implicit obligation. It sits in your system, waiting to be processed, read or acted upon. It appears in searches. It takes up attention whenever you scan the folder. Unprocessed captures are not neutral; they are small, accumulated guilts.

The shift is to capture with intention. Before saving something, ask briefly what you intend to do with it. Read it this week? Use it in a specific project? Reference it when a particular situation arises? If you can name an intention, save it with that intention attached, perhaps as a short note or tag. If you cannot name one, ask whether it is worth saving at all. Often the honest answer is no, and letting it go is a relief.

Every save is a small promise. Do not make promises you have no plan to keep.

This does not contradict the principle that capture beats curation. That principle is about not losing ideas and insights from your own thinking, the things only you can notice. This one is about the vast stream of external material that arrives constantly: articles, links, documents, recordings. Your own thoughts deserve generous capture. Other people's content deserves deliberate selection. Treating the two the same way is how inboxes overflow.

Intention also makes processing easier. When you review your inbox, an item saved with a stated intention is quick to handle: either fulfil the intention, move it to where it will be used, or acknowledge that the intention has lapsed and delete it. An item saved without intention requires you to reconstruct why you wanted it in the first place, which is slow and often impossible. Intentions are metadata for the future.

This applies with special force to AI-generated captures. Meeting assistants that record and summarise every call, research tools that save every source they consult, agents that produce reports nobody asked to see: each generates a stream of saved material with no human intention behind it. Decide in advance what you will do with these outputs, and configure the tools accordingly, or they will fill your system with commitments made by machines on your behalf. This week, for every item you save, add one word or phrase stating your intention. A library is a set of promises. Keep only the ones you mean.

Every save is a small promise About to save link, doc, recording Your own thought? yes Capture freely only you noticed it no: external stream Can you name an intention? yes Save + intention tag it no Let it go often a relief INTENTION TAGS read:this-week use:project-x ref:when-renewing Configure meeting bots and research agents too: no machine-made promises Keep only the promises you mean.
Fig 50 · Capture as Commitment. Before saving external material, name an intention for it or let it go.
Part VI

Finding Things

Search, browsing and the moment of need.

Chapter 51 · Part VI

Search Is a Skill

Most people search the way they knock on a door: two words, a pause, and if nobody answers, they go away. Search boxes reward this behaviour just often enough to keep it alive. But search is a skill, and a modest amount of practice turns a dumb index into a genuinely precise instrument. The tools you already use almost certainly support more than you ask of them.

Start with the basic operators, which work in some form in most search engines, email clients, document systems and file browsers. Quotation marks around a phrase find that exact phrase rather than the words scattered anywhere. A minus sign before a word excludes results containing it, which is invaluable when a common word drowns out what you want. Many systems also support field filters, such as searching only in titles, only from a certain sender or only files of a certain type. And most support date bounds, restricting results to a period you specify.

Combine these and searches change character. Instead of typing budget into your email and scrolling through hundreds of results, you search for the exact phrase revised budget, from a particular person, with an attachment, in the last three months. Instead of searching your drive for contract, you search titles only, for files of one type, excluding the word template. Each refinement takes a second to type and removes a large pile of irrelevant results.

Two words and hope is not a search strategy. It is a wish with a cursor.

The other half of the skill is knowing what words the thing you want actually contains. This is where the earlier parts of this book pay off. If you name files consistently, use a controlled vocabulary for tags and put dates in filenames, your searches become predictable, because you know the exact terms to look for. Search skill and organising discipline reinforce each other: the better your naming, the less clever your searching needs to be, and vice versa.

AI-powered search tools have changed the experience somewhat. Many now accept questions in plain language, what did we decide about the supplier in September?, and interpret them sensibly. This is genuinely useful, especially when you do not know the exact words. But it can also hide imprecision. A natural-language search returns a confident, plausible set of results whether or not they are the right ones. When accuracy matters, fall back on exact phrases and filters, which return precisely what you asked for or tell you plainly that nothing matched.

This week, learn the search syntax of the tool you search most often, probably your email or your document system. Find its help page on search operators and try each one once. Then, the next time a search returns too many results, refine it with a phrase, an exclusion or a date range instead of scrolling. Notice how often the right result rises to the top. The index was always that clever. You just had not asked it properly.

One search, refined four times Typed: budget budget hundreds of hits Exact phrase "revised budget" words together, in order Field filter: sender from:finance only one person Has an attachment has:attachment drops the chatter Date bound after:2026-07-01 last three months The right email One second per refinement.
Fig 51 · Search Is a Skill. Each operator strips away a pile of results until the right email rises to the top.
Chapter 52 · Part VI

The Inverted Index

Every fast search engine, from the one in your email client to the ones that index the web, works on a single trick. Instead of asking what words are in this document?, it asks which documents contain this word? This inversion, building a list of words, each pointing to the documents that contain it, is called an inverted index. Once you understand it, most of the behaviour of search engines, including their strange failures, makes sense.

Imagine searching a thousand documents for the word invoice without an index. You would have to open every document and scan every word, which is slow. With an inverted index, the system has already done that work once, in advance. It has a list: invoice appears in documents 12, 87, 341 and 902. Searching is now just a lookup. Searching for two words means fetching two lists and finding the documents that appear in both. This is why search feels instant even across enormous collections.

The inversion also explains search's characteristic failures. An inverted index finds words, exactly as they were indexed. If you search for invoice and the document says bill, it is not found. If the document is a scanned image with no recognised text, it contains no words as far as the index is concerned, and is invisible. If the document was saved after the index last updated, it is missing. If the word was misspelled, it is filed under the misspelling. The index does not understand meaning. It matches strings.

A search engine does not look through your documents. It looks through a list it made earlier.

This has practical consequences for how you write and store things. Use the words people will search for, especially in titles and the first few lines, which many systems weight more heavily. Make sure scanned documents are run through text recognition so their contents become searchable. Use the controlled vocabulary from Part Two so that the same concept is always indexed under the same word. And if a search fails for something you know exists, suspect the index first: wrong word, missing text, not yet indexed.

AI search systems often add a second kind of index alongside the inverted one, an index of meanings rather than words, which the next chapter explains. But the inverted index has not gone away. It remains the fastest, most precise way to find exact terms, codes, names and phrases, and many AI-powered tools still use it under the bonnet when you search for something specific. Understanding it is understanding the foundation everything else is built on.

This week, test your main search tool's limits. Search for a document you know exists using a synonym rather than the word it contains, and see whether it is found. Search for text inside a scanned PDF. Search for a file you created five minutes ago. Each test tells you something about how your index works and where it fails. Knowing the failure modes is half the skill. The other half is naming things so they never meet them.

Which documents contain this word? Documents Doc 12 invoice, Acme Doc 87 invoice, May Doc 341 bill, invoice Doc 902 scan, no text once Inverted index word documents acme 12 bill 341 invoice 12, 87, 341 may 87 You search invoice Instant answer 3 documents a lookup, not a scan Why a search misses Synonym doc says bill Scanned image no text to index Too new newer than index Misspelled filed under typo It looks through a list it made earlier, matching strings, not meaning.
Fig 52 · The Inverted Index. Each word points to the documents that contain it, so search becomes a lookup.
Chapter 53 · Part VI

Keyword Versus Semantic

Keyword search finds exact strings. Semantic search finds nearby meanings. Each fails precisely where the other works, which is why serious retrieval systems now run both and merge the results. Understanding the difference helps you choose the right search for the right question, and explains why your AI assistant sometimes finds the perfect document and sometimes misses something obvious.

Keyword search is the inverted index from the previous chapter. It is precise, predictable and fast. Search for an invoice number, a person's name, an error code or a product SKU, and keyword search will find every document containing exactly that string, and nothing else. Its weakness is that it knows nothing about meaning. Car does not find automobile. Cancel my subscription does not find a document titled ending your membership.

Semantic search works differently. It converts text into a mathematical representation of meaning, usually called an embedding, which Part Nine explains in more detail. Documents with similar meanings end up with similar representations, so a search for cancel my subscription finds the document about ending your membership, because the meanings are close even though the words differ. Its weakness is the mirror image of keyword search: it is fuzzy where you need precision. Search for an invoice number and it may return other invoices that look similar, which is exactly what you did not want.

Keywords find what you said. Semantics find what you meant. Most questions need a bit of both.

The practical lesson is to match the search to the question. When you know the exact term, a name, a code, a specific phrase, keyword search is better, and you should use exact-match operators to force it. When you know the idea but not the words, or you want to find related material you did not know existed, semantic search is better. Many tools now blend the two automatically, a technique usually called hybrid search, which returns results that match either way and ranks them together.

This also explains a common frustration with AI assistants. Ask one to find the contract with Acme and it may return documents about contracts in general, or about a similar company, because its retrieval is leaning on meaning rather than the exact name. Ask instead for documents containing the exact word Acme and you will often get a better result. Knowing which mode you need and saying so explicitly is a small skill with large returns.

This week, try a deliberate experiment. Take one question you would normally search for and run it twice: once as exact keywords with quotation marks, once as a plain-language question in whatever AI-powered search you have access to. Compare the results. Notice which kinds of question each handles better. Then make a habit of choosing consciously. Precision and recall are not enemies. They just speak different languages.

Exact strings, nearby meanings Keyword inverted index invoice numbers names, codes error codes, SKUs Misses: car vs automobile Semantic embeddings ideas, not words cancel my plan ending membership Misses: exact invoice number Hybrid both, merged Keywords find what you said. Semantics find what you meant.
Fig 53 · Keyword Versus Semantic. Keyword and semantic search fail in opposite places; hybrid search runs both.
Chapter 54 · Part VI

Recall Versus Precision

Every search balances two goals that pull against each other. Recall is the share of relevant items that the search finds: did it get everything that matters? Precision is the share of found items that are actually relevant: is everything it returned worth looking at? You cannot maximise both at once, and pretending otherwise is how search interfaces disappoint everybody.

Consider what happens at the extremes. A search that returns your entire collection has perfect recall: every relevant item is in there somewhere. It has terrible precision: almost everything returned is irrelevant. A search that returns a single, perfectly relevant item has perfect precision and, very likely, poor recall: there were probably other relevant items it missed. Every real search sits somewhere between, and moving towards one goal moves you away from the other.

The right balance depends on the question. A lawyer searching for every document relevant to a case needs high recall, because missing a single document could be disastrous, and is willing to wade through irrelevant results to get it. Someone looking for a quick answer to a simple question needs high precision, because they will read only the top few results and want them to be right. Most everyday searches lean towards precision. Audits, investigations and research lean towards recall.

Do you want everything relevant, or only things that are relevant? Decide before you search.

Knowing which you need changes how you search. For high recall, use broad terms, synonyms, few filters and semantic search, and accept that you will need to scan many results. For high precision, use exact phrases, specific filters and tight date ranges, and accept that you might miss something. If a high-precision search returns nothing, broaden it step by step. If a high-recall search returns too much, add one filter at a time.

AI systems face this trade-off constantly, and it explains some of their failures. When a retrieval system fetches documents to answer your question, it typically retrieves a limited number of chunks. If it retrieves too few, it may miss the crucial passage, a recall failure, and answer confidently without it. If it retrieves too many, irrelevant passages may crowd out the important ones, a precision failure, and the answer becomes muddled. When an AI answer seems wrong, it is worth asking which kind of failure occurred. Part Nine returns to this.

This week, before your next important search, ask yourself which matters more: finding everything, or finding only the right things. Then search accordingly. If you need recall, write down two or three synonyms and search for each. If you need precision, add one filter you would normally skip. Notice whether you find what you need faster. The search box cannot read your mind. It can read your intentions, if you state them.

Decide before you search Recall: did it find everything relevant? Precision: is all of it relevant? One perfect hit missed the others Quick answers exact phrase, filters The ideal rarely reachable Trade one to gain the other A vague guess little, mostly noise The whole collection everything, mostly noise Audits, lawsuits synonyms, broad terms broaden Too few results: broaden step by step. Too many: add one filter.
Fig 54 · Recall Versus Precision. Recall and precision pull against each other; the question decides which to favour.
Chapter 55 · Part VI

Ranking Is Editorial

When a search returns results, the order in which they appear is a set of value judgements dressed up as an algorithm. Should newer results rank above older ones? Should documents from senior people rank above those from juniors? Should popular pages rank above obscure ones? Should exact matches in the title beat exact matches in the body? Every ranking system answers these questions, and the answers shape what you see. You can choose them deliberately or inherit somebody else's taste.

Most people never think about ranking. They see the first few results and assume those are the best. But the system had to decide what best means, and it decided using signals that may or may not match your intentions. Recency is a common signal, which is helpful when you want the latest version and unhelpful when you want the foundational document from three years ago. Popularity is another, which favours what many people looked at, not necessarily what is correct. Authority, based on who wrote something or how many things link to it, favours established voices over new ones.

In personal and team systems, you often have more control over ranking than you realise. Many tools let you sort by date, relevance, title or modification time. Some let you pin important documents to the top of search results or mark them as official. Wikis can designate canonical pages. Even when the ranking algorithm is fixed, you can influence it: a document with the key terms in its title and first paragraph will usually rank higher than one with those terms buried on page six.

Every ranked list is an opinion about what matters. Make sure the opinion is one you would sign.

AI assistants add another layer of ranking, often invisible. When a system retrieves documents to answer a question, it ranks them and uses only the top few. When it then writes an answer, it decides which retrieved passages to emphasise. Both steps are editorial. If the system favours recent documents, old but authoritative policies may be ignored. If it favours documents that closely match your wording, a perfectly relevant document using different terms may be overlooked. Understanding this helps you phrase questions and structure documents to surface what matters.

The deliberate choice often comes down to making authority explicit. If one document is the official policy, say so in its title, its metadata and its status field. If a page has been superseded, mark it clearly so that ranking systems and readers alike can demote it. Ranking systems are only as good as the signals they receive, and the most reliable signals are the ones you set intentionally.

This week, run a search you do often and look critically at the order of the results. Ask what signal put the top result first. Is that the signal you would choose? If not, see whether you can change the sort order, pin the right document, or rename it so it ranks better. Algorithms are not neutral. They are just quiet about their opinions.

Every ranked list is an opinion Query supplier policy Matches 40 candidates Ranker whose taste? You see 1 newest draft 2 popular page 3 old policy top few only Recency newer first Popularity most viewed Authority who wrote it Match place title beats body Your levers Sort order date or title Pin it mark official Title terms first paragraph Demote old mark superseded Signals you set on purpose are the ones ranking can trust.
Fig 55 · Ranking Is Editorial. Recency, popularity, authority and match place decide order; set the signals yourself.
Chapter 56 · Part VI

Browsing Still Wins

Search requires you to know what you are looking for, or at least the words for it. Browsing does not. Wandering along a well-ordered shelf, scanning a well-organised folder or flicking through a curated index lets you find the thing you could never have named. A surprising amount of real discovery happens this way, and no search box, however clever, fully replaces it.

Think of the times you have found something valuable without looking for it. The book next to the one you came for. The document in the project folder that turned out to answer a question you had not yet asked. The old note that sparked a new idea because you happened to see its title. None of these would have appeared in a search, because you did not know to search for them. They appeared because something placed them near what you were already looking at.

This is why the structural chapters of this book still matter in an age of powerful search. Good structure makes browsing productive. A shallow folder with well-named files invites scanning. A map of content invites exploration. A wiki whose home page is organised around real questions invites newcomers to discover what they did not know to ask about. Poor structure, by contrast, makes browsing pointless: a folder of untitled files or a wiki organised alphabetically offers nothing to the wandering eye.

Search answers the question you asked. Browsing answers the question you did not know you had.

Browsing is also how people learn the shape of a body of knowledge. A new team member who browses the wiki for an hour comes away with a sense of what exists, what matters and who knows what, even if they cannot recall specific pages. That sense, a mental map, is what lets them later search effectively, because they know roughly what is there. Search without that map is like asking directions in a city you have never seen.

AI has made search far more powerful, and some people conclude that structure no longer matters, because a model can find anything. But a model finds only what you ask about. It does not, unprompted, show you the adjacent document that changes your thinking. Some tools are beginning to offer suggestions of related material, which is a form of machine browsing, and these can be genuinely useful. They work best on collections that are already well structured, because they borrow that structure to decide what counts as related.

This week, spend fifteen minutes browsing instead of searching. Open a shared folder, wiki or notes collection you use regularly and simply look around, without a specific goal. Read titles. Open anything that catches your eye. Note anything useful you did not know was there, and anything that made browsing difficult: vague names, deep nesting, missing descriptions. Fix one of those obstacles. You will find something. You always do. That is why shelves were invented.

Two ways into a collection A need arises Know the words? yes / no yes no Search it the question you asked Browse the shelf scan titles, wander The thing you named precise, narrow The thing next to it never searchable mental map makes search better Browsing needs: shallow folders, clear names, a map of content, question-led home pages Browsing answers the question you did not know you had.
Fig 56 · Browsing Still Wins. Search finds what you can name; browsing a good structure finds what sits beside it.
Chapter 57 · Part VI

Serendipity by Design

A collection you never revisit is a dead archive. A collection that occasionally shows you something you had forgotten is a living one. The difference is serendipity, and it does not have to be left to chance. Random resurfacing, deliberately designed into your routine, turns old material into new thinking at almost no cost.

The simplest version is a random note each morning. Many notes apps have a feature that opens a random note, or you can build one with a short script or an AI agent. Read it with fresh eyes. Sometimes it is irrelevant and you move on. Sometimes it connects unexpectedly with something you are working on today, and a new idea emerges from the collision. Occasionally it is something you badly needed and had completely forgotten.

This works because memory and attention are biased towards the recent. The note you wrote last week is easy to recall; the one from three years ago is not, even if it is more relevant to today's problem. Random resurfacing corrects this bias by giving old material the same chance of being seen as new. It is particularly effective in collections built with the slip-box or atomic note principles from Part Four, where each note stands alone and can be read in isolation.

A random note each morning beats a recommendation engine you were never going to build.

There are more structured versions too. Some people review notes from the same week in previous years, which surfaces seasonal patterns and reminds them of past plans. Others set a weekly review that includes one note chosen at random from each major area. Spaced repetition systems, which Part Seven discusses, are a highly structured form of resurfacing designed for memory rather than discovery. The method matters less than the habit of letting the past back into the present.

AI agents are well suited to designed serendipity, and better than pure randomness in some ways. You can ask an assistant to find three old notes related to the project you are working on today, or to surface something from your archive that contradicts your current plan. This is semantic resurfacing: not random, but not driven by any search you would have thought to run. It combines the surprise of serendipity with a degree of relevance that pure chance cannot provide. Used occasionally, it can feel like having a well-read colleague who remembers everything you ever wrote.

This week, set up one form of resurfacing. The simplest is a daily reminder to open one random note from your collection and read it for a minute. If your tool cannot do this, ask an AI assistant to pick one for you, or sort your notes by creation date and open one from a random year. Do it for a week. Note any idea that comes from it. Serendipity is not luck. It is a shelf you visit on purpose.

A shelf you visit on purpose Collection old notes, any year Resurface one random note Collide meets today's work New note born of the collision corrects the recency bias Methods random note daily this week, past years AI: related to today A random note each morning beats the engine you never built.
Fig 57 · Serendipity by Design. Resurfacing old notes lets them collide with current work and produce new ones.
Chapter 58 · Part VI

The Zero-Results Log

The searches that fail are your gap map. Every time someone searches your collection and finds nothing, they are telling you something precise: either the collection lacks something it should have, or it has it under words nobody would think to search for. Log these failures and you learn exactly what is missing and exactly where your vocabulary went wrong. Ignore them and the same failures repeat, quietly, for ever.

Websites and large libraries have long tracked failed searches for this reason. A spike in searches for a term that returns nothing tells a site owner what content to create. A recurring failed search for a synonym tells them what word to add to their index. The same principle works at the scale of a team or a single person, and it costs almost nothing to apply.

For a personal system, the log can be a simple note. Whenever you search for something and cannot find it, write down what you searched for and, if you eventually found it, where it actually was and what it was called. After a few weeks, look at the log. You will see patterns. Some failures are naming problems: you searched for expenses and the file was called claims. Some are gaps: you searched for something that genuinely does not exist and needs writing. Some are indexing problems: the thing existed, but in a format search could not read.

Every failed search is a free consultation from your future self.

For a team, the zero-results log is even more valuable. If your wiki or document system has search analytics, look at the most frequent searches that return nothing or are immediately followed by another search. These are the questions your team cannot answer from its own knowledge base. Each one is a page waiting to be written, or a page that exists but needs a better title. Many teams also use a channel where people ask questions; the questions asked there because search failed are another version of the same log.

AI assistants add a new source of failure data. When an assistant says it could not find information on a topic, or gives a vague answer because retrieval returned nothing useful, that is a zero-result. Some systems log these automatically; if yours does not, you can ask the agent to note any question it could not answer from your documents. Over time, this produces an excellent list of gaps, ranked by how often they came up.

This week, start a zero-results log. Keep a note open, and every time a search fails, in your files, your notes, your wiki or your AI assistant, add a line: what you searched for, and what you eventually found, if anything. At the end of the week, read the log and fix the top three: rename a file, add a synonym to your vocabulary, or write a missing page. Your collection is telling you what it needs. It speaks in failed searches.

Failed searches are a gap map Your searches files, notes Wiki analytics no-hit queries Help channel asked, not found AI assistant could not find Zero-results log searched for / found where read it weekly fix the top three Naming problem expenses vs claims Rename it or add a synonym A genuine gap never written Write the page ranked by demand Indexing problem unreadable format Make it readable text recognition Every failed search is a free consultation from your future self.
Fig 58 · The Zero-Results Log. Failed searches from every source go into one log, then get sorted into three fixes.
Chapter 59 · Part VI

Chunking for Retrieval

How you cut a document decides what can be found in it. This matters more now than it ever did, because AI retrieval systems do not usually read whole documents. They split documents into pieces, called chunks, find the chunks most relevant to a question and hand those to the model. If the chunks are cut badly, retrieval returns fragments that answer nothing and mislead extremely confidently.

The simplest chunking method is to cut every so many words or characters, regardless of content. It is easy to implement and widely used, and it has an obvious flaw. Fixed-size cuts slice through sentences, separate a heading from its section, and split an argument from its conclusion. A chunk might contain the first half of a list of conditions and none of the second half. Retrieved alone, that chunk tells the model something that is true in the original but false on its own.

Better chunking follows the structure of the document: split on headings, sections, paragraphs and other logical units, so that each chunk is a coherent piece of meaning. Many systems also add a small overlap between chunks, repeating a sentence or two at each boundary, so that context is not lost at the seams. Some prepend the document's title and section heading to each chunk, so that a retrieved fragment carries a reminder of where it came from.

Cut on meaning, not on length. A chunk should answer something, not merely contain words.

You do not need to build a retrieval system for this to matter to you. If you write documents that AI tools will search, and increasingly that means most documents, you can write them to chunk well. Use clear headings that say what each section is about. Keep each section focused on one thing. Make each section understandable on its own, which is the granularity principle from Part Two applied at the level of the section. Avoid as mentioned above and see below, which point to context a retrieved chunk will not have. Put the key point near the start of each section, where it is most likely to survive any cut.

These habits also make documents better for human readers, which is no coincidence. People skim, jump between sections and read out of order, just as retrieval systems do. A document that chunks well for a machine is usually one that scans well for a person. Writing for retrieval is not a new discipline. It is good technical writing, given a sudden and urgent reason to matter.

This week, take one important reference document you own, a policy, a process guide, a product description, and read it section by section, asking whether each section would make sense if it were the only part someone saw. Fix the ones that would not: add a heading, restate the subject, replace a backward reference with the actual information. The document will be no longer and much more findable. Every section is a doorway. Make sure each one opens onto a room.

Cut on meaning, not on length Before: every 500 characters After: split on headings ...staff accrue leave monthly. ## Carry-over Up to 5 days carry over if: (a) a manager approves, and (b) used by 31 March. ## Sick leave. Staff who... [Leave > Accrual] Staff accrue leave monthly. [Leave > Carry-over] Up to 5 days if (a) approved and (b) used by 31 March. [Leave > Sick leave] Staff who are unwell... heading orphaned, rule cut in half title prepended, small overlap Write sections that chunk well Clear heading says the topic One idea per section Stands alone no "see above" Point first survives a cut Chunk 2 on the left is true in the document and false on its own.
Fig 59 · Chunking for Retrieval. Fixed-size cuts split rules mid-sentence; heading-based chunks each stand alone.
Chapter 60 · Part VI

Retrieval Is the Product

Nobody ever experiences your taxonomy. Nobody admires your folder structure, your tag vocabulary or your frontmatter schema. What people experience is a single moment: they needed something, and they either got it or they did not. Every design choice in a knowledge system should be judged at that moment, and only at that moment.

This is easy to forget, because the parts of a knowledge system you spend time on are the ones nobody else sees. You design folder structures, debate naming conventions, curate tags and write READMEs. These are means. The end is retrieval: the right information, reaching the right person, quickly enough to be useful. A beautiful system that fails at retrieval has failed. A scruffy system that succeeds at retrieval has succeeded.

Judging by retrieval clarifies many decisions. Should you spend an hour reorganising your folders? Only if it will make finding things measurably easier. Should you add a new metadata field? Only if someone will use it to find something. Should you write a long, thorough document or a short, focused one? Whichever is more likely to give a reader what they need when they arrive with a question. Every organising choice becomes a hypothesis about retrieval, and hypotheses can be tested.

The catalogue is not the library. The moment someone finds what they needed is the library.

The test is simple. Pick a realistic question someone might bring to your collection. Time how long it takes to find the answer, and note where you hesitated. Did you know where to look? Did the names make sense? Was the answer current? Was it clear that this was the authoritative version? Each hesitation is a design flaw, and fixing the flaws you encounter in real retrieval is far more valuable than fixing the ones you imagine in the abstract.

AI makes this principle sharper, because AI assistants now perform a growing share of retrieval on your behalf. When a colleague asks an agent a question about your team's work, the quality of the answer depends on everything this book has discussed: names, metadata, structure, chunking, currency, canonical homes. The agent is the front desk, and your knowledge system is the library behind it. If the library is badly organised, the front desk will give bad answers, politely and at speed. Retrieval quality is no longer a private concern. It is the quality of every answer your tools give about your work.

This week, run five retrieval tests on your main collection, using questions you or your team genuinely ask. For each, time the search and note every hesitation. Then fix the biggest hesitation you found. Repeat the tests next month. This is the most honest measure of a knowledge system there is, and the only one that matters to the people using it. Organising is the work. Finding is the point.

What people experience, and what holds it up The moment of need found it, or did not Front desk search box, AI agent Names files and titles Metadata status, dates, tags Structure folders, wiki, home Chunking sections stand alone Currency current and canonical shaded: the work nobody sees The retrieval test 1 Pick a real question 2 Time the search 3 Note each hesitation knew where to look? names made sense? answer was current? clearly authoritative? 4 Fix the biggest one 5 Repeat next month hesitation = design flaw The catalogue is not the library. The moment of finding is.
Fig 60 · Retrieval Is the Product. Every hidden layer is judged at one moment: did the person find what they needed.
Part VII

Memory and Recall

What belongs in your head, and what does not.

Chapter 61 · Part VII

The Forgetting Curve

In 1885 the German psychologist Hermann Ebbinghaus published the results of a long, lonely and rather heroic experiment. He memorised lists of nonsense syllables, then tested himself at intervals to see how much he retained. The result, now called the forgetting curve, showed that memory decays steeply at first and then more slowly: much of what you learn is lost within days unless you review it, and what remains fades gradually after that. Nothing invented since has managed to repeal it.

The precise shape of the curve varies with the material and the person. Meaningful information is retained better than nonsense syllables, and things you care about stick better than things you do not. But the general pattern holds remarkably well across more than a century of research. Without review, forgetting is fast and largely invisible. You do not notice yourself forgetting; you simply find, weeks later, that something you once knew is no longer there.

This has an obvious implication for anyone building a knowledge system. Your external notes do not forget, but you do. If the only copy of an important idea is in your head, the forgetting curve will take most of it. If it is in your notes but you never review them, you will forget that it exists, which is almost as bad. The curve is the reason external memory matters, and it is also the reason external memory alone is not enough.

Forgetting is not a malfunction. It is the default setting, and it has been since 1885 at least.

The good news in Ebbinghaus's work is that review changes the curve. Each time you revisit something, the subsequent rate of forgetting slows. Material reviewed several times, at increasing intervals, can be retained for a very long time. This finding is the basis of spaced repetition, which the next chapter discusses, and of the weekly review habit later in this part. The curve is not a sentence. It is a schedule.

AI tools offer a tempting shortcut: why remember anything, when you can ask a machine? For many facts, this is entirely sensible, and the last chapter of this part argues for offloading facts freely. But you cannot ask good questions about things you have entirely forgotten, and you cannot recognise a wrong answer if you have no memory of the right one. A certain amount of knowledge has to live in your head for the external tools to be useful. The forgetting curve tells you that keeping it there takes effort.

This week, notice the curve in action. Pick something you learned in detail a month ago, perhaps from a course, a book or a meeting. Without looking it up, write down everything you remember. Then compare with your notes. The gap is the curve. Choose the three most important things you had forgotten and put them somewhere you will see them again next week. Memory is a leaky bucket. Review is the hand over the hole.

Memory leaks fast, then slowly all little Kept learn review review review time With review each one slows the loss Without review fast, invisible forgetting Ebbinghaus, 1885 The curve is not a sentence. It is a schedule.
Fig 61 · The Forgetting Curve. Unreviewed memory drops steeply; each spaced review resets it and slows the decay.
Chapter 62 · Part VII

Spaced Repetition

If you review something just before you would forget it, the memory strengthens, and the next time you can wait longer before reviewing again. Repeat this a few times and the intervals stretch from days to weeks to months. This is spaced repetition, and it is one of the most effective learning techniques ever studied. It is also used by very few people outside language learners and medical students, which is a pity, because it works for almost anything worth remembering.

The idea is simple. Instead of reviewing everything equally, you review each item on its own schedule, determined by how well you remembered it last time. Items you recall easily are pushed further into the future. Items you struggle with come back sooner. The result is that your review time is concentrated on the things you are about to forget, which is exactly where review does the most good.

You can do this with physical flashcards, using a system of boxes where cards move to a less frequently reviewed box each time you answer correctly and back to the first box when you answer wrongly. Most people now use software, which calculates the intervals automatically. Several well-established flashcard apps implement spaced repetition algorithms, and they all work on the same principle. You write a question on one side and the answer on the other; the software decides when to show it to you.

Review just before you forget, and forgetting gets slower every time.

The hard part is not the system but the cards. Good cards ask one specific question with one specific answer. What is the capital of Peru? is a good card. Everything about Peru is not. For professional knowledge, good cards might ask what a particular acronym means, which command does a certain task, what the three criteria for an approval are, or who owns a given system. Writing cards forces you to break knowledge into atomic pieces, which is itself a useful exercise in understanding.

AI assistants have made card writing much easier. You can give a model a document and ask it to propose a set of question-and-answer pairs, then edit the ones worth keeping. This saves time, but be selective. Machine-generated cards tend to test trivial details because those are easiest to turn into questions. The cards worth keeping are the ones testing things you will actually need to recall without looking them up: concepts, relationships, procedures, the reasons behind decisions.

This week, choose one body of knowledge you need to hold in your head, not just in your notes: terminology for a new role, the key facts about a major client, the steps of a procedure you perform occasionally. Write twenty cards. Put them into any spaced repetition app and review them daily for a week; it takes a few minutes. Notice how quickly the easy ones stop appearing and the hard ones become easy. It feels slightly like cheating. It is, in fact, just how memory works.

Cards move further away as you recall them Box 1 every day recalled Box 2 every 3 days recalled Box 3 every week recalled Box 4 every month forgot: back to Box 1 time spent where forgetting is closest The hard part is the card What is the capital of Peru? one question, one answer Everything about Peru not a card good work cards: an acronym, a command, three approval criteria, who owns a system Review just before you forget, and forgetting slows every time.
Fig 62 · Spaced Repetition. Recalled cards move to rarer boxes; forgotten ones return to Box 1 for daily review.
Chapter 63 · Part VII

Active Recall Wins

Rereading feels productive. You go over your notes, highlight the important parts again, nod along to familiar ideas. And because the material feels familiar, you conclude that you know it. You probably do not. Familiarity and memory feel almost identical from the inside, and only one of them will help you when the notes are not in front of you.

The alternative is active recall: closing the notes and trying to retrieve the information from memory. Write down everything you remember about a topic on a blank page. Answer a question before checking the answer. Explain a concept aloud without looking at anything. It feels considerably harder than rereading, often uncomfortably so, and it works far better. Psychologists call this the testing effect: the act of retrieving information strengthens the memory of it much more than re-exposure does.

The discomfort is the mechanism. When you try to recall something and struggle, your brain is doing the work of reconstructing the memory, and that work is what makes the memory durable. When you reread, the information is handed to you, and your brain does very little. The ease of rereading is precisely why it is ineffective. This is one of the more counterintuitive findings in learning research: the methods that feel most productive are often the least productive, and vice versa.

Rereading is recognition. Recall is retrieval. Only one of them shows up in the meeting.

Active recall applies far beyond studying for exams. Before a meeting with a client, try to write down what you know about their situation before opening the file. After reading a report, close it and write the three main points. Before running a procedure you perform occasionally, try to list the steps from memory, then check. Each attempt reveals what you actually know, as opposed to what you can recognise, and strengthens it in the process.

This principle has a particular edge in the age of AI. It is now trivially easy to have a model summarise a document, answer a question or explain a concept. Each of these is a form of being handed the information, the equivalent of rereading. Useful for getting the information; nearly useless for remembering it. If you want to retain something, the most valuable use of an assistant may be the reverse of the usual: ask it to quiz you, then answer without help, and let it tell you what you got wrong.

This week, replace one rereading session with a recall session. Pick notes you would normally review by reading. Instead, close them, take a blank page and write everything you can remember. Then open the notes and compare. Mark what you missed. Next time, start with the missed items. It will feel worse than rereading. That feeling is your memory being built. Comfort is not a learning outcome.

Recognition is not retrieval Rereading Active recall Feels productive, familiar hard, uncomfortable Your brain is handed the answer rebuilds the memory It builds recognition retrieval Looks like reread, AI summary blank page, quiz me In the meeting gone there when needed testing effect: retrieving strengthens memory more than re-exposure Comfort is not a learning outcome.
Fig 63 · Active Recall Wins. Rereading feels easy and builds recognition; recall feels hard and builds memory.
Chapter 64 · Part VII

Notes Are Not Memory

An external note stores the artefact, not the recall. If you cannot retrieve an idea unaided, you do not know it; you merely own a record of it. This distinction is easy to blur, because owning the record feels like knowing. You have the note, you could look it up, and so you assume the knowledge is yours. In most situations where it would matter, it is not.

The difference shows up at the moments when looking things up is impossible or too slow. In a conversation, when someone asks a question and the useful answer must come now. In a meeting, when a decision depends on recognising that a proposal repeats a mistake from two years ago. In creative work, when a new idea requires connecting two things you know, and you can only connect things that are in your head at the same time. Notes cannot participate in any of these moments. Only memory can.

This is not an argument against notes. External memory is enormously valuable for things that do not need to be in your head: reference material, details, sources, records of decisions. The argument is against treating notes as a substitute for understanding. A person with a vast archive and little internalised knowledge is like a library with an excellent catalogue and no readers. Everything is findable. Nothing is being thought about.

The note remembers so you can forget the details. It cannot remember the understanding for you.

The practical lesson is to decide deliberately what should live in your head and what should live in your notes. Concepts, principles, the shape of your field, the key relationships between things, the reasons behind important decisions: these should be internalised, because you need them to think. Specific facts, figures, procedures you rarely perform, references and sources: these can live outside, because you need them only when you can afford to look them up. The chapters in this part on recall, spaced repetition and writing to remember are tools for the first category.

AI tools intensify the temptation to externalise everything. If an assistant can answer any question about your notes instantly, why remember anything? Because the assistant answers only the questions you think to ask, and you think to ask only about things you know enough to wonder about. The more you have internalised, the better your questions, and the better you can judge the answers. External memory, human or machine, amplifies what is in your head. It does not replace it.

This week, pick a subject central to your work. Without looking at anything, write a single page explaining it to a capable newcomer. Then check your notes. Where you relied on the notes for a fact, that is fine. Where you could not explain a concept or a connection without them, you have found something that belongs in your head and is not there yet. Put it there, with recall and review. A record is something you own. Knowledge is something you are.

Owning a record is not knowing In your notes look it up later facts and figures rare procedures references sources In your head needed to think concepts principles shape of the field why we decided Usable cue in head detail in notes A record is something you own. Knowledge is something you are.
Fig 64 · Notes Are Not Memory. Details live in notes, understanding lives in your head; the overlap is usable.
Chapter 65 · Part VII

The Generation Effect

Information you produce yourself is remembered much better than information you simply receive. Psychologists began documenting this in the 1970s and called it the generation effect. If you are given a word pair to read, you remember it less well than if you are given a clue and must generate the second word yourself. The effort of producing information, even a small effort, makes it stick.

The effect has broad implications for how you take notes. Copying text from a source involves no generation: you are merely transferring words from one place to another. Rewriting the same idea in your own words involves considerable generation: you must understand the idea, choose words and construct sentences. The second takes longer and produces a much more durable memory, along with a note that reflects your own understanding.

This is why many experienced note-takers insist on paraphrasing rather than quoting, and why the slip-box method demands that every note be written in your own words. It is also why the chapter in Part Five on writing your own sentence was so emphatic. Rewriting a concept is not a formatting operation; it is a memory operation. The note is a by-product. The real product is the change in your head.

What you make, you keep. What you are given, you borrow.

The generation effect also explains why teaching is such a powerful way to learn. To explain something to someone else, you must generate the explanation: decide what to say, in what order, with what examples. Every explanation you produce strengthens your own memory of the material. Many people discover that they truly understand a subject only after they have tried to teach it, because teaching forces them to generate the parts they had previously only recognised.

AI tools present a clear risk here. A model will generate summaries, explanations, paraphrases and examples instantly and well. Every time you accept a machine-generated explanation instead of producing your own, you skip the generation step, and with it the memory benefit. The output may be excellent; it simply is not yours. For material you need to remember and think with, the habit worth keeping is to generate first and consult the machine second. Write your own explanation, then ask the model to critique it or fill the gaps. You get the memory benefit and the quality check.

This week, apply the effect to one thing you need to learn. Instead of reading a summary, write your own before looking at any. Instead of accepting an AI explanation, write yours first and compare. Instead of rereading notes on a topic, explain the topic aloud to an imaginary colleague or a real one. Notice how much more clearly you remember it a few days later. The effort feels like a cost. It is the price of owning something rather than renting it.

What you make, you keep Given Read the pair Copy the quote Borrowed fades in days Generated Recall a clue Rewrite it your own words Kept lasts, and yours With an AI model: generate first, consult second Write yours explanation Model critiques gaps, errors Fill the gaps still yours Teaching is generation at full strength.
Fig 65 · The Generation Effect. Copying passes words along; generating your own version makes them stick.
Chapter 66 · Part VII

Interleaving Topics

When people practise or study, they usually block: they work on one topic or skill until they have it, then move to the next. Mixing topics within a session, called interleaving, feels worse. It is more confusing, progress seems slower, and you make more mistakes. It also works better, often substantially, for long-term retention and for the ability to apply what you have learned in new situations.

The reason is that interleaving forces a decision that blocking hides. When you practise ten problems of the same type in a row, you know which method to use before you start, so you never practise choosing the method. When problems of different types are mixed, you must first work out what kind of problem you are facing, and only then apply the right approach. That act of discrimination, recognising which tool fits, is exactly what real situations demand, and blocking never trains it.

This principle extends well beyond maths homework. A new manager learning to handle different kinds of conversations, feedback, conflict, negotiation and delegation, will learn more from a mixed set of scenarios than from a week on each. A developer learning several new tools will understand each better if they alternate between them, because the contrasts make each one's purpose clearer. A team member learning about different parts of the business will build a better mental map by moving between areas than by mastering one before starting the next.

The confusion is the mechanism. Your brain must pick the right tool each time, so it learns which tool is which.

The difficulty is that interleaving feels like failure. During the session, blocked practice produces better performance, so it feels more effective. The benefits of interleaving appear later, in better retention and transfer. This mismatch between how learning feels and how well it works is a recurring theme of this part, and it explains why so many people choose the less effective methods. Their intuitions about learning are being fooled by short-term fluency.

Interleaving has a natural partner in your knowledge system. When you review notes or flashcards, mix topics rather than reviewing one area at a time. Spaced repetition software does this automatically, which is one of its hidden advantages. Random resurfacing, from Part Six, is a form of interleaving too. AI assistants can help by generating mixed practice: ask one to quiz you with questions drawn from several topics in random order, without telling you which topic each question belongs to.

This week, take one thing you are learning that has several distinct parts and change how you practise. Instead of working on each part in a separate session, mix them within each session. Expect it to feel harder and slower. Persist for at least three sessions, then test yourself on the whole. Compare with how you usually perform. Learning that feels smooth is often learning that does not last. A little confusion is cheap tuition.

Blocked feels better. Mixed lasts longer. Blocked F F F C C C N N N Interleaved F C N C N F N F C F feedback C conflict N negotiation must pick the tool During the session blocked interleaved Weeks later blocked interleaved The confusion is the mechanism. A little of it is cheap tuition.
Fig 66 · Interleaving Topics. Mixing topics forces you to choose the method each time, so the learning lasts.
Chapter 67 · Part VII

Cues and Contexts

Memory is retrieved by cues, not searched by content. You cannot simply decide to recall a fact; something has to trigger it. A word, an image, a place, a smell, a question. When you fail to remember something you know you know, the memory is usually still there. What is missing is a cue that leads to it. Attach each important fact to a vivid hook, and recall suddenly gets a handle.

This explains a familiar experience: walking into a room and forgetting why you went in, then remembering as soon as you return to where you started. The context of the original room was part of the cue. Researchers have demonstrated context effects in many settings; in one well-known study, divers who learned words underwater recalled them better underwater than on land, and vice versa. Context is not background to memory. It is part of the retrieval path.

For deliberate learning, the lesson is to build cues on purpose. Connect new information to things you already know well. Attach abstract facts to concrete examples, stories or images. Link a new concept to a specific person, place or event where you encountered it or might use it. The more connections a memory has, the more paths lead to it, and the more likely it is that something in a future situation will trigger it. Isolated facts are hard to recall. Well-connected facts are hard to forget.

A memory without a cue is a book with no catalogue entry. It is on the shelf, and nobody will ever find it.

This is, of course, the same principle as the rest of this book, applied to your brain instead of your files. External knowledge systems work by providing cues: names, tags, links, folders, search terms. Each is a route to an item. Your memory works the same way, except that the cues are associations rather than metadata. A good external system mirrors a good internal one: richly connected, with many paths to every important item.

There is a useful trick for combining the two. When you write a note, include the cues that would help you remember it, not just the content. Where were you when you learned this? What problem made it matter? What does it remind you of? Who said it? These details look irrelevant, but they give both your memory and your search tools more ways to find the note later. They also give an AI assistant richer context, so that a question phrased in terms of the situation, that thing we discussed in the planning session about the outage, can still reach the right note.

This week, when you learn something worth keeping, give it at least two cues. Connect it explicitly to something you already know, and note the concrete situation in which you learned it. Write both into the note. A week later, test yourself on a few of these items. Notice whether the cues help. Facts are easy to store. Handles are what let you pick them up.

Every cue is another path in A memory one fact Place where you learned it Problem what made it matter Person who said it Known idea ties to the known Example a concrete story Image a vivid hook your files work the same way: names, tags, links, folders Isolated facts are hard to recall. Connected facts are hard to forget.
Fig 67 · Cues and Contexts. Place, person, problem, example, image and prior knowledge each lead back to a memory.
Chapter 68 · Part VII

Write to Remember

There is a rough gradient of effort in how we engage with information, and it maps almost exactly onto how long the knowledge lasts. Reading is renting: you have access while the page is open, and little remains when it closes. Summarising is leasing: you hold the material longer, because you had to process it. Teaching is owning: once you have explained something well, it is yours for a long time. Each step up costs more effort and returns more retention.

Reading is the default mode of knowledge work, and it is the least effective for memory. You can read a report carefully, agree with every point and find a week later that you can recall almost nothing specific. This is not a failure of attention. It is how reading works. The information passes through you without much processing, because understanding a sentence while reading does not require you to reconstruct or reorganise it.

Summarising forces processing. To summarise, you must decide what matters, how ideas relate and how to express them concisely. Each of these decisions is a small act of generation, and as the previous chapters explained, generation builds memory. A summary in your own words, even a few sentences, transforms a passive reading into an active one. It is also a far more useful note than any number of highlights.

Reading is renting. Summarising is leasing. Teaching is owning.

Teaching goes further still. To teach, you must anticipate questions, choose examples, find the right order and fill gaps you did not know existed. Writing for an audience, a blog post, an internal guide, a careful explanation in a team channel, has much the same effect. The audience forces rigour. Many practitioners find that the fastest way to master a new subject is to commit to explaining it to others, because the commitment forces them to learn it properly.

This gradient gives a practical rule for any information you encounter. Decide how long you need to retain it, then choose the level of engagement accordingly. For information you need only briefly, reading is fine. For information you will use over the coming months, write a summary. For knowledge that is central to your work, teach it, formally or informally. The effort is not a cost to minimise; it is an investment proportionate to how long you want the return.

AI assistants can help at each level without taking over. They can find and retrieve material to read. They can review your summary and point out what you missed. They can play the role of a curious student while you practise teaching, asking the awkward questions a real audience would ask. What they cannot do is the writing on your behalf without removing the benefit. This week, take one piece of knowledge central to your work and teach it: write a short explainer for your team, or explain it to a colleague over coffee. Notice what you discover you did not know. Then write that down too. Teaching is the most selfish thing you can do for your memory.

Effort in, retention out Teaching owning Summarising leasing Reading renting more effort longer kept core to your work for months briefly AI can fetch the reading, review your summary and play the student. Reading is renting. Summarising is leasing. Teaching is owning.
Fig 68 · Write to Remember. Reading rents knowledge, summarising leases it, and teaching makes it yours.
Chapter 69 · Part VII

The Weekly Review

A fixed weekly session to revisit, prune and connect is the single habit that separates people with a knowledge system from people with a folder. Everything else in this book, naming, structure, capture, curation, decays without it. With it, even a modest system stays useful for years. The weekly review is to knowledge what brushing is to teeth: unglamorous, regular and far cheaper than the alternative.

The review has a simple structure, and it should take no more than an hour, often less. First, empty your inboxes: process every captured item, filing, acting on or deleting each one. Second, review what is active: open your current projects and areas, update status fields, close finished items, note what is stuck. Third, connect: look at what you captured and created this week and add links to related notes, update maps of content, promote stable conclusions into reference pages. Fourth, prune: archive what is finished, delete what is dead, merge duplicates. Fifth, look ahead: note what you will need next week and make sure it is findable.

The precise steps matter less than the regularity. A review done every week, even imperfectly, prevents the build-up of mess that eventually forces a great reorganisation. A review done sporadically, whenever things get bad enough, never gets ahead of the decay. The power is in the schedule. Put it in your calendar as a recurring appointment, at a time when you are unlikely to be interrupted, and treat it with the same seriousness as a meeting with someone important. It is one.

The weekly review is where a pile becomes a library, one Friday at a time.

Many people find the review easier with a written checklist. Without one, each session requires remembering what to do, and the ones you forget are usually the uncomfortable ones, like deleting things. A checklist turns the review into a routine that can be done on autopilot, which is exactly what you want for a habit that must survive busy weeks and low moods.

AI assistants can take on much of the clerical work. An agent can prepare a review brief: listing items in your inbox with suggested destinations, projects untouched for a fortnight, notes created this week with no links, documents with status fields that look out of date. You then make the decisions, quickly, from a prepared list. This can halve the time the review takes. It does not remove the need for you to be there, because the review is fundamentally about judgement: what still matters, what has changed, what deserves to stay.

This week, schedule your first review. Write a checklist of no more than six steps based on the outline above. Block an hour in your calendar, ideally at the end of the week, and do it. Then schedule the next one. After four weeks, adjust the checklist based on what you actually did and what you skipped. The system you have is the system you review. Everything else is wishful filing.

One hour, every Friday recurring, in the calendar 1 Empty inboxes file, act on or delete every captured item 2 Review active update status, close finished, note what is stuck 3 Connect link new notes, update maps, promote conclusions 4 Prune archive finished, delete dead, merge duplicates 5 Look ahead make next week's needs findable an agent can prepare the brief: stale projects, unlinked notes Where a pile becomes a library, one Friday at a time.
Fig 69 · The Weekly Review. Five steps in under an hour: empty, review, connect, prune and look ahead.
Chapter 70 · Part VII

Externalise Judgement Last

Offload facts, dates and references freely. Keep taste, judgement and the questions inside your head. This is the right division of labour between you and your tools, and it becomes more important as those tools become more capable. External systems, including AI assistants, can store and retrieve almost any fact. They cannot hold the thing that makes facts useful: a sense of what matters, what is good, and what to ask next.

The case for offloading facts is strong. Your memory is limited and unreliable; external storage is vast and exact. There is no virtue in memorising phone numbers, reference figures or the details of a procedure you perform once a year. Put them in a reliable system, make them findable, and free your memory for other things. This is what knowledge systems are for, and it is a liberation, not a weakness.

The case for keeping judgement internal is less obvious but more important. Judgement is not a fact that can be stored. It is the capacity to evaluate facts, weigh them against each other and decide what to do. It depends on a rich, connected understanding of your field, built from experience and internalised knowledge. When you outsource the facts, you still need the judgement to know which facts to retrieve, whether they are right, and what they mean for the situation in front of you.

Store what you know. Keep how you decide.

AI tools blur this line in a seductive way. A model will happily offer judgement: which option is best, what the risks are, what you should do. Often its suggestions are good, and you should consider them. But a model's judgement is generic, formed from patterns across vast amounts of text, not from your situation, your values and your history. If you accept its judgement without exercising your own, you gradually lose the ability to tell when it is wrong. The tool becomes a crutch for a muscle that wastes away.

The practical balance is to use tools to inform judgement, not to replace it. Ask an assistant to gather the facts, summarise the options, and point out considerations you might have missed. Then make the decision yourself, and write down why. That written reasoning, in a decision log or a note, is itself valuable knowledge: it records not just what was decided but the judgement that decided it. Part Ten returns to this as one of the most important team habits.

This week, notice one decision you make with help from a tool, whether a search engine, a spreadsheet or an AI assistant. Before accepting what the tool suggests, write down in a sentence or two what you would have decided without it, and why. Compare. Sometimes you will agree with the tool, and your reasoning will be stronger for having been made explicit. Sometimes you will not, and that disagreement is exactly where your judgement lives. Externalise everything you can. Except yourself.

Store what you know. Keep how you decide. You taste, judgement, questions Assistant facts, dates, references Ask the question facts, not a verdict Gather the facts figures, sources Summarise options plus what you missed Write your own call before its pick Decide your values, history Log why decision log Use the tool to inform judgement, never to replace it.
Fig 70 · Externalise Judgement Last. The assistant gathers facts and options; you write your own call, decide and log why.
Part VIII

Curation and Decay

Versioning, archiving and the courage to delete.

Chapter 71 · Part VIII

Weeding Is the Job

Librarians remove books constantly. They call it weeding, and it is a normal, scheduled, professionally respected part of the work, not an emergency measure or a sign of failure. A collection that only grows becomes unusable: the shelves fill, the good material is crowded by the outdated, and readers lose trust in what they find. The courage to remove things is exactly what keeps the remainder findable.

Most personal and team knowledge systems have no weeding at all. Things are added constantly and removed almost never. Old drafts sit beside final versions. Obsolete procedures sit beside current ones. Notes from abandoned projects clutter searches for active ones. Nobody decided to keep all of this. It is simply that adding is easy and removing feels risky, so the default is accumulation.

Libraries use criteria for weeding, and you can borrow them. Is the item out of date or superseded? Is it inaccurate? Is it a duplicate of something better? Has nobody used it in a long time, and is it unlikely anyone will? Is it in such poor condition, or so badly described, that nobody could use it even if they wanted to? An item that meets one or more of these criteria is a candidate for removal, either to an archive or to the bin.

A library that never removes anything is not a library. It is a storage unit with a reading room.

The resistance to weeding is mostly emotional. Deleting something feels irreversible, and there is always a nagging possibility that you might need it one day. The archive, discussed later in this part, solves much of this by giving you somewhere to put things that are not quite dead. But even with an archive, weeding requires a mindset shift: accepting that the value of a collection lies in what it makes findable, not in how much it contains. Every item you remove makes every remaining item slightly easier to find.

Weeding matters more when AI assistants search your collection. A person searching might recognise an old document as outdated and skip it. An agent may not, especially if the old document is well written and confidently phrased. Every obsolete item left in a searchable collection is a chance for an assistant to give a wrong answer with full conviction. Weeding is no longer just tidiness. It is quality control for every answer your tools produce.

This week, weed one collection. Choose a shared folder, a wiki space or a section of your notes. Go through it with the criteria above. For each item, decide: keep, archive or delete. Aim to remove at least a fifth of the items, which will feel drastic and will almost certainly be fine. Then put a recurring reminder in your calendar to weed again in three months. The shelf will feel emptier. It will also, for the first time in a while, be readable.

Keep, archive or delete Weeding criteria Out of date superseded Inaccurate wrong now Duplicate of something better Unused and unlikely to be Unusable badly described One item Meets a criterion? no yes Might need it? maybe no Archive set aside Delete the bin Keep earns it aim to remove a fifth; weed again in three months A library that never removes anything is a storage unit.
Fig 71 · Weeding Is the Job. Five weeding criteria send each item to keep, archive or delete.
Chapter 72 · Part VIII

Knowledge Has a Half-Life

Different kinds of knowledge go stale at different rates. A mathematical proof is good for centuries. The principles of a craft last decades. A company's strategy may last a few years. A tax rule might last until the next budget. An API's behaviour might change next month. A person's phone number can change tomorrow. Treating all of these as equally durable is how collections fill with confident falsehoods.

The idea of a half-life, borrowed loosely from physics, is a useful way to think about this. It suggests that each kind of knowledge has a characteristic rate of decay: the time after which a substantial share of it is no longer accurate. You do not need precise numbers. You need a rough sense of which category each piece of knowledge falls into, so you know how much to trust it as it ages and how often to check it.

A practical scheme uses three or four broad bands. Durable knowledge: principles, concepts, history, things that rarely change. Slow knowledge: strategies, structures, policies, things that change over years. Fast knowledge: prices, procedures, software details, contacts, things that change over months. Volatile knowledge: current status, live figures, anything that changes weekly or daily. Most collections mix all four indiscriminately, which means a reader cannot tell at a glance whether a given fact is likely still true.

All facts are true for a while. The question is how long a while.

Once you think in half-lives, several habits follow. Mark fast and volatile knowledge as such when you record it, perhaps with a tag or a field. Always record the date on which a fast fact was true. Prefer linking to a live source for volatile information rather than copying it, because the copy begins decaying the moment it is made. And review fast-decaying knowledge on a schedule, while leaving durable knowledge alone.

AI assistants are particularly vulnerable to half-life problems. A model reading your documents has no inherent sense of which facts are stale. It will cite a three-year-old price list as readily as yesterday's, unless something in the document signals its age or status. Dates in filenames, status fields and half-life tags all help, as do explicit instructions to prefer recent sources for fast-decaying topics. Without these signals, an assistant can only treat everything it finds as equally current, which is to say, equally untrustworthy.

This week, take one reference document you or your team rely on and go through it fact by fact. For each important fact, decide which half-life band it belongs to. Mark the fast and volatile ones, and check whether each is still true. You will probably find at least one that has quietly expired. Fix it, and note the date. Truth has a shelf life. Label it like milk.

How long a while? days weeks months years decades centuries Durable proofs, principles leave it alone Slow strategy, policy review each planning cycle Fast prices, contacts record the date it was true Volatile status, live figures link the live source, never copy All facts are true for a while. Label the while, like milk.
Fig 72 · Knowledge Has a Half-Life. Durable, slow, fast and volatile knowledge decay at different rates.
Chapter 73 · Part VIII

The Review-By Date

Give time-bound facts a review-by date at the moment you capture them. Then your system can raise its hand when something might be stale, instead of quietly serving it to you, or to an AI assistant, as if it were still true. This is the practical tool that follows from thinking about half-lives, and it is one of the simplest and most effective metadata fields you can add.

The idea comes from shops and kitchens. A best-before date does not say the food is bad after that date. It says that after that date, someone should check. A review-by date works the same way. When you record a fact that will probably change, a price, a contact, a procedure, an assumption in a plan, you also record when it should next be checked. When that date arrives, the fact is flagged for review rather than assumed to be current.

The date should reflect the fact's half-life. A supplier's pricing might be reviewed every six months. A team contact list every quarter. A policy every year. A strategic assumption at each planning cycle. You do not need precise dates; a rough interval is enough. The point is to replace the default, which is never checking, with a schedule, however approximate.

A review-by date turns silent decay into a reminder.

The field is only useful if something acts on it. In a notes app or wiki that supports queries, a saved search for review-by date before today produces a list of everything due for checking. In a spreadsheet, a filter does the same. In a team, the review can be assigned to the owner of each document, who receives a reminder when their documents come due. Some wiki tools have built-in verification features that work exactly this way, marking pages as unverified after a set period.

AI assistants can make review-by dates far more powerful. An agent can run the query weekly, gather the items due for review and prepare a brief: here are the facts due for checking, here is what each one says, and here, where possible, is what current sources suggest. You then confirm, correct or extend each one. This turns a tedious maintenance task into a quick approval session. Agents can also be instructed to treat any fact past its review-by date with caution, mentioning the date when citing it, so that readers know it may be stale.

This week, add a review-by field to the template for one kind of document you maintain, perhaps a process guide, a contact list or a pricing sheet. Fill it in for your ten most important existing documents, choosing an interval that matches each one's half-life. Set up a query or reminder that will show you what is due. When the first item comes up, review it properly. The system does not need to know what is true. It needs to know when to ask.

A fact that raises its hand Captured review-by date set Current trusted, cited Due for review flagged, not assumed Checking owner or agent brief Confirmed or fixed with today's date Retired archived date passes query lists it confirm next date set no longer true The interval follows the half-life pricing: 6 months contacts: quarterly policy: yearly assumptions: each plan The system does not need to know what is true, only when to ask.
Fig 73 · The Review-By Date. A review-by date moves a fact from current to due, then back with a new date.
Chapter 74 · Part VIII

Dead Links Rot Quietly

Links break. Pages move, websites close, documents are deleted, permissions change, and the address that once led to something useful now leads to an error page or, worse, to something completely different. Studies of link rot have repeatedly found that a striking share of links on the web stop working within a few years. Nobody sends you a warning. The link simply stops leading anywhere, and you discover this at the moment you need it most.

The problem is everywhere in knowledge systems. Notes link to articles that no longer exist. Wikis link to documents that have been moved. Decision records cite sources that have vanished. A reference document built carefully on external sources can become a tissue of broken references within a few years, each one a small hole in its credibility. The knowledge it summarised may still be there, in your note. The evidence for it is gone.

The core principle is simple: if a source truly matters, archive the content, not just the address. A link is a pointer to something you do not control. If you rely on the thing pointed to, keep a copy. This can be as simple as saving a PDF of a web page alongside your note, pasting the key passages into the note itself, or using a web archiving service that preserves a snapshot of the page at a stable address. The aim is that your note remains meaningful even if the original disappears.

A link is a promise someone else made. Keep a copy of anything you cannot afford for them to break.

Internal links rot too, and these are more within your control. Part Three's advice on permanent identifiers is the main defence: link to stable IDs rather than to titles or paths, so that renames and moves do not break anything. Beyond that, a periodic link check, which many tools and simple scripts can perform, will find broken internal links before readers do. Fixing a broken link while the original is still findable takes seconds. Fixing it years later, when nobody remembers what it pointed to, may be impossible.

AI agents are both affected by link rot and useful against it. An agent that follows a broken link may report an error, or may silently skip the source and answer without it, which is worse. On the other hand, an agent can be given the job of checking links across a collection, reporting which are broken and, where possible, finding archived versions or current equivalents. This is tedious work for a person and simple work for a machine.

This week, take one important document that relies on external sources and check every link in it. For any source that matters, save a copy of the content, as a PDF, a pasted quote or an archived snapshot, alongside the document. Fix or remove any links that are already broken. Then make a habit of saving content, not just links, whenever you capture something you expect to rely on. The web forgets. Your notes do not have to.

A link is a promise someone else made Your note the summary link Their page you do not control it Moved Deleted Locked Replaced no warning sent keep alongside Saved copy PDF, quote, archive the note still makes sense when the page is gone Internal links rot too Stable IDs not titles or paths Periodic check script or agent Fix it now seconds, not years The web forgets. Your notes do not have to.
Fig 74 · Dead Links Rot Quietly. External pages move, vanish or change; a saved copy keeps the note meaningful.
Chapter 75 · Part VIII

Duplicates Are Lies

Two copies of a document mean two versions of the truth, and at least one of them is wrong, or soon will be. This is the harsh but useful way to think about duplicates. They do not just waste space. They create uncertainty about which version is current, and uncertainty is what destroys trust in a knowledge system. Deduplicate ruthlessly, and link to the original instead of copying it.

Duplicates arise innocently. Someone downloads an attachment to edit it, then uploads the edited version to a different place. Someone copies a table from one document into another, because linking felt like more trouble. Someone cannot find a template and creates a new one. Someone saves the same article twice, months apart, having forgotten the first time. Each duplicate starts identical to its original. Then one of them is updated, and they diverge, and now there are two truths.

The danger is that duplicates look authoritative. Each copy has the same title, the same formatting, the same apparent origin. A reader who finds one has no way of knowing that another, more current version exists elsewhere. They act on what they found, confidently, and the error propagates. Meanwhile, the person who updated the other copy believes the problem is fixed.

Every copy is a fork in the road. Most people do not notice which branch they took.

The defence is the canonical home principle from Part Four, applied with discipline. Every important piece of knowledge has one authoritative location. Everything else links to it. When you need to reference something, link rather than copy. When you need to excerpt something, mark the excerpt clearly with its source and date, so readers know it is a copy and where to find the original. When you find a duplicate, decide which copy is canonical, update it if necessary, and replace the other with a link or delete it.

AI assistants create a new and fast-growing category of duplicates: derivatives. Summaries, rewrites, translations, reformatted versions and extracts generated from an original document are all, in effect, copies, and each will diverge from the original the moment the original changes. Mark machine-generated derivatives clearly as such, with a link to their source and the date they were generated. And when you ask an agent to answer questions, instruct it to prefer canonical sources over derivatives, so that it does not cite a stale summary when the real document is available.

This week, hunt duplicates in one collection. Search for documents with the same or similar titles. Look for files with names like copy, (1) or v2. Use a duplicate-finding tool if you have one, or ask an AI assistant to compare titles and contents and list likely duplicates. For each pair, choose the canonical version, merge anything important from the other, and replace it with a link. Each duplicate you remove is a small lie your collection no longer tells. Truth is easier when there is only one of it.

Two copies, two truths original copied diverged acted on Proposal one file Copy A downloaded Copy B left in place Edited the new truth Unchanged looks official Updater thinks: fixed Reader acts on stale The fix One canonical home everything else links Excerpts marked source and date AI derivatives labelled, dated Every copy is a fork. Most readers never notice which branch they took.
Fig 75 · Duplicates Are Lies. A copied file diverges; the reader of the stale copy acts on a lie.
Chapter 76 · Part VIII

Versioning Over Copies

A file called proposal-final-v3-REALfinal-edited.docx is a filing failure with a name. It is also one of the most recognisable artefacts of modern office life, which tells you how widespread the failure is. Versioning, done properly, gives you the full history of a document without multiplying the present. You get every previous state when you need it, and one current file the rest of the time.

The problem with version-by-filename is that each version is a separate, complete copy. They accumulate in the same folder, and soon nobody is sure which is current. Is final-v3 newer than final-edited? Did someone make changes to v2 after v3 was created? Which one was sent to the client? Each copy is a duplicate, with all the problems the previous chapter described, plus the additional confusion of ambiguous ordering.

Proper versioning keeps one file and records its history separately. Most modern document tools do this automatically: every save creates a version you can view or restore, while the file itself keeps one name and one location. Software developers use version control systems that go further, recording who changed what, when and why, with a message explaining each change. For plain-text notes, the same tools work beautifully. For any document, even a simple changelog at the top or bottom, listing dates and what changed, is better than a folder of copies.

History belongs behind the document, not beside it.

There are good reasons to create a separate, named version occasionally. When a document is formally issued, signed, published or sent externally, it can be worth saving a frozen copy that records exactly what was issued, with a date and a clear status. The rule is to make these snapshots deliberately and label them clearly, 2026-10-07-proposal-acme-as-sent.pdf, rather than creating a new copy every time someone makes an edit. A snapshot is a record of a moment; a working copy is a source of confusion.

Version history becomes especially valuable when AI agents edit your documents. An agent making changes to a file should do so in a way that preserves history, so that every change can be seen, understood and reversed if necessary. Version control systems, document history and tools that show differences between versions are what make it safe to let machines edit. Without them, an agent's edits overwrite the past invisibly. With them, every edit is a reversible proposal.

This week, find one folder with multiple copies of the same document distinguished only by suffixes like v2, final or new. Identify the current version. Make sure your tool's version history is turned on for it, or start a simple changelog. Archive or delete the other copies, keeping any genuine issued snapshots with clear, dated names. From now on, save over the file instead of saving as a new one. Final is not a version number. It is a hope.

History behind the document, not beside it Before: a folder of copies After: one file, with history proposal.docx proposal-v2.docx proposal-final.docx proposal-final-v3.docx proposal-final-edited.docx proposal-final-v3-REALfinal.docx which is current? which was sent? proposal-acme.docx current v14 7 Oct pricing updated v13 2 Oct scope cut v12 28 Sep first draft 2026-10-07-proposal-acme-as-sent.pdf issued snapshot, made on purpose Save over the file. Let the tool keep every earlier state. with agents editing: every change visible and reversible Final is not a version number. It is a hope.
Fig 76 · Versioning Over Copies. Six named copies become one file whose history sits behind it, plus one snapshot.
Chapter 77 · Part VIII

Archive, Then Delete

Deletion is irreversible and therefore frightening, which is precisely why people hoard. A cold archive gives you psychological permission to clear the shelf: things move out of the working space, out of everyday searches and out of sight, without being gone forever. Then, when they have sat in the archive long enough to prove nobody needs them, deletion becomes easy.

The archive is not a second working space. It is a separate, deliberately out-of-the-way location for items that are no longer active but might conceivably be needed. Finished projects, superseded documents, old correspondence, notes from areas you no longer work in. These are removed from the main collection, so they do not clutter browsing or searching, but kept somewhere they can be retrieved if necessary.

The archive works because it addresses the real fear behind hoarding. People do not keep everything because they expect to need it all. They keep everything because they cannot be sure which items they will need, and the cost of deleting the wrong one feels much higher than the cost of keeping everything. An archive reduces the cost of a mistake to almost nothing. If you archive something and later need it, you retrieve it. The working collection gets lighter, and you sleep fine.

The archive is where things go to prove they are not needed. Most of them succeed.

But an archive is not a black hole. It needs a policy, or it becomes the same overgrown collection you were trying to escape, just in a different folder. The simplest policy is time-based: items that have sat in the archive untouched for a set period, perhaps two or three years, are reviewed and, unless there is a reason to keep them, deleted. Some items must be kept for legal or regulatory reasons, and those should be marked as such with their required retention period. Everything else can eventually go.

Deletion also matters for privacy and for AI. Information you keep is information that can be found, by you, by colleagues and by any agent with access to your files. Old personal data, outdated client details and sensitive material that is no longer needed are liabilities, not assets. An agent searching an archive full of material that should have been deleted may surface it in unexpected contexts. Deliberate deletion, after a sensible archival period, is part of handling knowledge responsibly.

This week, set up an archive if you do not have one: a single, clearly named location, separate from your working collection, and excluded from your default searches if your tools allow. Move at least one finished project or one set of superseded documents into it. Then write a one-line archive policy, specifying how long things stay before review, and put a reminder in your calendar for the first review. Archiving is a decision deferred. Deletion is the decision made. You need both.

Permission to clear the shelf Working collection Archive out of sight Review any reason? Delete decision made 2 to 3 years untouched need it? retrieve it lighter, faster not in searches Legal hold until its date old personal data is a liability policy, in one line: review after 3 years untouched Archiving is a decision deferred. Deletion is the decision made.
Fig 77 · Archive, Then Delete. Items wait in the archive to prove they are unneeded, then get reviewed and deleted.
Chapter 78 · Part VIII

The Cost of Keeping

Storage is cheap. Attention is not. Every item you retain imposes a small tax on every future search, every browse, every review, every agent query. The tax on any single item is tiny. Multiplied across thousands of items and years of retrieval, it becomes a significant drain on the most valuable resource in knowledge work: the time and attention of the people trying to find things.

The cost is hard to see because it is distributed. When you save a file, you pay nothing noticeable. Storage costs fractions of a penny and nobody sends a bill. But that file now appears in search results, adds a line to folder listings and competes for attention with the files you actually want. Each future visitor to that folder pays a few seconds of scanning. Each search returns one more result to look past. The cost is real; it is just paid by someone else, later, in small instalments.

This hidden cost explains why collections degrade even when nobody does anything wrong. Every reasonable decision to keep something adds a little to the burden. Over years, the accumulated weight of reasonable keeping makes the whole collection slower, noisier and less trustworthy. The only counter is regular, deliberate removal, which requires acknowledging that keeping has a cost even when it does not feel like one.

Your future self pays for everything you keep. Ask whether they would have bought it.

AI makes the cost of keeping more visible, if you know where to look. When an assistant searches your collection to answer a question, it retrieves the most relevant items and has a limited amount of space to consider them. Every irrelevant, outdated or duplicate item that ranks highly takes space that a useful item could have occupied. The quality of AI answers degrades as the noise in a collection rises. In a very real sense, the cost of keeping now shows up as the quality of every answer your tools give.

This does not mean keeping as little as possible. It means keeping deliberately. For each kind of material, ask whether its expected future value exceeds its ongoing cost to every future search. Records of decisions, canonical reference material and genuinely useful notes clearly pass. Drafts of finished documents, duplicate downloads and abandoned project scraps clearly fail. Most collections contain far more of the second kind than people realise.

This week, estimate the cost of keeping in one collection. Pick a folder you search often and count the items. Then count how many you have opened or found useful in the past year. The ratio is usually striking. Archive or delete everything in the unused group that does not have a specific reason to stay. Then search the folder for something you need and notice how much faster you find it. Keeping is never free. You simply pay later, with interest.

Would your future self have bought it? Expected future value Search tax: noise in every query Remove Keep, but tidy Archive Keep duplicate downloads drafts of finished docs abandoned scraps sprawling notes decision records canonical reference Storage is cheap. Attention is not. You pay later, with interest.
Fig 78 · The Cost of Keeping. Items low in value but high in search noise should go; records and references stay.
Chapter 79 · Part VIII

Curation Is a Signal

A short list that someone maintained is worth more than a long list that someone generated. The value of curation is not the items themselves, which could probably be found elsewhere, but the judgement that selected them. When a trusted colleague sends you the five articles worth reading on a topic, they are transferring their judgement to you, and judgement is the genuinely scarce part of knowledge work.

This principle has become sharper as generation has become cheap. A search engine or an AI assistant can produce a list of fifty relevant resources on almost any topic in seconds. The list may be accurate, comprehensive and well formatted. It is also nearly worthless as a guide to what to read, because it reflects no judgement about quality, relevance to your situation or what you already know. The curated list of five, by someone who has read them all and knows what you need, is a different kind of thing entirely.

Curation has three components. Selection: choosing a few items from many, which requires knowing the field well enough to tell the good from the merely relevant. Annotation: saying briefly why each item is included, what it is good for and how it relates to the others. Maintenance: updating the list as new material appears and old material becomes outdated. A list with all three is a valuable piece of knowledge infrastructure. A list missing any of them is just a list.

Anyone can generate a list. A curated one tells you what someone who knows would choose.

In a team, curated collections are among the most valuable knowledge assets you can create. A maintained reading list for new joiners. A curated set of example documents showing what good looks like. A short list of the decisions that shaped the current architecture, each with a line on why it matters. Maps of content, from Part Four, are curation applied to your own collection. Each represents accumulated judgement that would otherwise exist only in someone's head.

AI changes the economics of curation without removing the need for it. An assistant can do the gathering cheaply: finding candidates, summarising each one, flagging duplicates. The selecting and annotating still need someone who knows the field and the audience. A good division of labour is for the machine to propose a long list with summaries and for a person to cut it to a short one, adding a sentence of judgement to each. The final list carries the person's endorsement, which is what makes it worth trusting.

This week, curate one list for someone else. Choose a topic you know well and a person who could benefit, a new team member, a colleague moving into your area. Select no more than seven items. For each, write one sentence saying why it is on the list. Send it, and put it somewhere others can find it, with your name and the date. You have just transferred a piece of your judgement. That is what curators do. It is also what makes them worth listening to.

From fifty links to seven reasons Generated: fifty links search or AI, in seconds Gathered, summarised duplicates flagged Selected: seven at most good, not just relevant Annotated one line on why Maintained, signed your name and date machine person Anyone can generate a list. Curation shows what someone who knows would choose.
Fig 79 · Curation Is a Signal. A machine gathers and summarises; a person selects, annotates and signs the list.
Chapter 80 · Part VIII

Prune to Reveal

Cutting is not loss. It is contrast. A collection halved is a collection in which the remaining half is finally visible to the person who owns it. Gardeners prune not to make plants smaller but to make them healthier and more productive, directing growth to the branches that matter. Knowledge collections respond to pruning in exactly the same way.

Most people approach pruning with anxiety, focused on what they might lose. The better frame is to focus on what they will gain. Every item removed from a working collection makes the rest more findable, more browsable and more trustworthy. The good material, which was always there, stops competing with the outdated, the redundant and the trivial. You see what you have, often for the first time in years.

The experience of a serious prune is often surprising. People discover documents they had forgotten were valuable, buried under layers of drafts and copies. They notice gaps that had been hidden by clutter: subjects where they had many notes but no clear conclusion, or important areas where they had almost nothing. They find that their collection, once pruned, actually reflects how they think, rather than the accumulated sediment of everything they ever saved.

You do not see the shape of a collection until you cut away what obscures it.

This part has given you the tools for pruning: weeding criteria, half-lives, review-by dates, deduplication, versioning, archiving and an honest accounting of the cost of keeping. The final step is to use them with conviction. A light weeding that removes a few obvious items is useful. A serious prune that removes half the collection is transformative. Most collections can lose half their contents with no meaningful loss of value, and the archive is there to catch anything you remove by mistake.

AI agents benefit from pruning more dramatically than people do. A person can learn to skip the clutter in a familiar collection; they know which folders to ignore and which documents are stale. An agent comes to the collection fresh each time, with no such knowledge. Every outdated document is a potential source for a wrong answer. A pruned collection gives an agent a much smaller, much cleaner body of material to search, and the quality of its answers improves accordingly. If you want better answers from your tools, pruning is one of the most effective things you can do.

This week, choose one collection and attempt a serious prune: aim to archive or delete half of it. Use the criteria from this part. Be bold; the archive will catch your mistakes. When you have finished, browse what remains and notice what you see. Notice what was hiding. Notice what is missing. Then decide what to add, which is now a much clearer question. Less is not the goal. Visible is the goal. Less is merely how you get there.

Cut away what obscures the shape Before: everything kept After: half removed clients methods decisions forgotten gem, now visible gap: a missing conclusion drafts, copies, sediment the gem is in there somewhere Less is not the goal. Visible is the goal.
Fig 80 · Prune to Reveal. Halving a collection groups what remains and exposes buried gems and real gaps.
Part IX

Machine Librarians

Making knowledge legible to AI agents.

Chapter 81 · Part IX

RAG Is Cataloguing

Retrieval-augmented generation, usually shortened to RAG, is the technique behind most AI systems that answer questions about your own documents. The name sounds technical. The idea is a library with a talkative front desk. When you ask a question, the system first retrieves relevant passages from a collection, then hands them to a language model, which writes an answer based on what it was given. Retrieve, then generate.

The front desk is the impressive part, and it gets all the attention. A fluent model that reads your question, considers the retrieved material and composes a clear answer feels like magic. But the quality of that answer depends overwhelmingly on the library behind the desk. If retrieval brings back the wrong passages, the model will answer fluently from the wrong material. If it brings back an outdated policy, the answer will be confidently outdated. If it brings back nothing useful, the model may fill the gap with plausible guesswork.

Everything that makes a library good decides whether a RAG system answers well. Chunking, from Part Six, decides what units can be retrieved. Metadata, from Part Three, decides whether retrieval can filter by date, status or type. Naming and structure decide whether the right documents rank highly. Deduplication and weeding decide whether stale copies compete with current ones. Canonical homes decide whether the system can tell which version is authoritative. Every chapter so far has been, among other things, a chapter about making RAG work.

A RAG system is only as good as the catalogue it searches. The model is the voice; the library is the knowledge.

This reframing is useful because it tells you where to spend effort. When an AI assistant gives poor answers about your documents, the instinct is to blame the model, or to try a different one. Sometimes that helps. Far more often, the fix is in the library: documents that need clearer headings, stale material that needs removing, missing metadata that would let retrieval filter properly, or simply a gap where the answer was never written down. Improving the collection improves every answer, from every model, for every question.

It also means the skills of librarianship have become unexpectedly valuable. The person who knows how to name, structure, describe and prune a collection is the person whose AI tools give good answers. The person who dumps everything into a folder and hopes the model will sort it out is the person whose tools hallucinate. Cataloguing was never glamorous. It has quietly become infrastructure.

This week, ask an AI assistant connected to your documents three questions you know the answers to. For each answer, check where it came from. If the assistant shows its sources, look at them. If an answer is wrong or weak, trace the problem: was the right document retrieved? Was it the current version? Was the answer clearly stated in it? Fix one problem you find, in the library rather than the prompt. Then ask again. The front desk is only as good as the stacks behind it.

A talkative desk, a library behind it Your question plain language 1 ask Front desk language model 4 write Answer from step 3 2 retrieve 3 passages The library behind the desk Chunking units to fetch Metadata date, status Names right doc ranks Weeding no stale rivals Canonical the authority Coverage answer written? When retrieval fails wrong passage fluent, and wrong outdated policy confidently stale nothing useful plausible guesswork The model is the voice. The library is the knowledge.
Fig 81 · RAG Is Cataloguing. Retrieval feeds the model; chunking, metadata and weeding decide the answer.
Chapter 82 · Part IX

Embeddings as Shelf Space

An embedding is a way of representing a piece of text as a list of numbers, positioned so that texts with similar meanings end up close together. Imagine a vast room with many more dimensions than the three we are used to, in which every document has a location. Documents about cats cluster near each other, documents about invoices cluster somewhere else, and a document about invoicing for a cat sanctuary sits somewhere between. This is how semantic search works: your question is placed in the same room, and the nearest documents are returned.

The analogy to library shelving is close. Dewey and other classification schemes put similar books near each other on physical shelves, so that a reader who finds one useful book can browse its neighbours. Embeddings do the same thing in a mathematical space, automatically, for any text. They are, in a sense, Dewey without the numbers and without the argument: a classification that emerges from patterns in language rather than being imposed by a committee.

This has real advantages. Embeddings handle synonyms and paraphrases naturally, because texts with similar meanings land close together regardless of the exact words. They work across languages in many models. They require no manual classification. And they can position a document near several different clusters at once, which is a kind of automatic polyhierarchy.

Embeddings put every document on a shelf beside its neighbours. Nobody decided the shelves. Nobody can quite explain them either.

They also have limitations worth understanding. The space reflects the patterns in the data the embedding model was trained on, which may not match the distinctions that matter in your work. Two documents that look similar to a general model may be importantly different to you: a draft and a final contract, a proposal and its rejection. Embeddings are poor at exact matches such as codes, names and numbers, which is why hybrid search, from Part Six, combines them with keyword search. And the arrangement is opaque: you cannot easily inspect why two documents were placed near each other.

The practical lessons follow from both sides. Write documents whose meaning is clear from their content, because that is what the embedding captures. Put distinguishing information, status, date, type, in metadata fields that retrieval can filter on, rather than relying on embeddings to notice the difference. Use clear, specific titles and opening sentences, which often carry extra weight. And do not assume that semantic search will find exact identifiers; for those, use keyword search.

This week, if you have access to a semantic search tool over your documents, try a revealing experiment. Search for a concept using a phrase that does not appear in any document but describes something that does. Then search for an exact code or name. Notice where semantic search shines and where it stumbles. Then look at one document it ranked oddly and ask what in its content might have placed it there. The shelves are invisible. Their effects are not.

Shelves nobody decided meaning space (many more dimensions than shown) cats invoices invoice for a cat sanctuary sits between your question nearest documents returned contracts draft and final: too close tell them apart with metadata exact codes, names: use keyword Dewey without the numbers, and without the argument.
Fig 82 · Embeddings as Shelf Space. Similar meanings sit close together; your question returns its nearest neighbours.
Chapter 83 · Part IX

Context Is the New Shelf

A language model has two kinds of knowledge. There is what it learned during training, which is broad, general and fixed at a point in time. And there is what is in its context window: the text it can see right now, in the current conversation or task. The context is everything the model can actually consult while it works. Context engineering, the practice of deciding what goes into that window, is shelving for a reader with perfect recall and no memory.

Think of the context as the desk in front of the reader. Everything on the desk can be read, cross-referenced and used, instantly and in full. Everything not on the desk might as well not exist for the purposes of this task. The desk is large, much larger than a human's working memory, but it is finite, and it fills quickly. Once full, adding something means removing something else, or the system starts to lose track of what is already there.

This changes the librarian's question. In a traditional library, the question is how to arrange the shelves so a reader can find things. With a language model, it is also how to choose what goes on the desk. Too little, and the model lacks what it needs to answer well. Too much, and the important material is diluted by the irrelevant, and the model's attention is spread thin. The right context is the smallest set of material that contains everything needed for the task.

The model knows only what is on its desk right now. Your job is to put the right books there.

Most of the habits in this book improve context quality directly. Concise, well-structured documents use less of the window to convey the same information. Clear headings let retrieval select the relevant sections rather than whole documents. Status fields let stale material be excluded before it reaches the desk. Indexes and maps of content let an agent load a short overview first and fetch details only when needed. Every organising choice that helps a human find the right page quickly also helps a system fill the context with the right material.

Agents that work over longer tasks face an additional challenge: the desk fills as they work. Each file read, each command output, each step of reasoning adds to the context. Good agent tools manage this by summarising older material, dropping what is no longer needed and loading new material on demand. You can help by keeping files focused, avoiding enormous documents that must be loaded whole, and providing summaries that let an agent decide what to read in full.

This week, think about one task you regularly hand to an AI assistant. List what it needs to know to do the task well. Then look at what you actually give it. Is something essential missing, which you have been hoping it would infer? Is there clutter, pasted in out of habit, that dilutes the essentials? Write a short, reusable brief that contains exactly what the task needs. The model reads everything on the desk. Make sure the desk is worth reading.

What is on the desk right now Training broad, general, fixed at a date Context window: the desk read in full, instantly; finite Task brief exactly what it needs Index first short overview Relevant sections not whole documents Earlier steps summarised as it goes Kept off the desk Stale pages status: superseded Whole archives fetch on demand Pasted clutter habit, not need Old outputs dropped when done The right context is the smallest set that holds everything needed.
Fig 83 · Context Is the New Shelf. Training is fixed; the context window holds only what the model can use right now.
Chapter 84 · Part IX

The Agent Needs a Catalogue

An AI agent with a search tool and no map simply wanders. It runs queries, opens files, follows hunches and eventually finds something, often the right thing, sometimes not, always at a cost in time and context. Give it an index note describing what exists and where, and its very first query improves enormously. The catalogue that libraries have always maintained turns out to be exactly what agents need.

Watch an agent explore an unfamiliar project and you will see the problem. It lists the top-level folder, guesses which subfolder looks relevant, lists that, opens a file that sounds promising, finds it is not quite right, searches for a keyword, opens three results, and so on. A person new to a project does the same thing, but a person learns and remembers. Many agents start fresh each session, so they repeat the exploration every time, paying the same cost again and again.

An index fixes this. It is a short document, often at the top of a project or collection, that describes what is there: the main sections and what each contains, where the canonical documents for important topics live, which areas are current and which are archived, and where to look for common questions. It is a map of content, from Part Four, written with an agent as one of its readers. An agent that reads the index first can go directly to the right place.

A catalogue costs the librarian an hour. It saves every reader a search.

The best indexes are concise, current and explicit. Concise, because the index itself occupies context, and a ten-page index defeats its purpose. Current, because an index that points to moved or deleted documents sends the agent on wild goose chases with false confidence. Explicit, because agents follow instructions literally: policies live in this folder; the current pricing is in this file; ignore anything in the archive unless asked gives an agent clear rules to follow, where a vaguer description invites guesswork.

Indexes compound with the other practices in this book. An index pointing to well-named files in a shallow structure with good metadata lets an agent navigate with remarkable precision. An index pointing into chaos merely tells the agent where the chaos starts. The index is not a substitute for organisation. It is the front page of organisation, the part that makes the rest legible quickly.

This week, write a catalogue for one collection an AI agent works in, or that you would like one to. Keep it under a page. List the main areas and what each contains, the canonical locations for the five most important topics, and any areas to avoid. Put it at the top of the collection, with a clear name such as INDEX or within the README. Then ask an agent a question that previously required exploration, and watch whether it goes straight to the answer. The map is not the territory. But without it, the territory is just a very large room.

Straight there, first try Agent starts fresh INDEX.md one page pricing.md canonical read the index first pricing lives in pricing.md open that file current prices answers, step 4 Without an index, every session list root guess open file not it search open three A catalogue costs the librarian an hour. It saves every reader a search.
Fig 84 · The Agent Needs a Catalogue. With a one-page index the agent goes straight to the file instead of wandering.
Chapter 85 · Part IX

The Memory File

Many AI agent tools now support a standing instructions file: a plain-text document, usually in a project's root folder, that the agent reads automatically at the start of every session. Different tools use different names for it, such as CLAUDE.md or AGENTS.md, but the idea is the same. It is the agent's memory of your project: what it should know before it starts, every time, without being told again. It is also the most important single document you can write for an agent.

Think of it as the briefing you would give a capable contractor on their first morning, written once and handed to every contractor who ever arrives. What is this project? How is it organised? What conventions must be followed? What commands are used to build, test and check things? What must never be touched? What mistakes have previous contractors made? An agent that reads this briefing starts every session already oriented, instead of rediscovering the basics from scratch.

The memory file is a different kind of document from a README, though the two overlap. A README describes a project to anyone who arrives. A memory file instructs a worker who is about to change things. It contains rules as well as descriptions: always run the tests before declaring a task complete, never edit files in the generated folder, use British spelling in user-facing text. These are the conventions that live in experienced team members' heads, made explicit for a reader with no memory of yesterday.

The memory file is tacit knowledge, written down for a colleague who forgets everything overnight.

Good memory files share some characteristics. They are short, because they are loaded into every session and take up context. They are specific, because general advice such as write good code tells the agent nothing it did not already assume. They are current, because an outdated instruction will be followed faithfully and wrongly. And they are maintained like any important document: updated when conventions change, pruned when instructions stop being relevant, and reviewed when an agent repeatedly makes the same mistake, which usually indicates something missing from the file.

The practice of writing memory files turns out to benefit humans too. The act of writing down a project's real conventions, the ones that were never documented because everyone just knew them, forces a team to agree on what they are. New human team members find the file as useful as the agents do. The memory file is, in the end, the tacit-to-explicit conversion from Part One, given a deadline and a reader who will follow it literally.

This week, if you use an agent tool that supports a memory file, write or revise one for your main project. Include what the project is, how it is organised, the commands to build and check it, the five most important conventions and anything that must never be done. Keep it under a page. Then notice, over the next few sessions, what the agent still gets wrong. Each repeated mistake is a missing line. Add it. Memory is not something the agent has. It is something you give it.

The briefing for every first morning Memory file CLAUDE.md, AGENTS.md What it is the project Layout how it is organised Commands build, test, check Conventions British spelling Never do edit generated/ Past mistakes one line each read at the start of every session short, specific, current, maintained Tacit knowledge, written for a colleague who forgets overnight.
Fig 85 · The Memory File. The memory file tells every session what the project is, how to work, what to avoid.
Chapter 86 · Part IX

A README for Two Readers

For decades, README files were written for one kind of reader: a human who had just arrived at a project and wanted to know what it was and how to use it. Now there is a second reader, an AI agent, which arrives at the same README with similar questions and very different habits. The best READMEs today are written for both at once, and the good news is that what serves one usually serves the other.

The human reader skims. They want to know quickly whether they are in the right place, what the project does, how to get started and where to find more. They appreciate clear headings, short paragraphs, examples and links. They are put off by walls of text, jargon and outdated instructions, and they will tolerate a little ambiguity because they can ask someone or figure it out.

The agent reader is more literal. It reads everything, but it takes instructions at face value and cannot ask a colleague what something means. It benefits from explicit statements rather than hints: the main entry point is this file, rather than a vague description of the architecture. It benefits from exact commands it can run, exact paths it can open and exact rules it can follow. It is badly served by outdated instructions, which it will follow faithfully, and by ambiguity, which it will resolve in whatever direction seems most plausible to it.

Write for the human who skims and the machine that believes every word.

These needs converge more than they conflict. Both readers benefit from a clear statement of purpose at the top. Both benefit from headings that say what each section covers. Both benefit from concrete commands, exact paths and explicit conventions. Both are harmed by stale information. The main adjustment is to be slightly more explicit than you would be for a human alone: spell out what a human might infer, and state rules plainly rather than leaving them implied.

There is one useful division of labour. Some projects keep the README focused on what a newcomer needs to understand the project, and put agent-specific working instructions in the memory file from the previous chapter. The README says what the project is and how it is organised; the memory file says how to work in it. This keeps each document focused and short. Other projects combine them. Either works, as long as both readers can find what they need and neither document contradicts the other.

This week, reread the README of a project or shared folder you care about as if you were an agent: literal, thorough and unable to ask questions. Mark every place where you would have to guess. Mark every instruction that is no longer accurate. Mark every command or path that is described but not stated exactly. Fix them all. Then reread it as a hurried human and check it still skims well. A README is a welcome mat. These days, two kinds of guest wipe their feet on it.

Skims, and believes every word Human reader skims headings, examples short paragraphs can ask someone Agent reader literal exact commands exact paths follows stale text Both purpose first clear headings stated rules nothing stale README: what it is. memory file: how to work in it. Spell out what a human might infer.
Fig 86 · A README for Two Readers. Humans skim, agents read literally; a good README serves the overlap.
Chapter 87 · Part IX

Structured Beats Prose

Language models read prose remarkably well, but they read tables, schemas and typed fields more reliably. If a fact has to be exact, a price, a date, a limit, an owner, a status, store it in a structure rather than a sentence. Prose is for explanation and argument. Structure is for facts that must be retrieved and used precisely, by people and machines alike.

Consider the difference. A paragraph in a policy document says that expense claims over a certain amount require approval from a director, unless the expense was pre-approved in the project budget, in which case the project lead can approve claims up to a higher amount. A human reader can parse this with some care. A model can too, most of the time. But every reading is an act of interpretation, and interpretation sometimes goes wrong, especially when the paragraph is retrieved without its surrounding context.

Now consider the same information as a small table: rows for each case, columns for the condition, the threshold and the approver. Nothing to interpret. The facts are separated, labelled and unambiguous. A model retrieving this table can apply it correctly without inferring the structure from the grammar. A human scanning it can find the relevant row in seconds. The table is not more informative than the paragraph. It is more reliable.

Prose explains. Structure states. When a fact must be exact, let it be stated.

This principle applies at every scale. Within a document, use tables for comparisons, lists of options and anything with repeated attributes. Use frontmatter, from Part Three, for metadata. For collections of similar items, contacts, suppliers, systems, decisions, consider a spreadsheet or simple database instead of a folder of documents, because the structure then applies across the whole collection. For configuration and rules that agents must follow, use structured formats that tools can validate.

There is a balance to keep. Structure without explanation is brittle: a table of approval thresholds with no account of why they exist will be followed blindly and applied badly to unusual cases. The best documents combine both: structured facts for precision, with prose around them for context and reasoning. A decision record might have structured fields for date, owner, status and decision, followed by prose explaining the reasoning and the alternatives considered. The structure makes it findable and checkable. The prose makes it understandable.

This week, find one important document where exact facts are buried in paragraphs: a policy, a price list, a process with conditions, a list of responsibilities. Extract the facts into a table or a set of labelled fields, leaving the explanatory prose around them. Then ask an AI assistant a precise question about those facts, once using the old version and once using the new. Compare the answers. You will usually find the structured version wins. Sentences are lovely. Tables do not misread themselves.

Prose explains. Structure states. In a paragraph In a table Expense claims over 500 pounds need a director's approval, unless the expense was pre-approved in the project budget, in which case the project lead can approve claims up to 2,000 pounds. every reading is an interpretation Condition Limit Approver Any claim over 500 Director In budget to 2,000 Lead nothing to interpret Best of both: a decision record Structured fields date, owner, status, decision Prose around them the reasoning, the alternatives Sentences are lovely. Tables do not misread themselves.
Fig 87 · Structured Beats Prose. An approval rule buried in a paragraph becomes a two-row table that cannot be misread.
Chapter 88 · Part IX

Evaluate Retrieval Separately

When an AI system gives a wrong answer about your documents, the instinct is to blame the model. Often the model is innocent. In retrieval-based systems, the answer depends on two layers: retrieval, which finds the relevant material, and generation, which writes an answer from it. Retrieval usually fails first. If the right passage was never retrieved, no model, however capable, can answer correctly from it. Test the two layers independently, or you will spend a great deal of time tuning the wrong one.

The test for retrieval is simple in principle. For a question you know the answer to, look at what the system retrieved before it answered. Was the passage containing the answer among the retrieved results? Was it near the top? If not, the failure is in retrieval, and the fixes are in the library: better chunking, clearer headings, better metadata, removing stale duplicates that outrank the right document, or adding missing information. Changing the model or rewriting the prompt will not help.

If the right passage was retrieved and the answer was still wrong, the failure is in generation. Perhaps the model misread the passage, or blended it with other retrieved material, or ignored it in favour of its general training. The fixes here are different: clearer instructions about how to use retrieved material, restructuring the source so its meaning is unambiguous, or reducing the number of retrieved passages so the right one is not lost among the others.

Before asking whether the model understood, ask whether it was ever shown the right page.

Many systems use a refinement worth knowing about. They retrieve broadly, fetching many candidate passages with a fast, cheap method, then use a second, more careful step, often called reranking, to reorder those candidates and pass only the best to the model. This combines high recall at the first stage with high precision at the second, the balance discussed in Part Six. When you are evaluating a system, it helps to know whether it does this, because a failure might occur at either stage.

You do not need sophisticated tools to evaluate retrieval. A small set of test questions, perhaps ten or twenty, each paired with the document and passage that contains its answer, is enough to start. Run them periodically, especially after changing your collection or your system. Note which questions retrieve the right passage and which do not. Over time, this simple test set becomes the most honest measure of whether your knowledge system is working for its machine readers.

This week, write five test questions about your documents, each with a known answer and a known source. Ask your AI assistant each one, and for each answer, check whether the source it used was the right one. Sort the failures into retrieval failures and generation failures. Fix one retrieval failure in the collection itself, then retest. Diagnosis before treatment. Even for machines.

Diagnosis before treatment Question known answer Retrieve 50 fast, for recall Rerank to 5 for precision Model answers gets it wrong Right passage retrieved? no yes Retrieval failure usually fails first Generation failure misread or ignored Fix the library chunking, headings, metadata remove stale duplicates write the missing answer Fix how it is used clearer instructions unambiguous source fewer passages test set: 10 to 20 questions, each paired with its source passage Before asking whether it understood, ask whether it saw the page.
Fig 88 · Evaluate Retrieval Separately. Check whether the right passage was retrieved before blaming the model.
Chapter 89 · Part IX

Memory Needs Eviction

An agent that remembers everything degrades. Its memory fills with stale facts, superseded decisions, one-off details and its own past mistakes, and all of these compete for attention with the things it actually needs to know. Good memory, for agents as for people, requires deciding what gets promoted to long-term storage, what stays only in the current session and what is deliberately forgotten.

Many agent tools now have some form of persistent memory: memory files, notes the agent writes for itself between sessions, or stored summaries of past conversations. This is genuinely useful. An agent that remembers your preferences, your project's conventions and the outcome of previous work is far more effective than one that starts from nothing each time. But memory that is only ever added to has the same problem as every collection in this book. It grows, accumulates noise and becomes less useful the bigger it gets.

The solution is a lifecycle, borrowed from how good libraries and good minds handle information. Most details should stay in the session: useful while the task is underway, irrelevant afterwards, never saved. Some things deserve promotion to long-term memory: durable preferences, stable conventions, lessons from mistakes that should not be repeated. And some things in long-term memory should be evicted as they go stale: preferences that changed, conventions that were replaced, facts that are no longer true.

Remembering is easy. Forgetting on purpose is what keeps memory useful.

Promotion should be deliberate. Before something goes into an agent's long-term memory, ask whether it will still be true and useful in a month. A user's preferred coding style probably will be. The name of a temporary branch will not. A lesson such as the tests in this folder are slow; run them only when changing this module probably will. A note that a particular file was edited yesterday will not. Many agent tools let you review and edit their memory directly; use this ability, rather than letting memory accumulate unsupervised.

Eviction should be scheduled. Review agent memory periodically, as you would any collection: remove outdated entries, merge duplicates, correct anything that has become wrong. This is the weeding principle from Part Eight applied to a new kind of collection. Stale memory is worse than no memory, because the agent will act on it with confidence. An instruction to use a deprecated tool, faithfully followed for months, is a small disaster in slow motion.

This week, if you use an agent with persistent memory or a memory file, open it and read every entry. For each, ask whether it is still true, still useful and still worth the space it takes. Delete what fails. Merge what overlaps. Correct what has drifted. Then decide on a review interval, perhaps monthly, and put it in your calendar. An agent's memory is a library like any other. It needs a librarian, and for now, that is you.

Promote, use, evict This session temp branch name drop file edited today drop tests here are slow keep prefers this style keep Promote? true in a month? no: gone at session end Long-term memory tests here are slow prefers this style conventions old tool: deprecated stale Scheduled review monthly Evict stale, replaced Merge, correct overlaps, drift Stale memory is worse than none: it is acted on with confidence.
Fig 89 · Memory Needs Eviction. Only durable lessons are promoted; scheduled reviews evict what has gone stale.
Chapter 90 · Part IX

The Machine Reads Structure

Every convention you kept over the years, clean filenames, consistent dates, frontmatter, controlled tags, canonical homes, READMEs, turns out to be machine-readable leverage. People who organised their knowledge carefully, often for reasons that seemed fussy at the time, quietly built the ideal environment for their own AI assistants. Tidy people built the training set for their own tools, and they are now reaping the reward.

Consider two people who give the same AI assistant access to their files. The first has spent years naming files consistently, keeping a shallow folder structure, recording status and dates in frontmatter, maintaining a few maps of content and weeding regularly. The second has saved everything wherever it landed, with default names, in a deep and inconsistent tree, never deleting anything. Ask both assistants the same question. The first will find the right document quickly, recognise it as current and answer accurately. The second will search widely, find several candidate documents of uncertain status and produce an answer that may blend the current with the obsolete.

The model is the same. The difference is entirely in the collection. This is perhaps the most important practical lesson of the AI era for knowledge management: the quality of your tools' output depends on the quality of your organisation. Capability in the model is necessary but not sufficient. An excellent model searching a chaotic collection will give worse answers than a modest model searching a well-kept one.

The machine is only as tidy as the shelves it is given.

This is good news for anyone willing to do the work, because the work is now doubly rewarded. Every chapter in this book improves your own ability to find things, which was always the point. It now also improves every answer your AI tools give, every summary they write and every task they perform on your behalf. Organising your knowledge has become a way of improving your tools without changing your tools.

It is also good news because the machines can help with the work itself. An agent can propose names for untitled files, suggest frontmatter for notes that lack it, find duplicates, flag stale documents, draft READMEs and maps of content, and check links. The judgement remains yours: what matters, what is current, what belongs where. But the clerical labour that once made good organisation so expensive can now be largely delegated. The cost of tidiness has fallen at exactly the moment its value has risen.

This week, pick one structural improvement from this book that you have been putting off: consistent filenames, frontmatter, a README, a status field. Ask an AI assistant to help you apply it across one collection, reviewing its proposals rather than accepting them blindly. Then ask the assistant a question about that collection and notice how much better it navigates. You are not just tidying your files. You are teaching your tools to read. The shelves were always for someone. Now one of the readers never sleeps.

Same model, different shelves Tidy shelves names, dates, status, maps Same model unchanged Right and current found fast Saved anywhere default names, deep tree Same model unchanged Blended answer current + obsolete The agent can now do the clerical part Propose file names Suggest frontmatter Find duplicates Flag stale docs Draft READMEs, maps Check links you review its proposals; the judgement stays yours The machine is only as tidy as the shelves it is given.
Fig 90 · The Machine Reads Structure. One model gives a right answer from tidy shelves and a blended one from chaos.
Part X

The Frontier

Teams, provenance and the promise of a library.

Chapter 91 · Part X

Libraries That Watch Usage

Log what gets retrieved and what never does. Usage data will reorder your shelves far better than any taxonomy meeting you could schedule. This is the first frontier idea, and it is not really new: good librarians have always watched which books are borrowed, which sections are busy and which shelves gather dust. What is new is how cheaply anyone can now gather and act on the same evidence.

Most knowledge systems are designed once and then judged by feel. People believe certain documents are important because they were expensive to produce or because someone senior wrote them. Meanwhile, the documents people actually open every day may be a scrappy checklist and an unofficial page somebody wrote years ago. Usage data replaces belief with evidence. It shows you which items earn their place and which merely occupy it.

The signals are usually already available. Many wikis and document platforms show view counts and last-opened dates. Search tools can report the most frequent queries and the results people click. Your own notes app may show when each note was last opened. Even without analytics, you can sort a folder by last-opened date and see at a glance what is alive. For AI assistants, logs of which documents were retrieved to answer questions are a rich new source of the same kind of evidence.

Readers vote with every click. A good library counts the votes.

Usage evidence suggests several actions. Heavily used items deserve investment: better titles, a place on a map of content, an owner, a review-by date. Never-used items are candidates for weeding or archiving, unless they are rare-but-critical, like disaster recovery procedures, which should be marked as such so they are not pruned by accident. Items often retrieved together might deserve to be linked or merged. Searches that lead to the same document over and over suggest that document should be easier to reach, perhaps from a home page.

There is a caution here. Usage measures popularity, and popularity is not the same as importance, as Part Six noted under ranking. An item rarely used might be rarely needed but vital when it is. An item heavily used might be popular because it is wrong in a convenient way. Usage data is evidence for judgement, not a replacement for it. A good library watches usage and then thinks.

This week, gather one piece of usage evidence about your main collection. If your tools provide view counts, look at the top twenty and the bottom twenty. If they do not, sort a key folder by last-opened date. Note what surprises you: important-seeming documents nobody opens, scrappy ones everybody does. Promote one surprisingly popular item, giving it a better name and a more prominent place. Archive one item that has not been opened in years. The shelves will start to look like the library people actually use. That was always the point.

Count the votes, then think opens, last 12 months what the evidence suggests onboarding-checklist.md Invest owner, better title unofficial-howto Promote link from home page pricing + terms Link or merge opened together strategy-2024.pdf Ask why costly, rarely read disaster-recovery.md Keep, mark critical rare but vital old-meeting-notes/ Archive never opened popularity is not importance: usage is evidence for judgement Readers vote with every click. A good library counts the votes.
Fig 91 · Libraries That Watch Usage. Usage evidence sorts items into invest, promote, link, archive or keep as critical.
Chapter 92 · Part X

Self-Organising Collections

Take a large collection of documents, convert each to an embedding, group the embeddings into clusters of similar meaning, and ask a language model to suggest a name for each cluster. The result is a taxonomy that emerges from what you actually collected, rather than what you once planned to collect. This is now easy to do, and it is one of the most revealing exercises you can perform on a mature collection.

Part Two described the tension between imposed and emergent taxonomies. Imposed ones are predictable; emergent ones fit reality. Until recently, emergence was slow, because it required a person to read everything and notice the patterns. Clustering does the noticing automatically. Within minutes, you can see the actual shape of a collection of thousands of items: which topics dominate, which are scattered across many folders, which form tight groups and which sit alone.

The results are often surprising. A team might discover that a fifth of its wiki concerns a topic that has no section of its own. An individual might discover that their notes cluster around three interests they had never consciously identified. Clusters that cut across existing folders reveal where the imposed structure no longer matches how people think. Clusters that do not match any folder at all reveal missing categories, the kind of thing the miscellaneous shelf hints at, made visible at scale.

Your collection already knows its own shape. Clustering lets it tell you.

The proposed taxonomy should be treated as evidence, not as an instruction. Machine-generated clusters reflect statistical similarity, which is not the same as usefulness. Two documents might cluster together because they share vocabulary while serving completely different purposes. A cluster name proposed by a model might be accurate but uninformative. And the clustering knows nothing about who will use the collection or what questions they will bring. A person must review the proposal, keep what clarifies, discard what confuses and decide how much of the existing structure to change.

Used well, self-organisation complements the human practices in this book. Run it occasionally, perhaps once a year, on a large collection. Compare the emergent clusters with your existing structure. Where they agree, your structure is sound. Where they disagree, investigate: either the structure needs adjusting, or the clusters are picking up on something superficial. Either way, you learn something about your collection that would have taken weeks to discover by reading.

This week, if you have access to a tool or an AI assistant that can analyse a large set of documents, ask it to group one of your collections by topic and propose a name for each group. Compare its groups with your folders or tags. Pick the most interesting disagreement and look at the items involved. Decide whether the machine has spotted a real pattern you missed or a coincidence of vocabulary. The collection has been organising itself all along. You simply had not asked it what it thought.

Clusters against your folders Clients/ Projects/ Admin/ no folder one big client pricing supplier onboarding invoices hiring Cuts across two folders: structure has drifted. No folder: a missing category. embed, cluster, let a model name each group, then a person decides Your collection already knows its own shape.
Fig 92 · Self-Organising Collections. Clusters that cross folders or sit outside them show where the structure has drifted.
Chapter 93 · Part X

The Interrogable Archive

Not search, which returns a list of documents. Not chat, which returns an answer without evidence. Something in between: an archive you can question in plain language and receive cited, checkable answers from, with the sources standing next to every claim. This is the most useful form that AI-assisted knowledge systems are taking, and it is worth understanding what makes it work, because the difference between a good one and a bad one is mostly in the library.

The defining feature is citation. When the archive answers a question, it shows which documents, and ideally which passages, each part of the answer came from. You can click through, read the source and decide whether the answer is supported. This changes the relationship between you and the machine from trust to verification. You no longer have to believe the answer; you can check it. And when the answer is wrong, the citation shows you why, which is the first step to fixing it.

Citations only mean something if the sources are good. An interrogable archive built on a collection full of duplicates, stale drafts and unlabelled documents will cite them faithfully, giving the appearance of evidence without the substance. Provenance fields, status fields and canonical homes, all discussed earlier, are what make citations trustworthy. A citation to a document marked current, owned by a named person, reviewed last month, is evidence. A citation to notes (3).docx is a shrug with a link.

An answer with a source is a claim you can check. An answer without one is a claim you must believe.

The interrogable archive also changes how you write. If you know that your documents will be questioned rather than read from start to finish, you write so that each section can answer something on its own, with clear headings and explicit statements. You state decisions and facts plainly rather than implying them. You date things. You mark what is current. These are the habits of good reference writing, and they have become directly useful, because they determine whether the archive can answer well.

For teams, this kind of archive changes the economics of knowledge. A question that once required finding the right person and interrupting them can often be answered by the archive, with sources, in seconds. This is not a reason to stop talking to colleagues. It is a reason to write down what colleagues know, so that the archive can answer the routine questions and people can spend their time on the interesting ones.

This week, if you have access to a tool that answers questions over your documents with citations, use it for one real question a day. For each answer, follow at least one citation and check it. Note when the citation supports the answer and when it does not, and when the cited document should not have been cited at all because it was stale or duplicate. Fix one source per day. The archive answers from what you gave it. Give it something worth citing.

Not search, not chat, something between Search a list of documents you read them all Chat an answer, no evidence you must believe it Interrogable archive an answer with sources you can check it Q: when did supplier terms change? In March, after the review [1]. Notice is now 60 days [2]. every claim carries a source [1] pricing-policy.md current, owner Sam, reviewed Sep [2] notes (3).docx no status, no owner, no date a shrug with a link follow one citation a day; fix one bad source a day An answer with a source is a claim you can check.
Fig 93 · The Interrogable Archive. Answers arrive with citations; a citation is only evidence if its source is.
Chapter 94 · Part X

Personal Knowledge Graphs

When every note carries a permanent identifier and links to related notes, the links become edges and your collection becomes a graph that can be traversed. You can start at any note and follow its connections outward, discovering paths between ideas you never consciously linked. The value of such a collection was never really the notes themselves. It is the paths running between them.

Part Two introduced the difference between trees and graphs, and Part Four described the slip-box, which builds a graph one reasoned link at a time. A personal knowledge graph is what results when you do this consistently for long enough. Many modern note-taking tools display these graphs visually, as webs of dots and lines, which is pretty and occasionally useful. The more important capability is traversal: being able to ask what is connected to this, and what is connected to that, and so on.

Traversal is where the graph earns its keep. Say you are working on a proposal for a new client. You open your note about the client's industry, follow its links to notes about previous projects in that industry, follow those to notes about lessons learned, follow those to a note about a pricing approach that worked well. None of these notes was written with this proposal in mind. The path between them was built incrementally, one link at a time, and now it delivers exactly the context you need.

A pile of notes is a collection. A web of linked notes is a way of thinking that persists.

AI agents can traverse graphs well, which makes personal knowledge graphs newly powerful. An agent given a starting note can follow links to gather context, much as you would, but faster and more thoroughly. It can also find paths you would not have thought to look for: connections between distant notes through intermediate ones. The quality of what it finds depends entirely on the quality of the links. Links with a short explanation of why they exist are far more useful than bare links, because they tell both you and the agent what kind of relationship the link represents.

The caution, as always, is that graphs can grow into hairballs. If every note links to dozens of others without reason, traversal becomes noise. The discipline is to link deliberately: connect notes when there is a real relationship, say what it is, and prune links that no longer make sense. A graph with fewer, better links is more navigable than one with many careless ones.

This week, pick a note you consider central to your work and add three links from it to related notes elsewhere in your collection, each with a sentence explaining the relationship. Then do the same for each of those three notes. You have just built a small neighbourhood in your graph. Next time you visit that central note, follow the paths and see where they lead. Notes are the stations. Links are the railway. The journey is where the knowledge lives.

The path delivers the context Client sector start here Past project last year Lesson learned what went wrong Pricing method it worked Old proposal unused today Supplier note unused today Talk notes unused today Sector report unused today same sector taught us fixed it say why on each link; an agent can walk the same path Notes are the stations. Links are the railway.
Fig 94 · Personal Knowledge Graphs. Following explained links from industry to pricing assembles a proposal's context.
Chapter 95 · Part X

Shared Team Brains

The hardest organising problem is not personal. It is collective. A person can maintain an idiosyncratic system that works perfectly for them. A team must maintain a shared system that works for everyone, including people who joined last week, people who think differently and people who would rather be doing something else. Most team knowledge bases fail, and they fail for the same reason: contributing to them is harder than asking a colleague.

That comparison is the key. When someone needs to know something, they have two options: look it up, or ask someone. When someone learns something worth sharing, they have two options: write it down, or keep it in their head and answer when asked. In most teams, asking and answering are easier than searching and writing. So knowledge flows through conversation, stays in heads and leaves when people do. The knowledge base gets the occasional burst of effort after a crisis and slowly decays between bursts.

To change this, the knowledge base must become easier than the alternative. Make writing easy: templates for common types of document, a clear place for each kind of knowledge, permission to write rough first drafts. Make searching rewarding: good structure, current content, a home page that orients. And make the connection explicit: when someone answers a question in a chat, the habit should be to answer with a link, or, if no link exists, to write the page and then share the link. Each question answered this way improves the base for the next person.

A team knowledge base works when contributing to it is easier than being interrupted.

Ownership matters even more for teams than for individuals. Every important page needs a named owner who keeps it current. Every area needs someone who notices when it is drifting. Without owners, shared spaces become commons, and commons are famously poorly maintained. Owners do not have to write everything; they have to care whether it is true.

AI assistants are changing the economics of team knowledge in an interesting way. An assistant connected to a team's documents can answer routine questions, reducing interruptions, but only if the documents contain the answers. This creates a new incentive to write things down, because now writing benefits not only the next human reader but also the assistant that answers on everyone's behalf. Teams that make this connection explicit, if the assistant could not answer it, write the page, find their knowledge bases improving steadily rather than in bursts.

This week, start one habit in your team: whenever someone answers a question in chat that will probably be asked again, they either link to an existing page or write a short one and link to that. Make it light. Rough pages are fine; they can be improved later. Track how many pages appear over a month. You are converting conversations into a library, one question at a time. Shared brains are not built. They are accumulated, by people who decided the second explanation should be a link.

The second explanation should be a link Assistant stumped no answer found Asked in chat a routine question Is there a page? yes no Write a rough page template, then link Answer with a link not a retelling Next asker finds it or the assistant does named owners keep pages true; rough drafts are fine Contributing must be easier than being interrupted.
Fig 95 · Shared Team Brains. Every repeated question ends in a link, and a missing page gets written first.
Chapter 96 · Part X

The Decision Log

Of all the knowledge a team produces, decisions are the most valuable and the most often lost. What was decided is sometimes recorded. Why it was decided, what alternatives were considered and what was known at the time almost never are. Six months later, someone asks why the system works this way, and nobody can say. The decision is either preserved by inertia or reversed by someone who did not understand it, and both outcomes are expensive.

A decision log fixes this with a simple, durable habit. For each significant decision, write a short record: the date, the decision itself, who made it, the context and constraints at the time, the alternatives considered and why they were rejected, and the expected consequences. A few paragraphs, often less. Give each record a permanent identifier and a status, such as proposed, accepted or superseded. Keep all the records in one canonical place.

Software teams have used a version of this for years, often called architecture decision records, and the practice translates well to any kind of work. A marketing team can log decisions about positioning. A small business can log decisions about suppliers and pricing. An individual can log decisions about their career or finances. The format barely matters. What matters is that the reasoning survives alongside the outcome.

The decision is what you did. The log is why. Without the why, the what is just a rule nobody can defend.

The log is particularly valuable because decisions are rarely final. Circumstances change, and decisions are revisited. A good log lets you revisit them intelligently: you can see what was known at the time, check whether the assumptions still hold and make a new decision that builds on the old one rather than repeating the same debate from scratch. When a decision is reversed, the log records that too, with a link from the old record to the new one, so the history stays legible.

Decision logs are among the most useful things you can give an AI agent. An agent working on a project will often encounter something that looks odd: a convention, a dependency, a structure that seems suboptimal. Without the log, it may helpfully fix it, undoing a decision made for good reasons it could not see. With the log, it can check whether the oddity was deliberate and respect it, or flag it for reconsideration. The log is, in effect, a memory file for the reasoning behind the project, as Part Nine described for its conventions.

This week, start a decision log, if you do not have one. Create a single location, a folder or a page, and write records for the three most significant decisions made in your team or your work in the last month. Use a simple template with the fields above. Then make a habit of writing a record whenever a decision is made that someone might later ask about. It will take ten minutes each time. It will save hours of archaeology. The past is not obvious. Write it down while it still is.

The what, and the why DEC-007 superseded date 2026-03-12 decision One print supplier made by Ops lead context costs rising rejected two suppliers: overhead expected cheaper, simpler DEC-012 accepted date 2026-09-30 decision Add a backup supplier made by Ops lead context two late orders rejected switch fully: risky expected no single failure links one canonical place, a permanent ID, a status Team revisits it old assumptions in view Agent checks it before fixing an oddity Without the why, the what is a rule nobody can defend.
Fig 96 · The Decision Log. Each record keeps date, decision, context and rejected options, linked when superseded.
Chapter 97 · Part X

Provenance at Scale

As synthetic text floods every corpus, knowing where a claim came from becomes the whole ballgame. The archives that survive the next decade will be the ones that can prove things: that this document was written by this person on this date, that this figure came from this source, that this summary was generated from this original by this tool. Provenance, introduced in Part Three as a modest metadata field, becomes at scale a foundation of trust.

The problem is volume. AI tools now produce enormous quantities of text: summaries, drafts, reports, answers, notes and rewrites. Much of it is useful. Some of it is wrong. Most of it looks identical in style to text written by people with genuine knowledge. When this material enters your collection, which it increasingly does, a reader cannot easily tell an original record from a machine-generated derivative, or a carefully sourced claim from a plausible invention.

Provenance at scale means making origin a property of everything in the collection, not just of the items someone remembered to label. Who or what created this? From what sources? When? Has a person reviewed it? Is it original, derived or generated? These questions can be answered with a few metadata fields, applied consistently, ideally automatically. Many tools already record author and date; the frontier is extending this to capture whether content was generated, from what, and whether a human checked it.

In a world of fluent text, the scarce thing is not words. It is knowing whose words, and why to believe them.

Some of this is being addressed by technical standards for content credentials and signed metadata, which attach verifiable origin information to files. These are worth watching, and adopting where your tools support them. But you do not need to wait for standards to apply the principle. A simple convention, such as marking AI-generated content clearly, linking derivatives to their sources and recording who reviewed what, gives most of the benefit with tools you already have.

Provenance also protects against a quieter problem: feedback loops. When AI-generated summaries are saved into a collection and later retrieved by another AI to produce new content, errors can compound, each generation building on the mistakes of the last. Clear provenance lets you break the loop, by instructing agents to prefer original sources over generated ones and by making generated material easy to identify and exclude when accuracy matters.

This week, adopt one provenance convention for AI-generated content in your collection. It might be a tag such as generated, a field recording the source document and tool, or a standard line at the top of every generated document saying what produced it and whether a person reviewed it. Apply it to everything generated from now on, and to the generated items you can identify from the past month. In a few years, you will be very glad you can tell the difference. So will everyone who relies on your archive.

Whose words, and why believe them Origin recorded: who, from what, when Reviewed by a person Checked, from where? Evidence Plausible invention Traceable, unchecked pasted quote, no link signed original record summary, source linked unlabelled generated text AI draft, source linked tag generated text; link it to its source; prefer originals In a world of fluent text, the scarce thing is knowing whose words.
Fig 97 · Provenance at Scale. Content with recorded origin and human review is evidence; the rest needs labels.
Chapter 98 · Part X

Knowledge as Infrastructure

Treat your knowledge collection like a production system: with schemas, validation, backups and tests. Most people run their second brain with less rigour than a hobby database, and most teams run their wiki with less care than their least important server. This made a certain sense when knowledge bases were read occasionally by people who could compensate for their flaws. It makes much less sense now that they are read constantly by agents that cannot.

Infrastructure has a few defining properties. It is relied upon, so its failures cause real damage. It is maintained deliberately, not just when someone notices a problem. It has defined structures and checks that those structures hold. And it is backed up, monitored and recoverable. A knowledge collection that AI assistants use to answer questions, make decisions and perform tasks meets the first condition already. The others usually lag behind.

Schemas are the frontmatter contracts and controlled vocabularies discussed in Part Three. Validation means checking that they are followed: that every note has the required fields, that status values are from the allowed list, that dates are valid, that tags are in the vocabulary. This can be automated with simple scripts, or delegated to an AI agent that runs a check and reports violations. Backups mean what they always mean: more than one copy, in more than one place, tested by occasionally restoring something.

If your tools rely on it every day, it is infrastructure. Run it like infrastructure.

Tests are the frontier idea. Software developers write automated tests that check their code still works after every change. You can do something similar for a knowledge collection. A link checker is a test: it fails if internal links are broken. A schema validator is a test: it fails if metadata is missing or malformed. A retrieval test set, from Part Nine, is a test: it fails if known questions stop retrieving the right documents. Run these periodically, or after significant changes, and you will catch decay before it reaches a reader.

This might sound excessive for a personal notes collection, and for many people it is. But the principles scale down gracefully. A personal collection can have a simple schema, a monthly link check and a reliable backup. A team collection can add validation and a small retrieval test set. An organisation whose AI assistants answer customer questions from its documentation should have all of it, run automatically, with someone responsible for the results. Rigour should match reliance.

This week, choose one infrastructure practice to add to your main collection. If you have no backup you have tested, test one by restoring a file. If you have a frontmatter schema, write or ask an agent to write a short script that checks every note against it, and run it. If you have neither, start with a link check. Fix what the check finds. Then schedule it to run again. Knowledge that people and machines depend on deserves the care we give the systems that serve it. Libraries were always infrastructure. We just stopped noticing.

Rigour should match reliance Personal Team Organisation Schema frontmatter contract Validation script or agent checks Tested backup restore one file Link check fails on broken links Retrieval tests known questions Automated, owned someone reads results yes optional If your tools rely on it every day, run it like infrastructure.
Fig 98 · Knowledge as Infrastructure. Schemas, validation, backups and tests scale from a personal collection to a company.
Chapter 99 · Part X

The Librarian as Agent

The librarian's work can be described as six verbs: acquire, describe, shelve, retrieve, weed and answer. For most of history, people did all six. Increasingly, software can do much of each. The role of the librarian is becoming a job description for an agent, and the practical question for anyone with a growing collection is how to build, or configure, an agent that does all six on their behalf, while keeping the judgement that makes the work worthwhile.

Look at each verb. Acquire: agents can capture material from email, meetings, documents and the web, transcribing, extracting and saving. Describe: they can propose titles, summaries, tags and metadata fields from the content. Shelve: they can file items into the right folder or collection based on your conventions. Retrieve: they can search, filter and assemble context. Weed: they can identify duplicates, stale items and broken links. Answer: they can respond to questions with cited material from the collection. Each of these was, until recently, skilled human work.

The pieces already exist in many tools, and the rest of this book has described how to make them work well. An agent that acquires needs intake limits and a clear inbox. An agent that describes needs a controlled vocabulary and a schema. An agent that shelves needs a documented structure and a README. An agent that retrieves needs good names, chunking and an index. An agent that weeds needs half-lives, review-by dates and an archive policy. An agent that answers needs provenance and canonical homes. Every chapter has been, in part, a specification for this agent.

The librarian's six verbs are becoming an agent's job description. The librarian's judgement is not.

What remains human is judgement: deciding what is worth keeping, what the categories should be, which source to trust, what is current, what to remove and what question is actually being asked. An agent can propose answers to each of these. It cannot own them, because owning them requires understanding why the collection exists and who it serves. The most effective arrangement is an agent that does the labour and proposes the decisions, and a person who reviews, corrects and decides. The work moves from doing to supervising.

This arrangement also changes the economics of good organisation. Practices that once required hours of tedious effort, consistent naming, complete metadata, regular weeding, can now be largely delegated. This lowers the cost of a well-kept collection dramatically, at exactly the moment when a well-kept collection has become more valuable, because AI tools depend on it. People who once could not justify the effort of being organised now can.

This week, delegate one of the six verbs to an AI assistant for one collection. Choose whichever you neglect most: probably describe or weed. Give the assistant your conventions in writing, ask it to propose changes and review every proposal before accepting. After a week, decide whether to continue, adjust or try another verb. You are not replacing yourself. You are promoting yourself from clerk to head librarian. The desk work goes to the agent. The judgement stays at the top of the stairs.

From clerk to head librarian Head librarian: judgement what to keep, trust, remove, and what is really asked proposals decisions Agent: the six verbs Acquire capture transcribe needs intake limits Describe titles tags needs schema vocabulary Shelve file it by rule needs README structure Retrieve search assemble needs names an index Weed duplicates stale needs half-lives archive Answer cites sources needs provenance homes The six verbs are becoming an agent's job. The judgement is not. this week: delegate one verb, review every proposal
Fig 99 · The Librarian as Agent. An agent does the six verbs and proposes; the head librarian keeps the judgement.
Chapter 100 · Part X

A Library Is a Promise

Here is the whole book in one sentence: a library is a promise that things can be found again. Everything else, the naming and tagging, the folders and frontmatter, the inboxes and reviews, the weeding and archiving, the indexes and memory files, is machinery for keeping that promise. A collection that cannot keep it is not a library, however large or well funded. A modest collection that keeps it reliably is one, however humble.

The promise has three parties. It is made by whoever saves something, to whoever will need it later. Often these are the same person, separated by months; you are making a promise to your future self every time you save a file. In a team, the promise is made to colleagues, including ones who have not yet joined. And now it is made to machines as well: to the agents and assistants that will search your collection on your behalf and answer from whatever they find. Each of these readers is relying on the person who saved the item to have done so in a way that lets it be found, understood and trusted.

Keeping the promise does not require perfection. It requires a few habits held over years. Capture what matters before it escapes. Name things so they can be recognised. Give each important item one canonical home. Describe it with enough metadata to filter and trust it. Link it to what it relates to. Review regularly, and remove what is stale. Write down what you know, especially the reasons behind decisions. And make the structure legible to strangers, human and otherwise, so that the promise does not depend on your being there to explain.

A library is a promise that things can be found again. Everything else is how you keep it.

The tools will keep changing. Search got better, then semantic, then conversational. Agents now acquire, describe, shelve and answer, and they will do more next year. None of this changes the promise. If anything, it raises the stakes, because machines act on what they find faster and more confidently than any person, and they find whatever you left them. A well-kept library makes every tool better. A neglected one makes every tool a faster way to be wrong.

So the library is not a product you buy or an app you install. It is a practice, a set of small disciplines that survive your moods, your busy weeks and every change of software. The system you have is whatever survives your discipline. Start small this week: one folder renamed, one README written, one duplicate removed, one decision logged. Then do the next one. Over time, you will notice that you can find things, that your colleagues can find things, and that your tools give answers you can trust. That is what it feels like when a promise is being kept. It is quiet, unglamorous and enormously valuable. It is what librarians have always done. It is now, in a small way, what everyone does.

The promise, and its machinery You, saving now The machinery Capture before it escapes Name it to be recognised One canonical home Describe with metadata Link what relates Review, remove the stale Write down the why Legible to strangers Found again the promise kept Future you months later Colleagues even new ones Agents act on it fast A library is a promise that things can be found again. start small: one rename, one README, one duplicate gone, one decision logged
Fig 100 · A Library Is a Promise. Eight small habits connect the moment of saving to finding, for you, colleagues, agents.
The Librarian · First Edition, October 2026
100 chapters · 10 parts · one hundred diagrams
by Mat Siems · MS Books, No. 16 · 2026