feat: integrate OpenCode + Copilot Pro model routing strategy

Transition devkit from Claude/Google model references to OpenCode Zen
models with a dual-tool strategy: OpenCode for heavy agentic work,
Copilot Pro for lightweight tasks.

Changes:
- Create opencode.json with model routing, MCP servers, and plugins
- Update all 12 existing agents to OpenCode Zen model IDs
- Add 2 new agents: coder (GPT 5.3 Codex, autonomous test-fix loops)
  and frontend (Kimi K2.5, vision-to-code)
- Rewrite agent-advisor with full routing table and Copilot vs OpenCode
  decision framework
- Add cost-awareness rule to skills/rules/ with model tier guidelines
- Create opencode-setup.sh for symlinks and Copilot CLI install
- Add OpenCode alias (oc) to shell enhancements
- Update CLAUDE.md and README.md with dual-tool documentation

Model routing: Gemini 3.1 Pro for planning/review, GPT 5.4 for
building, GPT 5.3 Codex for autonomous coding, Kimi K2.5 for
frontend, MiniMax M2.5 Free for grunt work.

https://claude.ai/code/session_018HqGQwqAc7inAbJ1B9sc2g

Author: claude

.claude/rules/cost-awareness.md

@@ -0,0 +1 @@
+../../skills/rules/cost-awareness.md

.config/shell/enhancements.zsh

@@ -57,3 +57,8 @@ alias zapi='zellij --layout ~/devkit/zellij/layouts/api.kdl'
 alias zdebug='zellij --layout ~/devkit/zellij/layouts/debug.kdl'
 alias znode='zellij --layout ~/devkit/zellij/layouts/node.kdl'
 alias zgo='zellij --layout ~/devkit/zellij/layouts/golang.kdl'
+
+# --- OpenCode aliases ---
+if command -v opencode &> /dev/null; then
+    alias oc='opencode'
+fi

CLAUDE.md

@@ -18,7 +18,8 @@ A portable, reproducible terminal development environment (devkit). Not a softwa
 - `.cursor/rules/` -- Cursor rules (same standards, `.mdc` format)
 - `.config/` -- Tool configs: Ghostty terminal, git-delta, Starship prompt, shell enhancements (zoxide, fzf, eza aliases)
 - `sounds/` -- Notification sounds for Claude Code hooks (Navi "Hey! Listen!" from Zelda)
-- `scripts/` -- Utility scripts (killport.sh, brew-update.sh, dev-cleanup.sh)
+- `opencode.json` -- OpenCode configuration (model routing, MCP servers, plugins)
+- `scripts/` -- Utility scripts (killport.sh, brew-update.sh, dev-cleanup.sh, opencode-setup.sh)
 
 ## Key Commands
 
@@ -41,6 +42,10 @@ zgo      # Go development
 ./scripts/killport.sh <port>
 ./scripts/brew-update.sh
 ./scripts/dev-cleanup.sh
