create-harness-vibe-coding 0.8.6 → 0.8.8
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.
- package/README-CN.md +157 -105
- package/README.md +160 -244
- package/bin/create-harness-vibe-coding.js +2 -2
- package/docs/images/harness-architecture-light.png +0 -0
- package/docs/images/harness-architecture.drawio +164 -0
- package/package.json +46 -44
- package/src/generator.js +30 -11
- package/src/index.js +143 -14
- package/src/prompts.js +37 -37
- package/templates/common/.claude/agents/architect-manager.md +45 -45
- package/templates/common/.claude/agents/context-master.md +75 -75
- package/templates/common/.claude/agents/debugger.md +41 -41
- package/templates/common/.claude/agents/explore-manager.md +41 -41
- package/templates/common/.claude/agents/implement-manager.md +49 -49
- package/templates/common/.claude/agents/implementer.md +40 -40
- package/templates/common/.claude/agents/memory-master.md +64 -64
- package/templates/common/.claude/agents/planner.md +34 -34
- package/templates/common/.claude/agents/reflector.md +35 -0
- package/templates/common/.claude/agents/researcher.md +41 -41
- package/templates/common/.claude/agents/review-manager.md +56 -56
- package/templates/common/.claude/agents/verifier.md +34 -32
- package/templates/common/.claude/commands/wf-help.md +2 -3
- package/templates/common/.claude/rules/ecc/common.md +44 -44
- package/templates/common/.claude/skills/subagent-orchestrator/SKILL.md +10 -4
- package/templates/common/.claude/skills/wf/SKILL.md +7 -3
- package/templates/common/.claude/skills/wf-auto/SKILL.md +61 -107
- package/templates/common/.claude/skills/wf-auto-spark/SKILL.md +19 -17
- package/templates/common/.claude/skills/wf-max/SKILL.md +40 -21
- package/templates/common/.claude/skills/wf-readme/SKILL.md +49 -49
- package/templates/common/.claude/skills/wf-remove/SKILL.md +7 -7
- package/templates/common/.claude/skills/wf-update/SKILL.md +9 -4
- package/templates/common/.codex/config.toml +5 -0
- package/templates/common/.harness-version +78 -36
- package/templates/common/.opencode/agents/architect-manager.md +52 -0
- package/templates/common/.opencode/agents/architect.md +35 -0
- package/templates/common/.opencode/agents/context-master.md +81 -0
- package/templates/common/.opencode/agents/debugger.md +43 -0
- package/templates/common/.opencode/agents/docs-researcher.md +42 -0
- package/templates/common/.opencode/agents/explore-manager.md +49 -0
- package/templates/common/.opencode/agents/implement-manager.md +56 -0
- package/templates/common/.opencode/agents/implementer.md +42 -0
- package/templates/common/.opencode/agents/memory-master.md +70 -0
- package/templates/common/.opencode/agents/planner.md +38 -0
- package/templates/common/.opencode/agents/reflector.md +39 -0
- package/templates/common/.opencode/agents/researcher.md +42 -0
- package/templates/common/.opencode/agents/review-manager.md +63 -0
- package/templates/common/.opencode/agents/reviewer.md +37 -0
- package/templates/common/.opencode/agents/tdd-guide.md +83 -0
- package/templates/common/.opencode/agents/test-writer.md +54 -0
- package/templates/common/.opencode/agents/verifier.md +37 -0
- package/templates/common/.opencode/commands/wf-help.md +23 -0
- package/templates/common/AGENTS.md +26 -25
- package/templates/common/CLAUDE.md +86 -88
- package/templates/common/Harness/ACCEPTANCE_PROTOCOL.md +12 -4
- package/templates/common/Harness/PROGRESS.md +17 -17
- package/templates/common/Harness/README.md +26 -16
- package/templates/common/Harness/WF-AUTO-ANGLES.md +170 -0
- package/templates/common/Harness/WF-AUTO-SPARK.md +23 -6
- package/templates/common/Harness/WF-AUTO.md +508 -493
- package/templates/common/Harness/WF-MAX.md +284 -232
- package/templates/common/Harness/WF.md +47 -29
- package/templates/common/Harness/agent-workflow.md +108 -76
- package/templates/common/Harness/architecture.md +124 -124
- package/templates/common/Harness/context-loading.md +111 -111
- package/templates/common/Harness/dispatch.md +96 -95
- package/templates/common/Harness/extension.md +67 -67
- package/templates/common/Harness/lifecycle.md +20 -20
- package/templates/common/Harness/research/PRD.md +56 -56
- package/templates/common/Harness/research/README.md +169 -169
- package/templates/common/Harness/research/research-results.md +66 -66
- package/templates/common/Harness/subagents.md +192 -170
- package/templates/common/Harness/tasks/_template/ARTIFACTS.md +3 -3
- package/templates/common/Harness/tasks/_template/NOTES.md +3 -3
- package/templates/common/Harness/tasks/_template/PLAN.md +53 -60
- package/templates/common/Harness/tasks/_template/PROGRESS.md +26 -29
- package/templates/common/MEMORY.md +27 -30
- package/templates/common/README.md +36 -36
- package/templates/common/SETUP.md +1 -1
- package/templates/common/memory/agent-lessons-patterns.md +21 -21
- package/templates/common/memory/tool-usage-reflections.md +21 -21
- package/templates/common/memory/user-corrections-preferences.md +21 -21
- package/templates/common/opencode.json +19 -0
- package/templates/common/scripts/scan-clean.mjs +487 -448
- package/templates/common/scripts/validate-harness.mjs +245 -146
- package/templates/common/scripts/wf-remove.mjs +311 -293
- package/templates/common/scripts/wf-update-check.mjs +511 -311
- package/templates/optional/catalog.json +41 -33
- package/templates/optional/skills/browser-e2e/.claude/skills/wf-browser/SKILL.md +194 -194
- package/templates/optional/skills/browser-e2e/Harness/workflows/browser-e2e.md +105 -69
- package/templates/optional/skills/github-pr-review/Harness/workflows/github-pr-review.md +28 -28
- package/templates/optional/skills/python-backend/Harness/workflows/python-backend.md +34 -34
- package/templates/optional/skills/ts-react-frontend/Harness/workflows/ts-react-frontend.md +34 -34
- package/templates/optional/skills/ui-ux-review/Harness/workflows/ui-ux-review.md +26 -26
|
@@ -6,16 +6,33 @@
|
|
|
6
6
|
|
|
7
7
|
- User explicitly invokes `/wf-auto-spark` or `$wf-auto-spark`
|
|
8
8
|
- Auto-degrade from `/wf-auto` when user can't clarify direction at Re-Anchor Gate
|
|
9
|
-
- Auto-activate when
|
|
9
|
+
- Auto-activate when adaptive internal coverage returns empty for 3+ consecutive cycles AND oracle also empty
|
|
10
10
|
|
|
11
11
|
## Core Philosophy
|
|
12
12
|
|
|
13
13
|
**"Inspiration never runs dry, but direction must hold."**
|
|
14
14
|
|
|
15
|
-
Spark mode replaces the
|
|
15
|
+
Spark mode replaces the adaptive internal probe scan with EXTERNAL inspiration search. Unlike vanilla `/wf-auto` which can stop when no internal improvements are found, spark mode NEVER stops — it always looks outward for the next idea.
|
|
16
16
|
|
|
17
17
|
But perpetual search without direction = drift. The **Roadmap** is the anchor.
|
|
18
18
|
|
|
19
|
+
## Inherited Execution Chain
|
|
20
|
+
|
|
21
|
+
WF-AUTO-SPARK inherits WF-AUTO and WF constraints. External spark search replaces discovery only; it does not replace acceptance, implementation, review, verification, reflection, or evidence.
|
|
22
|
+
|
|
23
|
+
Every accepted spark candidate must re-enter the same per-cycle chain:
|
|
24
|
+
|
|
25
|
+
```text
|
|
26
|
+
spark search -> Value Gate -> deviation check -> Mini PRD -> AC IDs
|
|
27
|
+
-> test/validation plan -> implementer -> verifier -> cross-review
|
|
28
|
+
-> reflector PASS -> evidence ledger -> next spark cycle
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Spark searchers are read-only. Any implementation must use the dispatch packet
|
|
32
|
+
from `Harness/dispatch.md` with explicit write set, forbidden truth files, AC
|
|
33
|
+
IDs, and verification commands. A candidate with no verifier evidence or no
|
|
34
|
+
reflector PASS is not accepted, even if the idea is valuable.
|
|
35
|
+
|
|
19
36
|
## Startup: Roadmap Declaration
|
|
20
37
|
|
|
21
38
|
Before first spark cycle, CEO MUST declare a roadmap. This is written to `Harness/tasks/auto/SPARK-ROADMAP.md`.
|
|
@@ -60,7 +77,7 @@ Answers: "What does success look like in 6-12 months?">
|
|
|
60
77
|
STARTUP: Declare roadmap (North Star + Milestones) → user confirms
|
|
61
78
|
↓
|
|
62
79
|
┌─────────────────────────────────────────────────────────┐
|
|
63
|
-
│ SPARK:
|
|
80
|
+
│ SPARK: parallel external searches → gather sparks │
|
|
64
81
|
│ ↓ │
|
|
65
82
|
│ FILTER: Keep only sparks relevant to project stack/size │
|
|
66
83
|
│ ↓ │
|
|
@@ -79,7 +96,7 @@ STARTUP: Declare roadmap (North Star + Milestones) → user confirms
|
|
|
79
96
|
│ ↓ │
|
|
80
97
|
│ IMPLEMENT: Bounded cycle (≤3 files, ≤50 lines net) │
|
|
81
98
|
│ ↓ │
|
|
82
|
-
│
|
|
99
|
+
│ VERIFY + CROSS-REVIEW + REFLECTOR PASS │
|
|
83
100
|
│ ↓ │
|
|
84
101
|
│ VALUE REFLECTION: CEO writes in PROGRESS.md │
|
|
85
102
|
│ "Driven by [source]. Matters because [reason]. │
|
|
@@ -190,14 +207,14 @@ If CEO CANNOT write a convincing value reflection → spark was NOT valuable →
|
|
|
190
207
|
| SP3 | **Copycat without context** | "Project X does Y so we should too" | Value Gate question 1 |
|
|
191
208
|
| SP4 | **Silent North Star drift** | Small changes accumulate, direction shifts without noticing | Cumulative deviation check every 10 cycles |
|
|
192
209
|
| SP5 | **Milestone rot** | Milestones become irrelevant but aren't updated | Milestone review at Re-Anchor Gate |
|
|
193
|
-
| SP6 | **Spark tunnel vision** | Only looking at one type of source | Rotate through
|
|
210
|
+
| SP6 | **Spark tunnel vision** | Only looking at one type of source | Rotate through the registered source families and record skipped sources |
|
|
194
211
|
|
|
195
212
|
## Integration with /wf-auto
|
|
196
213
|
|
|
197
214
|
```text
|
|
198
215
|
/wf-auto (autonomous optimization)
|
|
199
216
|
↓
|
|
200
|
-
Internal
|
|
217
|
+
Internal adaptive coverage scan per cycle
|
|
201
218
|
↓
|
|
202
219
|
Re-Anchor Gate (every preset interval)
|
|
203
220
|
├── User gives clear direction → refine, continue /wf-auto
|