stacklit-navigator

What problem does it solve?

Stacklit-navigator helps AI agents avoid wasting context window tokens on repetitive file exploration by using the prebuilt stacklit.json index as a fast, structured navigation layer.

Core Features & Use Cases

• Index-first navigation: Directs the agent to start from stacklit.json at the repo root and locate relevant modules without grepping or scanning directories.
• Module-driven decision making: Leverages module fields like purpose, depends_on/depended_by, exports, file_list, and git activity to understand impact and where to read next.
• Actionable conventions and safety rails: Uses hints (add_feature, test_command, env vars) and explicit “What not to do” rules to reduce wasted effort and avoid high-blast-radius changes.
• Optional MCP integration: If stacklit serve is available, instructs the agent to use MCP tools (get_overview, get_module, find_module, get_dependencies, get_hot_files, get_hints) instead of manual JSON reading.

Quick Start

Ask the agent to read stacklit.json first and then choose the most relevant module(s) using purpose, depends_on/depended_by, and the module file_list before opening any source files.