obsidian-vault/wiki/vault-filling-guide.md

namespace, tags, last_synced, confidence

namespace	tags	last_synced	confidence
work	system vault guide	2026-04-27	1.0

Vault Filling Guide

How to populate ~/obsidian/. Eagle can write to any section below except wiki/ and raw/.

Directory Map

~/obsidian/
├── wiki/          ← LLM-generated ONLY (wiki-ingest). Never write here manually.
├── raw/           ← Symlinks to external files ONLY. Never write content here.
├── work/          ← Alex's work notes. Eagle can write with confirmation.
│   ├── projects/      One file per active project.
│   ├── decisions/     Architectural/process decisions with date prefix.
│   └── tech-design/   References to designs, review notes.
├── personal/      ← Alex's personal notes. Eagle can write with confirmation.
│   ├── documents/     WHERE docs live (not the docs themselves).
│   ├── instructions/  Personal how-tos and procedures.
│   └── projects/      Personal side projects.
└── family/        ← Household knowledge. Eagle can write with confirmation.
    ├── how-to/        Practical guides (devices, home equipment, procedures).
    ├── documents/     WHERE family documents live.
    ├── contacts/      Emergency contacts, doctors, services.
    └── schedule/      Recurring schedules, school, events.

File Naming

• work/projects/ → kebab-case-project-name.md (e.g. ios-duck-ai-toggle.md)
• work/decisions/ → YYYY-MM-topic.md (e.g. 2026-04-personal-os-arch.md)
• family/how-to/ → kebab-case-topic.md (e.g. truenas-access.md, router-reset.md)
• family/contacts/ → emergency.md, doctors.md, services.md
• family/documents/ → apartment.md, insurance.md, passports.md (location pointers, not the files)

Frontmatter

Every file should have:

---
namespace: work | personal | family
tags: [tag1, tag2]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

What Goes Where

Info type	Location
Active work project status, decisions, links	work/projects/SLUG.md
"We decided X because Y" (architectural)	work/decisions/YYYY-MM-TOPIC.md
Home network / NAS / router config	family/how-to/DEVICE.md
Where passport/insurance/lease is stored	family/documents/TOPIC.md
Emergency contacts, doctors	family/contacts/CATEGORY.md
Recurring events, school schedule	family/schedule/TOPIC.md
Personal project notes	personal/projects/SLUG.md
Personal procedures (backups, etc.)	personal/instructions/TOPIC.md

Eagle Write Protocol

1. Show draft content before writing (never silently create)
2. Confirm namespace (work / personal / family)
3. Write the file
4. Run cd ~/obsidian && git add -A && git commit -m "..." to save

What Eagle Should NOT Do

• Write anything to wiki/ — that's wiki-ingest's job
• Modify raw/ — those are symlinks managed manually
• Create files without showing the content first
• Overwrite existing files without showing a diff