docs: fix audit issues - remove bloat, fix broken links, sync models

- README: remove 102-line Competitive Analysis (moved to docs/research/)
- README: add concise Alternatives section with links (613→517 lines)
- Fix broken links: REPO-STRUCTURE.md, INSTALLATION-VERIFICATION.md
- Sync Ollama models: qwen2.5-coder → devstral-small-2 (current default)
- Fix COMMANDS.md: gpt-5.2-codex → gpt-4.1 (Codex incompatible)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: FlorianBruniaux

QUICKSTART.md

@@ -349,9 +349,9 @@ brew install ollama  # macOS
 ollama serve &
 
 # 3. Pull a coding model (choose one)
-ollama pull qwen2.5-coder:32b   # Best quality, ~20GB
+ollama pull devstral-small-2   # Best agentic (default)
 # or
-ollama pull qwen2.5-coder:7b    # Faster, ~4.7GB
+ollama pull ibm/granite4:small-h  # Long context, less VRAM
 
 # 4. Test
 cco
@@ -429,7 +429,7 @@ Keep it running in a separate terminal.
 ### "Ollama model not found"
 
 ```bash
-ollama pull qwen2.5-coder:32b
+ollama pull devstral-small-2
 ```
 
 ### Verify Installation
@@ -449,8 +449,8 @@ alias ccs
 ## Next Steps
 
 - Read [README.md](README.md) for full documentation
-- Check [MODEL-SWITCHING.md](MODEL-SWITCHING.md) for model selection strategies
-- See [REPO-STRUCTURE.md](REPO-STRUCTURE.md) for advanced setup
+- Check [MODEL-SWITCHING.md](docs/MODEL-SWITCHING.md) for model selection strategies
+- See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for advanced setup
 
 ---
 

README.md

@@ -342,108 +342,13 @@ ccd
 
 ---
 
