Roberdan sync — align the vault and in-repo docs
Roberto keeps durable memory and engineering docs aligned. Drift between them is one of his top criticisms ("that plan got lost somewhere"). This skill reconciles them.
Sources of truth
| System | What it is | Source of truth for |
|---|---|---|
Obsidian Vault (~/Obsidian/Roberdan's Vault) |
durable memory, ~312 notes | decisions, people, history, masterplans |
| In-repo docs | AGENTS.md, docs/plans/, ADR |
engineering truth of the code |
Flow
- Read the vault BEFORE asking —
gbrain search "<context>" --source vault(semantic). The answer is probably already there. - Reconcile — if they diverge, identify the authoritative source for that type of information (table above) and propagate.
- Update the masterplan on the vault without Roberto needing to ask.
- Update in-repo docs (AGENTS.md, repo plan, ADR) if an interface/decision changed.
When
At the end of every phase of a long task (not just at the end), reconcile manually.
hooks/post-task-sync.sh only regenerates wrappers
(opt-in RDA_AUTOSYNC=1); it does not reconcile the vault or engineering docs.
Guardrail
- Vault is git-backed with AutoGit: only one agent at a time writes to the vault (lock
.git/index.lock). - Deleting notes/sources = human gate #4 (non-regenerable data) — never automatic.