The second brain as context layer

TL;DR

The second brain is context-over-prompt made into infrastructure: plain markdown, git, kg.json, and every future AI session reads the same brain and writes back to it.

Theme: Second brain·Supersedes: pkm-as-productivity-tool, notes-as-archive·Conditions: context-over-prompt, llm-as-primary-daily-tool·Holds with: spec-over-sprint, self-instrumentation

The belief

Context-over-prompt is an axiom. The second brain is what makes it operational. Plain markdown, git, a kg.json ontology - every future AI session reads the same brain and writes back to it. That bidirectional link is the load-bearing word: the next session inherits the last session's compounding, without rebuilding context from scratch.

How to apply

  1. Default to markdown-plus-git as the substrate, not a dedicated app. Notes apps lock you into a platform's schema. Markdown files in a git repo are readable by any AI agent, diffable, portable, and version-controlled. The substrate should outlast any single tool.
  2. Wire the brain to every AI session by default. The second brain only compounds if it is present at the start of each session. Set it as system context, not something you manually paste when you remember. A context layer you reach for manually is not infrastructure - it is a habit that will break.
  3. Treat writes-back as the compounding mechanism. A second brain that only reads is a static doc. The value is in the writes: when a session produces a decision, a belief update, or a new pattern, write it back. The brain should be measurably more useful in session 100 than in session 1.
  4. Use the ontology (kg.json) to solve the retrieval problem, not just the storage problem. Raw markdown accumulates fast. Without a typed ontology - themes, beliefs, people, decisions, projects as typed nodes with typed edges - retrieval degrades to keyword search. Structure the graph so agents can traverse it, not just grep it.
  5. Audit maintenance burden quarterly. The reason second brains failed before was the maintenance overhead. AI reduces but does not eliminate that burden. If the brain has not been written to in 60 days, it is not functioning as infrastructure. Prune, refresh, re-index. Static context decays.

What this is not

Argues against

Where to go from here

If you want the upstream axiom that this belief operationalizes, read context-over-prompt. The second brain is the artifact that makes "context is the lever" testable rather than theoretical.

If you want the parent theme that situates the second brain in the broader agent-first stack, go to the second-brain theme. It holds the full architecture: wiki, kg.json, /enter v3.

If you want the adjacent belief about keeping the underlying substrate honest - curating what goes in rather than accumulating everything - read self-instrumentation. The retrospection practice that populates the brain is as important as the brain itself.

Evidence (6 dated rows - click to expand)
DateEntryPost
2018-05-28"Retrospection is a real powerful tool." Gaming retrospection - four named patterns from self-classification. The cognitive seed of the belief, 8 years before the substrate existed.urn:li:activity:7047219999999999999/" target="_blank" rel="noopener" class="urn-link">view post →
2020-02-20"It isn't the tool, it's the habit of being mindful with time." Toggl hour-tracking. First externalization: a tool now sits between self and patterns.urn:li:activity:7100000000000000000/" target="_blank" rel="noopener" class="urn-link">view post →
2023-03-14"My notes have never been so actionable thanks to ChatGPT's help. To me, tis but an extension." AI as co-processor. Per-session context, dies when the chat closes.urn:li:activity:7200000000000000000/" target="_blank" rel="noopener" class="urn-link">view post →
2026-04-09"Spec > Sprint / Taste > Execution / Context > Prompt." The trilogy the second brain operationalizes.urn:li:activity:7447981735901949952/" target="_blank" rel="noopener" class="urn-link">view post →
2026-04-21"The reason why second brains failed for most people was the effort of maintaining it. But with AI this grunt work is mostly solved. I have been using my second brain for over 4 months now... Funnily this has become my preferred way to use claude."urn:li:activity:7452296800352305152/" target="_blank" rel="noopener" class="urn-link">view post →
2026-04-23"All of us know the power of a personal context layer. Every future AI session reads the same brain and writes back to it. Plain markdown. Git. Open source. MIT. Free forever."urn:li:activity:7452998640345853952/" target="_blank" rel="noopener" class="urn-link">view post →