opencode-sdlc-plugin 0.3.2 → 1.0.0-alpha.0

package/README.md

@@ -35,7 +35,7 @@ The interactive installer will:
 1. Ask about your LLM subscriptions (Claude, OpenAI, Google, GitHub Copilot)
 2. Configure agent models for TDD roles
 3. Set up GitHub integration
-4. Install bridge commands
+4. Configure Marvin modes
 
 ## Requirements
 
@@ -48,9 +48,51 @@ The interactive installer will:
   - Google/Gemini
   - GitHub Copilot
 
+## Marvin: The Orchestrator
+
+Marvin is the unified orchestrator that coordinates all development work. Instead of separate commands, Marvin operates in different **modes** that you switch between using the **Tab key** in OpenCode.
+
+### Available Modes
+
+| Mode | Purpose | Key Activities |
+|------|---------|----------------|
+| **Build** | Implementation | TDD cycle, code changes via subagents |
+| **Discover** | Exploration | Problem understanding, user journeys, assumptions |
+| **Model** | Event Modeling | Event discovery, workflow design, GWT specs |
+| **Architect** | Design Decisions | ADRs, technology evaluation, tradeoffs |
+| **PRD** | Specifications | User stories, acceptance criteria, requirements |
+| **PM** | Project Management | Issues, branches, PRs, board management |
+
+### Mode Switching
+
+Press **Tab** in OpenCode to switch modes. Marvin will:
+- Suggest the appropriate mode for your request
+- Carry context between modes when relevant
+- Enforce mode-specific constraints (e.g., Build mode cannot skip TDD)
+
+```
+User: I need to add user authentication
+
+Marvin (Discover): Let me understand the requirements first...
+  - Who are the users?
+  - What authentication methods needed?
+
+[Tab → Model mode]
+
+Marvin (Model): Let me design the events...
+  - UserRegistered, UserLoggedIn, TokenRefreshed
+
+[Tab → Build mode]
+
+Marvin (Build): Starting TDD cycle for AC1...
+  - RED: Writing failing test for registration
+  - DOMAIN: Creating Email, Password types
+  - GREEN: Implementing registration service
+```
+
 ## TDD Cycle Enforcement
 
-The plugin enforces a strict 4-phase TDD cycle:
+The plugin enforces a strict 4-phase TDD cycle in Build mode:
 
 ```
 RED → DOMAIN → GREEN → DOMAIN → [repeat or refactor]
@@ -60,10 +102,10 @@ RED → DOMAIN → GREEN → DOMAIN → [repeat or refactor]
 
 | Phase | Agent | Purpose | Can Edit |
 |-------|-------|---------|----------|
-| **RED** | `sdlc_red` | Write ONE failing test | Test files only |
-| **DOMAIN** (after RED) | `sdlc_domain` | Review test, create types | Type definitions |
-| **GREEN** | `sdlc_green` | Make test pass | Source files only |
-| **DOMAIN** (after GREEN) | `sdlc_domain` | Verify domain integrity | Type definitions |
+| **RED** | Red Agent | Write ONE failing test | Test files only |
+| **DOMAIN** (after RED) | Domain Agent | Review test, create types | Type definitions |
+| **GREEN** | Green Agent | Make test pass | Source files only |
+| **DOMAIN** (after GREEN) | Domain Agent | Verify domain integrity | Type definitions |
 
 ### Domain Agent Veto Power
 
@@ -73,18 +115,15 @@ The domain agent can block workflow for:
 - **Invalid states representable** - Using boolean flags instead of enum variants
 - **Parse-don't-validate violations** - Checking email in business logic instead of at boundary
 
-## Commands
+### File Ownership
 
-After installation, these commands are available in OpenCode:
+In Build mode, the orchestrator cannot directly edit files. All changes go through specialized subagents:
 
-| Command | Description |
-|---------|-------------|
-| `/sdlc-dev` | Start/continue work on current issue |
-| `/sdlc-review` | 3-stage PR review (spec, quality, domain) |
-| `/sdlc-debug` | Debug with Oracle (deep reasoning) |
-| `/sdlc-research` | Research with Librarian + MCPs |
-| `/sdlc-status` | View/update issue status |
-| `/sdlc-info` | Show toolkit configuration |
+| Agent | Can Edit | Cannot Edit |
+|-------|----------|-------------|
+| Red Agent | `*.test.*`, `*.spec.*` | Source files |
+| Green Agent | Source files | Test files |
+| Domain Agent | Type definitions | Tests, implementation |
 
 ## GitHub Issues Integration
 
@@ -102,6 +141,8 @@ Work items are tracked via GitHub Issues instead of local files:
 [#42ΔAC2] Add rate limiting
 ```
 
