create-harness-vibe-coding 0.3.4 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-harness-vibe-coding",
-  "version": "0.3.4",
+  "version": "0.4.1",
   "description": "Scaffold a 0-1 product harness for AI-assisted research, PRD, planning, architecture, build, test, and feedback loops",
   "type": "module",
   "bin": {

package/templates/common/.claude/commands/wf-max.md

@@ -1,6 +1,6 @@
-# /wf max
+# /wf-max [task]
 
-Enter maximum-parallelism workflow mode. Splits tasks into minimal non-conflicting units and dispatches as many subagents as possible in parallel waves.
+Enter maximum-parallelism workflow mode with an optional task description. Splits tasks into minimal non-conflicting units and dispatches as many subagents as possible in parallel waves.
 
 ## Required
 

package/templates/common/.claude/commands/wf.md

@@ -1,6 +1,6 @@
-# /wf
+# /wf <task/mission>
 
-Enter `wf-mode`.
+Enter `wf-mode` with the given task or mission description.
 
 ## Required
 

package/templates/common/.claude/skills/wf-max/SKILL.md

@@ -84,9 +84,9 @@ CLOSEOUT: CEO → context-master + memory-master (direct)
 - all changes share single interface → serial
 - overhead > 30% → degrade
 
-## /wf vs /wf max
+## /wf vs /wf-max
 
-| | /wf | /wf max |
+| | /wf | /wf-max |
 |---|-----|------|
 | Organization | flat | CEO→Mgr→Worker (3-tier) |
 | Span formula | none | sqrt(files) + domain cap |

package/templates/common/CLAUDE.md

@@ -11,7 +11,7 @@ Root entry for Claude Code. Keep this file short.
 - `Harness/README.md` is the task router. For every request, check `Harness/README.md#Load By Task`; if a row matches, read and follow those docs before acting.
 - `Harness/PROGRESS.md` is the global task index. Load at session start to see active task and task history.
 - If work spans more than one step, create a task capsule from `Harness/tasks/_template/` and update `Harness/tasks/<task-id>/PROGRESS.md`.
-- Use `/wf`, `/wf max`, `wf-mode`, `wf mode`, `workflow mode`, `wk mode`, `Harness/WF.md`, or `Harness/WF-MAX.md` for long, difficult, uncertain, multi-file, or repeated-failure work.
+- Use `/wf <task>`, `/wf-max [task]`, `wf mode`, `workflow mode`, `wk mode`, `Harness/WF.md`, or `Harness/WF-MAX.md` for long, difficult, uncertain, multi-file, or repeated-failure work.
 - Use `subagent-orchestrator` and `Harness/subagents.md` when coordinating multiple subagents.
 - Use `/wf update` to check for and apply scaffold updates from GitHub. See `.claude/skills/wf-update/SKILL.md`.
 - Subagents are readers and reporters. Only the main agent writes to `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md`.
@@ -67,3 +67,10 @@ Root entry for Claude Code. Keep this file short.
 - **Context threshold trigger**: when context approaches ~85% of the window, dispatch `context-master` to analyze and write a non-blocking compression suggestion to `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat`.
 - **Closeout trigger**: during WF closeout, dispatch `context-master` to extract durable knowledge, then `memory-master` to consolidate into `Harness/memory/*`.
 - Never record secrets, credentials, tokens, or private data.
+
+## 7. CEO Constraints
+
+- Never call `EnterPlanMode` — it blocks the session waiting for user confirmation. Delegate all planning to `planner` subagents.
+- **Never write code directly in `/wf` or `/wf-max` mode.** CEO orchestrates only: dispatch subagents, review results, synthesize, decide next wave. Subagents write code; CEO does not touch files.
+- Exception: only when all subagents have failed, or the task is trivially flat (single file, <20 lines). Otherwise delegate everything.
+- Why: CEO context is the bottleneck. Every direct edit bloats context and degrades orchestration quality.

package/templates/common/docs/README.md

@@ -51,7 +51,7 @@ Keywords are retrieval hints, not project facts.
 
 Load the matching row only. Add adjacent docs only when the loaded doc directly names them.
 
-Routing priority: if a request explicitly says `/wf`, `/wf max`, `wf mode`, `workflow mode`, or `wk mode`, or is long, difficult, uncertain, repeated-failure, migration, architecture-heavy, browser-visible, or broad multi-agent implementation work, choose the WF row first. `wf-mode` MUST then delegate subagent coordination to `subagent-orchestrator`.
+Routing priority: if a request explicitly says `/wf <task>`, `/wf-max [task]`, `wf mode`, `workflow mode`, or `wk mode`, or is long, difficult, uncertain, repeated-failure, migration, architecture-heavy, browser-visible, or broad multi-agent implementation work, choose the WF row first. `wf-mode` MUST then delegate subagent coordination to `subagent-orchestrator`.
 
 | When to Read | Keywords | Load | Output |
 | --- | --- | --- | --- |
@@ -60,7 +60,7 @@ Routing priority: if a request explicitly says `/wf`, `/wf max`, `wf mode`, `wor
 | Need MVP/spec | PRD, MVP, scope, requirement, acceptance, non-goal | [research/PRD.md](research/PRD.md) | one-page PRD with verifiable acceptance criteria |
 | Need architecture or boundaries | architecture, boundary, layer, domain, port, adapter, dependency | [architecture.md](architecture.md), [domain/ports.md](domain/ports.md) | layer map, ports, constraints |
 | Need WF mode | wf, /wf, wf mode, workflow mode, wk mode, long task, difficult, stuck, repeated failure | [WF.md](WF.md), [PROGRESS.md](PROGRESS.md), the current task `tasks/<id>/PROGRESS.md` and `tasks/<id>/PLAN.md` | exploration plan, second plan, heartbeat, recovery loop; explicit WF/WK loads subagent docs immediately |
-| Need WF Max mode | /wf max, wf max, maximum parallelism, max parallel | [WF-MAX.md](WF-MAX.md), [WF.md](WF.md), [subagents.md](subagents.md), [dispatch.md](dispatch.md) | max-parallel exploration, write-set coloring, wave dispatch |
+| Need WF Max mode | /wf-max, wf max, maximum parallelism, max parallel | [WF-MAX.md](WF-MAX.md), [WF.md](WF.md), [subagents.md](subagents.md), [dispatch.md](dispatch.md) | max-parallel exploration, write-set coloring, wave dispatch |
 | Adding harness to existing project | existing project, onboarding, migrate, bootstrap, preserve, conflict | [extension.md](extension.md), [PROGRESS.md](PROGRESS.md), root `README.md` and package/CI files | discovered project facts, preserved config, manual registration plan |
 | README optimization | README, docs, quickstart, install docs, architecture diagram, command table, documentation polish | root `README.md`, `.claude/skills/readme-optimizer/SKILL.md`, [PROGRESS.md](PROGRESS.md), [architecture.md](architecture.md) as needed | approved README mode, preserved sections, proposed diff plan |
 | Need implementation plan | plan, task, write set, verify, milestone, progress | [PROGRESS.md](PROGRESS.md), the current task `tasks/<id>/PROGRESS.md` and `tasks/<id>/PLAN.md`, [agent-workflow.md](agent-workflow.md) | tasks, write set, verification commands |
@@ -79,7 +79,7 @@ Routing priority: if a request explicitly says `/wf`, `/wf max`, `wf mode`, `wor
 ## Gates
 
 - Move phases in order unless the user asks for a fast lane.
-- Use `/wf`, `wf mode`, `workflow mode`, or `wk mode` when a task is long, difficult, uncertain, multi-file, or repeatedly failing.
+- Use `/wf <task>`, `/wf-max [task]`, `wf mode`, `workflow mode`, or `wk mode` when a task is long, difficult, uncertain, multi-file, or repeatedly failing.
 - Do not code before the PRD has MVP, non-goals, and acceptance criteria.
 - Do not cross a layer boundary without reading `domain/ports.md` and updating architecture or ports.
 - Before adding failure paths, read `data-flow.md`.
@@ -108,7 +108,7 @@ Harness/tasks/_template/           task capsule template (copy to create new tas
 Harness/WF.md                      long-task workflow and recovery loop
 Harness/WF-MAX.md                  max-parallelism workflow with wave dispatch
 .claude/skills/wf-max/SKILL.md     max-parallelism skill loader
-.claude/commands/wf-max.md         /wf max slash command bridge
+.claude/commands/wf-max.md         /wf-max slash command bridge
 Harness/lifecycle.md               0-1 product flow
 Harness/subagents.md               controller-led subagent orchestration
 Harness/context-loading.md         dynamic loading and subagent packs

package/templates/common/docs/harness/WF-MAX.md

@@ -2,7 +2,7 @@
 
 ## Trigger
 
-- Explicit: `/wf max`
+- Explicit: `/wf-max [task]`
 - Auto: WF task with write-set ≥5 files AND clear disjoint boundaries
 - parallelismScore = (files × avgLines × 3 / 800) × independenceFactor
   - spawn ≥2.0 | maybe 1.0-2.0 | skip <1.0 (degrade to /wf)
@@ -21,7 +21,7 @@ CEO(1) ──┬── Manager₁(span) ──┬── Worker₁..ₙ
          └── Manager₂(span) ── Worker₁..ₙ
 ```
 
-- CEO: intent, scope, integration, final verification. Direct reports 3-5 Managers.
+- CEO: intent, scope, integration, final verification. Direct reports 3-5 Managers. **CEO never writes code directly** — dispatch Workers for all file changes. CEO only synthesizes results and decides next waves.
 - Manager: domain partition → parallel dispatch → synthesize → report. Serial across domains; parallel within domain.
 - Worker: single file per write Worker (implementer, one file_claim). Single dimension/topic per read Worker (reviewer, researcher). File claims must be file-level disjoint. Topic-level splitting within a single file is only allowed for read-only Workers.
 - depth ≥3: Manager spawns Sub-Manager (span ≤7) instead of Worker. Recursive until leaf condition met.
@@ -113,16 +113,16 @@ overhead(depth) = 0.10 (depth≤2) | 0.20 (depth=3) | 0.35 (depth≥4)
 - overhead > 0.30 → degrade to /wf
 - independenceFactor: 1.0 (no deps) | 0.3-0.7 (shared imports)
 
-## When NOT to use /wf max
+## When NOT to use /wf-max
 
 - files < 5 → use /wf
 - all changes share single interface → serial dependency
 - import/re-export refactor → global consistency required
 - communication overhead > 30% → degrade
 
-## /wf vs /wf max
+## /wf vs /wf-max
 
-| Dimension        | /wf              | /wf max                          |
+| Dimension        | /wf              | /wf-max                          |
 |------------------|------------------|----------------------------------|
 | Organization     | flat             | CEO → Mgr → Worker (3-tier)      |
 | Exploration      | 3-5 serial       | Mgr → 10 parallel                |

package/templates/common/docs/harness/WF.md

@@ -13,7 +13,7 @@ Enter WF mode when any of these are true:
 - The task needs research, architecture judgment, browser/API validation, or migration planning.
 - Confidence in intent, architecture, or implementation is below 95%.
 - The same command, test, tool, or approach fails twice.
-- The user explicitly says `/wf max` or `wf max` (for maximum-parallelism mode, see [WF-MAX.md](WF-MAX.md)).
+- The user explicitly says `/wf-max [task]` or `wf max` (for maximum-parallelism mode, see [WF-MAX.md](WF-MAX.md)).
 
 ## Multi-Subagent Requirement
 
@@ -25,7 +25,7 @@ WF mode requires multi-subagent orchestration by default.
 - Record every dispatch or bounded-pass fallback in `Harness/tasks/<task-id>/PLAN.md#Subagent Dispatch`.
 - If subagents are unavailable, emulate the same roles as separate bounded passes and record why the fallback was used.
 
-For maximum-parallelism mode (write-set coloring, wave dispatch, parallel reviewers), use `/wf max` and see [WF-MAX.md](WF-MAX.md).
+For maximum-parallelism mode (write-set coloring, wave dispatch, parallel reviewers), use `/wf-max [task]` and see [WF-MAX.md](WF-MAX.md).
 
 ## WF Loop
 

package/templates/common/scripts/validate-harness.mjs

@@ -410,7 +410,7 @@ requireText('Harness/WF.md', 'Explicit `/wf`, `wf mode`, `workflow mode`, or `wk
 requireText('Harness/WF.md', '.claude/agents/', 'WF built-in agent roster path');
 requireText('Harness/WF.md', '7:3 collaboration bias', 'WF collaboration bias');
 requireText('Harness/WF.md', 'Harness/tasks/', 'WF task directory reference');
-requireText('Harness/README.md', '`/wf`, `wf mode`, `workflow mode`, or `wk mode`', 'WF/WK router aliases');
+requireText('Harness/README.md', '`wf mode`, `workflow mode`, or `wk mode`', 'WF/WK router aliases');
 requireText('Harness/README.md', 'explicit WF/WK loads subagent docs immediately', 'explicit WF/WK router output');
 requireText('.claude/skills/harness-router/SKILL.md', '`/wf`, `wf mode`, `workflow mode`, `wk mode`', 'harness-router WF/WK aliases');
 requireText('.claude/skills/wf-mode/SKILL.md', 'Harness/WF.md', 'wf-mode loads WF document');
@@ -441,12 +441,12 @@ requireText('CLAUDE.md', '/wf update', 'wf update startup instruction');
 requireText('Harness/README.md', 'Need harness update', 'update routing row');
 requireText('Harness/WF-MAX.md', 'write-set coloring', 'WF-MAX coloring algorithm');
 requireText('Harness/WF-MAX.md', 'wave dispatch', 'WF-MAX wave dispatch');
-requireText('Harness/README.md', '/wf max', 'wf max router alias');
+requireText('Harness/README.md', '/wf-max', 'wf max router alias');
 requireText('Harness/README.md', 'WF-MAX.md', 'WF-MAX router reference');
 requireText('Harness/subagents.md', 'Max parallelism', 'subagents max parallelism row');
 requireText('Harness/dispatch.md', 'Concurrency group', 'dispatch concurrency group field');
 requireText('Harness/dispatch.md', 'File claim', 'dispatch file claim field');
-requireText('CLAUDE.md', '/wf max', 'wf max startup instruction');
+requireText('CLAUDE.md', '/wf-max', 'wf max startup instruction');
 
 if (errors.length) {
   console.error(`Harness validation failed${strict ? ' (strict)' : ''}:`);