RoteiroRoteiroThe pilot book for your codebase.
The Portuguese roteiros were the guarded pilot books of the Age of Discovery — accumulated route knowledge that made navigation repeatable. Roteiro does the same for software: structure, intent, and context in one queryable, provenance-tagged knowledge graph, for humans and AI agents alike.
| Provenance | Source | Nature |
|---|---|---|
derived | tree-sitter AST extraction | Deterministic — symbols, calls, imports |
authored | ADRs, blueprints, // @rto: annotations | Curated intent, drift-checked in CI |
inferred | Docs, PDFs, embeddings | Fuzzy suggestions with confidence scores |
One SQLite store. One query surface. Three renderers — docs website, Obsidian vault, optional MCP server — all build outputs of the same graph, so what humans review is what agents query.