The repo is the record
Facts live as plain files beside the code they describe. No database, no catalog service. Models in the repo, payloads where they belong.
Organizational knowledge, kept true by a compiler.
Who owns which service. What depends on what. Knowledge as code puts those facts in git, reviews them in pull requests, and lets a compiler reject the ones that stop being true. No wiki rot, no stale catalog.
This approach is implemented in Cueto, open source on GitHub.
Nobody lied. The facts just went stale.
A wiki can say Alice owns the billing service long after she has left. Write ownership as a typed reference instead of a string, and the claim only compiles while Alice exists. Remove her, and the build fails in the same pull request.
How knowledge as code works.
Six pieces that turn scattered facts into a record a compiler can vouch for.
Your vocabulary
You decide what exists in your world, teams, services, datasets. Nothing is imposed, because people only maintain schemas they own.
Composition
Packages from different teams merge into one unified view with no central coordinator. The org-wide picture is derived, never written by hand.
The membrane
CI validates every change. References are typed against what actually exists, so a change that breaks one is rejected at the door.
Pipelines
Imports from HR systems, wikis, and warehouses converge into the repo, and pass the same checks as any human edit.
History and review
Git is the archive, the pull request is the review. Versioning did not need to be reinvented.
Knowledge that cannot quietly rot.
The checks run on every proposed change, forever. Agents and busy humans keep adding facts, and the ones that stop being true fail the build instead of drifting silently.
Adopting knowledge as code.
Adoption is incremental, and each step pays for itself.
01
Start with one domain
Pick the facts that go stale fastest, usually service ownership, and encode just those. One domain, a few files.
02
Turn on the membrane
CI checks every pull request from day one. Drift stops accumulating the moment the first check runs.
03
Connect the sources
Pipelines import from the systems you already run, and the record grows without manual upkeep.
Encoding knowledge as code is hands-on work we take on in delivery engagements. For another system we designed and shipped, read the PR Triage design study.
Curious whether this fits your organization?
We will look at where your knowledge lives today and where encoding it would pay off first.