← Systems

Self-Maintaining Knowledge Vault

second-brain
Year
2026
Used by
The Course Companion team, and the model for the whole company
  1. triggerA knowledge base is current only while somebody maintains it by hand, and nobody does that reliably for long.
  2. transformationNine scheduled jobs sweep the sources on fixed days, diff the vault against its own index, and file new material where it belongs.
  3. outputA knowledge base that updates itself every week, with every summary kept in agreement with what it summarises.

metricNo public number

8 sources converge on one hub, MCP: Important links, Meeting notes, Prototypes, Decisions, Opportunities, PRDs, User research, Screenshots. Out of the hub: Every summary brought back into agreement.

  • Important links
  • Meeting notes
  • Prototypes
  • Decisions
  • Opportunities
  • PRDs
  • User research
  • Screenshots
MCP

Every summary brought back into agreement

Every knowledge base decays the same way. Somebody sets it up carefully, it is accurate for a month, and then reality moves and the document does not. The usual fix is discipline, which is another way of saying it will decay.

So the maintenance is scheduled rather than intended. Nine jobs run across the week, each with one source and one destination. Meeting notes are pulled in and filed. Engineering channels are swept for anything that breaks the local environment, and the runbook is updated when something does. The vault is diffed against a stored index, so a digest can say what was actually added, updated and removed rather than what someone remembers. New research is filed into the right folder.

Filing is only half of it. Every summary document that depended on the old state is brought back into agreement. That is what makes it a system rather than a pile of scripts: material does not wait in an inbox to be sorted, it arrives, it is filed, and whatever summarised the previous state is corrected. It never invents a decision or a number, and anything it inferred is marked as inferred.

It is maintained, not just running. One job is retired with a written note not to turn it back on, because what it did was folded into another. One is paused and run by hand, because it deletes things. One exists only to remind someone to run that one, and reschedules itself. Every job runs on a single machine while the app is open, so a missed run fires on next launch rather than never.

It started as the Course Companion team's vault, and it became the model for the whole company.

More systems

  • Design System for AI Prototyping

    Two component systems, desktop and app, rebuilt 1:1 between the frontend repo and Figma, every variant and state, so a prototype made with AI already looks like the product.

    design-system · 2026 · how it works
  • Frontend Shipping Guide

    A skill that takes a designer, PM or analyst from an idea to a merged change, and proves with a search which files the change can reach before a line is written.

    pipeline · 2026 · how it works
See all 5