AI work must be replayable across providers and handoffs.

Every agent handoff becomes replayable, but storage retention must be explicit.

Decision: Persist every meaningful agent handoff as an append-only session event.

Recall quality depends on semantic proximity and explicit source lineage.

Improves recall lineage while adding index consistency risk.

Decision: Combine vector retrieval with graph traversal for decisions, projects, and research.

Policy-heavy workflows drift differently from routine coding and research work.

Cleaner quality signals, slower initial benchmark setup.

Decision: Benchmark model quality by workflow class before routing decisions are automated.

The vault must stay portable and human-readable while sync design matures.

Protects Obsidian notes while the dashboard exposes future sync state.

Decision: Allow dashboard read models and previews, but keep markdown writes manual.