-## 📊 Competitive Landscape & Tool Comparison
-
-The Claude Code ecosystem includes 30+ routing and provider management tools. Here's how **cc-copilot-bridge** positions itself:
-
-### 🎯 Market Segmentation
-
-| Category | Representative Tools | Target Use Case |
-|----------|---------------------|-----------------|
-| **Configuration Switchers** | jiang6641/claude-switch, foreveryh/claude-code-switch | Manual profile switching |
-| **Multi-Provider Proxies** | @musistudio/claude-code-router (31.9k/week), fuergaosi233/claude-code-proxy | API routing & aggregation |
-| **Copilot Bridges** | **cc-copilot-bridge** (this project) | Free access via Copilot Pro+ |
-| **Orchestration Frameworks** | ruvnet/claude-flow, coder/anyclaude | Multi-agent systems |
-| **Desktop Apps** | farion1231/cc-switch (Rust GUI) | Cross-platform GUI management |
-| **Open-Source Alternatives** | OpenCode (48k stars) | Complete Claude Code replacement |
-
-### 🥊 Head-to-Head Comparison (Top Tools)
-
-| Feature | **cc-copilot-bridge** | @musistudio/router | fuergaosi233/proxy | OpenCode |
-|---------|----------------------|-------------------|-------------------|----------|
-| **Weekly Downloads** | N/A (new) | **31,917** 🏆 | Unknown | 48,000 stars |
-| **Architecture** | Copilot proxy | Multi-provider API router | OpenAI-compatible proxy | Full IDE replacement |
-| **Cost Model** | Premium requests quota | Per-token ($0.14-$75/1M) | Per-token | Free (self-hosted) |
-| **Copilot Integration** | ✅ **Primary feature** | ❌ Not supported | ❌ Not supported | ❌ Not supported |
-| **Providers Supported** | 3 (Direct, Copilot, Ollama) | 8+ native | OpenAI-compatible only | 75+ providers |
-| **Offline Mode** | ✅ Ollama provider | ❌ Cloud only | ❌ Cloud only | ✅ Local models |
-| **MCP Profiles** | ✅ Auto-generated | ✅ Manual config | ❌ None | N/A |
-| **Model Identity** | ✅ Injected prompts | ❌ N/A | ❌ N/A | N/A |
-| **Web UI** | ❌ CLI only | ✅ Full React UI | ❌ CLI only | ✅ Full IDE |
-| **Setup Complexity** | ⚡ 1 command | 🔧 Medium (config.json) | ⚡ Simple (.env) | 🔧 Complex |
-| **GitHub Actions** | ❌ Not supported | ✅ Native integration | ❌ Not supported | ✅ Workflows |
-| **Target Audience** | **Copilot Pro+ subscribers** | API users, enterprises | OpenAI-centric teams | Open-source purists |
-| **Best For** | Use Copilot quota with Claude Code | Production routing at scale | Simple OpenAI fallback | Full IDE replacement |
-
-### 🎯 Unique Value Propositions
-
-| Tool | Core USP | When to Choose |
-|------|----------|----------------|
-| **cc-copilot-bridge** | Route Copilot quota to Claude Code | You have Copilot subscription, want to use Claude Code |
-| @musistudio/router | Market leader (31.9k/week), mature ecosystem | Production-grade multi-provider routing |
-| fuergaosi233/proxy | Python-based, minimal setup | Python stack, OpenAI fallback only |
-| 1rgs/proxy | LiteLLM integration (100+ providers) | Maximum provider coverage |
-| horselock/proxy | OAuth PKCE (account-based auth) | No API key dependency |
-| glidea/worker-proxy | Edge deployment (Cloudflare Workers) | Ultra-low latency, global distribution |
-| ruvnet/claude-flow | 54 agents, neural learning, persistence | Enterprise orchestration, multi-agent |
-| farion1231/cc-switch | Rust desktop GUI (macOS/Linux/Windows) | Non-technical users, visual config |
-| OpenCode | 75+ providers, open-source | Complete open-source alternative |
-
-### 💡 Why cc-copilot-bridge Exists
-
-**Serving Copilot Pro+ subscribers specifically.**
-
-For general multi-provider routing at scale, see [@musistudio/claude-code-router](https://www.npmjs.com/package/@musistudio/claude-code-router) (31.9k weekly downloads).
-
-| Dimension | cc-copilot-bridge | Other Tools |
-|-----------|-------------------|-------------|
-| **Primary Value** | Use existing Copilot subscription with Claude Code | Route to multiple paid APIs |
-| **Cost Structure** | Premium requests quota (plan-dependent) | Per-token billing |
-| **Prerequisites** | GitHub Copilot Pro or Pro+ subscription | API keys from multiple providers |
-| **Use Case** | Daily development, prototyping, learning | Production routing, cost optimization |
-| **Philosophy** | "Use your Copilot quota with Claude Code CLI" | "Route to best API for each task" |
-
-### 🏆 Market Insights
-
-**Market Leaders by Adoption**:
-1. **@musistudio/claude-code-router** - 31,917 weekly downloads (proxy category winner)
-2. **OpenCode** - 48,000 GitHub stars (open-source category winner)
-3. **fuergaosi233/claude-code-proxy** - 1,600 GitHub stars (Python category winner)
-
-**Market Distribution**:
-- **Configuration Switchers**: <5% adoption (legacy approach)
-- **Multi-Provider Proxies**: 95%+ adoption (current standard)
-- **Orchestration Frameworks**: <1% but fastest-growing (enterprise future)
-
-**Technology Stack Preferences**:
-- TypeScript/Node.js: 60% of tools (musistudio, 1rgs, etc.)
-- Python: 25% of tools (fuergaosi233, ujisati)
-- Rust: 10% (farion1231 desktop app)
-- Go/Hybrid: 5% (jimmc414)
-
-### 🚀 Differentiation Strategy
-
-**cc-copilot-bridge differentiates through**:
-1. **Copilot-First Architecture** - Only tool optimized for copilot-api proxy
-2. **Quota-Based Model** - Uses your existing Copilot subscription (no additional API costs)
-3. **MCP Compatibility System** - Auto-generated profiles for strict models (GPT-4.1)
-4. **Model Identity Injection** - System prompts ensure models know who they are
-5. **Hybrid Provider Strategy** - Copilot + Ollama (offline) + Anthropic (fallback)
-
-**Complementary tools**:
-- Use **cc-copilot-bridge** for daily dev (uses Copilot quota)
-- Use **@musistudio/router** for production multi-provider routing
-- Use **OpenCode** for complete open-source alternative
-
-### 📈 Ecosystem Maturity
-
-| Maturity Level | Tools | Status |
-|----------------|-------|--------|
-| **Production-Ready** | 24/30 (80%) | ✅ Battle-tested |
-| **Pre-Release** | 3/30 (10%) | 🟡 Alpha/Beta |
-| **Limited Maintenance** | 3/30 (10%) | ⚠️ Stale repos |
-
-**Market positioning**: The Claude Code ecosystem is mature with established leaders. **cc-copilot-bridge** serves Copilot subscribers who want to use Claude Code CLI without additional API costs.
+## 📊 Alternatives
+
+For general multi-provider routing, see [@musistudio/claude-code-router](https://www.npmjs.com/package/@musistudio/claude-code-router) (31.9k weekly downloads). For a complete open-source alternative, see [OpenCode](https://github.com/opencode-ai/opencode) (48k stars).
+
+**cc-copilot-bridge** specifically serves Copilot Pro+ subscribers who want to use Claude Code CLI with their existing subscription.
+
+📖 [Full Competitive Analysis →](docs/research/COMPETITIVE-ANALYSIS.md)
 
 ---
 

docs/COMMANDS.md

@@ -24,7 +24,7 @@
 | `ccc-opus` | Claude Opus 4.5 | Slow | Best quality, code review |
 | `ccc-sonnet` | Claude Sonnet 4.5 | Medium | Balanced (default) |
 | `ccc-haiku` | Claude Haiku 4.5 | Fast | Quick questions |
-| `ccc-gpt` | GPT-5.2 Codex | Medium | Alternative perspective |
+| `ccc-gpt` | GPT-4.1 | Fast | Alternative perspective (0x quota) |
 
 ---
 
@@ -34,15 +34,15 @@
 ```bash
 COPILOT_MODEL=claude-opus-4.5 ccc
 COPILOT_MODEL=claude-haiku-4.5 ccc
-COPILOT_MODEL=gpt-5.2-codex ccc
+COPILOT_MODEL=gpt-4.1 ccc
 COPILOT_MODEL=gemini-3-pro-preview ccc
 ```
 
 **Ollama** (local models):
 ```bash
-OLLAMA_MODEL=qwen2.5-coder:7b cco
-OLLAMA_MODEL=qwen2.5-coder:14b cco
-OLLAMA_MODEL=deepseek-coder:6.7b cco
+OLLAMA_MODEL=devstral-small-2 cco       # Best agentic (default)
+OLLAMA_MODEL=ibm/granite4:small-h cco   # Long context, less VRAM
+OLLAMA_MODEL=qwen3-coder:30b cco        # Highest accuracy
 ```
 
 ---

docs/DECISION-TREES.md

@@ -214,7 +214,7 @@ copilot- service model key/    base
 |-------|-----------|
 | copilot-api not running | `copilot-api start` |
 | Ollama not responding | `brew services restart ollama` |
-| Model not found | `ollama pull qwen2.5-coder:32b` |
+| Model not found | `ollama pull devstral-small-2` |
 | API key invalid | Check `echo $ANTHROPIC_API_KEY` |
 | Aliases not working | `source ~/.zshrc` |
 

docs/FAQ.md

@@ -88,7 +88,7 @@ ccc
 # Expected: Claude Code starts successfully
 ```
 
-See [INSTALLATION-VERIFICATION.md](INSTALLATION-VERIFICATION.md) for full checklist.
+See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for full checklist.
 
 ---
 
@@ -226,8 +226,8 @@ COPILOT_MODEL=gemini-3-pro-preview ccc
 
 **Ollama models**:
 ```bash
-OLLAMA_MODEL=qwen2.5-coder:7b cco
-OLLAMA_MODEL=qwen2.5-coder:14b cco
+OLLAMA_MODEL=devstral-small-2 cco       # Best agentic (default)
+OLLAMA_MODEL=ibm/granite4:small-h cco   # Long context, less VRAM
 ```
 
 Or use pre-configured aliases: `ccc-opus`, `ccc-haiku`, `ccc-gpt`.

docs/README.md

@@ -63,7 +63,6 @@ Complete documentation index for cc-copilot-bridge - Bridge GitHub Copilot to Cl
 ### Troubleshooting
 - [Troubleshooting Guide](TROUBLESHOOTING.md) - Common issues & solutions
 - [FAQ](FAQ.md) - Frequently asked questions
-- [Installation Verification](INSTALLATION-VERIFICATION.md) - Setup checklist
 
 ### Team & Enterprise
 - [Team Adoption](workflows/TEAM-ADOPTION.md) - Onboarding guide
@@ -222,8 +221,7 @@ cc-copilot-bridge/
     │   └── CODE_OF_CONDUCT.md Community guidelines
     │
     ├── Troubleshooting
-    │   ├── TROUBLESHOOTING.md Common issues
-    │   └── INSTALLATION-VERIFICATION.md Setup checklist
+    │   └── TROUBLESHOOTING.md Common issues
     │
     ├── Workflows
     │   ├── DAILY-DEV.md ····· Daily development