ypollak2/llm-router

Content Generation Routing Discipline

Systemic routing improvements to prevent content generation routing misses across all llm-router users.

What's New

• Automatic Content Generation Detection — Hook detects "write", "draft", "compose", "add card", "add section" patterns
• Fast-Path Routing — Detected patterns route instantly via llm_generate before classifier layers
• Decomposition Guidance — CLAUDE.md decision trees codify best practices: generate first, integrate locally second
• Soft Nudge Suggestions — Non-blocking suggestions encourage routing discipline without enforcement

Cost Impact

• Per task: ~$0.0009 saved (route $0.0001 vs local $0.001 generation) = 90% savings
• Per cycle: $0.10–$0.30 saved across 20-30 content tasks per 51-release cycle
• Per team: $0.36–$0.54 annual savings for 5-engineer team

How It Works

When you write something like "add carousel card about AI auditing to CAROUSEL-BLUEPRINT.md":

1. Detect — Hook recognizes "add.*card" + ".md file" pattern
2. Route — Suggests: "Consider routing via llm_generate first, then integrate locally"
3. Execute — Users follow suggestion: llm_generate (cheap) → Edit (local integration)
4. Learn — Repeated nudges form habit; users adopt routing discipline by default

Documentation

• CLAUDE.md — New § Content Generation Routing (v7.4.0)

  • Pre-flight decision tree: "Does this task create new content?"
  • Cost impact quantified with examples
  • Decomposition pattern guidelines

• README.md — New v7.4.0 features section

  • Highlights automatic detection + pattern matching
  • References routing decision rules

• CHANGELOG.md — Full implementation details

  • Detection patterns and fast-path routing
  • Technical architecture and cost analysis

Testing

• ✅ 24/24 auto-route hook tests passing
• ✅ Pattern specificity verified (no false positives)
• ✅ Backward-compatible (fully soft enforcement)

Breaking Changes

None — fully backward-compatible. Detection is opt-in via hook suggestion.

Install: pip install --upgrade claude-code-llm-router

See CHANGELOG.md for full details.