Skip to content

Review Documents — Vault Convention

Purpose

The Obsidian vault at ~/hermes-vault/ serves as a human-readable review surface. Hermes writes documents here that Adam can open in Obsidian for long-form review, discussion, or sign-off.

What Goes Here

  • PRDs and design docs — before implementation, for review
  • Architecture proposals — for discussion and sign-off
  • Long-form reports — research, career docs, anything needing a full read
  • Retrospectives — session retros, post-mortems

What Mnemosyne Does

  • All vault pages are indexed by Mnemosyne's episodic memory for recall
  • When Adam asks "what did we decide about X?", Hermes searches Mnemosyne which pulls from vault content
  • Vault is the source of truth for durable documents; Mnemosyne is the search index

Write Protocol

  1. Create a markdown file in the appropriate vault directory (Projects/, Knowledge/, Health/, Systems/, Meta/)
  2. Use YAML frontmatter with type:, status:, last_updated:, source: fields
  3. Mnemosyne's on_memory_write hook auto-indexes new content
  4. Run wiki_maintenance.py health periodically to fix cross-links

Directory Structure

~/hermes-vault/
├── Projects/    — Active & past project docs, incident reports
├── Knowledge/   — Career-strategic reference, industry research
├── Health/      — Fitness programs, biometric pipeline docs
├── Systems/     — Infrastructure, security, tool configs
├── Meta/        — How Hermes works (self-knowledge)
├── People/      — Contact notes (planned)
└── Patterns/    — Recurring patterns (planned)

Mnemosyne → Vault Re-import

If vault pages are updated manually (in Obsidian), re-run the bulk import: 

python3 ~/.hermes/scripts/mnemosyne_bulk_import.py --import --only vault
This will add new/updated vault pages to episodic memory.