Second Brain system-v1
Contents

Using your second brain

You keep this second brain by talking to an AI agent. You tell it what happened and what you need to do, and it files, links, reminds and reviews. You read and plan in your views, and you can always open a note and fix it yourself.

This page shows what that looks like from day to day.

Start a session

Open your agent in the folder that holds your vault. It first reads the vault’s instructions and what it remembers about how you like things. Then it tells you in a few lines what needs you today. If nothing does, it says nothing.

Inside the vault, the agent creates and edits notes on its own. After each batch it saves a version, so you can always undo. It asks you first before changing your rules, before deleting a note, and before anything outside the vault, like sending a message or booking something.

Get things in

One sentence is enough. Say it the way it comes to you:

remind me to call the plumber
Sam's birthday is 2 July
dentist on 14 November at 10:00

After a meeting or a call, hand over what you have: a transcript, your notes, or a single line.

here's the transcript of my meeting with Sam, update the vault
talked to Sam, the website deadline moved to 1 December

The agent keeps the conversation and files what came out of it: tasks, dates, and things worth remembering about people. What it can’t place waits in your inbox with a question. You get one short summary of what went where.

You can also drop notes in the inbox yourself, in any form. Say process the inbox when you want them sorted. Just thinking out loud? Nothing is saved unless you ask.

Ask

what am I waiting on?
when did I last talk to Sam?
I have an hour at home, what can I do?

Answers come from your notes, with links to them. If the agent can’t find something, it tells you where it looked instead of guessing.

Plan your week

At the start of each week the agent builds an overview from what the vault already knows: appointments, deadlines, repeating tasks and birthdays. Planning on top of that is up to you.

help me plan this week
this week I want to choose the hosting for Sam's site

Do, and mark it done

Work from your views: today, this week, each project’s next step, and what you’re waiting for. When something is done, mark it done in a view, or tell your agent.

I called the plumber
paid the rent yesterday
sent the landlord the form, waiting for a reply

Either way, your notes stay in step. A repeating task moves to its next date, and anything you’re waiting on gets a date to chase it.

Review

Once a week, the agent leads a review of about twenty minutes. You empty the inbox, look back, check each project’s next step, look two weeks ahead, and plan the week. On a busy day there’s a five-minute version.

let's do the weekly review
just the short review today

The agent prepares, and you decide. Skipping a review loses nothing.

After a break

Back after a week or more away? The agent doesn’t hand you a long list. It says something like “Welcome back. 3 things need you now; 14 others can wait.” Then you choose: just what matters, small batches, or not now.

It never quietly settles a deadline, a bill, or anything someone else is waiting on. What was set aside comes back a few at a time in later reviews.

A week with it

Each session
The catch-up: a few lines, or nothing when nothing needs you. In the first session of a week, the week plan builds itself.
what does my day look like?
Through the week
Capture things as they come up. Work from Today and This week, and mark things done.
talked to Sam, the deadline moved; I called the plumber
End of the week
The weekly review, about 20 minutes, led by the agent, then, if you want one, a plan for the week.
let's do the weekly review
A week with a second brain. Each drawing is one week, Monday to Sunday: sessions in red, with days off left blank; things captured as open circles and things done in red; the review on your review day (Sunday by default), looking back over the week. Restated from sections 4.4 to 4.8 of the system design.

The rhythm is a guide, not a rule. Miss a day or a few weeks, and nothing is lost.

It learns your ways

Correct the agent the same way twice, or say “always do this”, and it proposes a rule. It adds the rule only after your yes. Until then, what it noticed stays in its memory, and memory never decides what is true. Your notes do.

Go deeper

Each flow here comes from the system design: capture, organize, conversations, the catch-up, reviews, the week plan, coming back after a break and doing. What the agent may and may not do is in boundaries.

In the author’s implementation

How the author runs it. This is one example, not part of the framework. The details are in Implementation.

  • Agent: Claude Code, Codex, or VS Code with GitHub Copilot, started in the vault folder. The vault’s instructions live in AGENTS.md.
  • Views: Obsidian with Ninja Board, which shows Today, Week, Projects, Backlog & Waiting, and a Guide. Marking something done there makes the same edit the agent would.
  • Getting started: Second Brain Setup sets up a vault from one sentence to your agent.

Second Brain Setup is an early version. Today its agent edits notes when you ask, and you plan and mark things done on the boards. The catch-up, the reviews and the week overview come in later versions.