opencode-swarm 2.1.0 → 2.1.1

package/README.md

@@ -1,161 +1,78 @@
 # OpenCode Swarm
 
-Architect-centric agentic swarm plugin for OpenCode. Hub-and-spoke orchestration with SME consultation, code generation, and QA review.
+![License](https://img.shields.io/badge/license-MIT-blue)
+![OpenCode Plugin](https://img.shields.io/badge/opencode-plugin-green)
+![Agentic Architecture](https://img.shields.io/badge/architecture-architect--centric-purple)
 
-## Overview
+**Architect-driven, multi-agent development for OpenCode.**  
+Design-first orchestration with domain-aware SMEs, heterogeneous model perspectives, production-grade code generation, and layered QA.
 
-OpenCode Swarm implements a multi-agent development pipeline where:
+OpenCode Swarm is built for engineers who want **structured reasoning, controlled delegation, and predictable outcomes**—not parallel agent noise.
 
-1. **Architect** (central orchestrator) analyzes requests and coordinates all agents
-2. **SME Agents** provide domain-specific technical expertise (serial execution)
-3. **Coder** implements unified specifications
-4. **QA Agents** (Security Reviewer + Auditor) validate code quality
-5. **Test Engineer** generates test cases for approved code
+---
 
-```
-User → Architect (analyze) → [SME Pool - serial] → Architect (collate)
-     → Coder → [QA: Security + Auditor] → Architect (triage) → Test
-```
+## Why OpenCode Swarm
 
-## Installation
+Most agent frameworks parallelize everything and hope coherence emerges later.  
+OpenCode Swarm enforces discipline:
 
-```bash
-bunx opencode-swarm install
-```
+- A single Architect owns analysis and decisions
+- Experts are consulted only when technically relevant
+- Agents execute serially for traceability
+- Security and correctness are validated before delivery
+- Different models can be assigned per role, introducing genuinely distinct perspectives
 
-Then start OpenCode:
+This design improves **accuracy, efficiency, and failure detection**, especially on complex or high-stakes tasks.
 
-```bash
-opencode
-```
-
-## Configuration
+---
 
-Edit `~/.config/opencode/opencode-swarm.json`:
-
-```json
-{
-  "preset": "hybrid",
-  "presets": {
-    "remote": {
-      "architect": { "model": "anthropic/claude-sonnet-4.5" },
-      "coder": { "model": "openai/gpt-5.2-codex" },
-      "_sme": { "model": "google/gemini-3-flash" },
-      "_qa": { "model": "google/gemini-3-flash" },
-      "test_engineer": { "model": "google/gemini-3-flash" }
-    },
-    "hybrid": {
-      "architect": { "model": "anthropic/claude-sonnet-4.5" },
-      "coder": { "model": "ollama/qwen3:72b" },
-      "_sme": { "model": "npu/qwen3:14b" },
-      "_qa": { "model": "npu/qwen3:14b" },
-      "test_engineer": { "model": "npu/qwen3:14b" }
-    }
-  },
-  "swarm_mode": "hybrid",
-  "gpu_url": "http://192.168.1.100:1234/v1",
-  "npu_url": "http://localhost:11435/v1",
-  "max_iterations": 5
-}
-```
+## Key Advantage: Heterogeneous Model Perspectives
 
-### Category Defaults
+OpenCode Swarm allows **per-role model selection** so that each cognitive function is optimized independently:
 
-Use `_sme` and `_qa` to set models for all agents in a category:
+- Architect → deep reasoning and synthesis
+- SMEs → domain recall and speed
+- Coder → implementation fidelity
+- QA → adversarial review and audit rigor
 
-```json
-{
-  "agents": {
-    "_sme": { "model": "npu/qwen3:14b" },
-    "_qa": { "model": "npu/qwen3:14b" }
-  }
-}
-```
+Using different models per role reduces correlated failure modes, increases early error detection, and mirrors how real engineering teams benefit from diverse expertise.
 
-To override a specific agent within a category:
+See: [docs/design-rationale.md](docs/design-rationale.md)
 
-```json
-{
-  "agents": {
-    "_sme": { "model": "npu/qwen3:14b" },
-    "sme_oracle": { "model": "ollama/qwen3:72b" }
-  }
-}
-```
+---
 
-### Custom Prompts
+## Architecture Overview
 
-Place custom prompts in `~/.config/opencode/opencode-swarm/`:
+OpenCode Swarm implements a hub-and-spoke pipeline with a single controlling Architect.
 
-- `{agent}.md` - Replace the default prompt entirely
-- `{agent}_append.md` - Append to the default prompt
-
-Example: `architect_append.md` to add custom instructions to the Architect.
-
-## Agents
-
-### Orchestrator
-
-| Agent | Role |
-|-------|------|
-| `architect` | Central orchestrator, coordinates all phases |
-
-### SME Specialists (Domain Experts)
-
-| Agent | Domain |
-|-------|--------|
-| `sme_windows` | Windows OS internals, registry, services |
-| `sme_powershell` | PowerShell scripting, cmdlets, modules |
-| `sme_python` | Python ecosystem, libraries, best practices |
-| `sme_oracle` | Oracle Database, SQL/PLSQL, administration |
-| `sme_network` | Networking, firewalls, DNS, TLS/SSL |
-| `sme_security` | STIG compliance, hardening, encryption |
-| `sme_linux` | Linux administration, systemd, packages |
-| `sme_vmware` | VMware vSphere, ESXi, PowerCLI |
-| `sme_azure` | Azure cloud services, Entra ID, ARM/Bicep |
-| `sme_active_directory` | Active Directory, LDAP, Group Policy |
-| `sme_ui_ux` | UI/UX design, interaction patterns |
-
-### Pipeline Agents
-
-| Agent | Role |
-|-------|------|
-| `coder` | Implements specifications, writes production code |
-| `security_reviewer` | Security vulnerability assessment |
-| `auditor` | Code correctness and quality review |
-| `test_engineer` | Test case and validation script generation |
-
-## Workflow Phases
-
-1. **ANALYZE** - Parse request, identify domains, create initial spec
-2. **SME_CONSULTATION** - Consult domain experts serially
-3. **COLLATE** - Synthesize SME outputs into unified spec
-4. **CODE** - Generate implementation
-5. **QA_REVIEW** - Security and quality review (parallel)
-6. **TRIAGE** - Approve, request revision, or block
-7. **TEST** - Generate tests for approved code
-
-## Delegation Rules
+```
+User → Architect (analysis)
+     → Reader (optional)
+     → Relevant SMEs (serial)
+     → Architect (spec synthesis)
+     → Coder
+     → Security Review → Audit
+     → Architect (triage)
+     → Test Engineer
+```
 
-The Architect enforces resource-aware delegation:
+See: [docs/architecture.md](docs/architecture.md)
 
-- **SME agents**: Execute serially (one at a time) to avoid overwhelming local inference
-- **QA agents**: May execute in parallel (independent analysis)
-- **Cross-category**: One agent per category may run simultaneously
+---
 
-## Tools
+## Installation
 
-| Tool | Description |
-|------|-------------|
-| `detect_domains` | Auto-detect SME domains from text |
-| `extract_code_blocks` | Extract and save code blocks to files |
+```json
+{
+  "plugin": ["opencode-swarm"]
+}
+```
 
-## Environment Variables
+```bash
+bunx opencode-swarm install
+```
 
-| Variable | Description |
-|----------|-------------|
-| `OPENCODE_SWARM_PRESET` | Override preset selection |
-| `OPENCODE_SWARM_DEBUG` | Enable debug logging (`1` to enable) |
+---
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",