84 lines
3.1 KiB
Markdown
84 lines
3.1 KiB
Markdown
---
|
|
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
|