For approved readers
Wrong password.
For a friend
Obsidian and Claude, from an empty folder to a working system.
Francisco Lorca · August 2026
This page is behind a password, so Claude cannot open the link itself. Save it first — in your browser, File → Save Page As, or print it to PDF — then start a conversation, attach the file, and say:
"Read this guide. Walk me through it one section at a time, do the mechanical work for me as we go, and stop after each section until I say continue. Ask me anything you need rather than assuming."
That is the intended way to use it. Reading it front to back first is optional.
01
All three are reversible, so decide quickly. But decide, because each one determines the shape of everything after it.
Claude Code, or Cowork
Claude Code runs in the terminal and reads and writes files on your machine directly. Cowork — Claude in the browser and the desktop app — works through connectors instead. You will end up with both: Claude Code does the work, Cowork handles whatever is open in front of you. Start with whichever feels safer; the vault underneath is the same.
Surface
Plain files you own
Markdown files in a folder, not notes inside an app's database. That single choice is what lets every version of Claude read the same thing, and what means you keep everything if you stop using any of these tools.
Format
The commonest mistake
Resist the urge to split knowledge across a notes app, a drive, and a wiki. One vault. Cloud sync sits underneath it as plumbing, not as a second home. Overlap is where the system quietly dies.
Architecture
Obsidian is a good default for the second decision — it is a viewer over a folder of markdown files, not a database. If you delete Obsidian tomorrow, every file is still there and still readable.
02
A vault is just a folder. Obsidian gives you a way to read and link it; Claude reads the same files off disk. Nothing is stored anywhere else.
Cloud storage lies to you about what is on your machine. iCloud, Dropbox and OneDrive all default to keeping files "in the cloud" and streaming them down when you double-click — so Finder shows you a full folder while the disk holds nothing but placeholders. Obsidian handles that; Claude does not. It reads the disk. A streamed file reads as missing or empty, and you get confident answers built on nothing.
Turn streaming off for the vault before you put anything in it. On a Mac: System Settings → your Apple Account → iCloud → iCloud Drive, and switch off Optimise Mac Storage. Then right-click the vault folder in Finder and choose Keep Downloaded. Dropbox calls the same setting "make available offline"; OneDrive calls it "always keep on this device". Do it on every machine, not just the main one.
Numbered folders so they sort in a deliberate order rather than alphabetically. This is the shape mine has settled into after four months:
"Create this folder structure in my vault, with a one-line README in each folder saying what belongs there. Do not create anything else yet."
Empty folders are fine. They are a set of decisions about where things go, made once, so you never have to make them again mid-task.
03
There are several ways to talk to Claude and they should all read the same vault. One of them does the heavy lifting; the others are specialists.
| Way in | What it does | What it should not do |
|---|---|---|
| Terminal | Reads and writes files directly, runs the system end to end, and is the only one allowed to edit your rules. | Nothing. This is the one that does the work. |
| Cowork | Claude in the browser and the desktop app. Drafting, quick questions, editing an open Word or PowerPoint file, working from a phone. Section 04. | Editing the rules folder. It proposes changes as dated notes for the terminal to review and apply. |
| Scheduled runs | Anything that should happen without you — mine reads my inboxes five times a day. | Anything it cannot undo. Give it read-only permissions and let it hand you drafts. |
"Here is my vault folder. Set yourself up to read it at the start of every session, and tell me exactly which file you will read first and where it lives."
Test it before moving on: start a fresh session and ask a question only the vault could answer. If it answers from the file, the wiring is right.
04
Cowork is Claude in the browser and in the desktop app. The terminal does the heavy work, so it is tempting to skip this. Do not: there are three things Cowork does that the terminal cannot, and one of them you will hit in the first week.
The one you will hit first
Editing a Word, Excel or PowerPoint file that is open in front of you, live, while you watch. Writing to that file from the terminal instead gets silently overwritten the next time the app saves. This alone justifies the second surface.
Live editing
Connectors
Email, calendar and cloud drive attach here as permissions you grant once. This is how Claude comes to know what is in your inbox and what your week looks like.
Reach
Phone and browser
The same setup, on any machine, with no terminal. Useful far more often than it sounds — most of what I ask for in a day is a question, not a build.
Anywhere
The point is that it reads the same folder, so nothing has to be explained twice. Two steps.
"Write me the shortest possible instruction to paste into my settings here so that you boot from my vault's entry-point file and follow the same rules as my terminal sessions. Then confirm what you can and cannot reach from this surface."
Cowork also takes skills — small instruction modules that fire on a kind of task rather than on a keyword. Mine cover drafting an email in my voice, building a document on my template, and building a deck. They are worth adding only once you have the voice files from section 07; before that there is nothing for them to apply.
| The task | Surface | Why |
|---|---|---|
| Anything with rules, files or a project attached | Terminal | The default. It sees everything and it is the only one that can change the system. |
| A document open in front of you | Cowork | Live edits in the running app. A disk write behind an open file gets clobbered. |
| Away from the machine | Cowork | Same vault, no terminal needed. |
| A quick question not worth a session | Cowork | Not everything deserves the ceremony of a logged session. |
Two surfaces, one vault, one writer. The split only works because the second one proposes instead of editing.
05
This is the core of the whole thing, and it is three files. Every session begins by reading them, in one batch, before anything else happens.
| File | What goes in it | How to write it |
|---|---|---|
| The entry point | What Claude is for, and an instruction to read the next two files together before responding. | Short. Mine is under 40 lines. It points; it does not explain. |
| About me | Career, current ventures, who you work with and in what register, languages, what you are focused on this quarter. | Do not write this yourself. Have Claude interview you and draft it. |
| My rules | How to work. File paths, what needs approval, output style, hard stops. | Start with five rules. It grows on its own — see section 12. |
"Interview me to write my about-me file. Ask one question at a time, and push back when an answer is vague or when it contradicts something I told you earlier."
"Now draft my rules file from what you have learned about how I actually work in this conversation — not from best practice."
The interview matters more than it sounds. Writing about yourself from a blank page produces a CV. Being asked produces the things you would never have thought to write down, which are exactly the things that make the output sound like you.
One batched read at the start of every session — entry point, about me, rules. Everything else loads only when a task calls for it.
06
I got this one wrong for four months. My configuration told Claude who I am and what to do, and never once said what it was there to achieve. A system made only of rules produces obedience, and obedience is not what I need from it.
The harder half is disagreement. I did not want to be argued with about everything, and I did not want a second personality to manage. What worked was three escalating levels with honesty constant across all of them, and only the friction varying.
Always on
If Claude sees something that changes what I should do, it says so in one line and carries on with the job. The bar is deliberately checkable: would this change my decision — not would Claude have done it differently.
Unprompted
Three words that flip it
Stop executing, argue the framing properly, find what I am missing. Agreeing with me is explicitly not the goal. It goes back to normal on the next task.
On demand
On anything expensive
Legal, tax, valuation, structuring — separate reviewers go looking for the errors rather than confirming the answer, and I am told what they found instead of handed a clean draft.
Automatic
A personality paragraph — "a sharp, incisive strategic partner" — reads well and arbitrates nothing. "Adviser, not executor" was worse, because it is simply false: I ask for execution constantly, and a line that fails on its face teaches Claude to discount everything around it. A trigger phrase on its own also failed, for the reason that matters most: the moment I most need challenge is when I am moving fast and confident, and that is exactly when I would never think to ask.
Write this early. It is the single highest-return page in the whole setup, and I wrote it last.
07
Generic AI prose is the thing that makes people abandon these systems. The fix is not a prompt asking for a better tone — it is a file per format, extracted from things you actually wrote.
"Read these twenty emails. Write a voice file that would let you reproduce how I write — including the things I avoid. Be specific enough that another person could follow it. Then show me the three patterns you were least sure about."
Six files. One loaded per task. Corrections go into the file, never just into the draft.
08
Pick something live and slightly messy. The point of the first project is not to finish it; it is to establish the shape that every future project copies.
| Artefact | What it is | The discipline |
|---|---|---|
| State file | A short snapshot: where this stands, what is open, what is next. | Stays slim. Always current. Detail moves out to the log. |
| Log | Append-only record of what happened — dated, newest at top, a few sentences each. | Never edited. Only added to. |
| Decisions | One file per decision worth defending: context, alternatives you rejected and why, consequences. | Frozen once accepted. Reversing it creates a new one. |
| Outputs | Drafts in current. Signed-off in sent. Replaced versions in superseded. | A state machine on documents. Nothing is ever deleted. |
The distinction that took me longest: a log entry records something that happened; a decision record captures something you decided, with the alternatives. Both can come out of the same session. If you cannot tell which one you are writing, you are writing a log entry.
"Create a project folder for [project] in this shape. Then interview me to write the state file — status, open items, next priorities. Ask about what is blocked and why, not just what is happening."
Same four artefacts, every project, no exceptions. That sameness is what lets Claude open any project cold and be useful in one read.
09
Everything so far describes what Claude knows at the start. This is how it keeps what it learns at the end — and it is the part most setups get wrong by making it one enormous file.
Mine holds a few hundred files behind one index. The index is the only part loaded every time.
10
Once you have done the same multi-step thing three times, write it down as a playbook Claude can run by name. Mine cover things like processing call transcripts, running a quarterly review pack, and closing a session.
"Walk me through what I did the last time I ran [workflow], one step at a time. Then write it as a playbook you could follow without me, and flag every step where you would need my approval."
A dozen of these run my week. Each one started as something I did by hand and got tired of explaining.
11
This is the playbook that matters most, because it is what makes the next session cheap. Without it, everything you worked out today is gone tomorrow. It runs on three tracks at three different speeds.
Done without asking
Housekeeping you never want to be consulted about: drafts filed, log entries written, project state updated, new memories saved, follow-up tasks created.
Automatic
One question, answered in chat
Anything needing your say-so — filing a document as final, a new decision record, a rule earning its place. It all arrives as a single numbered question. You answer by number, or "all".
By approval
Never silent, ever
Sending anything. Deleting anything permanently. Sharing externally. Investor, legal or compliance material. Financial figures and legal terms in a deliverable.
Explicit only
One word ends a session — "wrap". Three tracks run underneath it. Nothing on the third track ever moves without me.
12
The instinct is to sit down and write a comprehensive rulebook. Do not. Rules written in advance are guesses, and a file full of guesses is one Claude learns to read loosely.
Four months in, I have 137 candidates sitting in the queue and a rules file of about 290 lines. That ratio is the point: the overwhelming majority of things that looked like rules never became rules.
The system grows by use, not by design. So does the trust — the list of things Claude may do without asking got there the same way.
13
This is not the order I built it in. I am fairly sure it is the order that would have got me here faster.
DAY ONE
Vault and the three files
Folder skeleton, the entry point, about-me by interview, five rules. Working, not finished.
DAY ONE
Say what it's for
Purpose and the three levels of challenge. Twenty minutes. The thing I did last and should have done first.
WEEK ONE
Voice, then one project
One voice file from real emails. One live project in the standard shape. Nothing else.
WEEK TWO
Session close
The wrap playbook and the memory index. This is where sessions start compounding instead of resetting.
ONGOING
Everything else
Commands, connected apps, scheduled runs, the research library. All of it earned its way in.
A weekend to working. A month to genuinely useful. The compounding does not start until the wrap does.
14
If you want to start now rather than read this twice, paste this into a fresh conversation with the vault folder in front of you.
"I want to build a personal operating system in a folder of markdown files that you read at the start of every session. Do not build it all at once and do not write anything until I approve the plan.
Start by interviewing me — one question at a time — about who I am, what I am working on, and how I like to work. Push back when an answer is vague. Then propose: a folder structure, an entry-point file stating what you are for and when you should disagree with me, an about-me file, and a rules file with no more than five rules in it.
Two constraints. Write only what is true today — if I describe a discipline I do not actually have, say so rather than writing it down. And tell me which of your proposals you are least confident about."
The last line is the one that matters. A setup that only ever agrees with you is a more expensive way of talking to yourself.
Everything on this page came out of getting it wrong first. None of it needed to be designed up front — only ended properly, session after session.