+./scripts/opencode-setup.sh  # Set up OpenCode + Copilot Pro
+
+# OpenCode
+oc           # Launch OpenCode (alias)
 ```
 
 ## Configuration Linking
@@ -51,6 +56,16 @@ Configs are symlinked from this repo to `~/.config/` and `~/`:
 - `.config/git/delta.gitconfig` -> included via `git config --global include.path`
 - `.config/shell/enhancements.zsh` -> sourced from `.zshrc`
 - `.claude/settings.json` -> `~/.claude/settings.json`
+- `opencode/aig_agents/` -> `~/.config/opencode/agents/` (via `scripts/opencode-setup.sh`)
+- `opencode.json` -> `~/.config/opencode/config.json` (via `scripts/opencode-setup.sh`)
+
+### OpenCode + Copilot Pro Setup
+
+```bash
+./scripts/opencode-setup.sh
+```
+
+This symlinks OpenCode agents and config, and installs the Copilot CLI extension. See `opencode/aig_agents/README.md` for the full agent reference and model routing strategy.
 
 ### Claude Code Settings
 
@@ -70,15 +85,24 @@ export DEVKIT_PATH="$HOME/path/to/devkit"
 
 AI agent and assistant configs are included but optional -- the core workflow (tools, layouts, shell configs) works without them.
 
+### Dual-Tool Strategy
+- **OpenCode + Zen** (~$90/mo) -- Heavy agentic work: architecture, multi-file refactors, autonomous coding, code review pipelines
+- **Copilot Pro** ($10/mo) -- Lightweight: inline completions (unlimited), quick chat (300 reqs), PR review (free), CLI agents
+- **Claude Code** -- Kept for work use; devkit includes Claude rules and settings for both tools
+
 ### OpenCode Agents
-OpenCode agents in `opencode/aig_agents/` are invoked with `@agent-name` syntax inside OpenCode:
-- `@agent-advisor` -- routes tasks to appropriate agents
-- `@planning-agent` -- system design and architecture
-- `@engineer` / `@lead_dev` -- implementation
-- `@reviewer` / `@plan-reviewer` -- code review
-- `@qa` / `@test_generator` -- testing
-- `@security` -- vulnerability scanning
-- `@linear` -- Linear project management integration
+14 specialized agents in `opencode/aig_agents/`, invoked with `@agent-name` syntax inside OpenCode:
+- `@agent-advisor` -- routes tasks to appropriate agents and tools
+- `@planning-agent` / `@plan-reviewer` -- architecture and plan review (Gemini 3.1 Pro)
+- `@engineer` -- default builder (GPT 5.4, requires approval)
+- `@coder` -- autonomous test-fix loops (GPT 5.3 Codex)
+- `@frontend` -- UI/vision-to-code (Kimi K2.5)
+- `@lead_dev` -- quick tasks, auto-commits (MiniMax Free)
+- `@reviewer` / `@security` -- code review and security audit (Gemini 3.1 Pro, cross-model)
+- `@qa` / `@test_generator` -- testing (GPT 5.3 Codex)
+- `@docs_generator` -- documentation (Gemini 3 Flash)
+- `@linear` -- Linear project management
+- `@commiter` -- git automation (MiniMax Free)
 
 ### Rules & Commands
 Always-on rules in `skills/rules/` are symlinked into `.claude/rules/` -- they apply to every conversation automatically.
@@ -101,5 +125,7 @@ Frontend design skills (`/audit`, `/polish`, `/critique`, `/animate`, etc.) are
 - Agent configs are markdown files with persona/behavior instructions
 - Shell scripts should use `set -e` and follow existing patterns in `scripts/`
 - `skills/rules/` is the single source of truth for always-on rules -- `.claude/rules/` files are symlinks. Edit files in `skills/rules/`, not `.claude/rules/`
+- `opencode/aig_agents/` is the single source of truth for OpenCode agents -- `~/.config/opencode/agents/` is a symlink
+- Agent model IDs use the `opencode/` prefix for Zen models (e.g., `opencode/gpt-5.4`)
 - `skills/commands/` and `skills/plane/` are slash commands symlinked into `~/.claude/skills/`
 - `.cursor/rules/` is maintained separately in `.mdc` format -- update when modifying standards in `skills/`

README.md

@@ -71,27 +71,44 @@ It includes curated CLI tools installed via Homebrew, 9 Zellij layouts for diffe
 
 ## AI Tools (Optional)
 
-The repo includes configs for AI coding tools — these are entirely optional and nothing else depends on them. Agent definitions are provided for [OpenCode](https://github.com/anomalyco/opencode), and assistant rules are included for Claude Code and Cursor.
+The repo includes configs for AI coding tools — these are entirely optional and nothing else depends on them.
+
+### Dual-Tool Strategy: OpenCode + Copilot Pro
+
+| Layer | Tool | Cost | What It Handles |
+| :--- | :--- | :--- | :--- |
+| Inline completions | Copilot Pro | $10/mo | Tab-complete in Neovim. Unlimited. |
+| Quick chat | Copilot Pro | Included | Quick questions, explain errors (300 reqs). |
+| PR review | Copilot | Included | Assign Copilot as reviewer on PRs. |
+| Heavy agentic work | OpenCode + Zen | ~$90/mo | Architecture, multi-file refactors, autonomous coding. |
+
+### OpenCode Agents (14 agents)
+
+| Agent | Specialty | Model | Cost | Invoke With |
+| :--- | :--- | :--- | :--- | :--- |
+| **Advisor** | Task routing & tool selection | Gemini 3 Flash | Budget | `@agent-advisor` |
+| **Architect** | System design & planning | Gemini 3.1 Pro | $2/$12 | `@planning-agent` |
+| **Plan Reviewer** | Architecture review | Gemini 3.1 Pro | $2/$12 | `@plan-reviewer` |
+| **Engineer** | Default builder (approval) | GPT 5.4 | $2.50/$15 | `@engineer` |
+| **Coder** | Autonomous test-fix loops | GPT 5.3 Codex | $1.75/$14 | `@coder` |
+| **Frontend** | UI/vision-to-code | Kimi K2.5 | $0.60/$3 | `@frontend` |
+| **Lead Dev** | Quick tasks (auto-commit) | MiniMax Free | FREE | `@lead_dev` |
+| **Reviewer** | Code quality review | Gemini 3.1 Pro | $2/$12 | `@reviewer` |
+| **Security** | Vulnerability scanning | Gemini 3.1 Pro | $2/$12 | `@security` |
+| **QA** | Test generation & execution | GPT 5.3 Codex | $1.75/$14 | `@qa` |
+| **Test Gen** | BDD/requirements-driven tests | GPT 5.3 Codex | $1.75/$14 | `@test_generator` |
+| **Docs** | Inline + external docs | Gemini 3 Flash | Budget | `@docs_generator` |
+| **PM** | Linear integration | Gemini 3 Flash | Budget | `@linear` |
+| **Committer** | Git automation | MiniMax Free | FREE | `@commiter` |
+
+Agent configs live in [`opencode/aig_agents/`](opencode/aig_agents/). Rules live in [`skills/`](skills/) (symlinked into [`.claude/rules/`](.claude/rules/)) and [`.cursor/rules/`](.cursor/rules/).
 
 For frontend design skills (`/audit`, `/polish`, `/critique`, `/animate`, `/frontend-design`, etc.), install [Impeccable](https://impeccable.style/):
 
 ```bash
 npx skills add pbakaus/impeccable
 ```
 
-| Agent | Specialty | Invoke With |
-| :--- | :--- | :--- |
-| **Advisor** | Task routing & agent selection | `@agent-advisor` |
-| **Architect** | System design & planning | `@planning-agent` |
-| **Reviewer** | Code & architecture review | `@plan-reviewer` `@reviewer` |
-| **Engineer** | Complex features & refactoring | `@engineer` |
-| **Lead Dev** | Fast implementation & fixes | `@lead_dev` |
-| **QA** | Test generation & execution | `@qa` `@test_generator` |
-| **Security** | Vulnerability scanning | `@security` |
-| **PM** | Linear integration & project mgmt | `@linear` |
-
-Agent configs live in [`opencode/aig_agents/`](opencode/aig_agents/). Rules live in [`skills/`](skills/) (symlinked into [`.claude/rules/`](.claude/rules/)) and [`.cursor/rules/`](.cursor/rules/).
-
 ## Open-Source Tools of Interest
 
 Tools and projects from the community that complement this workflow:
@@ -145,7 +162,13 @@ git config --global include.path ~/devkit/.config/git/delta.gitconfig
 echo 'source ~/devkit/.config/shell/enhancements.zsh' >> ~/.zshrc
 ```
 
