Skip to content

Commit 359da71

Browse files
authored
Post: building a second brain with Git & agents (#42)
* feat: add building a second brain post * wip: add todos for demo + template when back * feat: add v2 * fix: move it move it * fix: correct year in "Building a Second Brain" post
1 parent a45ea32 commit 359da71

File tree

1 file changed

+70
-0
lines changed

1 file changed

+70
-0
lines changed
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: "Building a second brain"
3+
date: 2026-04-06
4+
description: "Extending my contexts using Git + agents — and what the log reveals that I never intended to show"
5+
tags:
6+
- project
7+
---
8+
9+
I've cycled through many writing mediums—notebooks, Apple Notes, Notion, Evernote, Google Docs, and paper. It wasn't until December 2025 that I settled on a Git repository as my primary system for logging thoughts, work, and learnings.
10+
11+
The shift came after reading [Jon Magic's "How I Work, 2025 Edition"](https://jonmagic.com/posts/how-i-work-2025-edition/) and revisiting [Ben Balter's "Why everything should have a URL"](https://ben.balter.com/2015/11/12/why-urls/). As someone who's worked with Git since 2012, the transition felt natural—directing my working memory into version control rather than scattered notes apps.
12+
13+
The immediate benefit: performance reviews and accountability. Instead of scrambling to remember what happened in the last quarter, I had a structured log. Over the past few months, I've used this system to understand my own processes better.
14+
15+
## Current Structure (April 2026)
16+
17+
- **Daily Projects** — Day-level focus logs and context, organized by date
18+
- **Weekly Notes** — Planning, goals, and backlinks; weekly anchors for reflection
19+
- **Meeting Notes** — Conversations with timestamps and action items
20+
- **Snippets** — Weekly accomplishment summaries (Ships, Collabs, Risks, etc.)
21+
- **Executive Summaries** — Distilled updates for leadership
22+
- **Projects** — Multi-week initiatives with milestones and resources
23+
- **Self** — Personal context: assessments, performance reviews, goals, personality insights
24+
- **Feedback, Transcripts, Templates, Archive** — Supporting systems
25+
26+
### Automation Skills
27+
28+
I've built several agent skills to power the workflow:
29+
30+
- Creating daily notes
31+
- Summarizing weekly notes
32+
- Transforming meeting transcripts into reusable artifacts
33+
- PR review assist: tracking reviews and reusable context
34+
35+
## What the Git Log Reveals
36+
37+
The real insight came from studying the corpus itself. I've used the historical record to crawl my writing, build a personal writing style guide (packaged as an agent skill), and link ideas across contexts. But the most revealing discovery was what Git captures *unintentionally*.
38+
39+
### The Commit Graph as Data
40+
41+
The content of each note is intentional—I chose every word. But the commit graph isn't. The timestamps, cadence, and gaps accumulated without my direction.
42+
43+
**The gaps are information too.** What doesn't appear in the commit history is as expressive as what does.
44+
45+
- Weekends are nearly silent (intentional design working as intended)
46+
- The system is almost entirely optimized for *capture*, not *retrieval testing*. Writing something down is treated as equivalent to knowing it. The implicit bet: `git log` itself is the retrieval mechanism. When I need to reconstruct February, I run the log, filter by date, and follow the breadcrumbs.
47+
48+
### Time Made Legible
49+
50+
It's easy to treat version control as a technical requirement—something developers use because that's what we do. But in a knowledge system, Git does something different: it makes time legible.
51+
52+
- Every commit is an unfakeable timestamp
53+
- Every commit message is a claim about intent
54+
- Every diff is the delta between two states of mind
55+
- The full history is preserved—not edited, not summarized, not lost
56+
57+
You can go back and see not just *what* you thought, but *when* you thought it and *how confident you were*.
58+
59+
**This is what separates it from a notes app.** Notes apps store content. Git stores content *and* the progression of content over time. The progression is often more valuable than any single snapshot.
60+
61+
## Where This Is Headed
62+
63+
The system is alive and imperfect. Some weeks are captured in detail; others get a single setup commit and nothing more. The structure has evolved—directories renamed, skills removed, workflows refactored. That evolution is documented too (which is the point).
64+
65+
The goal was never perfection. It was to build a system that improves through use—and that leaves enough of a trail that anyone paying close attention can see the shape of the work over time.
66+
67+
---
68+
69+
**Resources:**
70+
- [second-brain-template (open source)](https://github.com/francisfuzz/second-brain-template)

0 commit comments

Comments
 (0)