Skip to content

ADR-66: Adopt CodeRAG MCP Family SOTA Roadmap ​

Date: 2026-07-09 Status: Accepted Slug: mcp-family-sota-roadmap

Context ​

CodeRAG is the code retrieval engine in the SylphxAI MCP family. It needs a repo-local roadmap that preserves its ownership of search, indexing, ranking, chunking, embeddings, persistence, and codebase_search while clarifying how it supports architecture, reader, filesystem, and consultation workflows.

Decision ​

Adopt docs/roadmap/sota-family-roadmap.md as the local roadmap for CodeRAG's family role.

CodeRAG owns code evidence retrieval. It should evolve toward Rust indexing, ranking, and MCP serving while preserving the public codebase_search contract during migration.

Consequences ​

  • Architecture graph semantics stay in Architecture Reader MCP.
  • File mutations stay in Filesystem MCP.
  • Non-code media extraction stays in Reader MCPs.
  • Future ranking and indexing work must include retrieval evals, evidence locators, freshness, and benchmark gates.

Amendment: Rust-Native MCP Runtime ​

The family runtime direction now targets Rust MCP servers using modelcontextprotocol/rust-sdk / rmcp. For CodeRAG, TypeScript can remain as a compatibility wrapper or generated client surface, but it is not the target MCP server runtime.

Verification ​

  • Roadmap added at docs/roadmap/sota-family-roadmap.md.
  • README and PROJECT link to the roadmap.
  • Docs-only validation: git diff --check.

Released under the MIT License.