2026-04-27 add family/how-to/truenas-access.md

2026-04-27 22:16:59 +06:00
parent fd21fd9ca5
commit dac59f4cff
6 changed files with 177 additions and 0 deletions
@@ -0,0 +1,78 @@
+---
+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