+Todos automatically sync with issue body checkboxes when marked complete.
+
 ## Configuration
 
 Configuration files are stored in `~/.config/opencode/`:
@@ -123,6 +164,18 @@ npx opencode-sdlc install --preset event-modeling # Standard + event modeling
 
 Create `.opencode/sdlc.json` in your project root to override global settings.
 
+## CLI Commands
+
+```bash
+npx opencode-sdlc install         # Install or reconfigure
+npx opencode-sdlc upgrade         # Upgrade to latest version
+npx opencode-sdlc upgrade --check # Check for updates without installing
+npx opencode-sdlc doctor          # Diagnose issues
+npx opencode-sdlc doctor --fix    # Auto-fix common problems
+npx opencode-sdlc info            # Show current configuration
+npx opencode-sdlc uninstall       # Remove SDLC plugin
+```
+
 ## Troubleshooting
 
 ```bash
@@ -130,12 +183,32 @@ npx opencode-sdlc doctor        # Diagnose issues
 npx opencode-sdlc doctor --fix  # Auto-fix common problems
 ```
 
+Common issues:
+- **"No LLM provider configured"** - Run installer and enable at least one subscription
+- **"GitHub CLI not authenticated"** - Run `gh auth login`
+- **"oh-my-opencode not installed"** - Run `npx opencode-sdlc doctor --fix`
+
 ## Development Status
 
-This project is currently in active development for v0.3.0. See [AGENTS.md](AGENTS.md) for the implementation plan and GitHub issues.
+This project is in active development for v1.0.0. See [AGENTS.md](AGENTS.md) for architecture details.
 
 **Project Board:** https://github.com/users/jwilger/projects/27
 
+## Migration from v0.x
+
+If you're upgrading from v0.x (which used bridge commands like `/sdlc-dev`), see [MIGRATING-TO-V1.md](MIGRATING-TO-V1.md) for migration instructions.
+
+### Quick Migration Reference
+
+| Old Command | New Approach |
+|-------------|--------------|
+| `/sdlc-dev` | Build mode (Tab) |
+| `/sdlc-debug` | Build mode + invoke Oracle |
+| `/sdlc-research` | Discover mode |
+| `/sdlc-design` | Model or Architect mode |
+| `/sdlc-info` | `npx opencode-sdlc info` |
+| `/sdlc-status` | PM mode |
+
 ## Credits
 
 Built on top of:

package/config/presets/copilot-only.json

