Problem
The current README leads with 'tool-agnostic framework for multi-model agentic orchestration' — accurate but abstract. It doesn't answer 'why should I install this right now?' within the first scroll.
Context
GitHub AI Credits move to token-based billing June 1, 2026. Developers are actively searching for complexity-based routing to preserve cloud credits for hard problems. NEXUS's local routing is the direct answer, and the 'zero-token git' workflow (routing commit messages, lint fixes, boilerplate to local Ollama) is the most concrete cited use case in the community (r/ClaudeCode, April 2026).
What needs updating
- Tagline — lead with the concrete value: route boilerplate locally, save cloud credits for what matters
- Problem section — the configuration wall: developers copy-paste their 'soul' between tools (r/LocalLLaMA, r/ChatGPTCoding, April 2026)
- Feature list — clear, structured with what's built now vs. what's on the roadmap
- Tool compatibility matrix — table showing all supported tools and support level
- Zero-token git section — concrete example of the local routing workflow
- Research references — cite community findings for credibility
- Roadmap table — milestone sequence with dependency notes
- Architecture diagram — update to reflect multi-tool projection model
Dependencies
Can be partially done now (current features). Full update after #86 (compat matrix) so the tool support table is accurate.
Problem
The current README leads with 'tool-agnostic framework for multi-model agentic orchestration' — accurate but abstract. It doesn't answer 'why should I install this right now?' within the first scroll.
Context
GitHub AI Credits move to token-based billing June 1, 2026. Developers are actively searching for complexity-based routing to preserve cloud credits for hard problems. NEXUS's local routing is the direct answer, and the 'zero-token git' workflow (routing commit messages, lint fixes, boilerplate to local Ollama) is the most concrete cited use case in the community (r/ClaudeCode, April 2026).
What needs updating
Dependencies
Can be partially done now (current features). Full update after #86 (compat matrix) so the tool support table is accurate.