You explain the same things every session.
Who you are, what you're working on, why you made that decision three weeks ago, what "Val" means, which project is which. Every time.
Context for AI assistants
Your AI doesn't know who you are. This fixes that.
A structured way to store context — projects, people, decisions, vocabulary — in plain Markdown inside your Obsidian vault, so any AI assistant can load it.
Structure
Just files
vault/
|-- CLAUDE.md
|-- COPILOT.md
|-- TASKS.md
`-- memory/
|-- glossary.md
|-- context/
|-- people/
|-- projects/
`-- decisions/
Files you own, in a format that will outlast any tool.
No database, no embeddings, no API. Markdown files in folders, readable by humans and machines alike.
Put it in files. Load what's relevant.
Glossary, projects, people, tasks, decisions — structured in your vault, loaded on demand. The AI reads; you stop repeating yourself.
How it works
Folders, files, and a loading order.
There's no clever trick. You organize context into files with a consistent structure, and the AI follows rules about what to read first.
Write context as Markdown
Projects, people, vocabulary, tasks, decisions — each in its own file, with frontmatter for metadata. Human-readable, grep-friendly.
Load selectively
A master file and a memory index tell the AI what to read first and what to load only when relevant. Context windows are finite.
Keep it current
The guide includes review routines. Stale context is worse than no context, so maintenance is part of the design.
Design choices
The tradeoffs are intentional.
Plain text over infrastructure
No database, no vector store, no embeddings. Your context is in files you can read, edit, version, and move with standard tools.
Any AI that reads files
Claude Code, Copilot, Cursor, ChatGPT — the same files work across tools. You adapt the loading mechanism, not the data.
Tested in daily use
This came from actual work — writing, software, personal context, long-running projects. The structure reflects what survived contact with reality.
Decisions, not just state
The system stores the rationale behind changes. Future sessions get the "why", not just the latest snapshot.
Minimal moving parts
Folders, Markdown files, frontmatter, a loading order. That's the entire stack. Complexity goes into the content, not the plumbing.
Extensible via plugins
The repo includes examples for packaging workflows as installable commands and skills, for tools that support them.
Compatibility
Same files, different tools.
Claude Code
Reads CLAUDE.md natively. Best integration out of the box.
GitHub Copilot
Uses COPILOT.md and workspace context. Plugin flows available.
ChatGPT / Claude.ai
Attach or paste the relevant files when starting a session.
Cursor and others
Adapt the files to each tool's context mechanism. The data doesn't change.
Scope
What you get and what you don't.
Included
- A folder structure for persistent context across AI sessions
- File templates for projects, people, decisions, and vocabulary
- Loading rules so the AI reads selectively, not everything
- Maintenance routines to keep context accurate over time
Not included
- Automatic memory — you maintain the files, that's the point
- Guaranteed behavior — AI tools vary; the context is consistent
- A product — this is a system you run yourself
- Magic — it's structured text, and that's enough
Get started
Read the guide, adapt the structure, start using it.
The whole system is in the repo. Fork it, copy what works, change what doesn't. It's Markdown — you'll figure it out.
FAQ
Questions
Do I actually need Obsidian?
No. The system is Markdown files in folders — any text editor works. Obsidian is where this was built and where it works best (wikilinks, graph view, frontmatter), but it's not a dependency.
Does this only work with Claude?
Claude Code has the best native integration, but the files work with any AI that can read them. The guide covers multiple tools.
Will the AI remember everything automatically?
No. You maintain the files, you choose what to load. The AI reads structured context — it doesn't build it for you.
Why not use a dedicated memory product?
If one works for you, use it. This is for people who prefer open formats and files they control.