@@ -9,13 +9,20 @@
     "githubCopilot": { "enabled": true, "plan": "business" }
   },
   "models": {
-    "sisyphus": "github-copilot/claude-sonnet-4.5",
-    "oracle": "github-copilot/gpt-5.1",
+    "marvin": "github-copilot/gpt-5.2-codex",
+    "oracle": "github-copilot/gpt-5.2",
     "librarian": "github-copilot/claude-haiku-4.5",
     "frontend": "github-copilot/claude-sonnet-4.5",
-    "documentWriter": "github-copilot/gemini-2.5-pro",
-    "multimodalLooker": "github-copilot/gemini-2.5-pro",
-    "explore": "github-copilot/gpt-5-mini"
+    "documentWriter": "github-copilot/gemini-3-pro",
+    "multimodalLooker": "github-copilot/gemini-3-flash",
+    "explore": "github-copilot/gemini-3-flash",
+    "settings": {
+      "marvin": { "temperature": 0.2 },
+      "oracle": { "temperature": 0.1 },
+      "documentWriter": { "temperature": 0.4 },
+      "multimodalLooker": { "temperature": 0.2 },
+      "explore": { "temperature": 0.2 }
+    }
   },
   "tdd": {
     "enabled": true,

package/config/presets/enterprise.json

@@ -9,15 +9,15 @@
     "githubCopilot": { "enabled": false, "plan": "none" }
   },
   "models": {
-    "sisyphus": "anthropic/claude-opus-4-5-thinking",
-    "oracle": "openai/gpt-5.1-high",
+    "marvin": "anthropic/claude-opus-4-5-thinking",
+    "oracle": "openai/gpt-5.2",
     "librarian": "anthropic/claude-sonnet-4-5-thinking",
-    "frontend": "google/gemini-2.5-pro",
+    "frontend": "google/gemini-3-pro-preview",
     "documentWriter": "anthropic/claude-opus-4-5",
-    "multimodalLooker": "google/gemini-2.5-pro",
-    "explore": "google/gemini-2.5-flash",
+    "multimodalLooker": "google/gemini-3-flash-preview",
+    "explore": "google/gemini-3-flash-preview",
     "settings": {
-      "sisyphus": { "thinkingLevel": "high" },
+      "marvin": { "thinkingLevel": "high" },
       "oracle": { "thinkingLevel": "high" },
       "librarian": { "thinkingLevel": "medium" },
       "frontend": { "temperature": 0.5 },
@@ -68,7 +68,7 @@
     },
     "agentOverrides": {
       "oracle": { "requiresThinking": true },
-      "sisyphus": { "requiresThinking": true }
+      "marvin": { "requiresThinking": true }
     },
     "fallbackBehavior": {
       "autoFallback": true,

package/config/presets/event-modeling.json

@@ -9,15 +9,15 @@
     "githubCopilot": { "enabled": false, "plan": "none" }
   },
   "models": {
-    "sisyphus": "anthropic/claude-sonnet-4-5-thinking",
-    "oracle": "openai/gpt-5.1-high",
+    "marvin": "openai/gpt-5.2-codex",
+    "oracle": "openai/gpt-5.2",
     "librarian": "anthropic/claude-sonnet-4-5",
     "frontend": "anthropic/claude-sonnet-4-5",
-    "documentWriter": "google/gemini-2.5-pro",
-    "multimodalLooker": "google/gemini-2.5-flash",
-    "explore": "google/gemini-2.5-flash",
+    "documentWriter": "google/gemini-3-pro-preview",
+    "multimodalLooker": "google/gemini-3-flash-preview",
+    "explore": "google/gemini-3-flash-preview",
     "settings": {
-      "sisyphus": { "thinkingLevel": "medium" },
+      "marvin": { "thinkingLevel": "medium" },
       "oracle": { "thinkingLevel": "high" },
       "librarian": { "thinkingLevel": "low" },
       "frontend": { "temperature": 0.5 },

package/config/presets/minimal.json

@@ -9,12 +9,12 @@
     "githubCopilot": { "enabled": false, "plan": "none" }
   },
   "models": {
-    "sisyphus": "anthropic/claude-sonnet-4-5",
+    "marvin": "anthropic/claude-sonnet-4-5",
     "oracle": "anthropic/claude-sonnet-4-5-thinking",
     "librarian": "anthropic/claude-sonnet-4-5",
     "explore": "anthropic/claude-sonnet-4-5",
     "settings": {
-      "sisyphus": { "temperature": 0.2 },
+      "marvin": { "temperature": 0.2 },
       "oracle": { "thinkingLevel": "medium" },
       "librarian": { "temperature": 0.3 },
       "explore": { "temperature": 0.2 }

package/config/presets/solo-quick.json

@@ -9,12 +9,12 @@
     "githubCopilot": { "enabled": false, "plan": "none" }
   },
   "models": {
-    "sisyphus": "anthropic/claude-sonnet-4-5-thinking",
+    "marvin": "anthropic/claude-sonnet-4-5-thinking",
     "oracle": "anthropic/claude-sonnet-4-5-thinking",
     "librarian": "anthropic/claude-sonnet-4-5",
     "explore": "anthropic/claude-sonnet-4-5",
     "settings": {
-      "sisyphus": { "thinkingLevel": "medium" },
+      "marvin": { "thinkingLevel": "medium" },
       "oracle": { "thinkingLevel": "high" },
       "librarian": { "temperature": 0.3 },
       "explore": { "temperature": 0.2 }

package/config/presets/standard.json

@@ -9,15 +9,15 @@
     "githubCopilot": { "enabled": false, "plan": "none" }
   },
   "models": {
-    "sisyphus": "anthropic/claude-sonnet-4-5-thinking",
-    "oracle": "openai/gpt-5.1-high",
+    "marvin": "openai/gpt-5.2-codex",
+    "oracle": "openai/gpt-5.2",
     "librarian": "anthropic/claude-sonnet-4-5",
     "frontend": "anthropic/claude-sonnet-4-5",
-    "documentWriter": "google/gemini-2.5-pro",
-    "multimodalLooker": "google/gemini-2.5-flash",
-    "explore": "google/gemini-2.5-flash",
+    "documentWriter": "google/gemini-3-pro-preview",
+    "multimodalLooker": "google/gemini-3-flash-preview",
+    "explore": "google/gemini-3-flash-preview",
     "settings": {
-      "sisyphus": { "thinkingLevel": "medium" },
+      "marvin": { "thinkingLevel": "medium" },
       "oracle": { "thinkingLevel": "high" },
       "librarian": { "thinkingLevel": "low" },
       "frontend": { "temperature": 0.5 },

package/config/presets/strict-tdd.json

@@ -9,15 +9,15 @@
     "githubCopilot": { "enabled": false, "plan": "none" }
   },
   "models": {
-    "sisyphus": "anthropic/claude-sonnet-4-5-thinking",
-    "oracle": "openai/gpt-5.1-high",
+    "marvin": "anthropic/claude-sonnet-4-5-thinking",
+    "oracle": "openai/gpt-5.2",
     "librarian": "anthropic/claude-sonnet-4-5",
     "frontend": "anthropic/claude-sonnet-4-5",
-    "documentWriter": "google/gemini-2.5-pro",
-    "multimodalLooker": "google/gemini-2.5-flash",
-    "explore": "google/gemini-2.5-flash",
+    "documentWriter": "google/gemini-3-pro-preview",
+    "multimodalLooker": "google/gemini-3-flash-preview",
+    "explore": "google/gemini-3-flash-preview",
     "settings": {
-      "sisyphus": { "thinkingLevel": "high" },
+      "marvin": { "thinkingLevel": "high" },
       "oracle": { "thinkingLevel": "high" },
       "librarian": { "thinkingLevel": "medium" },
       "frontend": { "temperature": 0.3 },
@@ -68,7 +68,7 @@
     },
     "agentOverrides": {
       "oracle": { "requiresThinking": true },
-      "sisyphus": { "requiresThinking": true }
+      "marvin": { "requiresThinking": true }
     },
     "fallbackBehavior": {
       "autoFallback": false,

package/config/schemas/athena.schema.json

@@ -68,7 +68,7 @@
       "type": "object",
       "description": "Agent model assignments",
       "properties": {
-        "sisyphus": {
+        "marvin": {
           "type": "string",
           "description": "Model for main orchestrator agent"
         },
@@ -100,7 +100,7 @@
           "type": "object",
           "description": "Optional agent-specific settings for temperature and thinking level",
           "properties": {
-            "sisyphus": { "$ref": "#/definitions/agentSettings" },
+            "marvin": { "$ref": "#/definitions/agentSettings" },
             "oracle": { "$ref": "#/definitions/agentSettings" },
             "librarian": { "$ref": "#/definitions/agentSettings" },
             "frontend": { "$ref": "#/definitions/agentSettings" },
@@ -120,7 +120,7 @@
           "items": { "$ref": "#/definitions/customModel" }
         }
       },
-      "required": ["sisyphus", "oracle", "librarian"]
+      "required": ["marvin", "oracle", "librarian"]
     },
     "bmad": {
       "type": "object",
@@ -232,7 +232,7 @@
           "type": "object",
           "description": "Per-agent routing overrides",
           "properties": {
-            "sisyphus": { "$ref": "#/definitions/agentRouting" },
+            "marvin": { "$ref": "#/definitions/agentRouting" },
             "oracle": { "$ref": "#/definitions/agentRouting" },
             "librarian": { "$ref": "#/definitions/agentRouting" },
             "frontend": { "$ref": "#/definitions/agentRouting" },

package/config/schemas/sdlc.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "OpenCode SDLC Configuration",
-  "description": "Configuration schema for OpenCode SDLC Plugin - Strict TDD with domain modeling and event sourcing",
+  "description": "Configuration schema for OpenCode SDLC Plugin v1.0 - Strict TDD with domain modeling and event sourcing",
   "type": "object",
   "properties": {
     "$schema": {
@@ -12,6 +12,50 @@
       "type": "string",
       "description": "OpenCode SDLC Plugin version"
     },
+    "modes": {
+      "type": "object",
+      "description": "Mode configuration (v1.0.0+)",
+      "properties": {
+        "default": {
+          "type": "string",
+          "enum": ["discover", "model", "architect", "pm", "build"],
+          "default": "build",
+          "description": "Default mode on startup"
+        },
+        "eventModeling": {
+          "type": "boolean",
+          "default": true,
+          "description": "true=Model mode (Event Modeling), false=PRD mode"
+        },
+        "enabled": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["discover", "model", "architect", "pm", "build"]
+          },
+          "default": ["discover", "model", "architect", "pm", "build"],
+          "description": "Array of enabled modes"
+        }
+      }
+    },
+    "memory": {
+      "type": "object",
+      "description": "Memory configuration (v1.0.0+)",
+      "properties": {
+        "backend": {
+          "type": "string",
+          "enum": ["memento", "stateless"],
+          "default": "stateless",
+          "description": "Memory backend type"
+        },
+        "checkpointTtl": {
+          "type": "number",
+          "minimum": 1,
+          "default": 86400,
+          "description": "How long to keep checkpoints in seconds"
+        }
+      }
+    },
     "subscriptions": {
       "type": "object",
       "description": "LLM subscription configuration",
@@ -68,7 +112,7 @@
       "type": "object",
       "description": "Agent model assignments",
       "properties": {
-        "sisyphus": {
+        "marvin": {
           "type": "string",
           "description": "Model for main orchestrator agent"
         },
@@ -96,11 +140,25 @@
           "type": "string",
           "description": "Model for fast codebase exploration agent"
         },
+        "subagents": {
+          "type": "object",
+          "description": "Per-subagent model overrides (v1.0.0+)",
+          "properties": {
+            "red": { "$ref": "#/definitions/subagentModel" },
+            "green": { "$ref": "#/definitions/subagentModel" },
+            "domain": { "$ref": "#/definitions/subagentModel" },
+            "refactor": { "$ref": "#/definitions/subagentModel" },
+            "architect": { "$ref": "#/definitions/subagentModel" },
+            "pm": { "$ref": "#/definitions/subagentModel" },
+            "analyst": { "$ref": "#/definitions/subagentModel" },
+            "reviewer": { "$ref": "#/definitions/subagentModel" }
+          }
+        },
         "settings": {
           "type": "object",
           "description": "Optional agent-specific settings for temperature and thinking level",
           "properties": {
-            "sisyphus": { "$ref": "#/definitions/agentSettings" },
+            "marvin": { "$ref": "#/definitions/agentSettings" },
             "oracle": { "$ref": "#/definitions/agentSettings" },
             "librarian": { "$ref": "#/definitions/agentSettings" },
             "frontend": { "$ref": "#/definitions/agentSettings" },
@@ -120,7 +178,7 @@
           "items": { "$ref": "#/definitions/customModel" }
         }
       },
-      "required": ["sisyphus", "oracle", "librarian"]
+      "required": ["marvin", "oracle", "librarian"]
     },
     "github": {
       "type": "object",
@@ -188,6 +246,23 @@
               "description": "Minimum mutation score required (0-100)"
             }
           }
+        },
+        "domainVetoEnabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable domain agent veto power over type changes (v1.0.0+)"
+        },
+        "debateRounds": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 5,
+          "default": 2,
+          "description": "Max debate rounds before escalation to user (v1.0.0+)"
+        },
+        "requireVerification": {
+          "type": "boolean",
+          "default": true,
+          "description": "Require test output evidence before phase transitions (v1.0.0+)"
         }
       }
     },
@@ -358,7 +433,7 @@
           "type": "object",
           "description": "Per-agent routing overrides",
           "properties": {
-            "sisyphus": { "$ref": "#/definitions/agentRouting" },
+            "marvin": { "$ref": "#/definitions/agentRouting" },
             "oracle": { "$ref": "#/definitions/agentRouting" },
             "librarian": { "$ref": "#/definitions/agentRouting" },
             "frontend": { "$ref": "#/definitions/agentRouting" },
@@ -388,6 +463,11 @@
             }
           },
           "required": ["autoFallback", "retryPeriodMs", "notifyOnRateLimit"]
+        },
+        "classifierModel": {
+          "type": "string",
+          "default": "anthropic/claude-haiku",
+          "description": "Model for sdlc_classify_request tool (v1.0.0+)"
         }
       },
       "required": ["providerPriority", "modelFamilyPriority", "agentOverrides", "fallbackBehavior"]
@@ -459,6 +539,22 @@
           "description": "Preferred provider for this agent"
         }
       }
+    },
+    "subagentModel": {
+      "oneOf": [
+        {
+          "type": "string",
+          "const": "inherit",
+          "description": "Inherit model from marvin"
+        },
+        {
+          "type": "string",
+          "pattern": "^[a-z-]+/[a-z0-9-]+",
+          "description": "Full model identifier (e.g., 'anthropic/claude-sonnet-4-20250514')"
+        }
+      ],
+      "default": "inherit",
+      "description": "Subagent model value - either a model string or 'inherit' to use marvin model"
     }
   }
 }