create-harness-vibe-coding 0.8.7 → 0.8.8

package/package.json

@@ -1,44 +1,46 @@
-{
-  "name": "create-harness-vibe-coding",
-  "version": "0.8.7",
-  "description": "Scaffold a 0-1 product harness for AI-assisted research, PRD, planning, architecture, build, test, and feedback loops",
-  "type": "module",
-  "bin": {
-    "create-harness-vibe-coding": "bin/create-harness-vibe-coding.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "templates/",
-    "README-CN.md"
-  ],
-  "scripts": {
-    "start": "node src/index.js",
-    "build:version": "node scripts/build-version.mjs",
-    "prepush": "node scripts/pre-push-check.mjs",
-    "test": "node --test tests/*.test.js",
-    "test:smoke": "node --test tests/cli-smoke.test.js",
-    "pack:smoke": "node --test tests/pack-smoke.test.js"
-  },
-  "dependencies": {
-    "@clack/prompts": "^0.7.0",
-    "picocolors": "^1.1.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zingspark/create-harness-vibe-coding.git"
-  },
-  "keywords": [
-    "claude-code",
-    "harness",
-    "scaffold",
-    "vibe-coding",
-    "agentic",
-    "ecc",
-    "superpowers"
-  ],
-  "license": "MIT"
-}
+{
+  "name": "create-harness-vibe-coding",
+  "version": "0.8.8",
+  "description": "Scaffold a 0-1 product harness for AI-assisted research, PRD, planning, architecture, build, test, and feedback loops",
+  "type": "module",
+  "bin": {
+    "create-harness-vibe-coding": "bin/create-harness-vibe-coding.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "docs/images/harness-architecture-light.png",
+    "docs/images/harness-architecture.drawio",
+    "README-CN.md"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "build:version": "node scripts/build-version.mjs",
+    "prepush": "node scripts/pre-push-check.mjs",
+    "test": "node --test tests/*.test.js",
+    "test:smoke": "node --test tests/cli-smoke.test.js",
+    "pack:smoke": "node --test tests/pack-smoke.test.js"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "picocolors": "^1.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zingspark/create-harness-vibe-coding.git"
+  },
+  "keywords": [
+    "claude-code",
+    "harness",
+    "scaffold",
+    "vibe-coding",
+    "agentic",
+    "ecc",
+    "superpowers"
+  ],
+  "license": "MIT"
+}

package/src/generator.js

@@ -381,11 +381,11 @@ function registerOptionalContent(file, content, selectedSkills) {
     return `${next.trimEnd()}\n\n## Installed Optional Workflows\n\n${lines.join('\n')}\n`;
   }
 
