cli-five 0.2.18 → 0.2.20

package/README.md

@@ -2,7 +2,7 @@
 
 > **Code Like I'm Five** — scaffold a 5-agent AI team into any repo.
 
-## Two ways to install
+## Three ways to install
 
 ### Full setup (recommended for teams)
 
@@ -27,6 +27,21 @@ copilot plugin install idusortus/cli-five
 
 Installs the 5 agents to your Copilot profile. No project config, no interview — just the agents with the same autonomous contracts shipped by the scaffolded templates.
 
+### Let an agent do it (prompt)
+
+Paste a ready-made prompt into any repo and have your agent install *and verify* cli-five there:
+
+```text
+Install cli-five in this repo for OpenCode and verify it works. Preview with
+`npx -y cli-five@latest init --target opencode --dry-run --yes` first, then run it
+without --dry-run. Confirm all five agents appear in `opencode debug agents`, run a
+live orchestrator->planner delegation smoke test, run `npx -y cli-five@latest doctor`,
+gitignore STATE.md/agent-diary.md/histories/, and leave everything staged without
+committing. Report what you verified.
+```
+
+The full version — platform detection, provider/auth checks, collision preview, stop conditions, and what to report back — is in **[docs/INSTALL_PROMPT.md](docs/INSTALL_PROMPT.md)**. It is generic: use it in any repository, Copilot or OpenCode.
+
 ## Supported platforms
 
 cli-five can scaffold for:
@@ -210,12 +225,14 @@ During `init --full-interview` you can choose the model provider and optionally
 |---|---|---|
 | GitHub Copilot | Copilot | `Claude Sonnet 4.6 (copilot)` |
 | OpenCode Zen | OpenCode | `opencode/gpt-5.3-codex` |
-| OpenCode Go | OpenCode | `opencode-go/qwen3.8-max` |
+| OpenCode Go | OpenCode | `opencode-go/deepseek-v4.1-flash` |
 
 **On OpenCode, the default provider is auth-aware.** cli-five checks which provider you are actually authenticated for (`opencode auth list`) and uses it instead of blindly defaulting to OpenCode Zen. If you are authenticated for Go only, `init --target opencode` writes Go models automatically — no `--provider` flag needed. If nothing is detected, or the selected provider does not match your auth, `init` prints a warning telling you how to fix it, so you do not end up with agent files whose models silently fail.
 
 `--yes` uses the provider's defaults. `--provider opencode-go --yes` skips the provider prompt.
 
+**OpenCode Go defaults:** all five agents use `opencode-go/deepseek-v4.1-flash`, except the Planner, which uses `opencode-go/kimi-k2.7-code`.
+
 ### Copilot cost modes
 
 | Agent | `premium` (1x–3x) | `cheap` (0x) | `mixed` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cli-five",
