Skip to the text
waywardcelt.com · writing · contextkeeping-a-toolkit-built-the-way-it-tells-you-to-build · proof no. 4 · November 6, 2026 · author: J. O’Donnell · editor: also J. O’Donnell
The Wayward Celt
Galley · entry · November 6, 2026

Contextkeeping: a toolkit built the way it tells you to build

Filed under KCS The Workbench Work · 5 minute read

The Contextkeeping Toolkit is a self-serve kit for running a governed knowledge program in the age of AI: ten guides, fifty PDFs, and every working file behind them.

Editor: Serial comma: present.

Author: Always.

Built the way it tells you to build. Three pages from the Contextkeeping Toolkit.

KCS was built on two assumptions. Humans write the articles, and humans read them. In the last three years both quietly died.

AI can draft an article from a resolved case in seconds, so the capture tax that sank a thousand KCS programs is nearly gone. And the reader of your knowledge base is, more and more often, a machine assembling an answer for someone who will never see the article page. What survives is the part everyone treated as vegetables: governance. In this new world it’s the load-bearing wall.

01 · The intent

I wanted to package what I’ve learned running knowledge programs into something a team could pick up on a Monday and use, without hiring me, without buying a platform, and without pretending the AI era hasn’t happened. The toolkit’s own field guide puts it in six words: keep the soul, replace the machinery.

It’s KCS-informed, not KCS-branded, and it runs on whatever a team already owns: Zendesk, Salesforce Knowledge, Notion, plain git, or any other tooling you may have. Underneath is one operating model, the Governed Knowledge Loop.

The Governed Knowledge Loop: capture, curation, and delivery around a governed system of record, measured by cost per answer.

The authoring rules in the toolkit are stricter than the ones I’d give a client:

  • Cost per answer, never deflection first. Deflection appears only as a clearly labelled legacy view.
  • Nothing probabilistic writes to the record without a human decision. That’s the headline rule of the governance pack, and the reason the curation gate exists.
  • Only one module is allowed to name a model. The prompt library is the designated living module. Everything else has to stay true five model generations from now.
  • No real-world material, ever. Every toolkit example runs through a fictional company, Meridian Systems, and every number is a placeholder the buyer replaces.
  • Placement before prescription. The maturity assessment comes first, and your level is your weakest dimension, because bolting AI onto immature knowledge produces confident wrong answers with your logo on them.

That last idea has a name in the toolkit, the Precision Paradox: the more fluent AI answers get, the more each remaining error costs, because nothing in a polished answer signals doubt.

02 · The process

The toolkit lives in a git repository as Markdown and YAML, because a knowledge toolkit that wasn’t itself governed knowledge would be a very expensive joke. A build script turns the source into branded PDFs and per-product zip files, and a validator stands at the gate. It checks every document against the metadata schema, sweeps for leftover placeholders and stale branding, verifies the cross-references between modules, refuses a workbook whose formulas haven’t been recalculated, scans for terminology adherence, and then re-reads every built PDF to make sure the disclaimer and branding actually made it onto the page.

Editor: ‘very’: cut?

Author: Stet. Very.

editor: A release gate. For PDFs.

author: For everything. That’s rather the point. Stet.

Editor: Set as display. Bigger.

Author: Bigger.

The first day, August 9, did most of the heavy lifting: the scaffold and the field guide, the curation gate kit, the governance pack, the measurement workbook, the prompt library, the assessment, and the rollout playbook, then the brand, the PDF pipeline, and the store copy. By evening it had a name, Contextkeeping, and a version number, 1.0. Claude did the typing. I did the arguing, and the commit log shows where I won: a reordered module list, renamed loops, a refund policy, and terminology corrected more than once.

Inside the box: the field guide, the end-to-end walkthrough, the assessment, the levels, the measurement workbook guide, and the content graduation model.

Three releases followed, each adding a layer:

  • v1.1 (August 10): terminology governance. Terms are retrieval keys, for people and for machines. The pack’s rule is precision first: every replacement has to be more precise than the word it replaces. A few days later I overruled my own audit plan from thirty days to two or three weeks, and the whole pack was swept to match.
  • v1.2 (September 6): content graduation. The model I first built in 2014 and have iterated in production ever since: promotion up a trust ladder on measurable criteria, retirement on evidence, and the route from a workaround to a product fix. Two days later the terminology audit became a runnable tool instead of a procedure.
  • v1.3 (September 18): standards and style. Alignment with version 2.0 of the published Machine-Ready Knowledge standard, and an estate-wide em-dash sweep, because I don’t use them and neither does anything with my name on it.

03 · The outcome

Version 1.3 is built and validated: a field guide and nine modules, fifty branded PDFs, and every working file behind them. That means article templates with gold-standard examples, eight AI prompts (four of them for drafting) with an evaluation protocol that catches silent regressions when models change, three gate checklists, governance policies ready to ratify, a sixteen-tab measurement workbook built on cost per answer, a ninety-day rollout playbook, a terminology pack, and the content graduation model. All built from my own learning, words, and guidance. The store listings are up and delivering their files.

The ledger: 10 guides, 50 branded PDFs, about 46,000 words of source, 4 releases, 49 commits, 1 release gate.

My favourite piece is the smallest. One Issue, End to End follows a single support ticket through every module: a resolved case, a drafted article, a gate decision, an update when the world changes, and the economics of what one governed article is worth. Total human time across the issue’s entire life is about seven minutes. If you only read one document in the box, read that one.

The lesson of building it is the one I’d want buyers to take away. A toolkit that tells you to govern your knowledge had better be governed knowledge itself: in version control, validated before every release, every claim traced, and nothing shipped that a gate hasn’t seen. Otherwise it’s just another binder on a shelf, and those have never saved a support organization.

So, a question for anyone who owns a knowledge base: who is its next reader? If your answer isn’t “a machine,” look at your logs again.

Editor: Starting with ‘So’?

Author: And why not.


Transparency note: drafted with Claude from the toolkit repository, its changelog, and its field guide, then read, cut, edited heavily, rewritten, and finally approved by me. As always: AI drafts, humans ship.

Read by a human
OK to ship
November 6, 2026 · J. O’D.

AI drafts, humans ship. This entry has been through the human.

§ · More filed under KCS

17entries
Send me the corrected proofs

New entries by email. Join other subscribers to stay in the know!

Thirty minutes, no agenda required.
Book a call
© 2026 The Wayward Celt · set in Cormorant Garamond, Spectral, Barlow, and IBM Plex Mono · serial commas throughout