-**4. Reload shell**
+**4. Set up OpenCode + Copilot (optional)**
+
+```bash
+./scripts/opencode-setup.sh
+```
+
+**5. Reload shell**
 
 ```bash
 source ~/.zshrc

brewfile

@@ -26,6 +26,7 @@ brew "golang"    # Go programming language
 brew "dotnet"    # .NET SDK
 brew "docker"    # Container platform
 brew "gh"        # GitHub CLI (for Copilot and GitHub integration)
+                 # After brew bundle, run: gh extension install github/gh-copilot
 
 # Applications (Casks)
 cask "ghostty"

opencode.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "opencode/gpt-5.4",
+  "small_model": "opencode/minimax-m2.5-free",
+  "mode": {
+    "build": {
+      "model": "opencode/gpt-5.4",
+      "tools": {
+        "write": true,
+        "edit": true,
+        "bash": true
+      }
+    },
+    "plan": {
+      "model": "opencode/gemini-3.1-pro",
+      "tools": {
+        "write": false,
+        "edit": false,
+        "bash": false
+      }
+    }
+  },
+  "mcp": {
+    "github": {
+      "type": "local",
+      "command": ["gh", "copilot", "mcp"],
+      "enabled": true
+    },
+    "context7": {
+      "type": "local",
+      "command": ["npx", "-y", "@context7/mcp-server"],
+      "enabled": true
+    },
+    "linear": {
+      "type": "local",
+      "command": ["npx", "-y", "@linear/mcp-server"],
+      "enabled": true,
+      "environment": {
+        "LINEAR_API_KEY": "{env:LINEAR_API_KEY}"
+      }
+    },
+    "filesystem": {
+      "type": "local",
+      "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem"],
+      "enabled": false
+    }
+  },
+  "plugin": [
+    "@ramtinj95/opencode-tokenscope"
+  ]
+}