cli-five 0.2.6 → 0.2.8

package/README.md

@@ -25,12 +25,12 @@ Installs the 5 agents to your Copilot profile. No project config, no interview
 ```
 your-repo/
 ├── .github/
-│   ├── agents/                  # 5 agents with handoffs + subagent delegation
-│   │   ├── orchestrator.agent.md  # 📋 Plan  💻 Code  🎨 Design  🔍 Review
-│   │   ├── planner.agent.md       # 🎯 Execute  💻 Code Directly
-│   │   ├── coder.agent.md         # 🔍 Review  🎯 Back to Orchestrator
-│   │   ├── designer.agent.md      # 🔍 Review  🎯 Back to Orchestrator
-│   │   └── reviewer.agent.md      # 🎯 Back to Orchestrator  💻 Fix Issues
+│   ├── agents/                  # 5 agents — Orchestrator delegates autonomously
+│   │   ├── orchestrator.agent.md  # Routes tasks: Planner → Coder/Designer → Reviewer
+│   │   ├── planner.agent.md       # Researches codebase, produces implementation plans
+│   │   ├── coder.agent.md         # Writes production code, runs tests
+│   │   ├── designer.agent.md      # UI/UX design, layouts, theming
+│   │   └── reviewer.agent.md      # Code review, convention compliance
 │   ├── copilot-instructions.md  # Persona + project mandates from interview
 │   ├── instructions/            # Stack-specific coding guidelines
 │   └── skills/                  # Installed skills from awesome-copilot + skills.sh
@@ -42,14 +42,16 @@ your-repo/
 └── histories/                   # Per-agent accumulated learnings
 ```
 
-## Orchestration modes
+## How it works
 
-The Orchestrator supports **both** delegation patterns:
+Select the **Orchestrator** agent in Copilot Chat and describe what you want. The Orchestrator autonomously calls Planner → Coder/Designer → Reviewer without any manual handoff clicks.
 
-- **Handoff buttons** — Click `📋 Plan`, `💻 Code`, `🎨 Design`, or `🔍 Review` to manually transition between agents with pre-filled context.
-- **Subagent delegation** — Ask the Orchestrator to handle a complex task and it calls Planner → Coder → Reviewer autonomously.
+```
+User: implement from plan.md
+Orchestrator → [calls Planner] → [calls Coder] → [calls Reviewer] → done
+```
 
-Each specialist also has handoffs: Coder/Designer → Reviewer, Reviewer → Coder (fix loop), and everyone → back to Orchestrator.
+No buttons. No "click here to continue". Just results.
 
 ## Commands
 
@@ -77,10 +79,10 @@ npx cli-five help
 2. **git init** — if needed. Asks first.
 3. **Overwrite gate** — double-confirms ("Proceed?" then "R U Sure?"). Only `--force --yes` bypasses.
 4. **Interview** — name, one-liner, stack, frameworks, goals, constraints, cost mode, persona toggle.
-5. **Scaffold** — writes 18 files. Substitutes answers into templates. Swaps `model:` per cost mode. Adds `handoffs:` to all agents.
+5. **Scaffold** — writes 18 files. Substitutes answers into templates. Swaps `model:` per cost mode.
 6. **Skill discovery** — the hero feature. Multi-source discovery from **awesome-copilot** (30k+ ★ community marketplace) and **skills.sh**. Color-coded recommendations, source attribution, multiselect install, and post-install breadcrumbs with copy-paste commands for the awesome-copilot suggestion skill and MCP server.
 7. **Custom instructions** — generates stack-specific `.instructions.md` files for detected languages.
-8. **Next steps** — tells you to use handoff buttons or autonomous mode, offers plugin install shortcut.
+8. **Next steps** — tells you to open Copilot Chat, select Orchestrator, and start building. No button-clicking required.
 
 ## Cost modes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cli-five",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Code Like I'm Five — scaffold a 5-agent VS Code Copilot team into any repo.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test tests/",
