From 40dd267b127c26d8a8a65b02bb941fa940c81480 Mon Sep 17 00:00:00 2001
From: Darren Hinde <107584450+darrenhinde@users.noreply.github.com>
Date: Wed, 11 Mar 2026 23:49:03 +0000
Subject: [PATCH] feat(plugin): add settings.json with opusplan model (#264)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat(plugin): add settings.json with opusplan model for Claude Code plugin

Adds plugins/claude-code/settings.json with { "model": "opusplan" } so
the OAC plugin automatically uses Opus for planning/orchestration and
Sonnet for subagent execution — matching OAC's plan-first workflow.

Plugin-scoped settings.json takes priority over global/user settings
when the plugin is loaded (marketplace install or --plugin-dir).
Subagents that need a lighter model continue to override at the agent
level (external-scout → haiku, task-manager/test-engineer/coder-agent → sonnet).

Closes #35

* chore(plugin): bump version to 1.0.2 for marketplace pickup
---
 plugins/claude-code/.claude-plugin/plugin.json |  2 +-
 plugins/claude-code/README.md                  | 17 ++++++++++++++++-
 plugins/claude-code/settings.json              |  3 +++
 3 files changed, 20 insertions(+), 2 deletions(-)
 create mode 100644 plugins/claude-code/settings.json

diff --git a/plugins/claude-code/.claude-plugin/plugin.json b/plugins/claude-code/.claude-plugin/plugin.json
index 8b3b45a..5719665 100644
--- a/plugins/claude-code/.claude-plugin/plugin.json
+++ b/plugins/claude-code/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "oac",
   "description": "OpenAgentsControl — multi-agent orchestration for Claude Code. Context-aware development with skills, subagents, parallel execution, and automated code review.",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "author": {
     "name": "darrenhinde",
     "url": "https://github.com/darrenhinde"
diff --git a/plugins/claude-code/README.md b/plugins/claude-code/README.md
index e73a40c..090cf7e 100644
--- a/plugins/claude-code/README.md
+++ b/plugins/claude-code/README.md
@@ -320,7 +320,21 @@ Stage 4: Execute with loaded context → No nested discovery needed
 
 ## 🔧 Configuration
 
-The plugin uses context files from the main OpenAgents Control repository.
+### Model: opusplan
+
+The plugin ships with `settings.json` at the plugin root:
+
+```json
+{
+  "model": "opusplan"
+}
+```
+
+`opusplan` uses **Opus for planning/orchestration** (the main agent) and **Sonnet for execution** (subagents). This matches OAC's plan-first workflow and gives you Opus-quality reasoning without paying Opus rates for every tool call.
+
+Subagents that need a lighter model override this at the agent level (e.g. `external-scout` uses `haiku`). The root setting only affects the main orchestrating agent.
+
+To reload after any settings change: `/reload-plugins` (no restart needed).
 
 ### Context Structure
 
@@ -328,6 +342,7 @@ The plugin uses context files from the main OpenAgents Control repository.
 plugins/claude-code/
 ├── .claude-plugin/
 │   └── plugin.json              # Plugin metadata
+├── settings.json                # Model config: opusplan
 ├── agents/                      # Custom subagents (7 files)
 │   ├── task-manager.md
 │   ├── context-scout.md
diff --git a/plugins/claude-code/settings.json b/plugins/claude-code/settings.json
new file mode 100644
index 0000000..fa8e791
--- /dev/null
+++ b/plugins/claude-code/settings.json
@@ -0,0 +1,3 @@
+{
+  "model": "opusplan"
+}