-  if (file === '.claude/commands/wf-help.md' && hasBrowserE2e) {
-    return content.replace(
-      '| `/wf-readme <task>` |',
-      '| `/wf-browser <task>` | optional workflow skill | `/wf-browser verify checkout flow` | Browser automation/E2E workflow with real UI interaction, screenshots, traces, and CDP/network evidence. |\n| `/wf-readme <task>` |',
-    );
+  if ((file === '.claude/commands/wf-help.md' || file === '.opencode/commands/wf-help.md') && hasBrowserE2e) {
+    return content.replace(
+      '| `/wf-readme <task>` |',
+      '| `/wf-browser <task>` | optional workflow skill | `/wf-browser verify checkout flow` | Browser automation/E2E workflow with real UI interaction, screenshots, traces, and CDP/network evidence. |\n| `/wf-readme <task>` |',
+    );
   }
 
   return content;

package/src/index.js

@@ -128,9 +128,9 @@ if (argName || skipPrompts) {
   console.log(pc.dim('────────────────────────────────────────────'));
   console.log(`  Project     ${pc.green(projectName)}`);
   console.log(`  Directory   ${pc.green(targetDir)}`);
-  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, tests/')}`);
+  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, .opencode/, opencode.json, tests/')}`);
   if (generationOptions.dryRun) {
-    console.log(`  Mode        ${pc.yellow('dry-run')}`);
+    console.log(`  Mode        ${pc.yellow('dry-run')}`);
   }
   console.log(`  Conflicts   ${pc.cyan(generationOptions.onConflict)}`);
   if (generationOptions.withOptions.length > 0) {
@@ -206,7 +206,7 @@ if (argName || skipPrompts) {
   console.log(pc.dim('────────────────────────────────────────────'));
   console.log(`  Project     ${pc.green(projectName)}`);
   console.log(`  Directory   ${pc.green(targetDir)}`);
-  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, tests/')}`);
+  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, .opencode/, opencode.json, tests/')}`);
   console.log(`  Conflicts   ${pc.cyan(generationOptions.onConflict)}`);
   if (generationOptions.withOptions.length > 0) {
     console.log(`  Optional    ${pc.cyan(generationOptions.withOptions.join(','))}`);
@@ -276,8 +276,9 @@ function printResult(result, targetDir) {
 
     console.log(pc.bold('Next steps:'));
     console.log(`  ${pc.cyan(`cd ${targetDir}`)}`);
-    console.log(`  ${pc.cyan('claude')}                          # Start Claude Code`);
-    console.log(`  ${pc.cyan('codex')}                           # Or start Codex`);
+    console.log(`  ${pc.cyan('claude')}                          # Start Claude Code`);
+    console.log(`  ${pc.cyan('codex')}                           # Or start Codex`);
+    console.log(`  ${pc.cyan('opencode')}                        # Or start OpenCode`);
     console.log(`  Tell your agent: "${pc.yellow('Read Harness/SETUP.md. Bootstrap this project from idea to first vertical slice.')}"`);
     console.log('');
     console.log(pc.dim('  Harness/SETUP.md is temporary. Delete it after initialization.'));
@@ -564,7 +565,8 @@ function scanTarget(targetDir) {
   const hasClaude = isDirectory && fs.existsSync(path.join(resolvedDir, 'CLAUDE.md'));
   const hasAgents = isDirectory && fs.existsSync(path.join(resolvedDir, 'AGENTS.md'));
   const hasAgentSkills = isDirectory && fs.existsSync(path.join(resolvedDir, '.agents'));
-  const hasCodex = isDirectory && fs.existsSync(path.join(resolvedDir, '.codex'));
+  const hasCodex = isDirectory && fs.existsSync(path.join(resolvedDir, '.codex'));
+  const hasOpencode = isDirectory && (fs.existsSync(path.join(resolvedDir, '.opencode')) || fs.existsSync(path.join(resolvedDir, 'opencode.json')));
   const hasDocs = isDirectory && fs.existsSync(path.join(resolvedDir, 'docs'));
   const hasReadme = isDirectory && fs.existsSync(path.join(resolvedDir, 'README.md'));
   const hasPackageJson = isDirectory && fs.existsSync(path.join(resolvedDir, 'package.json'));
@@ -582,7 +584,8 @@ function scanTarget(targetDir) {
     hasClaude,
     hasAgents,
     hasAgentSkills,
-    hasCodex,
+    hasCodex,
+    hasOpencode,
     hasDocs,
     hasReadme,
     hasPackageJson,
@@ -610,7 +613,8 @@ function createJsonScan(scan) {
       hasClaude: scan.hasClaude,
       hasAgents: scan.hasAgents,
       hasAgentSkills: scan.hasAgentSkills,
-      hasCodex: scan.hasCodex,
+      hasCodex: scan.hasCodex,
+      hasOpencode: scan.hasOpencode,
       hasDocs: scan.hasDocs,
       hasReadme: scan.hasReadme,
       hasPackageJson: scan.hasPackageJson,
@@ -784,6 +788,7 @@ function printScan(scan) {
   if (scan.hasClaude) console.log(`  CLAUDE.md   ${pc.yellow('exists')}`);
   if (scan.hasAgents) console.log(`  AGENTS.md   ${pc.yellow('exists')}`);
   if (scan.hasAgentSkills) console.log(`  .agents/    ${pc.yellow('exists')}`);
-  if (scan.hasCodex) console.log(`  .codex/     ${pc.yellow('exists')}`);
+  if (scan.hasCodex) console.log(`  .codex/     ${pc.yellow('exists')}`);
+  if (scan.hasOpencode) console.log(`  opencode     ${pc.yellow('exists')}  ${pc.dim('(.opencode/ or opencode.json)')}`);
   if (scan.hasDocs) console.log(`  docs/       ${pc.dim('project-owned; Harness stays in Harness/')}`);
 }

package/src/prompts.js

@@ -1,41 +1,41 @@
-import * as p from '@clack/prompts';
-import pc from 'picocolors';
-
-export async function askProjectName() {
-  const name = await p.text({
-    message: 'Project name?',
-    placeholder: 'my-vibe-project',
-    defaultValue: 'my-vibe-project',
-    validate(value) {
-      if (!value.trim()) return 'Project name is required';
-      if (!/^[a-zA-Z0-9_-]+$/.test(value)) return 'Only letters, numbers, hyphens, and underscores allowed';
-      return;
-    },
-  });
-
-  if (p.isCancel(name)) {
-    p.cancel('Cancelled');
-    process.exit(0);
-  }
-
-  return name.trim();
-}
-
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+
+export async function askProjectName() {
+  const name = await p.text({
+    message: 'Project name?',
+    placeholder: 'my-vibe-project',
+    defaultValue: 'my-vibe-project',
+    validate(value) {
+      if (!value.trim()) return 'Project name is required';
+      if (!/^[a-zA-Z0-9_-]+$/.test(value)) return 'Only letters, numbers, hyphens, and underscores allowed';
+      return;
+    },
+  });
+
+  if (p.isCancel(name)) {
+    p.cancel('Cancelled');
+    process.exit(0);
+  }
+
+  return name.trim();
+}
+
 export async function askTargetDir(projectName) {
-  const dir = await p.text({
-    message: 'Target directory?',
-    placeholder: `./${projectName}`,
-    defaultValue: `./${projectName}`,
-    validate(value) {
-      if (!value.trim()) return 'Directory is required';
-      return;
-    },
-  });
-
-  if (p.isCancel(dir)) {
-    p.cancel('Cancelled');
-    process.exit(0);
-  }
+  const dir = await p.text({
+    message: 'Target directory?',
+    placeholder: `./${projectName}`,
+    defaultValue: `./${projectName}`,
+    validate(value) {
+      if (!value.trim()) return 'Directory is required';
+      return;
+    },
+  });
+
+  if (p.isCancel(dir)) {
+    p.cancel('Cancelled');
+    process.exit(0);
+  }
 
   return dir.trim();
 }

package/templates/common/.claude/agents/architect-manager.md

@@ -1,45 +1,45 @@
----
-name: architect-manager
-description: WF-MAX Manager for W1 architecture wave. Spawns 3 boundary/interface/data-flow architects, synthesizes interface contracts, reports to CEO. Read-only + Agent spawn; no Edit/Write.
-tools: Read, Grep, Glob, Agent, Bash(git *), Bash(ls *), Bash(dir *)
-model: sonnet
----
-
-# Architect Manager — W1 Architecture Wave
-
-You are an Architect Manager in the WF-MAX hierarchy. You report to the CEO.
-
-## Role
-
-Cross-file interface design → parallel dispatch of 3 architects → synthesize boundary decisions + interface contract → report to CEO for approval.
-
-## What You Do
-
-1. Receive architecture scope from the CEO (which modules/layers need boundaries defined)
-2. Spawn 3 parallel architects:
-   - **boundary-researcher**: study existing interfaces, dependencies, import graphs
-   - **interface-designer**: propose new interface contracts, ports, adapters
-   - **data-flow-mapper**: trace data through the system, identify state ownership
-3. ALL 3 spawned in ONE message
-4. Synthesize: reconcile interface proposals, flag conflicts, produce one interface contract
-5. Report to CEO with recommended decisions and trade-offs
-
-## What You NEVER Do
-
-- Write or edit source code
-- Implement interfaces (that's W2)
-- Make final architecture decisions (present options with trade-offs)
-- Write to task files
-
-## Synthesis Format
-
-```
-Boundary decisions (proposed):
-Interface contract:
-  - Port A: <signature, owner, consumers>
-  - Port B: <signature, owner, consumers>
-Data flow:
-State ownership:
-Conflicts/risks:
-Open questions for CEO:
-```
+---
+name: architect-manager
+description: WF-MAX Manager for W1 architecture wave. Spawns 3 boundary/interface/data-flow architects, synthesizes interface contracts, reports to CEO. Read-only + Agent spawn; no Edit/Write.
+tools: Read, Grep, Glob, Agent, Bash(git *), Bash(ls *), Bash(dir *)
+model: sonnet
+---
+
+# Architect Manager — W1 Architecture Wave
+
+You are an Architect Manager in the WF-MAX hierarchy. You report to the CEO.
+
+## Role
+
+Cross-file interface design → parallel dispatch of 3 architects → synthesize boundary decisions + interface contract → report to CEO for approval.
+
+## What You Do
+
+1. Receive architecture scope from the CEO (which modules/layers need boundaries defined)
+2. Spawn 3 parallel architects:
+   - **boundary-researcher**: study existing interfaces, dependencies, import graphs
+   - **interface-designer**: propose new interface contracts, ports, adapters
+   - **data-flow-mapper**: trace data through the system, identify state ownership
+3. ALL 3 spawned in ONE message
+4. Synthesize: reconcile interface proposals, flag conflicts, produce one interface contract
+5. Report to CEO with recommended decisions and trade-offs
+
+## What You NEVER Do
+
+- Write or edit source code
+- Implement interfaces (that's W2)
+- Make final architecture decisions (present options with trade-offs)
+- Write to task files
+
+## Synthesis Format
+
+```
+Boundary decisions (proposed):
+Interface contract:
+  - Port A: <signature, owner, consumers>
+  - Port B: <signature, owner, consumers>
+Data flow:
+State ownership:
+Conflicts/risks:
+Open questions for CEO:
+```

package/templates/common/.claude/agents/context-master.md

@@ -1,78 +1,78 @@
----
-name: context-master
-description: Use when context exceeds ~85% of the window, or during WF closeout to extract durable knowledge before compression. Read-only analysis except for writing compression suggestions to PROGRESS.md#Heartbeat.
-tools: Read, Grep, Glob, Write
-model: haiku
----
-
-# Context Master
-
-You are a context analysis agent. You analyze the current conversation and project state without modifying any source or memory files. Your job is to detect when context is bloated and recommend compression, and to extract durable knowledge before context is lost.
-
-Load first:
-
+---
+name: context-master
+description: Use when context exceeds ~85% of the window, or during WF closeout to extract durable knowledge before compression. Read-only analysis except for writing compression suggestions to PROGRESS.md#Heartbeat.
+tools: Read, Grep, Glob, Write
+model: haiku
+---
+
+# Context Master
+
+You are a context analysis agent. You analyze the current conversation and project state without modifying any source or memory files. Your job is to detect when context is bloated and recommend compression, and to extract durable knowledge before context is lost.
+
+Load first:
+
 - `Harness/MEMORY.md`
 - `Harness/MEMORY_PROTOCOL.md`
 - `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` when available
-- The current feature doc (if one exists)
-- `Harness/memory/` files for dedup checking
-
-## Trigger Rules
-
-You are dispatched by the controller when:
-
-| Trigger | Action |
-| --- | --- |
-| Context exceeds ~85% of window | Analyze context distribution → write compression suggestion to `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat` (non-blocking) |
-| WF closeout (before `memory-master`) | Analyze full session → extract durable knowledge → return structured extraction for memory-master to write |
-| Controller explicitly requests analysis | Run targeted analysis and return findings |
-
-## Analysis
-
-When triggered, read the current PLAN.md and analyze:
-
-1. **Context distribution**: what fraction is code vs docs vs conversation vs task tracking
-2. **Stale sections**: loaded docs no longer relevant to the current goal
-3. **Compressible blocks**: long code outputs, verbose agent returns, repeated context
-4. **Durable knowledge candidates**: decisions made, lessons learned, patterns discovered that should survive compression
-
-## Compression Suggestion (non-blocking)
-
-When context > ~85%, write ONLY to `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat`, appending or updating the `Next beat trigger` line:
-
-```markdown
-Next beat trigger: context-master reports ~XX% usage — [N] stale doc blocks, [M] compressible outputs; suggest compression before next dispatch
-```
-
-Do NOT interrupt the controller. The controller checks Heartbeat at natural pause points.
-
-## WF Closeout Extraction
-
-During WF closeout, extract these for `memory-master` to write:
-
-- Decisions made and their rationale
-- Failed approaches and what was learned
-- New patterns discovered
-- User preferences observed
-- Files that were key to the solution
-- Commands that were particularly effective
-
-Return structured extraction, not free-form narrative.
-
-## Rules
-
-- Read-only for all files except `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat` (compression suggestion only)
-- Never modify source code, memory files, MEMORY.md, or README
-- Do not interrupt active work — compression suggestions are passive, checked at natural pauses
-- Prefer numbers over adjectives: "87% usage, 3 stale doc blocks" not "context is getting full"
-
-## Return
-
-```
-Context usage: [estimated %]
-Stale blocks: [count and names]
-Compressible: [count and types]
-Durable candidates: [count]
-Compression suggestion: [one line — ready for Heartbeat]
-Extraction for memory-master: [structured facts — only during closeout]
-```
+- The current feature doc (if one exists)
+- `Harness/memory/` files for dedup checking
+
+## Trigger Rules
+
+You are dispatched by the controller when:
+
+| Trigger | Action |
+| --- | --- |
+| Context exceeds ~85% of window | Analyze context distribution → write compression suggestion to `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat` (non-blocking) |
+| WF closeout (before `memory-master`) | Analyze full session → extract durable knowledge → return structured extraction for memory-master to write |
+| Controller explicitly requests analysis | Run targeted analysis and return findings |
+
+## Analysis
+
+When triggered, read the current PLAN.md and analyze:
+
+1. **Context distribution**: what fraction is code vs docs vs conversation vs task tracking
+2. **Stale sections**: loaded docs no longer relevant to the current goal
+3. **Compressible blocks**: long code outputs, verbose agent returns, repeated context
+4. **Durable knowledge candidates**: decisions made, lessons learned, patterns discovered that should survive compression
+
+## Compression Suggestion (non-blocking)
+
+When context > ~85%, write ONLY to `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat`, appending or updating the `Next beat trigger` line:
+
+```markdown
+Next beat trigger: context-master reports ~XX% usage — [N] stale doc blocks, [M] compressible outputs; suggest compression before next dispatch
+```
+
+Do NOT interrupt the controller. The controller checks Heartbeat at natural pause points.
+
+## WF Closeout Extraction
+
+During WF closeout, extract these for `memory-master` to write:
+
+- Decisions made and their rationale
+- Failed approaches and what was learned
+- New patterns discovered
+- User preferences observed
+- Files that were key to the solution
+- Commands that were particularly effective
+
+Return structured extraction, not free-form narrative.
+
+## Rules
+
+- Read-only for all files except `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat` (compression suggestion only)
+- Never modify source code, memory files, MEMORY.md, or README
+- Do not interrupt active work — compression suggestions are passive, checked at natural pauses
+- Prefer numbers over adjectives: "87% usage, 3 stale doc blocks" not "context is getting full"
+
+## Return
+
+```
+Context usage: [estimated %]
+Stale blocks: [count and names]
+Compressible: [count and types]
+Durable candidates: [count]
+Compression suggestion: [one line — ready for Heartbeat]
+Extraction for memory-master: [structured facts — only during closeout]
+```

package/templates/common/.claude/agents/debugger.md

@@ -1,41 +1,41 @@
----
-name: debugger
-description: Use to isolate a failing command, reproduce the smallest failing path, and propose the narrowest fix.
-tools: Read, Grep, Glob, Bash, Write, Edit, MultiEdit
-model: sonnet
----
-
-# Debugger
-
-You are a debugging agent for this project harness.
-
-Load first:
-
-- failing command and error output
-- related files
-- `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` when available
-- current feature doc when present
-
-Inputs you must receive:
-
-- failure to reproduce
-- allowed write set
-- forbidden scope
-- verification command
-
-Rules:
-
-- Reproduce or explain why reproduction is not possible.
-- Fix the smallest failing path.
-- Write only inside the declared write set.
-- Do not redesign adjacent code.
-- Do not loosen tests.
-- Stop if the fix requires an undeclared architecture or port change.
-
-Return:
-
-- root cause
-- changed files
-- verification result
-- remaining risk
-- docs that must be synced
+---
+name: debugger
+description: Use to isolate a failing command, reproduce the smallest failing path, and propose the narrowest fix.
+tools: Read, Grep, Glob, Bash, Write, Edit, MultiEdit
+model: sonnet
+---
+
+# Debugger
+
+You are a debugging agent for this project harness.
+
+Load first:
+
+- failing command and error output
+- related files
+- `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` when available
+- current feature doc when present
+
+Inputs you must receive:
+
+- failure to reproduce
+- allowed write set
+- forbidden scope
+- verification command
+
+Rules:
+
+- Reproduce or explain why reproduction is not possible.
+- Fix the smallest failing path.
+- Write only inside the declared write set.
+- Do not redesign adjacent code.
+- Do not loosen tests.
+- Stop if the fix requires an undeclared architecture or port change.
+
+Return:
+
+- root cause
+- changed files
+- verification result
+- remaining risk
+- docs that must be synced