-  "version": "0.2.18",
+  "version": "0.2.20",
   "description": "Code Like I'm Five — scaffold a 5-agent AI team (GitHub Copilot or OpenCode) into any repo.",
   "type": "module",
   "repository": {

package/src/util/agents.mjs

@@ -98,6 +98,14 @@ export function validateAgentSource(source, fileName, { requiredMarkers = [] } =
   return errors;
 }
 
+/**
+ * Validate OpenCode agent frontmatter.
+ *
+ * Accepts BOTH permission shapes, which OpenCode treats equivalently:
+ *   - V1 map:   permission: { read: allow, task: { planner: allow } }
+ *   - V2 list:  permissions: [{ action: read, resource: "*", effect: allow }, ...]
+ * The orchestrator must, in either shape, grant subagent access to its children.
+ */
 export function validateOpenCodeAgentSource(source, fileName) {
   const errors = [];
   const { frontmatter, body } = parseAgentSource(source);
@@ -122,11 +130,8 @@ export function validateOpenCodeAgentSource(source, fileName) {
     errors.push(`expected mode ${expectedMode}, found ${frontmatter.mode}`);
   }
 
-  if (fileName === 'orchestrator.md') {
-    const task = frontmatter.permission?.task || frontmatter.permissions?.task;
-    if (!task) {
-      errors.push('orchestrator must declare permission.task for subagents');
-    }
+  if (fileName === 'orchestrator.md' && !hasSubagentGrant(frontmatter)) {
+    errors.push('orchestrator must declare subagent/task permissions for its children');
   }
 
   if (!body.trim()) {
@@ -136,6 +141,27 @@ export function validateOpenCodeAgentSource(source, fileName) {
   return errors;
 }
 
+/**
+ * True when the frontmatter grants subagent access to children, in either form:
+ *   V1: permission.task is a non-empty map
+ *   V2: permissions[] contains an action: subagent|task entry
+ */
+function hasSubagentGrant(frontmatter) {
+  const task = frontmatter.permission?.task;
+  if (task && typeof task === 'object' && Object.keys(task).length > 0) return true;
+  if (task === true) return true;
+
+  const list = frontmatter.permissions;
+  if (Array.isArray(list)) {
+    return list.some((entry) => {
+      const action = String(entry?.action || '').toLowerCase();
+      return action === 'subagent' || action === 'task';
+    });
+  }
+
+  return false;
+}
+
 function requiredFrontmatterKeys(fileName) {
   return fileName === 'orchestrator.agent.md'
     ? ['name', 'description', 'model', 'tools', 'agents']

package/src/util/models.mjs

@@ -31,11 +31,11 @@ export const DEFAULT_MODEL_MAP = {
     Reviewer: 'opencode/claude-sonnet-4-6',
   },
   [PROVIDER_GO]: {
-    Orchestrator: 'opencode-go/qwen3.8-max',
-    Planner: 'opencode-go/deepseek-v4-pro',
-    Coder: 'opencode-go/qwen3.8-max',
-    Designer: 'opencode-go/gpt-5.6-luna',
-    Reviewer: 'opencode-go/kimi-k2.7-code',
+    Orchestrator: 'opencode-go/deepseek-v4.1-flash',
+    Planner: 'opencode-go/kimi-k2.7-code',
+    Coder: 'opencode-go/deepseek-v4.1-flash',
+    Designer: 'opencode-go/deepseek-v4.1-flash',
+    Reviewer: 'opencode-go/deepseek-v4.1-flash',
   },
 };
 

package/templates/opencode/agents/coder.md

@@ -3,26 +3,48 @@ name: Coder
 description: "Writes production code following workspace conventions. Use when: implementing features, fixing bugs, writing tests, creating modules."
 mode: subagent
 model: opencode/gpt-5.3-codex
-permission:
-  read: allow
-  edit: allow
-  write: allow
-  glob: allow
-  grep: allow
-  list: allow
-  bash: allow
-  webfetch: allow
-  websearch: allow
-  skill: allow
-  lsp: allow
+permissions:
+  - action: read
+    resource: "*"
+    effect: allow
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: write
+    resource: "*"
+    effect: allow
+  - action: glob
+    resource: "*"
+    effect: allow
+  - action: grep
+    resource: "*"
+    effect: allow
+  - action: list
+    resource: "*"
+    effect: allow
+  - action: bash
+    resource: "*"
+    effect: allow
+  - action: webfetch
+    resource: "*"
+    effect: allow
+  - action: websearch
+    resource: "*"
+    effect: allow
+  - action: skill
+    resource: "*"
+    effect: allow
+  - action: lsp
+    resource: "*"
+    effect: allow
 ---
 
 ## Model Selection
 
 | Mode | Model | Premium Cost |
 |---|---|---|
-| **Default** | GPT 5.3 Codex | 1x |
-| **Cheap** | Qwen 3.8 Max | 0x |
+| **Default** (OpenCode Go) | DeepSeek V4.1 Flash | 0x |
+| **Alternative** (OpenCode Zen) | GPT 5.3 Codex | 1x |
 
 To switch: change the `model` key in frontmatter above.
 

package/templates/opencode/agents/designer.md

@@ -3,24 +3,42 @@ name: Designer
 description: "Handles all UI/UX design tasks. Use when: creating screens, layouts, theming, navigation flows, design systems."
 mode: subagent
 model: opencode/gemini-3.1-pro
-permission:
-  read: allow
-  edit: allow
-  write: allow
-  glob: allow
-  grep: allow
-  list: allow
-  webfetch: allow
-  websearch: allow
-  skill: allow
+permissions:
+  - action: read
+    resource: "*"
+    effect: allow
+  - action: edit
+    resource: "*"
+    effect: allow
+  - action: write
+    resource: "*"
+    effect: allow
+  - action: glob
+    resource: "*"
+    effect: allow
+  - action: grep
+    resource: "*"
+    effect: allow
+  - action: list
+    resource: "*"
+    effect: allow
+  - action: webfetch
+    resource: "*"
+    effect: allow
+  - action: websearch
+    resource: "*"
+    effect: allow
+  - action: skill
+    resource: "*"
+    effect: allow
 ---
 
 ## Model Selection
 
 | Mode | Model | Premium Cost |
 |---|---|---|
-| **Default** | Gemini 3.1 Pro | 1x |
-| **Cheap** | GPT 5.6 Luna | 0x |
+| **Default** (OpenCode Go) | DeepSeek V4.1 Flash | 0x |
+| **Alternative** (OpenCode Zen) | Gemini 3.1 Pro | 1x |
 
 To switch: change the `model` key in frontmatter above.
 

package/templates/opencode/agents/orchestrator.md

@@ -3,12 +3,19 @@ name: Orchestrator
 description: "Coordinates multi-agent workflows. Delegates to Planner, Coder, Designer, and Reviewer. Use when: complex multi-step tasks, cross-cutting changes, feature implementation."
 mode: primary
 model: opencode/gpt-5.3-codex
-permission:
-  task:
-    planner: allow
-    coder: allow
-    designer: allow
-    reviewer: allow
+permissions:
+  - action: subagent
+    resource: planner
+    effect: allow
+  - action: subagent
+    resource: coder
+    effect: allow
+  - action: subagent
+    resource: designer
+    effect: allow
+  - action: subagent
+    resource: reviewer
+    effect: allow
 ---
 
 You are a project orchestrator. You break down complex requests into tasks and delegate to specialist subagents. You coordinate work but NEVER implement anything yourself.
@@ -17,8 +24,8 @@ You are a project orchestrator. You break down complex requests into tasks and d
 
 | Mode | Model | Premium Cost |
 |---|---|---|
-| **Default** | GPT 5.3 Codex | 1x |
-| **Cheap** | Qwen 3.8 Max | 0x |
+| **Default** (OpenCode Go) | DeepSeek V4.1 Flash | 0x |
+| **Alternative** (OpenCode Zen) | GPT 5.3 Codex | 1x |
 
 To switch: change the `model` key in frontmatter above.
 

package/templates/opencode/agents/planner.md

@@ -3,14 +3,28 @@ name: Planner
 description: "Creates implementation plans by researching the codebase, consulting documentation, and identifying edge cases. Use when: planning features, architectural decisions, or complex multi-file changes."
 mode: subagent
 model: opencode/claude-opus-4-6
-permission:
-  read: allow
-  glob: allow
-  grep: allow
-  list: allow
-  webfetch: allow
-  websearch: allow
-  skill: allow
+permissions:
+  - action: read
+    resource: "*"
+    effect: allow
+  - action: glob
+    resource: "*"
+    effect: allow
+  - action: grep
+    resource: "*"
+    effect: allow
+  - action: list
+    resource: "*"
+    effect: allow
+  - action: webfetch
+    resource: "*"
+    effect: allow
+  - action: websearch
+    resource: "*"
+    effect: allow
+  - action: skill
+    resource: "*"
+    effect: allow
 ---
 
 # Planning Agent
@@ -21,8 +35,8 @@ You create plans. You do NOT write code.
 
 | Mode | Model | Premium Cost |
 |---|---|---|
-| **Default** | Claude Opus 4.6 | 3x |
-| **Cheap** | Qwen 3.8 Flash | 0x |
+| **Default** (OpenCode Go) | Kimi K2.7 Code | 0x |
+| **Alternative** (OpenCode Zen) | Claude Opus 4.6 | 3x |
 
 To switch: change the `model` key in frontmatter above.
 

package/templates/opencode/agents/reviewer.md

@@ -3,22 +3,36 @@ name: Reviewer
 description: "Reviews code and agent output for correctness, convention compliance, and architectural alignment. Use when: code review, auditing agent work, validating against specs."
 mode: subagent
 model: opencode/claude-sonnet-4-6
-permission:
-  read: allow
-  glob: allow
-  grep: allow
-  list: allow
-  webfetch: allow
-  websearch: allow
-  skill: allow
+permissions:
+  - action: read
+    resource: "*"
+    effect: allow
+  - action: glob
+    resource: "*"
+    effect: allow
+  - action: grep
+    resource: "*"
+    effect: allow
+  - action: list
+    resource: "*"
+    effect: allow
+  - action: webfetch
+    resource: "*"
+    effect: allow
+  - action: websearch
+    resource: "*"
+    effect: allow
+  - action: skill
+    resource: "*"
+    effect: allow
 ---
 
 ## Model Selection
 
 | Mode | Model | Premium Cost |
 |---|---|---|
-| **Default** | Claude Sonnet 4.6 | 1x |
-| **Cheap** | Qwen 3.8 Flash | 0x |
+| **Default** (OpenCode Go) | DeepSeek V4.1 Flash | 0x |
+| **Alternative** (OpenCode Zen) | Claude Sonnet 4.6 | 1x |
 
 To switch: change the `model` key in frontmatter above.