@doingdev/opencode-claude-manager-plugin 0.1.27 → 0.1.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/dist/plugin/agent-hierarchy.d.ts +5 -5
  2. package/dist/plugin/agent-hierarchy.js +22 -17
  3. package/dist/prompts/registry.js +90 -85
  4. package/package.json +1 -1
package/dist/plugin/agent-hierarchy.d.ts CHANGED
@@ -1,16 +1,16 @@
1
1
  /**
2
2
  * Agent hierarchy configuration for the CTO + Engineer Wrapper architecture.
3
3
  *
4
- * CTO (cto) — main operator, directly controls Claude Code sessions
5
- * Engineer Plan (engineer_plan) — thin subagent wrapper for read-only investigation
6
- * Engineer Build (engineer_build) — thin subagent wrapper for implementation tasks
7
- * Engineer — the Claude Code session itself (prompt only, no OpenCode agent)
4
+ * CTO (cto) — pure orchestrator, spawns engineers, reviews diffs, commits
5
+ * Engineer Plan (engineer_plan) — manages a Claude Code session for read-only investigation
6
+ * Engineer Build (engineer_build) — manages a Claude Code session for implementation
7
+ * Claude Code session — the underlying AI session (prompt only, no OpenCode agent)
8
8
  */
9
9
  import type { ManagerPromptRegistry } from '../types/contracts.js';
10
10
  export declare const AGENT_CTO = "cto";
11
11
  export declare const AGENT_ENGINEER_PLAN = "engineer_plan";
12
12
  export declare const AGENT_ENGINEER_BUILD = "engineer_build";
13
- /** All restricted tool IDs (union of engineer + git + approval) */
13
+ /** All restricted tool IDs (union of all domain groups) */
14
14
  export declare const ALL_RESTRICTED_TOOL_IDS: readonly ["engineer_send", "engineer_compact", "engineer_clear", "engineer_status", "engineer_metadata", "engineer_sessions", "engineer_runs", "git_diff", "git_commit", "git_reset", "approval_policy", "approval_decisions", "approval_update"];
15
15
  type ToolPermission = 'allow' | 'ask' | 'deny';
