loi

name	loi
description	Codebase "Library of Intent" for LLM navigation. Replaces probabilistic global searching with a deterministic, plain-English navigation hierarchy. Uses Campus → Building → Room nested indices to scale indefinitely. Use as the default codebase navigation method when a _root.md exists under docs/index/.
triggers	["/loi","navigate codebase using loi"]

Navigate

Fast three-read navigation: Campus → Building → Room. Zero greps.

1. Read Campus Map: Load docs/index/_root.md. Always follow path

2. Pick a Building: Use the TASK → LOAD table for domain tasks, or PATTERN → LOAD table for cross-cutting behavioral patterns (retry, backoff, caching, etc.). Select a subdomain (docs/index/<subdomain>/_root.md) or a top-level domain file.

3. Pick a Room: The building router points to a domain file. Load it. Check see_also in the room's YAML header for related rooms to pre-fetch.

4. Staleness Check: For each index file loaded, run:

   git diff --name-only $(git log -1 --format=%H -- <index-file>) HEAD -- <source-paths>
   

   Flag if files changed: Index may be stale — [files] changed after <domain>.md.

5. Surgical Entry: Use DOES (intent) and SYMBOLS (signatures) to jump directly to the target. If multiple SYMBOLS match, defer to Step 6 before selecting.

6. If the query names a function, method, or error case: