docs: add llm instrx

Author: pythoninthegrass

AGENTS.md

@@ -15,9 +15,10 @@ mt is a desktop music player designed for large music collections, built with Ta
 
 Always use Context7 MCP when I need library/API documentation, code generation, setup or configuration steps without me having to explicitly ask.
 
-### AlpineJS + Basecoat + Tauri Libraries
+### Libraries
 
 - alpinejs/alpine
+- cranot/roam-code
 - dubzzz/fast-check
 - hunvreus/basecoat
 - jdx/mise
@@ -79,6 +80,24 @@ The queue store (`app/frontend/js/stores/queue.js`) maintains tracks in **play o
 4. **Testing**: Unit tests + Playwright E2E. All integration tests MUST use Playwright.
 5. **Code Style**: ESLint + Prettier (frontend), `cargo fmt` + `cargo clippy` (backend). Run formatters before committing.
 
+## Codebase navigation
+
+This project uses `roam` for codebase comprehension. Always prefer roam over Glob/Grep/Read exploration.
+
+Before modifying any code:
+
+1. First time in the repo: `roam understand` then `roam tour`
+2. Find a symbol: `roam search <pattern>`
+3. Before changing a symbol: `roam preflight <name>` (blast radius + tests + fitness)
+4. Need files to read: `roam context <name>` (files + line ranges, prioritized)
+5. Debugging a failure: `roam diagnose <name>` (root cause ranking)
+6. After making changes: `roam diff` (blast radius of uncommitted changes)
+
+Additional: `roam health` (0-100 score), `roam impact <name>` (what breaks),
+`roam pr-risk` (PR risk), `roam file <path>` (file skeleton).
+
+Run `roam --help` for all commands. Use `roam --json <cmd>` for structured output.
+
 <!-- BACKLOG.MD MCP GUIDELINES START -->
 
 <CRITICAL_INSTRUCTION>