Obsidian Vault
The vault is a git folder of Markdown. Agents edit files. Do not drive the Obsidian GUI unless the user asks to open a note.
Resolve the vault
$OBSIDIAN_VAULT
else $HOME/git/personal/vault
Verify AGENTS.md exists at that root. If missing, stop and ask.
Hard rules
- Filesystem first. Create/update
.mdfiles.notesmd-cliis optional sugar. OfficialobsidianCLI needs the app running and is only foropen. - Inbox, then promote. New capture goes in
0 Inbox/(ideas:0 Inbox/Ideas.md). Do not invent top-level folders. Which bucket an item belongs in followsvd:para. - Append, do not rewrite. Newest bullet first under
## Open. Never delete an idea; move it to## Promotedwhen it becomes a project note. - Android-safe names. No
" * : < > ? \ |in filenames. Spaces are fine. - Do not commit plugin dirs.
.obsidian/,.makemd/,.space/,.trash/stay local. - Structured MCP is one-way from here. Vault daily note is source of truth for the list. When the user asks to put tasks on the planner, create Structured all-day tasks for that day (
create_task+day+is_all_day). Use the vault's usual task prefix convention when one exists (discover from recent daily notes; do not hardcode org labels). Recurring habits usecreate_recurring_task. Do not try calendar export. - Git only when asked. Prefix
vault:.
Workflow
Capture an idea
- Resolve vault.
- Open
0 Inbox/Ideas.md. - Insert
- YYYY-MM-DD: <one line>at the top of## Open. - If the user named a project, also add
0 Inbox/<short-title>.mdwith a[[wikilink]]back to Ideas.
Daily note
Path: 0 Inbox/Journals/Daily/YYYY-MM-DD.md. Create if missing. Match existing notes in that folder.
Promote
Move the Ideas bullet to ## Promoted. Write 1 Projects/<title>/<title>.md. Link both ways.
Optional CLI
notesmd-cli list-vaults
notesmd-cli create "0 Inbox/foo.md" --content "..."
notesmd-cli search-content "term"
If notesmd-cli is missing, write the file with the editor tools.
Anti-patterns
- Dumping ideas into
vd:journal(that is the engineering log). - Opening Obsidian to "make it real". Git + Markdown is enough.
- Calling Local REST API / MCP unless the user already runs that plugin.
