@tudeorangbiasa/sdd-multiagent-opencode 0.1.4 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # SDD Multi-Agent OpenCode
 
-Spec-Driven Development framework for OpenCode with multi-agent orchestration, DAG-based parallel execution, and free-tier model optimization.
+Spec-Driven Development workflow kit for OpenCode with four core commands, multi-agent support, and configurable model routing.
 
 Inspired by [spec-kit-command-cursor](https://github.com/madebyaris/spec-kit-command-cursor), rebuilt from scratch for OpenCode's multi-agent architecture.
 
@@ -20,38 +20,67 @@ external UI skills          # impeccable, taste, nothing-design, etc.
 
 | Aspect | Original (Cursor) | This (OpenCode) |
 |--------|-------------------|-----------------|
-| **Models** | Single `inherit` model | 4 models optimized per agent role |
-| **Parallel Execution** | Cursor `is_background: true` | OpenCode subagent spawning via Task tool |
+| **Models** | Single `inherit` model | Configurable per-agent routing |
+| **Parallel Execution** | Cursor `is_background: true` | Safe subagent spawning with file conflict detection |
 | **Codebase Search** | grep/glob | `codebase-memory-mcp` graph queries |
 | **Web Research** | Cursor web search | `exa_web_search_exa` |
 | **Visual Verification** | N/A | Chrome DevTools + Qwen (image-capable) |
 | **Hooks** | `hooks.json` | Plugin JS/TS with event system |
-| **Cost** | Per-token billing | All free-tier models |
+| **Commands** | 15+ slash commands | 4 core commands: explore, propose, apply, ship |
+| **Cost** | Per-token billing | Free-tier optimized with paid model routing |
 
 ## Multi-Agent Architecture
 
-| Agent | Model | Role |
-|-------|-------|------|
-| **sdd-orchestrator** | `opencode/minimax-m2.5-free` | DAG scheduling, conflict detection, deadlock handling |
-| **sdd-planner** | `opencode/qwen3.6-plus-free` | Architecture design, technical planning |
-| **sdd-explorer** | `opencode/deepseek-v4-flash-free` | Codebase discovery (readonly) |
-| **sdd-implementer** | `opencode/deepseek-v4-flash-free` | Code generation (high token usage) |
-| **sdd-verifier** | `opencode/qwen3.6-plus-free` | Completeness check + visual/UI verification (Chrome DevTools) |
-| **sdd-reviewer** | `opencode/minimax-m2.5-free` | Code review (security, performance, spec compliance) |
+| Agent | Default Model | Role |
+|-------|--------------|------|
+| **sdd-orchestrator** | configurable | DAG scheduling, conflict detection, deadlock handling |
+| **sdd-planner** | configurable | Architecture design, technical planning |
+| **sdd-explorer** | configurable | Codebase discovery (readonly) |
+| **sdd-implementer** | configurable | Code generation (high token usage) |
+| **sdd-verifier** | configurable | Completeness check + visual/UI verification (Chrome DevTools) |
+| **sdd-reviewer** | configurable | Code review (security, performance, spec compliance) |
+
+**All models are configurable** via `.sdd/model-profile.json`. Edit this file to change which model each agent uses. See [Model Settings](#model-settings) below.
 
 ## Quick Start
 
-### npx Install (Recommended)
+### Plugin Install (Recommended)
+
+Add to your `opencode.json` (global or project-level):
+
+```json
+{
+  "plugin": [
+    "@tudeorangbiasa/sdd-multiagent-opencode@latest"
+  ]
+}
+```
+
+Restart OpenCode. The plugin auto-registers skills, agents, commands, and internal plugins (model router, auto reasoning).
+
+To pin a specific version:
+
+```json
+{
+  "plugin": [
+    "@tudeorangbiasa/sdd-multiagent-opencode@0.2.0"
+  ]
+}
+```
+
+Verify by asking: "What SDD commands do you have?"
+
+**Why npm instead of GitHub?** GitHub installs pull the latest commit which may include beta/unstable changes. npm packages are versioned and tested before publish, so you get a stable, mature release.
+
+### npx Install (Fallback)
+
+For projects that prefer local files instead of a plugin:
 
 ```bash
 cd your-project
 npx -y -p @tudeorangbiasa/sdd-multiagent-opencode sdd-opencode init
 ```
 
-This installs both:
-- Base OpenCode agent rules (verification, CLI-first, context budget)
-- SDD multi-agent workflow (commands, agents, skills, templates)
-
 **Flags:**
 ```bash
 npx -y -p @tudeorangbiasa/sdd-multiagent-opencode sdd-opencode init              # Install everything
@@ -61,19 +90,147 @@ npx -y -p @tudeorangbiasa/sdd-multiagent-opencode sdd-opencode init --force
 npx -y -p @tudeorangbiasa/sdd-multiagent-opencode sdd-opencode init --dry-run    # Preview only
 ```
 
-### Model Settings
+### Updating
+
+Plugin installs from npm update when you bump the version in your `opencode.json` and restart OpenCode. Check [npm](https://www.npmjs.com/package/@tudeorangbiasa/sdd-multiagent-opencode) for the latest version.
+
+For npx installs, run the installer again with `--force` to overwrite existing files.
+
+## Command Flow Guide
+
+See [GUIDE.md](GUIDE.md) for the practical command flow.
+
+Default workflow:
+
+```text
+/sdd-explore   # investigate unclear ideas, bugs, or code areas; no code changes
+/sdd-propose   # create proposal.md, spec.md, design.md, tasks.md; no code changes
+/sdd-apply     # implement an approved change
+/sdd-ship      # final verification and readiness review
+```
+
+Most work starts with `/sdd-propose`, then `/sdd-apply`, then `/sdd-ship`. Use `/sdd-explore` first only when the problem is unclear.
+
+## Model Settings
 
 The installer creates `.sdd/model-profile.json`. Edit this file to change which model each OpenCode agent uses.
 
-Default profile avoids paid GPT models:
+**⚠️ Requirement:** SDD works best with at least **ONE paid/subscription model** for orchestrator and planner. These roles need strong reasoning + multimodal capabilities that free models lack.
+
+### Provider Prefix Format
+
+OpenCode supports 75+ providers. Model IDs use the format `provider_id/model_id`. Run `opencode provider list` for the full list on your system.
+
+| Provider | Prefix | Example |
+|----------|--------|---------|
+| OpenAI | `openai/` | `openai/gpt-5.5` |
+| Anthropic | `anthropic/` | `anthropic/claude-sonnet-4-5` |
+| Google Gemini | `google/` | `google/gemini-3-pro` |
+| OpenCode Zen | `opencode/` | `opencode/claude-opus-4-7` |
+| OpenCode Go | `opencode-go/` | `opencode-go/deepseek-v4-pro` |
+| OpenRouter | `openrouter/` | `openrouter/anthropic/claude-sonnet-4-5` |
+| Groq | `groq/` | `groq/qwen-qwq` |
+| DeepSeek | `deepseek/` | `deepseek/deepseek-chat` |
+| MiniMax | `minimax/` | `minimax/minimax-m2.7` |
+| Moonshot AI | `moonshot/` | `moonshot/kimi-k2.6` |
+| Z.AI | `zai/` | `zai/glm-5.1` |
+
+### OpenAI (Frontier Models)
+
+Best for orchestration and complex planning. Access via OpenAI API key.
+
+| Model | ID | Best For | Notes |
+|-------|----|----------|-------|
+| GPT 5.5 | `openai/gpt-5.5` | Orchestrator, Planner | Strongest reasoning + multimodal |
+| GPT 5.5 Pro | `openai/gpt-5.5-pro` | Planner (complex) | Maximum capability, slower |
+| GPT 5.5 Fast | `openai/gpt-5.5-fast` | Explorer, Implementer | Optimized for speed |
+| GPT 5.2 | `openai/gpt-5.2` | General | Previous generation |
+
+### Anthropic (Claude)
+
+Access via Anthropic API key or OpenCode Zen.
+
+| Model | ID (Zen) | Best For | Notes |
+|-------|----------|----------|-------|
+| Claude Opus 4.7 | `opencode/claude-opus-4-7` | Planner (complex) | Latest, strongest reasoning |
+| Claude Opus 4.6 | `opencode/claude-opus-4-6` | Planner | Same price as 4.7, good alternative |
+| Claude Opus 4.5 | `opencode/claude-opus-4-5` | Planner | Proven, stable |
+| Claude Sonnet 4.6 | `opencode/claude-sonnet-4-6` | Planner, Reviewer | Balanced cost/performance |
+| Claude Sonnet 4.5 | `opencode/claude-sonnet-4-5` | Planner, Reviewer | Excellent code understanding |
+
+### OpenCode Zen (Curated Paid Models)
+
+Models tested and verified by the OpenCode team. Access via OpenCode API key.
+
+| Model | ID | Best For | Price (Input/Output per 1M) |
+|-------|----|----------|----------------------------|
+| Claude Opus 4.7 | `opencode/claude-opus-4-7` | Planner (complex) | $5.00 / $25.00 |
+| Claude Opus 4.6 | `opencode/claude-opus-4-6` | Planner | $5.00 / $25.00 |
+| Claude Sonnet 4.6 | `opencode/claude-sonnet-4-6` | Planner, Reviewer | $3.00 / $15.00 |
+| Claude Sonnet 4.5 | `opencode/claude-sonnet-4-5` | Planner, Reviewer | $3.00 / $15.00 |
+| Gemini 3.1 Pro | `opencode/gemini-3.1-pro` | Verifier, Planner | $2.00 / $12.00 |
+| Gemini 3 Flash | `opencode/gemini-3-flash` | Explorer | $0.50 / $3.00 |
+| MiniMax M2.7 | `opencode/minimax-m2.7` | Reviewer | $0.30 / $1.20 |
+| MiniMax M2.5 | `opencode/minimax-m2.5` | Reviewer | $0.30 / $1.20 |
+| GLM 5.1 | `opencode/glm-5.1` | Explorer, Planner | $1.40 / $4.40 |
+| GLM 5 | `opencode/glm-5` | Explorer | $1.00 / $3.20 |
+| Kimi K2.6 | `opencode/kimi-k2.6` | Verifier | $0.95 / $4.00 |
+| Kimi K2.5 | `opencode/kimi-k2.5` | Explorer | $0.60 / $3.00 |
+| Qwen3.6 Plus | `opencode/qwen3.6-plus` | General | $0.50 / $3.00 |
+| Qwen3.5 Plus | `opencode/qwen3.5-plus` | General | $0.20 / $1.20 |
+
+### OpenCode Go (Budget Subscription — $10/month)
+
+Curated open-source models with generous limits. Best value for planner/orchestrator on a budget.
+
+| Model | ID | Best For | Notes |
+|-------|----|----------|-------|
+| DeepSeek V4 Pro | `opencode-go/deepseek-v4-pro` | Orchestrator, Planner | Strong reasoning, 1M context, MIT license |
+| DeepSeek V4 Flash | `opencode-go/deepseek-v4-flash` | Explorer, Implementer | Fast code gen |
+| GLM 5.1 | `opencode-go/glm-5.1` | Planner | Strong reasoning |
+| GLM 5 | `opencode-go/glm-5` | Explorer | Budget reasoning |
+| Kimi K2.6 | `opencode-go/kimi-k2.6` | Verifier | Vision support, open weights |
+| Kimi K2.5 | `opencode-go/kimi-k2.5` | Explorer | Fast exploration |
+| MiniMax M2.7 | `opencode-go/minimax-m2.7` | Reviewer | Structured output |
+| MiniMax M2.5 | `opencode-go/minimax-m2.5` | Reviewer | Fast review |
+| Qwen3.6 Plus | `opencode-go/qwen3.6-plus` | General | Balanced |
+| Qwen3.5 Plus | `opencode-go/qwen3.5-plus` | General | Budget |
+| MiMo-V2.5-Pro | `opencode-go/mimo-v2.5-pro` | Explorer | Alternative |
+| MiMo-V2.5 | `opencode-go/mimo-v2.5` | Explorer | Alternative |
+
+**DeepSeek V4 Pro vs MiniMax M2.7:** Based on [Artificial Analysis benchmarks](https://artificialanalysis.ai/models/comparisons/deepseek-v4-pro-vs-minimax-m2-7), DeepSeek V4 Pro scores higher on intelligence index, has 1M context (vs 205K), MIT license (vs non-commercial), and is more recent. Recommended for orchestrator/planner over MiniMax M2.7.
+
+### Free-Tier Models
+
+Models available at no cost via OpenCode Zen. Run `opencode models opencode | grep "free"` to check current availability — free models change frequently.
+
+**Current free models (verified):**
+
+| Model | ID | Best For | Notes |
+|-------|----|----------|-------|
+| DeepSeek V4 Flash Free | `opencode/deepseek-v4-flash-free` | Explorer, Implementer | Code generation |
+| MiniMax M2.5 Free | `opencode/minimax-m2.5-free` | Reviewer, Compaction | Structured output |
+| Nemotron 3 Super Free | `opencode/nemotron-3-super-free` | Explorer | NVIDIA model, 1M context |
+| Qwen3.6 Plus Free | `opencode/qwen3.6-plus-free` | Verifier, General | Multimodal support |
+
+⚠️ Free models are limited-time offers and may be removed or rotated without notice. Not recommended for production SDD workflows. Use `opencode models opencode | grep "free"` to verify what's currently available.
+
+**Alternative free options via other providers:**
+- `groq/qwen-qwq` — Qwen QwQ 32B via Groq (free tier available)
+- `groq/llama-3.3-70b-versatile` — Llama 3.3 70B via Groq
+- `openrouter/deepseek-r1-free` — DeepSeek R1 via OpenRouter (free)
+
+### Default Profile
+
+Recommended starting configuration (orchestrator/planner use OpenAI GPT 5.5, others use free):
 
 ```json
 {
-  "defaultPrimary": "opencode/minimax-m2.5-free",
+  "defaultPrimary": "openai/gpt-5.5",
   "small": "opencode/deepseek-v4-flash-free",
   "agents": {
-    "sdd-orchestrator": "opencode/minimax-m2.5-free",
-    "sdd-planner": "opencode/qwen3.6-plus-free",
+    "sdd-orchestrator": "openai/gpt-5.5",
+    "sdd-planner": "openai/gpt-5.5",
     "sdd-explorer": "opencode/deepseek-v4-flash-free",
     "sdd-implementer": "opencode/deepseek-v4-flash-free",
     "sdd-verifier": "opencode/qwen3.6-plus-free",
@@ -82,7 +239,34 @@ Default profile avoids paid GPT models:
 }
 ```
 
-`.opencode/plugins/sdd-model-router.js` reads this file at OpenCode startup and applies the model settings. Restart OpenCode after editing it.
+**Budget alternative** (OpenCode Go $10/month):
+
+```json
+{
+  "defaultPrimary": "opencode-go/deepseek-v4-pro",
+  "small": "opencode/deepseek-v4-flash-free",
+  "agents": {
+    "sdd-orchestrator": "opencode-go/deepseek-v4-pro",
+    "sdd-planner": "opencode-go/deepseek-v4-pro",
+    "sdd-explorer": "opencode/deepseek-v4-flash-free",
+    "sdd-implementer": "opencode/deepseek-v4-flash-free",
+    "sdd-verifier": "opencode-go/kimi-k2.6",
+    "sdd-reviewer": "opencode/minimax-m2.5-free"
+  }
+}
+```
+
+**Model routing rationale:**
+- **Orchestrator** → GPT 5.5 (OpenAI) or DeepSeek V4 Pro (Go): needs strongest reasoning for DAG coordination, deadlock detection
+- **Planner** → GPT 5.5 (OpenAI) or DeepSeek V4 Pro (Go): needs maximum reasoning for architecture design, risk assessment
+- **Explorer** → DeepSeek free: fast readonly exploration, token-efficient
+- **Implementer** → DeepSeek free: code generation, handles high token usage
+- **Verifier** → Qwen3.6 Plus free: multimodal for Chrome DevTools screenshots
+- **Reviewer** → MiniMax M2.5 free: structured code review output
+
+`.opencode/plugins/sdd-model-router.js` reads this file at OpenCode startup and applies the model settings. **Restart OpenCode after editing it.**
+
+**Important:** Do NOT set models in `opencode.json` — they will be ignored. All model routing goes through `model-profile.json`.
 
 ### Auto Reasoning
 
@@ -109,27 +293,14 @@ Default routing:
 
 Restart OpenCode after editing `.sdd/reasoning-profile.json`.
 
-### 1. Install (Manual)
-
-#### Option A: Using Commands (Recommended)
-
-If you have OpenCode running, you can use the init commands:
-
-```
-/init-rules   # Install base agent rules first
-/init-sdd    # Install SDD workflow layer
-```
+### Manual Install
 
-#### Option B: Manual Copy
+If you prefer local files over a plugin:
 
 ```bash
-# Recommended: install base agent rules first
 git clone https://github.com/TudeOrangBiasa/opencode-agent-rules.git
-
-# Clone into your project
 git clone https://github.com/TudeOrangBiasa/sdd-multiagent-opencode.git
 
-# Or copy the .opencode/ and .sdd/ directories into your project
 cp opencode-agent-rules/AGENTS.md /your-project/
 cp -r opencode-agent-rules/.opencode/rules /your-project/.opencode/
 cp -r opencode-agent-rules/.opencode/plugins /your-project/.opencode/
@@ -138,158 +309,92 @@ cp -r sdd-multiagent-opencode/.sdd /your-project/
 cp sdd-multiagent-opencode/opencode.json /your-project/
 ```
 
-### 2. Configure
-
 Merge the `agent` and `permission` sections from `opencode.json` into your project's `opencode.json`.
 
-### 3. Update Project Profile
+## Usage
 
-Edit `.sdd/project-profile.json` with your stack:
-- framework (e.g., "next", "react", "express")
-- language (e.g., "typescript", "javascript")
-- packageManager (e.g., "pnpm", "npm", "yarn")
-- commands (dev, build, test, lint)
+See [GUIDE.md](GUIDE.md) for the practical flow.
 
-### 4. Use
+```text
+/sdd-propose auth-reset "add secure password reset by email"
+/sdd-apply auth-reset
+/sdd-ship auth-reset
+```
 
-```bash
-# Quick planning (80% of features)
-/brief user-auth JWT authentication with login/logout
-
-# Full planning (complex features)
-/research database-engine Best database for our use case --deep
-/specify user-auth User authentication with login, logout, password reset
-/plan user-auth
-/tasks user-auth
-/implement user-auth
-
-# TDD workflow (test-driven development)
-/tasks user-auth --tdd
-/implement user-auth --tdd
-
-# Full project roadmap
-/sdd-full-plan blog-platform Full-featured blog with CMS and analytics
-/execute-parallel blog-platform --until-finish
-
-# Audit
-/audit user-auth
+If the problem is unclear, start with exploration:
+
+```text
+/sdd-explore "admin UI feels messy, find reusable component opportunities"
 ```
 
 ## Commands
 
-| Command | Purpose | Output |
-|---------|---------|--------|
-| `/init-rules` | Install base agent rules | Base rules files |
-| `/init-sdd` | Install SDD workflow | SDD files + project profile |
-| `/brief` | Lightweight feature brief (~30 min) | `feature-brief.md` |
-| `/research` | Pattern investigation (supports `--deep`) | `research.md` |
-| `/specify` | Detailed requirements | `spec.md` |
-| `/plan` | Technical architecture | `plan.md` |
-| `/tasks` | Task breakdown | `tasks.md` |
-| `/implement` | Execute implementation with todo tracking | Code + `todo-list.md` |
-| `/sdd-full-plan` | Complete project roadmap | `roadmap.json` + tasks |
-| `/execute-parallel` | Parallel DAG execution | Updated roadmap |
-| `/execute-task` | Single task execution | Updated roadmap |
-| `/evolve` | Update specs with discoveries | Updated specs |
-| `/refine` | Iterate on specs through discussion | Updated docs |
-| `/upgrade` | Brief → Full SDD planning | Full SDD docs |
-| `/audit` | Compare implementation against specs | Audit report |
-| `/generate-prd` | PRD via Socratic questions | `full-prd.md` |
-| `/generate-rules` | Auto-generate coding rules | Rule files |
-| `/grill-me` | Clarify product requirements | Clarified brief |
+| Command | Purpose | Writes Code? |
+|---------|---------|--------------|
+| `/sdd-explore` | Investigate unclear ideas, bugs, or code areas | No |
+| `/sdd-propose` | Create one focused change plan | No |
+| `/sdd-apply` | Implement an approved change | Yes |
+| `/sdd-ship` | Final verification and readiness review | No, unless explicitly asked |
 
 ## Project Structure
 
 ```
 .opencode/
-├── opencode.json          # Agent configs, permissions, model assignments
 ├── agents/
-│   ├── sdd-orchestrator.md   # DAG coordinator (GPT 5.5)
-│   ├── sdd-planner.md        # Architecture designer (GPT 5.5)
-│   ├── sdd-explorer.md       # Codebase investigator (DeepSeek)
-│   ├── sdd-implementer.md    # Code generator (DeepSeek)
-│   ├── sdd-verifier.md       # Completeness checker (Qwen + Chrome)
-│   └── sdd-reviewer.md       # Code reviewer (MiniMax)
+│   ├── sdd-orchestrator.md   # Multi-agent coordination internals
+│   ├── sdd-planner.md        # Proposal/spec/design/tasks planning
+│   ├── sdd-explorer.md       # Readonly codebase investigation
+│   ├── sdd-implementer.md    # Approved implementation work
+│   ├── sdd-verifier.md       # Completeness and UI verification
+│   └── sdd-reviewer.md       # Final review and readiness checks
 ├── commands/
-│   ├── brief.md              # /brief
-│   ├── research.md           # /research
-│   ├── specify.md            # /specify
-│   ├── plan.md               # /plan
-│   ├── tasks.md              # /tasks
-│   ├── implement.md          # /implement
-│   ├── sdd-full-plan.md      # /sdd-full-plan
-│   ├── execute-parallel.md   # /execute-parallel
-│   ├── execute-task.md       # /execute-task
-│   ├── evolve.md             # /evolve
-│   ├── refine.md             # /refine
-│   ├── upgrade.md            # /upgrade
-│   ├── audit.md              # /audit
-│   ├── generate-prd.md       # /generate-prd
-│   └── generate-rules.md     # /generate-rules
+│   ├── sdd-explore.md        # /sdd-explore
+│   ├── sdd-propose.md        # /sdd-propose
+│   ├── sdd-apply.md          # /sdd-apply
+│   └── sdd-ship.md           # /sdd-ship
 └── skills/
     ├── sdd-research/SKILL.md
     ├── sdd-planning/SKILL.md
     ├── sdd-implementation/SKILL.md
-    ├── sdd-audit/SKILL.md
-    └── sdd-evolve/SKILL.md
+    └── sdd-audit/SKILL.md
 
 .sdd/
 ├── config.json               # Project configuration
 ├── project-profile.json      # Stack and skill routing config
 └── templates/                # Document templates
-    ├── feature-brief-v2.md
-    ├── spec-compact.md
-    ├── plan-compact.md
-    ├── tasks-compact.md
-    ├── research-compact.md
-    ├── todo-compact.md
-    ├── roadmap-template.json
-    └── roadmap-template.md
+    ├── proposal-template.md
+    ├── spec-template.md
+    ├── design-template.md
+    ├── tasks-template.md
+    ├── progress-template.md
+    └── verification-template.md
 
 specs/
-├── active/                   # Features in development
-├── backlog/                  # Future features
-├── completed/                # Delivered features
-└── todo-roadmap/             # Project roadmaps with DAG
+└── active/
+    └── <change-id>/
+        ├── proposal.md
+        ├── spec.md
+        ├── design.md
+        ├── tasks.md
+        ├── progress.md
+        └── verification.md
 ```
 
 ## Workflows
 
-### Quick Planning (80% of features)
-```
-/brief → /evolve → /refine → /implement
-```
-
-### Full Planning (complex features)
-```
-/research → /specify → /plan → /tasks → /implement
-```
-
-### Deep Research (unfamiliar domain)
-```
-/research --deep → /specify → /plan → /tasks → /implement
-```
+Most changes use:
 
-### Parallel Execution (project roadmap)
-```
-/sdd-full-plan → /execute-parallel --until-finish
+```text
+/sdd-propose -> /sdd-apply -> /sdd-ship
 ```
 
-### TDD Workflow (Test-Driven Development)
+Unclear changes use:
 
+```text
+/sdd-explore -> /sdd-propose -> /sdd-apply -> /sdd-ship
 ```
-/brief feature-x → /tasks feature-x --tdd → /implement feature-x --tdd
-```
-
-With `--tdd` flag:
-- `/tasks` generates TDD-specific tasks with test-first structure
-- `/implement` writes failing test → implements minimum code → verifies pass → refactors
 
-**Example:**
-```
-/tasks user-auth --tdd
-/implement user-auth --tdd
-```
+This kit intentionally avoids fake CLI flags such as `--deep` or `--until-finish`. If deeper research or parallel execution is needed, describe that in normal language and let the agent plan it explicitly.
 
 ## Tools Integration
 
@@ -302,11 +407,10 @@ Used by `sdd-explorer` and `sdd-implementer` for:
 - `get_architecture` — high-level project structure
 
 ### exa_web_search_exa
-Used by `sdd-explorer` and `sdd-research` skill for:
+Used by `sdd-explorer` when external research is relevant:
 - External pattern research
 - Documentation lookup
 - Technology comparison
-- Deep research mode (`--deep`)
 
 ### chrome-devtools
 Used by `sdd-verifier` for:

package/bin/sdd-opencode.js

@@ -332,15 +332,9 @@ function patchOpencodeJson(ctx) {
       }
     }
 
-    if (pkgConfig.model) {
-      targetConfig.model = pkgConfig.model;
-      ctx.installed.push("opencode.json (model patch)");
-    }
-
-    if (pkgConfig.small_model) {
-      targetConfig.small_model = pkgConfig.small_model;
-      ctx.installed.push("opencode.json (small_model patch)");
-    }
+    // NOTE: model and small_model are NOT patched from opencode.json.
+    // Model routing is handled by .sdd/model-profile.json + sdd-model-router.js plugin.
+    // Users edit model-profile.json to change models — opencode.json models are ignored.
 
     if (pkgConfig.agents && !targetConfig.agents) {
       targetConfig.agents = pkgConfig.agents;
@@ -360,6 +354,10 @@ function patchOpencodeJson(ctx) {
       targetConfig.permission = pkgConfig.permission;
       ctx.installed.push("opencode.json (permission patch)");
     }
+
+    // NOTE: model and small_model are NOT patched here.
+    // Model routing is handled by .sdd/model-profile.json + sdd-model-router.js plugin.
+    // Users should edit model-profile.json to change models, not opencode.json.
   }
 
   if (ctx.dryRun) {

package/opencode.json

@@ -1,16 +1,13 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  "model": "opencode/minimax-m2.5-free",
-  "small_model": "opencode/deepseek-v4-flash-free",
   "plugin": [
     "./plugins/sdd-model-router.js",
     "./plugins/sdd-auto-reasoning.js"
   ],
   "agent": {
     "sdd-orchestrator": {
-      "description": "Parallel task coordination and DAG-based execution for SDD workflows. Use for /execute-parallel, --until-finish automation, and coordinating multiple subagents across complex projects.",
+      "description": "Internal coordination agent for complex SDD changes. Use only when a core command needs multi-agent scheduling.",
       "mode": "subagent",
-      "model": "opencode/minimax-m2.5-free",
       "temperature": 0.3,
       "permission": {
         "edit": "allow",
@@ -22,9 +19,8 @@
       "color": "accent"
     },
     "sdd-planner": {
-      "description": "Architecture design and technical planning for SDD workflows. Use when generating plans from specifications, designing system architecture, or breaking down features into tasks.",
+      "description": "Creates compact SDD proposal, spec, design, and task artifacts for /sdd-propose.",
       "mode": "subagent",
-      "model": "opencode/qwen3.6-plus-free",
       "temperature": 0.3,
       "permission": {
         "edit": "allow",
@@ -36,9 +32,8 @@
       "color": "info"
     },
     "sdd-explorer": {
-      "description": "Deep codebase exploration for SDD workflows using codebase-memory-mcp. Use proactively when technical approach is unclear, before /research or /specify, or when investigating existing patterns.",
+      "description": "Readonly codebase exploration for /sdd-explore and uncertain /sdd-propose requests.",
       "mode": "subagent",
-      "model": "opencode/deepseek-v4-flash-free",
       "temperature": 0.1,
       "permission": {
         "edit": "deny",
@@ -54,9 +49,8 @@
       "color": "secondary"
     },
     "sdd-implementer": {
-      "description": "Systematic code implementation following SDD plans and todo-lists. Use for executing planned implementations, code generation, and building features according to specifications.",
+      "description": "Systematic implementation for approved /sdd-apply changes.",
       "mode": "subagent",
-      "model": "opencode/deepseek-v4-flash-free",
       "temperature": 0.3,
       "permission": {
         "edit": "allow",
@@ -68,9 +62,8 @@
       "color": "success"
     },
     "sdd-verifier": {
-      "description": "Independent validation that implementations are actually complete. Uses Chrome DevTools for visual/UI verification and codebase-memory-mcp for structural checks. Spawns after implementation phases.",
+      "description": "Independent validation for /sdd-ship, including browser checks when needed.",
       "mode": "subagent",
-      "model": "opencode/qwen3.6-plus-free",
       "temperature": 0.1,
       "permission": {
         "edit": "deny",
@@ -80,9 +73,8 @@
       "color": "warning"
     },
     "sdd-reviewer": {
-      "description": "Code review specialist for security, performance, and spec compliance. Use before marking tasks complete, during pull request reviews, or for quality assurance audits.",
+      "description": "Final review specialist for /sdd-ship readiness checks.",
       "mode": "subagent",
-      "model": "opencode/minimax-m2.5-free",
       "temperature": 0.2,
       "permission": {
         "edit": "deny",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tudeorangbiasa/sdd-multiagent-opencode",
-  "version": "0.1.4",
-  "description": "Spec-Driven Development multi-agent workflow for OpenCode",
+  "version": "0.2.1",
+  "description": "Spec-Driven Development workflow kit for OpenCode with 4 core commands, multi-agent support, and configurable model routing",
   "type": "module",
+  "main": ".opencode/plugins/sdd-register.js",
   "bin": {
-    "sdd-multiagent-opencode": "bin/sdd-opencode.js",
     "sdd-opencode": "bin/sdd-opencode.js"
   },
   "files": [
@@ -13,6 +13,7 @@
     ".sdd",
     "vendor",
     "README.md",
+    "GUIDE.md",
     "opencode.json"
   ],
   "scripts": {
@@ -22,7 +23,8 @@
     "opencode",
     "sdd",
     "spec-driven-development",
-    "multi-agent"
+    "multi-agent",
+    "opencode-plugin"
   ],
   "license": "MIT"
 }