+    "test": "node --test tests/*.test.mjs",
     "smoke": "node bin/cli-five.mjs --help"
   },
   "engines": {

package/plugin-agents/coder.agent.md

@@ -4,15 +4,6 @@ description: "Writes production code following workspace conventions. Use when:
 model: GPT-5.3-Codex (copilot)
 tools: ['vscode', 'execute', 'read', 'github/*', 'edit', 'search', 'web', 'vscode/memory', 'todo']
 agents: []
-handoffs:
-  - label: "🔍 Review"
-    agent: Reviewer
-    prompt: "Review the changes I just made for correctness and conventions."
-    send: false
-  - label: "🎯 Back to Orchestrator"
-    agent: Orchestrator
-    prompt: "Implementation complete. Coordinate next steps."
-    send: false
 ---
 
 ## Mandatory Coding Principles

package/plugin-agents/designer.agent.md

@@ -4,15 +4,6 @@ description: "Handles all UI/UX design tasks. Use when: creating screens, layout
 model: Claude Opus 4.6 (copilot)
 tools: ['read', 'edit', 'search', 'web', 'vscode/memory']
 agents: []
-handoffs:
-  - label: "🔍 Review"
-    agent: Reviewer
-    prompt: "Review the UI changes for accessibility, conventions, and design quality."
-    send: false
-  - label: "🎯 Back to Orchestrator"
-    agent: Orchestrator
-    prompt: "Design work complete. Coordinate next steps."
-    send: false
 ---
 
 ## Design Principles

package/plugin-agents/orchestrator.agent.md

@@ -4,23 +4,6 @@ description: "Coordinates multi-agent workflows. Delegates to Planner, Coder, De
 model: Claude Sonnet 4.6 (copilot)
 tools: ['read/readFile', 'agent', 'vscode/memory', 'github/*']
 agents: ['Planner', 'Coder', 'Designer', 'Reviewer']
-handoffs:
-  - label: "📋 Plan"
-    agent: Planner
-    prompt: "Research the codebase and create an implementation plan for this task."
-    send: false
-  - label: "💻 Code"
-    agent: Coder
-    prompt: "Implement the approved plan."
-    send: false
-  - label: "🎨 Design"
-    agent: Designer
-    prompt: "Design the UI components described in the plan."
-    send: false
-  - label: "🔍 Review"
-    agent: Reviewer
-    prompt: "Review the implementation for correctness, conventions, and architecture."
-    send: false
 ---
 
 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.

package/plugin-agents/planner.agent.md

@@ -3,16 +3,6 @@ name: Planner
 description: "Creates implementation plans by researching the codebase, consulting documentation, and identifying edge cases."
 model: Claude Opus 4.6 (copilot)
 tools: ['read', 'search', 'web', 'vscode/memory']
-user-invocable: false
-handoffs:
-  - label: "🎯 Execute Plan"
-    agent: Orchestrator
-    prompt: "Plan is ready. Execute it phase by phase."
-    send: false
-  - label: "💻 Code Directly"
-    agent: Coder
-    prompt: "Implement this plan."
-    send: false
 ---
 
 # Planning Agent

package/plugin-agents/reviewer.agent.md

@@ -4,16 +4,6 @@ description: "Reviews code and agent output for correctness, convention complian
 model: Claude Opus 4.6 (copilot)
 tools: ['read', 'search', 'web', 'vscode/memory']
 agents: []
-user-invocable: true
-handoffs:
-  - label: "🎯 Back to Orchestrator"
-    agent: Orchestrator
-    prompt: "Review complete. See verdict above. Coordinate fixes or proceed."
-    send: false
-  - label: "💻 Fix Issues"
-    agent: Coder
-    prompt: "Fix the issues identified in the review above."
-    send: false
 ---
 
 ## Identity

package/src/commands/init.mjs

@@ -118,9 +118,8 @@ function printNextSteps(answers) {
   log.raw(`  2. Enable Copilot subagent invocations (settings.json):`);
   log.raw(kleur.gray(`        "chat.subagents.allowInvocationsFromSubagents": true`));
   log.raw(`  3. Open Copilot Chat — select an agent from the dropdown (${kleur.bold('not')} @mention).`);
-  log.raw(`  4. Select ${kleur.bold('Orchestrator')} — use handoff buttons or ask it to delegate:`);
-  log.raw(kleur.gray(`        📋 Plan  💻 Code  🎨 Design  🔍 Review`));
-  log.raw(`  5. ${hasDocs ? 'Kickoff prompt (paste this into Orchestrator):' : 'Or go autonomous:'}`);
+  log.raw(`  4. Select ${kleur.bold('Orchestrator')} — it routes tasks autonomously to Planner, Coder, Designer, and Reviewer.`);
+  log.raw(`  5. ${hasDocs ? 'Kickoff prompt (paste this into Orchestrator):' : 'Start building:'}`);
   if (hasDocs) {
     const docList = answers.docFiles.join(', ');
     log.raw(kleur.cyan(`        Review PROJECT.md (your source docs — ${docList} — are embedded`));

package/src/steps/skills.mjs

@@ -9,6 +9,7 @@ import { log } from '../util/log.mjs';
 // ── Known-good skill repos (verified working) ────────────────────────
 // awesome-copilot skills are discovered dynamically via `skills find`.
 const AWESOME_COPILOT_REPO = 'github/awesome-copilot';
+const BREADCRUMB_BOX_WIDTH = 66;
 
 // Well-known skill repos matched by stack term → repo + suggested skill names (skills.sh)
 const SKILL_CATALOG = [
@@ -56,20 +57,17 @@ function projectUsesPnpm(cwd) {
  */
 function detectEnv(cwd) {
   const bundledBin = resolveSkillsBin();
+  const npmVer = whichVersion('npm');
   const pnpmVer = whichVersion('pnpm');
   const npxVer = whichVersion('npx');
   const projectPnpm = projectUsesPnpm(cwd);
 
-  // ── Terse status lines ────────────────────────────────────────────
-  log.info(`skills CLI (bundled) ${bundledBin ? '✓' : '✗ not resolved'}`);
-  log.info(`pnpm                 ${pnpmVer ? `✓ ${pnpmVer}` : '✗ not found'}${projectPnpm ? '  (project uses pnpm)' : ''}`);
-  log.info(`npx                  ${npxVer ? `✓ ${npxVer}` : '✗ not found'}`);
-
   // ── Priority: bundled > pnpm (if project or system) > npx ─────────
   if (bundledBin) {
     return {
       label: 'bundled skills CLI',
       runner: (skillsArgs) => ({ cmd: process.execPath, args: [bundledBin, ...skillsArgs] }),
+      npmVer,
       pnpmVer,
       npxVer,
       projectPnpm,
@@ -79,6 +77,7 @@ function detectEnv(cwd) {
     return {
       label: 'pnpm dlx',
       runner: (skillsArgs) => ({ cmd: 'pnpm', args: ['dlx', 'skills', ...skillsArgs] }),
+      npmVer,
       pnpmVer,
       npxVer,
       projectPnpm,
@@ -88,6 +87,7 @@ function detectEnv(cwd) {
     return {
       label: 'npx',
       runner: (skillsArgs) => ({ cmd: 'npx', args: ['-y', 'skills', ...skillsArgs] }),
+      npmVer,
       pnpmVer,
       npxVer,
       projectPnpm,
@@ -109,7 +109,7 @@ export async function skillDiscovery({ cwd, answers, args }) {
   }
 
   // ── Environment checks ──────────────────────────────────────────────
-  const env = detectEnv(cwd);
+  let env = detectEnv(cwd);
 
   if (!env) {
     log.warn('Cannot run skills CLI: no bundled binary, pnpm, or npx found.');
@@ -119,7 +119,7 @@ export async function skillDiscovery({ cwd, answers, args }) {
   }
 
   // Offer pnpm if the user doesn't have it
-  if (!env.pnpmVer) {
+  if (shouldOfferPnpmInstall(env)) {
     const { wantPnpm } = await prompts({
       type: 'confirm',
       name: 'wantPnpm',
@@ -130,10 +130,13 @@ export async function skillDiscovery({ cwd, answers, args }) {
       try {
         execFileSync('npm', ['install', '-g', 'pnpm'], { stdio: 'inherit' });
         log.ok('pnpm installed.');
+        env = detectEnv(cwd) || env;
       } catch (err) {
         log.warn(`pnpm install failed: ${err.message}`);
       }
     }
+  } else if (env.projectPnpm && !env.pnpmVer) {
+    log.dim(`pnpm not found. Using ${env.label} for skill discovery.`);
   }
 
   log.ok(`Running skills via ${env.label}`);
@@ -345,21 +348,9 @@ function printInstallSummary(results) {
 
 function printBreadcrumbs() {
   log.raw('');
-  log.raw(kleur.bold().green('  ┌──────────────────────────────────────────────────────────────────┐'));
-  log.raw(kleur.bold().green('  │') + kleur.bold('  🎯 KEEP DISCOVERING — paste into VS Code / Copilot Chat:       ') + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  ├──────────────────────────────────────────────────────────────────┤'));
-  log.raw(kleur.bold().green('  │') + '                                                                  ' + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + '  Add awesome-copilot MCP for ongoing search:                     ' + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + kleur.white('    Add to .vscode/mcp.json:                                   ') + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + kleur.dim('      "awesome-copilot": {                                     ') + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + kleur.dim('        "command": "npx",                                      ') + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + kleur.dim('        "args": ["-y", "awesome-copilot-mcp"]                  ') + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + kleur.dim('      }                                                        ') + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + '                                                                  ' + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + '  Browse skills anytime:                                          ' + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + kleur.white('    npx skills find                                            ') + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  │') + '                                                                  ' + kleur.bold().green('│'));
-  log.raw(kleur.bold().green('  └──────────────────────────────────────────────────────────────────┘'));
+  for (const line of buildBreadcrumbBox()) {
+    log.raw(line);
+  }
   log.raw('');
 }
 
@@ -539,6 +530,44 @@ function pad(s, n) {
   return (s || '').padEnd(n);
 }
 
+/**
+ * Offer pnpm installation only for pnpm workspaces that are currently missing pnpm
+ * and can bootstrap it via npm on PATH.
+ */
+function shouldOfferPnpmInstall(env) {
+  return Boolean(env && env.projectPnpm && !env.pnpmVer && env.npmVer);
+}
+
+function buildBreadcrumbBox() {
+  const horizontalDivider = kleur.bold().green(`  ├${'─'.repeat(BREADCRUMB_BOX_WIDTH + 2)}┤`);
+  const lines = [
+    formatBoxLine(kleur.bold('  KEEP DISCOVERING -- paste into VS Code / Copilot Chat:'), BREADCRUMB_BOX_WIDTH),
+    horizontalDivider,
+    formatBoxLine('', BREADCRUMB_BOX_WIDTH),
+    formatBoxLine('  Add awesome-copilot MCP for ongoing search:', BREADCRUMB_BOX_WIDTH),
+    formatBoxLine(kleur.white('    Add to .vscode/mcp.json:'), BREADCRUMB_BOX_WIDTH),
+    formatBoxLine(kleur.dim('      "awesome-copilot": {'), BREADCRUMB_BOX_WIDTH),
+    formatBoxLine(kleur.dim('        "command": "npx",'), BREADCRUMB_BOX_WIDTH),
+    formatBoxLine(kleur.dim('        "args": ["-y", "awesome-copilot-mcp"]'), BREADCRUMB_BOX_WIDTH),
+    formatBoxLine(kleur.dim('      }'), BREADCRUMB_BOX_WIDTH),
+    formatBoxLine('', BREADCRUMB_BOX_WIDTH),
+    formatBoxLine('  Browse skills anytime:', BREADCRUMB_BOX_WIDTH),
+    formatBoxLine(kleur.white('    npx skills find'), BREADCRUMB_BOX_WIDTH),
+    formatBoxLine('', BREADCRUMB_BOX_WIDTH),
+  ];
+
+  return [
+    kleur.bold().green(`  ┌${'─'.repeat(BREADCRUMB_BOX_WIDTH + 2)}┐`),
+    ...lines,
+    kleur.bold().green(`  └${'─'.repeat(BREADCRUMB_BOX_WIDTH + 2)}┘`),
+  ];
+}
+
+function formatBoxLine(content = '', width = BREADCRUMB_BOX_WIDTH) {
+  const paddingNeeded = Math.max(0, width - stripAnsi(content).length);
+  return `${kleur.bold().green('  │ ')}${content}${' '.repeat(paddingNeeded)}${kleur.bold().green(' │')}`;
+}
+
 function runInteractive(cmd, args, cwd) {
   return new Promise((resolve) => {
     const proc = spawn(cmd, args, { cwd, stdio: 'inherit' });
@@ -567,3 +596,11 @@ function parseSkillRefs(output) {
   }
   return results;
 }
+
+export const __testables = {
+  buildBreadcrumbBox,
+  detectEnv,
+  formatBoxLine,
+  shouldOfferPnpmInstall,
+  stripAnsi,
+};

package/templates/.github/agents/coder.agent.md

@@ -4,15 +4,6 @@ description: "Writes production code following workspace conventions. Use when:
 model: GPT-5.3-Codex (copilot)
 tools: ['vscode', 'execute', 'read', 'io.github.upstash/context7/*', 'github/*', 'edit', 'search', 'web', 'vscode/memory', 'todo']
 agents: []
-handoffs:
-  - label: "🔍 Review"
-    agent: Reviewer
-    prompt: "Review the changes I just made for correctness and conventions."
-    send: false
-  - label: "🎯 Back to Orchestrator"
-    agent: Orchestrator
-    prompt: "Implementation complete. Coordinate next steps."
-    send: false
 ---
 
 ## Model Selection

package/templates/.github/agents/designer.agent.md

@@ -4,15 +4,6 @@ description: "Handles all UI/UX design tasks. Use when: creating screens, layout
 model: Claude Opus 4.6 (copilot)
 tools: ['read', 'edit', 'search', 'web', 'io.github.upstash/context7/*', 'vscode/memory']
 agents: []
-handoffs:
-  - label: "🔍 Review"
-    agent: Reviewer
-    prompt: "Review the UI changes for accessibility, conventions, and design quality."
-    send: false
-  - label: "🎯 Back to Orchestrator"
-    agent: Orchestrator
-    prompt: "Design work complete. Coordinate next steps."
-    send: false
 ---
 
 ## Model Selection

package/templates/.github/agents/orchestrator.agent.md

@@ -4,23 +4,6 @@ description: "Coordinates multi-agent workflows. Delegates to Planner, Coder, De
 model: Claude Sonnet 4.6 (copilot)
 tools: ['read/readFile', 'agent', 'vscode/memory', 'github/*']
 agents: ['Planner', 'Coder', 'Designer', 'Reviewer']
-handoffs:
-  - label: "📋 Plan"
-    agent: Planner
-    prompt: "Read PROJECT.md and STATE.md, then create an implementation plan for this task."
-    send: false
-  - label: "💻 Code"
-    agent: Coder
-    prompt: "Implement the approved plan. Read decisions.md for context."
-    send: false
-  - label: "🎨 Design"
-    agent: Designer
-    prompt: "Design the UI components described in the plan."
-    send: false
-  - label: "🔍 Review"
-    agent: Reviewer
-    prompt: "Review the implementation for correctness, conventions, and architecture."
-    send: false
 ---
 
 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.

package/templates/.github/agents/planner.agent.md

@@ -3,16 +3,6 @@ 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."
 model: Claude Opus 4.6 (copilot)
 tools: ['read', 'search', 'web', 'io.github.upstash/context7/*', 'vscode/memory']
-user-invocable: false
-handoffs:
-  - label: "🎯 Execute Plan"
-    agent: Orchestrator
-    prompt: "Plan is ready. Execute it phase by phase."
-    send: false
-  - label: "💻 Code Directly"
-    agent: Coder
-    prompt: "Implement this plan."
-    send: false
 ---
 
 # Planning Agent

package/templates/.github/agents/reviewer.agent.md

@@ -4,16 +4,6 @@ description: "Reviews code and agent output for correctness, convention complian
 model: Claude Opus 4.6 (copilot)
 tools: ['read', 'search', 'web', 'vscode/memory']
 agents: []
-user-invocable: true
-handoffs:
-  - label: "🎯 Back to Orchestrator"
-    agent: Orchestrator
-    prompt: "Review complete. See verdict above. Coordinate fixes or proceed."
-    send: false
-  - label: "💻 Fix Issues"
-    agent: Coder
-    prompt: "Fix the issues identified in the review above."
-    send: false
 ---
 
 ## Model Selection