---
namespace: work
tags: [system, vault, guide]
last_synced: 2026-04-27
confidence: 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:
```yaml
---
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

## See Also

- [[personal-os-agent-rules]] — Eagle's write permissions and rules
- [[personal-os-architecture]] — full system map and vault structure