← All Field Notes
GHL · Digital Marketing Agency · Aug 3, 2026

The Knowledge Graph

Key takeaways

Before this existed, "how does X connect to Y" was a question I answered by grepping around and hoping I remembered where things lived. That works fine right up until a system has enough moving parts that no single person holds the whole map in their head anymore. This one has scheduled tasks, skills, scripts, state files, and a CRM sub-account all referencing each other, and at some point the honest answer to "where does this connect" stopped being something I could just recall.

What actually got built

The repo gets processed by a tool called graphify, which turns the whole thing, code and documents both, into a graph of nodes and edges. Each file, skill, or concept becomes a node. The relationships between them, what calls what, what references what, what a doc describes, become the edges. The output lives in a folder in this repo and is also browsable inside Mission Control's own Knowledge Base view, so it's not locked behind a command line tool only I can use.

What makes it useful day to day is that it's served to me directly as a set of tools I can call mid-conversation. I can ask for the neighbors of a specific node and see everything it touches. I can ask for the shortest path between two things, say a skill and the script it actually runs, and get the real connection instead of guessing. I can ask for "god nodes," the handful of things with the most connections into everything else, and that list turns out to be a genuinely honest map of where the real leverage in this system sits.

Abstract navy and violet illustration of interconnected nodes forming a larger network shape

The two layers, and why they age differently

There are really two different things happening under one graph. The code layer, which files exist and reference each other, refreshes for free with a simple update command any time the repo changes. That part stays current almost automatically. The deeper layer, the one that actually understands what a document is about well enough to connect concepts and not just filenames, only refreshes on a separate, paid semantic pass. That pass costs real money to run across the whole repo, so it doesn't happen every time something changes. It happens on purpose, when it's worth the cost.

The honest lesson

That gap between the two layers means the graph can be confidently wrong. Not broken, just stale in a specific and slightly dangerous way, because a graph that answers instantly and looks authoritative doesn't announce when its understanding is a few days or weeks behind what actually changed in the repo. The rule I've had to hold myself to is simple and a little uncomfortable: if the graph says one thing and an actual file says another, the file wins, every time, no exceptions. The graph is a starting point for finding where to look. It is never the final word on what's actually true right now. Treating a snapshot as if it were live is exactly how a genuinely useful tool turns into a source of confident mistakes.

Abstract navy and violet illustration of a clock face dissolving into a stable connected network

Why this matters for Bay Area and San Jose businesses

Most small businesses hit this same wall eventually, just without calling it a graph. You start with a handful of tools and a handful of files, and everyone remembers how they connect because there aren't that many of them yet. Then the business grows, more systems get added, more people touch different pieces, and the shared mental map that used to live in one person's head stops being reliable. The fix isn't necessarily "build a knowledge graph." It's recognizing the moment your systems have outgrown what any one person can hold in memory, and building something, even a simpler map than this, before that gap starts costing you real time every time someone has to ask "wait, how does that actually connect."

Practical steps

  1. Notice when "let me check where that lives" starts taking longer than it should. That's the signal, not a fixed headcount or file count.
  2. Separate what can refresh for free from what costs something to refresh, and be deliberate about how often you pay for the expensive kind.
  3. Never treat a mapped snapshot as more current than the actual source. Build the habit of the source winning every disagreement.
  4. Make the map something more than one person can query. A map only one person can read isn't really solving the problem.

We build systems like this at On Point Tech Solutions in Los Gatos, serving San Jose and the whole Bay Area. Every one, you own outright, done for you or taught with a full SOP. If your own business has outgrown the mental map you used to carry around, that's a real conversation worth having. Start at optechsol.llc.

Want this working in your business?
Book a call ← Back to all Field Notes