A plain-Markdown vault for Obsidian. It comes with hooks that keep the agent following your rules: it files notes in the right folder, appends instead of rewriting, and archives instead of deleting.
projects/launch/pricing-idea.mdpeople/sam-lee/meetings/2026-10-30.md_archive/old-todo.mdIllustration of a session: the agent proposes where to file inbox notes, and a hook logs each edit to today's daily note.
Structure
Every note has one obvious home, so you and the agent always file things the same way.
Quick captures. Process within 7 days.
One note per day, YYYY-MM-DD.md. Append-only.
Active work only. Archive after 2 weeks untouched.
One folder per regular contact. Used for 1:1 prep.
Dormant material. Archive is not delete.
How it works
CLAUDE.md tells the agent where things go. Hooks make sure it sees those rules and records what it did.
Hooks
Small scripts in .claude/hooks/ run at fixed points, so the rules don't fade during a long session.
Loads CLAUDE.md into context.
Adds a folder-rules reminder.
Logs file edits to today's daily note.
Asks the agent to log decisions.
Asks the agent to log decisions before context is summarized.
Everyday use
These workflows are built into CLAUDE.md. The agent proposes changes and waits for your approval.
Proposes a destination for each capture, then moves it once you approve.
Reads the person's folder and summarizes recent meetings and open asks.
Flags inbox notes older than 7 days and projects untouched for 2 weeks.
Example slash commands in .claude/commands/. Keep the ones that match how you work and delete the rest.
Sprint changes, 1:1 prep for each direct report, and stakeholder updates.
Decisions, shipped work ready for an investor update, and open questions.
Hours and scope drift per client, matched to how each one is billed.
Meetings, decisions, and asks that have gone quiet, however old.
Setup
Requires bash, jq and python3. gh is optional.
Keep it private, since it will hold your notes.
No gh? Click Use this template on GitHub, or download the ZIP to keep the vault local.
Open the my-vault folder as a vault in Obsidian.
Edit CLAUDE.md to set the title and adjust the rules to taste.
Run Claude Code or Kiro in the vault folder. It should report "Vault context loaded".
Plain Markdown you own, with an assistant that follows your rules.