16
16
  type AgentPermission = {
package/dist/plugin/agent-hierarchy.js CHANGED
@@ -1,10 +1,10 @@
1
1
  /**
2
2
  * Agent hierarchy configuration for the CTO + Engineer Wrapper architecture.
3
3
  *
4
- * CTO (cto) — main operator, directly controls Claude Code sessions
5
- * Engineer Plan (engineer_plan) — thin subagent wrapper for read-only investigation
6
- * Engineer Build (engineer_build) — thin subagent wrapper for implementation tasks
7
- * Engineer — the Claude Code session itself (prompt only, no OpenCode agent)
4
+ * CTO (cto) — pure orchestrator, spawns engineers, reviews diffs, commits
5
+ * Engineer Plan (engineer_plan) — manages a Claude Code session for read-only investigation
6
+ * Engineer Build (engineer_build) — manages a Claude Code session for implementation
7
+ * Claude Code session — the underlying AI session (prompt only, no OpenCode agent)
8
8
  */
9
9
  // ---------------------------------------------------------------------------
10
10
  // Agent names
@@ -15,7 +15,7 @@ export const AGENT_ENGINEER_BUILD = 'engineer_build';
15
15
  // ---------------------------------------------------------------------------
16
16
  // Tool IDs — grouped by domain
17
17
  // ---------------------------------------------------------------------------
18
- /** Engineer-facing session tools */
18
+ /** All engineer tools — session interaction + diagnostics. Owned by wrappers. */
19
19
  const ENGINEER_TOOL_IDS = [
20
20
  'engineer_send',
21
21
  'engineer_compact',
@@ -25,22 +25,22 @@ const ENGINEER_TOOL_IDS = [
25
25
  'engineer_sessions',
26
26
  'engineer_runs',
27
27
  ];
28
- /** Git tools */
28
+ /** Git tools — owned by CTO */
29
29
  const GIT_TOOL_IDS = ['git_diff', 'git_commit', 'git_reset'];
30
- /** Approval tools */
30
+ /** Approval tools — owned by CTO */
31
31
  const APPROVAL_TOOL_IDS = [
32
32
  'approval_policy',
33
33
  'approval_decisions',
34
34
  'approval_update',
35
35
  ];
36
- /** All restricted tool IDs (union of engineer + git + approval) */
36
+ /** All restricted tool IDs (union of all domain groups) */
37
37
  export const ALL_RESTRICTED_TOOL_IDS = [
38
38
  ...ENGINEER_TOOL_IDS,
39
39
  ...GIT_TOOL_IDS,
40
40
  ...APPROVAL_TOOL_IDS,
41
41
  ];
42
- /** Tools available to engineer wrapper subagents (thin wrappers around Claude Code) */
43
- const ENGINEER_WRAPPER_TOOL_IDS = ['engineer_send', 'engineer_status'];
42
+ /** Tools the CTO can use directly (git + approval only, NO engineer tools) */
43
+ const CTO_TOOL_IDS = [...GIT_TOOL_IDS, ...APPROVAL_TOOL_IDS];
44
44
  // ---------------------------------------------------------------------------
45
45
  // Shared read-only tool permissions
46
46
  // ---------------------------------------------------------------------------
@@ -58,26 +58,31 @@ const READONLY_TOOLS = {
58
58
  // ---------------------------------------------------------------------------
59
59
  // Permission builders
60
60
  // ---------------------------------------------------------------------------
61
- /** CTO: full operator — all restricted tools + read-only codebase tools. No edit, no bash. */
61
+ /** CTO: pure orchestrator — read-only + git + approval + diagnostics. No session tools. */
62
62
  function buildCtoPermissions() {
63
- const allowed = {};
63
+ const denied = {};
64
64
  for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
65
+ denied[toolId] = 'deny';
66
+ }
67
+ const allowed = {};
68
+ for (const toolId of CTO_TOOL_IDS) {
65
69
  allowed[toolId] = 'allow';
66
70
  }
67
71
  return {
68
72
  '*': 'deny',
69
73
  ...READONLY_TOOLS,
74
+ ...denied,
70
75
  ...allowed,
71
76
  };
72
77
  }
73
- /** Engineer wrapper: only engineer_send + engineer_status. Everything else denied. */
78
+ /** Engineer wrapper: all engineer tools. No read-only, git, or approval tools. */
74
79
  function buildEngineerWrapperPermissions() {
75
80
  const denied = {};
76
81
  for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
77
82
  denied[toolId] = 'deny';
78
83
  }
79
84
  const allowed = {};
80
- for (const toolId of ENGINEER_WRAPPER_TOOL_IDS) {
85
+ for (const toolId of ENGINEER_TOOL_IDS) {
81
86
  allowed[toolId] = 'allow';
82
87
  }
83
88
  return {
@@ -91,7 +96,7 @@ function buildEngineerWrapperPermissions() {
91
96
  // ---------------------------------------------------------------------------
92
97
  export function buildCtoAgentConfig(prompts) {
93
98
  return {
94
- description: 'CTO agent that directly operates Claude Code, gathers information, investigates, reviews, and commits. Can spawn engineer wrappers for parallel or isolated work.',
99
+ description: 'Pure orchestrator that investigates, spawns engineers for planning and building, reviews diffs, and commits.',
95
100
  mode: 'primary',
96
101
  color: '#D97757',
97
102
  permission: buildCtoPermissions(),
@@ -100,7 +105,7 @@ export function buildCtoAgentConfig(prompts) {
100
105
  }
101
106
  export function buildEngineerPlanAgentConfig(prompts) {
102
107
  return {
103
- description: 'Thin wrapper that sends a read-only investigation task to Claude Code in plan mode and returns the result.',
108
+ description: 'Engineer that manages a Claude Code session in plan mode for read-only investigation and analysis.',
104
109
  mode: 'subagent',
105
110
  color: '#D97757',
106
111
  permission: buildEngineerWrapperPermissions(),
@@ -109,7 +114,7 @@ export function buildEngineerPlanAgentConfig(prompts) {
109
114
  }
110
115
  export function buildEngineerBuildAgentConfig(prompts) {
111
116
  return {
112
- description: 'Thin wrapper that sends an implementation task to Claude Code in free mode and returns the result.',
117
+ description: 'Engineer that manages a Claude Code session in free mode for implementation and execution.',
113
118
  mode: 'subagent',
114
119
  color: '#D97757',
115
120
  permission: buildEngineerWrapperPermissions(),
package/dist/prompts/registry.js CHANGED
@@ -1,34 +1,34 @@
1
1
  export const managerPromptRegistry = {
2
2
  ctoSystemPrompt: [
3
- 'You are the CTO — a top 0.001% Claude Code operator.',
4
- 'You directly operate Claude Code through a persistent session, gather information,',
5
- 'investigate code, review diffs, and commit changes. You can also spawn thin',
6
- 'engineer wrapper subagents for parallel or isolated work.',
3
+ 'You are the CTO — a top 0.001% technical leader.',
4
+ 'You orchestrate engineers to build the right thing with high quality.',
5
+ 'You investigate, clarify requirements, plan, delegate to engineers,',
6
+ 'review their work, and commit when satisfied.',
7
7
  '',
8
8
  '## Your role',
9
- '- You are the PRIMARY operator. You do not merely orchestrate — you execute.',
10
- '- Think like a staff+ engineer: correctness, maintainability, tests, rollback safety.',
11
9
  '- Gather requirements thoroughly before acting. Clarify ambiguity early.',
12
- '- Plan thoughtfully, execute with quality, review rigorously.',
10
+ '- Think like a staff+ engineer: correctness, maintainability, tests, rollback safety.',
11
+ '- Plan thoughtfully, delegate with precision, review rigorously.',
12
+ '- You have two types of engineers: `engineer_plan` (investigation) and `engineer_build` (implementation).',
13
13
  '',
14
14
  '## Decision loop',
15
15
  'On every turn, choose exactly one action:',
16
- ' investigate — read files, grep, search the codebase, or send a plan-mode task to build context',
17
- ' delegate — send a focused instruction to the engineer via engineer_send',
18
- ' review — run git_diff to inspect what changed',
19
- ' validate — tell the engineer to run tests, lint, or typecheck',
16
+ ' investigate — read files, grep, search the codebase to build context',
17
+ ' plan — spawn `engineer_plan` to analyze code, map dependencies, or draft a plan',
18
+ ' delegate — spawn `engineer_build` with a focused implementation task',
19
+ ' review — run git_diff to inspect what the engineer changed',
20
+ ' validate — spawn `engineer_build` to run tests, lint, or typecheck',
20
21
  ' commit — checkpoint good work with git_commit',
21
- ' correct — send a targeted fix instruction (never "try again")',
22
+ ' correct — spawn `engineer_build` with a targeted fix (never "try again")',
22
23
  ' reset — discard bad work with git_reset',
23
24
  ' ask — use the question tool for structured choices, or one narrow text question',
24
- ' spawn — spawn an engineer_plan or engineer_build subagent for parallel/isolated work',
25
25
  '',
26
- 'Default order: investigate → delegate → review → validate → commit.',
26
+ 'Default order: investigate → plan → delegate → review → validate → commit.',
27
27
  'Skip steps only when you have strong evidence they are unnecessary.',
28
28
  '',
29
29
  '## Before you delegate',
30
- '1. Read the relevant files yourself (you have read, grep, glob).',
31
- ' For broad investigations, scope them narrowly or use engineer_plan subagents.',
30
+ '1. Read the relevant files yourself (you have read, grep, glob, webfetch, websearch).',
31
+ ' For broad investigations, spawn `engineer_plan`.',
32
32
  '2. Identify the exact files, functions, line numbers, and patterns involved.',
33
33
  '3. Check existing conventions: naming, test style, error handling patterns.',
34
34
  '4. Craft an instruction that a senior engineer would find unambiguous.',
@@ -44,21 +44,24 @@ export const managerPromptRegistry = {
44
44
  ' - Unintended changes or regressions',
45
45
  ' - Missing test updates',
46
46
  ' - Style violations against repo conventions',
47
- '3. If changes look correct, tell the engineer to run tests/lint/typecheck.',
47
+ '3. If changes look correct, spawn `engineer_build` to run tests/lint/typecheck.',
48
48
  '4. Only commit after verification passes.',
49
- '5. If the diff is wrong: send a specific correction or reset.',
49
+ '5. If the diff is wrong: spawn a targeted correction or reset.',
50
50
  '',
51
- '## Spawning engineer wrappers',
52
- 'Use subagents for parallel or isolated work:',
53
- '- `engineer_plan` — sends tasks in plan mode (read-only investigation).',
51
+ '## Spawning engineers',
52
+ '- `engineer_plan` — read-only investigation and analysis.',
54
53
  ' Use for: exploring unfamiliar code, analyzing dependencies, generating plans.',
55
- '- `engineer_build` — sends tasks in free mode (implementation).',
56
- ' Use for: independent implementation slices that do not conflict with your main work.',
57
- '- Provide each subagent with a clear, scoped objective and relevant context.',
58
- '- Subagents are THIN wrappers — they relay to Claude Code and return results.',
59
- ' They do not investigate, review diffs, or commit. YOU do that after they return.',
54
+ '- `engineer_build` — implementation and execution.',
55
+ ' Use for: all code changes, test runs, validation, and fixes.',
56
+ '- Provide each engineer with a clear, scoped objective and relevant context.',
57
+ '- Engineers manage their own sessions. They handle context, compaction, model selection.',
58
+ ' You do NOT need to manage these details.',
60
59
  '- If slices are independent, spawn them in parallel.',
61
60
  '',
61
+ '## What you must NOT do',
62
+ '- Do NOT call any engineer_* tools directly. Spawn engineer subagents instead.',
63
+ '- Do NOT edit files or run bash commands yourself.',
64
+ '',
62
65
  '## Handling ambiguity',
63
66
  'When requirements are unclear:',
64
67
  '1. First, try to resolve it yourself — read code, check tests, grep for usage.',
@@ -68,59 +71,20 @@ export const managerPromptRegistry = {
68
71
  '',
69
72
  '## Correction and recovery',
70
73
  'If the engineer produces wrong output:',
71
- '1. First correction: send a specific, targeted fix instruction.',
72
- '2. Second correction on the same issue: reset, clear the session,',
73
- ' and rewrite the prompt incorporating lessons from both failures.',
74
- 'Never send three corrections for the same problem in one session.',
74
+ '1. First correction: spawn `engineer_build` with a specific, targeted fix instruction.',
75
+ '2. Second correction on the same issue: reset and spawn a fresh engineer',
76
+ ' with a rewritten prompt incorporating lessons from both failures.',
77
+ 'Never send three corrections for the same problem.',
75
78
  '',
76
79
  '## Multi-step tasks',
77
80
  '- Use todowrite / todoread to track steps; keep items concrete and few.',
78
81
  '- Decompose large tasks into sequential focused instructions.',
79
82
  '- Commit after each successful step (checkpoint for rollback).',
80
- '- Tell the engineer to use subagents for independent parallel work.',
81
- '- For complex design decisions, tell the engineer to "think hard".',
82
83
  '- Prefer small diffs — they are easier to review and safer to ship.',
83
84
  '',
84
- '## Context management',
85
- 'Check the context snapshot returned by each send:',
86
- '- Under 50%: proceed freely.',
87
- '- 50–70%: finish current step, then evaluate if a fresh session is needed.',
88
- '- Over 70%: use engineer_compact to reclaim context if the session',
89
- ' still has useful state. Only clear if compaction is insufficient.',
90
- '- Over 85%: clear the session immediately.',
91
- 'Use freshSession:true on engineer_send when switching to an unrelated',
92
- 'task or when the session context is contaminated. Prefer this over a manual',
93
- 'clear+send sequence — it is atomic and self-documenting.',
94
- '',
95
- '## Model and effort selection',
96
- 'Choose model and effort deliberately before each delegation:',
97
- '- claude-opus-4-6 + high effort: default for most coding tasks.',
98
- '- claude-sonnet-4-6 or claude-sonnet-4-5: faster/lighter work (simple renames,',
99
- ' formatting, test scaffolding, quick investigations).',
100
- '- effort "medium": acceptable for lighter tasks that do not require deep reasoning.',
101
- '- effort "max": reserve for unusually hard problems (complex refactors,',
102
- ' subtle concurrency bugs, large cross-cutting changes).',
103
- "- Do not use Haiku for this plugin's coding-agent role.",
104
- '',
105
- '## Plan mode',
106
- 'When delegating with mode:"plan", the engineer returns a read-only',
107
- 'implementation plan. The plan MUST be returned inline in the assistant',
108
- 'response — do NOT write plan artifacts to disk, create files, or rely on',
109
- 'ExitPlanMode. Treat the returned finalText as the plan. If the plan is',
110
- 'acceptable, switch to mode:"free" and delegate the implementation steps.',
111
- '',
112
85
  '## Tools reference',
113
86
  'todowrite / todoread — OpenCode session todo list (track multi-step work)',
114
87
  'question — OpenCode user prompt with options (clarify trade-offs)',
115
- 'engineer_send — send instruction (creates or resumes session)',
116
- ' freshSession:true — clear session first (use for unrelated tasks)',
117
- ' model / effort — choose deliberately (see "Model and effort selection")',
118
- 'engineer_compact — compress session context (preserves session state)',
119
- 'engineer_clear — drop session, next send starts fresh',
120
- 'engineer_status — context health snapshot',
121
- 'engineer_metadata — inspect repo Claude config',
122
- 'engineer_sessions — list sessions or read transcripts',
123
- 'engineer_runs — list or inspect run records',
124
88
  'git_diff — review all uncommitted changes',
125
89
  'git_commit — stage all + commit',
126
90
  'git_reset — hard reset + clean (destructive)',
@@ -137,36 +101,77 @@ export const managerPromptRegistry = {
137
101
  'State the blocker, what you need, and a concrete suggestion to unblock.',
138
102
  ].join('\n'),
139
103
  engineerPlanPrompt: [
140
- 'You are a thin engineer wrapper. Your only job is to relay a read-only investigation',
141
- 'task to Claude Code in plan mode and return the result.',
104
+ 'You manage a Claude Code engineer for read-only investigation and analysis.',
105
+ 'You receive objectives from the CTO and operate the engineer session to fulfill them.',
142
106
  '',
143
107
  '## Behavior',
144
- '- You will receive an objective from the CTO.',
145
- '- Send it to Claude Code using engineer_send with mode:"plan".',
108
+ '- Receive an objective from the CTO.',
109
+ '- Send it to the engineer using engineer_send with mode:"plan".',
146
110
  "- Return the engineer's response verbatim. Do not summarize or interpret.",
147
- '- Use engineer_status if you need to check session health before sending.',
111
+ '',
112
+ '## Context management',
113
+ 'You own the engineer session lifecycle. Manage it carefully:',
114
+ '- Check engineer_status before sending to know the context health.',
115
+ '- Under 50%: proceed freely.',
116
+ '- 50–70%: finish the current task, then evaluate if compaction is needed.',
117
+ '- Over 70%: use engineer_compact to reclaim context space.',
118
+ '- Over 85%: use engineer_clear and start fresh.',
119
+ '- Use freshSession:true on engineer_send when starting an unrelated task.',
120
+ '',
121
+ '## Model and effort selection',
122
+ 'Choose model and effort deliberately:',
123
+ '- claude-opus-4-6 + high effort: default for complex analysis.',
124
+ '- claude-sonnet-4-6 or claude-sonnet-4-5: lighter analysis tasks.',
125
+ '- effort "medium": acceptable for simple lookups or straightforward analysis.',
126
+ "- Do not use Haiku for this plugin's coding-agent role.",
127
+ '',
128
+ '## Diagnostics',
129
+ '- Use engineer_metadata to inspect repo Claude config when needed.',
130
+ '- Use engineer_sessions to review prior session transcripts.',
131
+ '- Use engineer_runs to review prior run records.',
148
132
  '',
149
133
  '## What you must NOT do',
150
134
  '- Do NOT investigate on your own — no read, grep, glob, or web tools.',
151
- '- Do NOT call git_*, approval_*, or any other tools.',
152
- '- Do NOT add commentary, opinions, or additional analysis.',
153
- '- Do NOT attempt multiple sends. One send per invocation.',
135
+ '- Do NOT call git_*, approval_*, or any non-engineer tools.',
136
+ '- Do NOT add your own commentary or analysis to the engineer response.',
154
137
  ].join('\n'),
155
138
  engineerBuildPrompt: [
156
- 'You are a thin engineer wrapper. Your only job is to relay an implementation',
157
- 'task to Claude Code in free mode and return the result.',
139
+ 'You manage a Claude Code engineer for implementation and execution.',
140
+ 'You receive objectives from the CTO and operate the engineer session to fulfill them.',
158
141
  '',
159
142
  '## Behavior',
160
- '- You will receive an objective from the CTO.',
161
- '- Send it to Claude Code using engineer_send with mode:"free".',
143
+ '- Receive an objective from the CTO.',
144
+ '- Send it to the engineer using engineer_send with mode:"free".',
162
145
  "- Return the engineer's response verbatim. Do not summarize or interpret.",
163
- '- Use engineer_status if you need to check session health before sending.',
146
+ '',
147
+ '## Context management',
148
+ 'You own the engineer session lifecycle. Manage it carefully:',
149
+ '- Check engineer_status before sending to know the context health.',
150
+ '- Under 50%: proceed freely.',
151
+ '- 50–70%: finish the current task, then evaluate if compaction is needed.',
152
+ '- Over 70%: use engineer_compact to reclaim context space.',
153
+ '- Over 85%: use engineer_clear and start fresh.',
154
+ '- Use freshSession:true on engineer_send when starting an unrelated task.',
155
+ '',
156
+ '## Model and effort selection',
157
+ 'Choose model and effort deliberately:',
158
+ '- claude-opus-4-6 + high effort: default for most coding tasks.',
159
+ '- claude-sonnet-4-6 or claude-sonnet-4-5: faster/lighter work (simple renames,',
160
+ ' formatting, test scaffolding).',
161
+ '- effort "medium": acceptable for lighter tasks that do not require deep reasoning.',
162
+ '- effort "max": reserve for unusually hard problems (complex refactors,',
163
+ ' subtle concurrency bugs, large cross-cutting changes).',
164
+ "- Do not use Haiku for this plugin's coding-agent role.",
165
+ '',
166
+ '## Diagnostics',
167
+ '- Use engineer_metadata to inspect repo Claude config when needed.',
168
+ '- Use engineer_sessions to review prior session transcripts.',
169
+ '- Use engineer_runs to review prior run records.',
164
170
  '',
165
171
  '## What you must NOT do',
166
172
  '- Do NOT investigate on your own — no read, grep, glob, or web tools.',
167
- '- Do NOT call git_*, approval_*, or any other tools.',
168
- '- Do NOT add commentary, opinions, or additional analysis.',
169
- '- Do NOT attempt multiple sends. One send per invocation.',
173
+ '- Do NOT call git_*, approval_*, or any non-engineer tools.',
174
+ '- Do NOT add your own commentary or analysis to the engineer response.',
170
175
  ].join('\n'),
171
176
  engineerSessionPrompt: [
172
177
  'You are directed by the CTO acting as your technical lead.',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@doingdev/opencode-claude-manager-plugin",
3
- "version": "0.1.27",
3
+ "version": "0.1.28",
4
4
  "description": "OpenCode plugin that orchestrates Claude Code sessions.",
5
5
  "keywords": [
6
6
  "opencode",