create-harness-vibe-coding 0.8.7 → 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 +5 -5
- package/src/index.js +14 -9
- 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/researcher.md +41 -41
- package/templates/common/.claude/agents/review-manager.md +56 -56
- package/templates/common/.claude/agents/verifier.md +29 -29
- package/templates/common/.claude/commands/wf-help.md +1 -1
- package/templates/common/.claude/rules/ecc/common.md +44 -44
- package/templates/common/.claude/skills/wf-auto/SKILL.md +8 -6
- 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/.harness-version +54 -14
- 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/CLAUDE.md +85 -88
- package/templates/common/Harness/PROGRESS.md +17 -17
- package/templates/common/Harness/README.md +16 -5
- package/templates/common/Harness/WF-AUTO-ANGLES.md +170 -0
- package/templates/common/Harness/WF-AUTO-SPARK.md +5 -5
- package/templates/common/Harness/WF-AUTO.md +85 -96
- package/templates/common/Harness/architecture.md +124 -124
- package/templates/common/Harness/context-loading.md +111 -111
- package/templates/common/Harness/extension.md +66 -66
- 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 +208 -208
- package/templates/common/Harness/tasks/_template/ARTIFACTS.md +2 -2
- package/templates/common/Harness/tasks/_template/NOTES.md +2 -2
- package/templates/common/MEMORY.md +1 -1
- package/templates/common/README.md +36 -36
- 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 +415 -415
- package/templates/common/scripts/validate-harness.mjs +274 -245
- package/templates/common/scripts/wf-remove.mjs +56 -39
- package/templates/common/scripts/wf-update-check.mjs +599 -599
- package/templates/optional/catalog.json +41 -33
- package/templates/optional/skills/browser-e2e/.claude/skills/wf-browser/SKILL.md +193 -193
- package/templates/optional/skills/browser-e2e/Harness/workflows/browser-e2e.md +48 -48
- 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
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: verifier
|
|
1
|
+
---
|
|
2
|
+
name: verifier
|
|
3
3
|
description: Use to run verification commands, inspect results, and record evidence. Final acceptance still waits for cross-review PASS and reflector PASS.
|
|
4
|
-
tools: Read, Grep, Glob, Bash
|
|
5
|
-
model: sonnet
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Verifier
|
|
9
|
-
|
|
10
|
-
You are a verification agent for this project harness.
|
|
11
|
-
|
|
12
|
-
Load first:
|
|
13
|
-
|
|
14
|
-
- `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` when available
|
|
15
|
-
- current feature doc when present
|
|
16
|
-
- verification commands and acceptance criteria
|
|
17
|
-
|
|
18
|
-
Rules:
|
|
19
|
-
|
|
20
|
-
- Do not write code.
|
|
21
|
-
- Run only declared verification commands unless asked to expand coverage.
|
|
22
|
-
- If a command is unavailable, record why and suggest a manual check.
|
|
4
|
+
tools: Read, Grep, Glob, Bash
|
|
5
|
+
model: sonnet
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Verifier
|
|
9
|
+
|
|
10
|
+
You are a verification agent for this project harness.
|
|
11
|
+
|
|
12
|
+
Load first:
|
|
13
|
+
|
|
14
|
+
- `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` when available
|
|
15
|
+
- current feature doc when present
|
|
16
|
+
- verification commands and acceptance criteria
|
|
17
|
+
|
|
18
|
+
Rules:
|
|
19
|
+
|
|
20
|
+
- Do not write code.
|
|
21
|
+
- Run only declared verification commands unless asked to expand coverage.
|
|
22
|
+
- If a command is unavailable, record why and suggest a manual check.
|
|
23
23
|
- Mark results as pass, fail, or not run with notes.
|
|
24
24
|
- Do not mark work verified without evidence.
|
|
25
25
|
- Do not claim final acceptance. Verification evidence is necessary but final
|
|
26
26
|
acceptance waits for cross-review PASS and reflector PASS.
|
|
27
|
-
|
|
28
|
-
Return:
|
|
29
|
-
|
|
30
|
-
- commands run
|
|
31
|
-
- result per command
|
|
32
|
-
- acceptance criteria status
|
|
33
|
-
- residual risk
|
|
34
|
-
- patch-ready verification update for `PLAN.md` or feature doc
|
|
27
|
+
|
|
28
|
+
Return:
|
|
29
|
+
|
|
30
|
+
- commands run
|
|
31
|
+
- result per command
|
|
32
|
+
- acceptance criteria status
|
|
33
|
+
- residual risk
|
|
34
|
+
- patch-ready verification update for `PLAN.md` or feature doc
|
|
@@ -8,7 +8,7 @@ do not dispatch agents, and do not edit files.
|
|
|
8
8
|
| `/wf-help` | direct command | `/wf-help` | Show this command table. |
|
|
9
9
|
| `/wf <task>` | workflow skill | `/wf fix failing login flow` | Standard acceptance-driven workflow for long, uncertain, multi-file, browser/API, or recovery work. |
|
|
10
10
|
| `/wf-max <task>` | workflow skill | `/wf-max refactor auth module` | WF strict superset: complete role chain plus maximum fan-out, CEO -> Manager -> Worker dispatch, cross-CLI overflow when the current runtime agent pool is exhausted. |
|
|
11
|
-
| `/wf-auto` | workflow skill | `/wf-auto` | Perpetual auto-optimization
|
|
11
|
+
| `/wf-auto` | workflow skill | `/wf-auto` | Perpetual adaptive auto-optimization using project evidence, dynamic probes, risk obligations, evidence ledger, and confirmation-based exhaustion. |
|
|
12
12
|
| `/wf-auto-spark` | workflow skill | `/wf-auto-spark` | Perpetual inspiration mode with roadmap anchoring and external spark search. |
|
|
13
13
|
| `/wf-review <focus>` | workflow skill | `/wf-review security and test coverage` | Cross-model peer review through the other CLI; use for second opinions and risk checks. |
|
|
14
14
|
| `/wf-learn` | workflow skill | `/wf-learn` | Force context-master -> memory-master learning cycle after repeated failures or closeout. |
|
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: "Universal harness constraints"
|
|
3
|
-
alwaysApply: true
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Universal Rules
|
|
7
|
-
|
|
8
|
-
## Context
|
|
9
|
-
|
|
10
|
-
- Start with `CLAUDE.md`, `Harness/MEMORY.md`, and `Harness/README.md`.
|
|
11
|
-
- Do not bulk-read `Harness/`. Load by router trigger.
|
|
12
|
-
- Keep `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` current when work has multiple steps, files, or agents.
|
|
13
|
-
- project files are the only durable communication channel. chat/subagent transcript state is non-authoritative.
|
|
14
|
-
- Important assumptions, decisions, blockers, evidence, and handoffs must be written to `Harness/tasks/<task-id>/PROGRESS.md`, `Harness/tasks/<task-id>/PLAN.md`, the current feature doc, `Harness/MEMORY.md`, or `Harness/memory/*` as appropriate.
|
|
15
|
-
|
|
16
|
-
## Verification
|
|
17
|
-
|
|
18
|
-
- Define acceptance criteria before implementation.
|
|
19
|
-
- New behavior: failing test first, or a written manual check if automation is not feasible yet.
|
|
20
|
-
- Bug fix: reproduction first.
|
|
21
|
-
- Before release, add CI for the chosen stack and run the full verification path.
|
|
22
|
-
|
|
23
|
-
## Subagents
|
|
24
|
-
|
|
25
|
-
- Use `Harness/subagents.md` before orchestrating multiple agents.
|
|
26
|
-
- Use `Harness/context-loading.md` before spawning.
|
|
27
|
-
- Use `Harness/dispatch.md` before parallel or multi-agent work.
|
|
1
|
+
---
|
|
2
|
+
description: "Universal harness constraints"
|
|
3
|
+
alwaysApply: true
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Universal Rules
|
|
7
|
+
|
|
8
|
+
## Context
|
|
9
|
+
|
|
10
|
+
- Start with `CLAUDE.md`, `Harness/MEMORY.md`, and `Harness/README.md`.
|
|
11
|
+
- Do not bulk-read `Harness/`. Load by router trigger.
|
|
12
|
+
- Keep `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` current when work has multiple steps, files, or agents.
|
|
13
|
+
- project files are the only durable communication channel. chat/subagent transcript state is non-authoritative.
|
|
14
|
+
- Important assumptions, decisions, blockers, evidence, and handoffs must be written to `Harness/tasks/<task-id>/PROGRESS.md`, `Harness/tasks/<task-id>/PLAN.md`, the current feature doc, `Harness/MEMORY.md`, or `Harness/memory/*` as appropriate.
|
|
15
|
+
|
|
16
|
+
## Verification
|
|
17
|
+
|
|
18
|
+
- Define acceptance criteria before implementation.
|
|
19
|
+
- New behavior: failing test first, or a written manual check if automation is not feasible yet.
|
|
20
|
+
- Bug fix: reproduction first.
|
|
21
|
+
- Before release, add CI for the chosen stack and run the full verification path.
|
|
22
|
+
|
|
23
|
+
## Subagents
|
|
24
|
+
|
|
25
|
+
- Use `Harness/subagents.md` before orchestrating multiple agents.
|
|
26
|
+
- Use `Harness/context-loading.md` before spawning.
|
|
27
|
+
- Use `Harness/dispatch.md` before parallel or multi-agent work.
|
|
28
28
|
- Use `Harness/extension.md` before adding stack-specific agents, skills, or rules.
|
|
29
|
-
- Every subagent needs role, task, read boundary, write boundary, and return format.
|
|
30
|
-
- Writing agents must run serially unless write sets are disjoint.
|
|
31
|
-
- If the runtime cannot spawn subagents, emulate the same role pack in a separate bounded pass.
|
|
32
|
-
- Main agent owns integration and final verification.
|
|
33
|
-
|
|
34
|
-
## Memory
|
|
35
|
-
|
|
36
|
-
- Record a lightweight reflection in `Harness/memory/tool-usage-reflections.md` when the same tool/use pattern fails 3+ times.
|
|
37
|
-
- Record repeated user corrections or durable preferences in `Harness/memory/user-corrections-preferences.md` when the user corrects the same assumption/pattern 2+ times.
|
|
38
|
-
- Record reusable review/debug lessons in `Harness/memory/agent-lessons-patterns.md`.
|
|
39
|
-
- Keep memory entries concise and never include secrets.
|
|
40
|
-
|
|
41
|
-
## Security
|
|
42
|
-
|
|
43
|
-
- No secrets in source code.
|
|
44
|
-
- Validate external input at system boundaries.
|
|
45
|
-
- High-risk actions need explicit user approval or documented permission policy.
|
|
29
|
+
- Every subagent needs role, task, read boundary, write boundary, and return format.
|
|
30
|
+
- Writing agents must run serially unless write sets are disjoint.
|
|
31
|
+
- If the runtime cannot spawn subagents, emulate the same role pack in a separate bounded pass.
|
|
32
|
+
- Main agent owns integration and final verification.
|
|
33
|
+
|
|
34
|
+
## Memory
|
|
35
|
+
|
|
36
|
+
- Record a lightweight reflection in `Harness/memory/tool-usage-reflections.md` when the same tool/use pattern fails 3+ times.
|
|
37
|
+
- Record repeated user corrections or durable preferences in `Harness/memory/user-corrections-preferences.md` when the user corrects the same assumption/pattern 2+ times.
|
|
38
|
+
- Record reusable review/debug lessons in `Harness/memory/agent-lessons-patterns.md`.
|
|
39
|
+
- Keep memory entries concise and never include secrets.
|
|
40
|
+
|
|
41
|
+
## Security
|
|
42
|
+
|
|
43
|
+
- No secrets in source code.
|
|
44
|
+
- Validate external input at system boundaries.
|
|
45
|
+
- High-risk actions need explicit user approval or documented permission policy.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: wf-auto
|
|
3
|
-
description: Perpetual auto-optimization mode.
|
|
3
|
+
description: Perpetual adaptive auto-optimization mode. Selects probes from project evidence instead of a fixed angle count. Inherits WF acceptance gates and subagent orchestration per cycle. Use for Claude /wf-auto, Codex $wf-auto, auto mode, or unbounded self-directed optimization.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# WF Auto - Perpetual Auto-Optimization
|
|
@@ -8,6 +8,7 @@ description: Perpetual auto-optimization mode. Never stops until 8-angle exhaust
|
|
|
8
8
|
## Load
|
|
9
9
|
|
|
10
10
|
- `Harness/WF-AUTO.md`
|
|
11
|
+
- `Harness/WF-AUTO-ANGLES.md`
|
|
11
12
|
- `Harness/subagents.md`
|
|
12
13
|
- `Harness/dispatch.md`
|
|
13
14
|
- `Harness/agent-workflow.md`
|
|
@@ -25,12 +26,13 @@ that auto scanning costs more than it helps.
|
|
|
25
26
|
|
|
26
27
|
## Hard Rules
|
|
27
28
|
|
|
28
|
-
1. Never stop except the A-GATE:
|
|
29
|
-
|
|
29
|
+
1. Never stop except the Adaptive Coverage A-GATE: dynamic high-risk
|
|
30
|
+
obligations are covered, two different confirmation strategies are empty,
|
|
31
|
+
and unresolved uncertainty is recorded.
|
|
30
32
|
2. CEO never edits production source. CEO may write only
|
|
31
33
|
`Harness/tasks/auto/PLAN.md` and `Harness/tasks/auto/PROGRESS.md`.
|
|
32
|
-
3.
|
|
33
|
-
oracle
|
|
34
|
+
3. Build a project profile each W0 cycle and dispatch only the selected probes;
|
|
35
|
+
invoke oracle and spark searchers when evidence justifies them.
|
|
34
36
|
4. One accepted finding per cycle: <=3 files and <=50 changed lines. Larger
|
|
35
37
|
ideas escalate to `/wf` or `/wf-max`, then return to auto.
|
|
36
38
|
5. Every accepted cycle inherits the full WF chain:
|
|
@@ -45,7 +47,7 @@ that auto scanning costs more than it helps.
|
|
|
45
47
|
## Loop
|
|
46
48
|
|
|
47
49
|
```text
|
|
48
|
-
W0: SENSE (
|
|
50
|
+
W0: SENSE (adaptive probes + oracle + spark sources as triggered)
|
|
49
51
|
A-GATE: continue, oracle, spark, confirm, or stop
|
|
50
52
|
W1: PRIORITIZE one finding
|
|
51
53
|
W2-W5: Mini PRD -> AC -> test/validation plan -> implementer -> verifier -> cross-review -> reflector PASS
|
|
@@ -1,49 +1,49 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: wf-readme
|
|
3
|
-
description: Use when a project README already exists and the user asks to preserve, merge, modernize, optimize, or clarify repository documentation during harness install or documentation work.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# README Optimizer
|
|
7
|
-
|
|
8
|
-
Improve `README.md` without breaking project-owned public docs.
|
|
9
|
-
|
|
10
|
-
## Load
|
|
11
|
-
|
|
12
|
-
- root `README.md`
|
|
13
|
-
- package files and scripts (`package.json`, `pyproject.toml`, `go.mod`, etc.)
|
|
14
|
-
- CI files when present
|
|
15
|
-
- `Harness/PROGRESS.md`
|
|
16
|
-
- `Harness/tasks/<task-id>/PLAN.md` when available
|
|
17
|
-
- `Harness/architecture.md` only when an architecture summary or diagram is requested
|
|
18
|
-
|
|
19
|
-
## Mode
|
|
20
|
-
|
|
21
|
-
Ask the user which mode they approve when the existing README is meaningful:
|
|
22
|
-
|
|
23
|
-
| Mode | Use when | Allowed edit |
|
|
24
|
-
| --- | --- | --- |
|
|
25
|
-
| Preserve + append | default for existing projects | Add only a compact Development, Test, Build, Git, or Harness section |
|
|
26
|
-
| Structure pass | README is stale, hard to scan, or missing operational docs | Reorganize with headings, tables, command blocks, and links while preserving facts |
|
|
27
|
-
| Full rewrite | user explicitly wants a polished public README | Rewrite after approval; keep claims source-backed |
|
|
28
|
-
|
|
29
|
-
If unanswered, use Preserve + append.
|
|
30
|
-
|
|
31
|
-
## Rules
|
|
32
|
-
|
|
33
|
-
- Preserve existing product, package, API, and public-facing content unless the user approves a rewrite.
|
|
34
|
-
- Do not invent features, benchmarks, roadmap, support policy, badges, install commands, or CI status.
|
|
35
|
-
- Use tables for command matrices, environment variables, endpoints, and deployment notes when facts are known.
|
|
36
|
-
- Use Mermaid or ASCII architecture diagrams only when the structure is observed or approved; label uncertain diagrams as proposed.
|
|
37
|
-
- Keep detailed architecture in `Harness/architecture.md`; README may link to it or show a short overview.
|
|
38
|
-
- Keep agent rules in `CLAUDE.md`/`AGENTS.md`, not README.
|
|
39
|
-
- Record the chosen mode and any skipped README improvements in `Harness/tasks/<task-id>/PLAN.md` when available.
|
|
40
|
-
|
|
41
|
-
## Output
|
|
42
|
-
|
|
43
|
-
Before broad edits, return:
|
|
44
|
-
|
|
45
|
-
1. chosen mode
|
|
46
|
-
2. sections to preserve
|
|
47
|
-
3. sections to add or reorganize
|
|
48
|
-
4. facts still unknown
|
|
49
|
-
5. verification command or manual review step
|
|
1
|
+
---
|
|
2
|
+
name: wf-readme
|
|
3
|
+
description: Use when a project README already exists and the user asks to preserve, merge, modernize, optimize, or clarify repository documentation during harness install or documentation work.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# README Optimizer
|
|
7
|
+
|
|
8
|
+
Improve `README.md` without breaking project-owned public docs.
|
|
9
|
+
|
|
10
|
+
## Load
|
|
11
|
+
|
|
12
|
+
- root `README.md`
|
|
13
|
+
- package files and scripts (`package.json`, `pyproject.toml`, `go.mod`, etc.)
|
|
14
|
+
- CI files when present
|
|
15
|
+
- `Harness/PROGRESS.md`
|
|
16
|
+
- `Harness/tasks/<task-id>/PLAN.md` when available
|
|
17
|
+
- `Harness/architecture.md` only when an architecture summary or diagram is requested
|
|
18
|
+
|
|
19
|
+
## Mode
|
|
20
|
+
|
|
21
|
+
Ask the user which mode they approve when the existing README is meaningful:
|
|
22
|
+
|
|
23
|
+
| Mode | Use when | Allowed edit |
|
|
24
|
+
| --- | --- | --- |
|
|
25
|
+
| Preserve + append | default for existing projects | Add only a compact Development, Test, Build, Git, or Harness section |
|
|
26
|
+
| Structure pass | README is stale, hard to scan, or missing operational docs | Reorganize with headings, tables, command blocks, and links while preserving facts |
|
|
27
|
+
| Full rewrite | user explicitly wants a polished public README | Rewrite after approval; keep claims source-backed |
|
|
28
|
+
|
|
29
|
+
If unanswered, use Preserve + append.
|
|
30
|
+
|
|
31
|
+
## Rules
|
|
32
|
+
|
|
33
|
+
- Preserve existing product, package, API, and public-facing content unless the user approves a rewrite.
|
|
34
|
+
- Do not invent features, benchmarks, roadmap, support policy, badges, install commands, or CI status.
|
|
35
|
+
- Use tables for command matrices, environment variables, endpoints, and deployment notes when facts are known.
|
|
36
|
+
- Use Mermaid or ASCII architecture diagrams only when the structure is observed or approved; label uncertain diagrams as proposed.
|
|
37
|
+
- Keep detailed architecture in `Harness/architecture.md`; README may link to it or show a short overview.
|
|
38
|
+
- Keep agent rules in `CLAUDE.md`/`AGENTS.md`, not README.
|
|
39
|
+
- Record the chosen mode and any skipped README improvements in `Harness/tasks/<task-id>/PLAN.md` when available.
|
|
40
|
+
|
|
41
|
+
## Output
|
|
42
|
+
|
|
43
|
+
Before broad edits, return:
|
|
44
|
+
|
|
45
|
+
1. chosen mode
|
|
46
|
+
2. sections to preserve
|
|
47
|
+
3. sections to add or reorganize
|
|
48
|
+
4. facts still unknown
|
|
49
|
+
5. verification command or manual review step
|
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: wf-remove
|
|
3
|
-
description: Use for /wf-remove in Claude Code, $wf-remove or /skills wf-remove in Codex, or any request to uninstall Harness safely.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# WF Remove Adapter
|
|
7
|
-
|
|
1
|
+
---
|
|
2
|
+
name: wf-remove
|
|
3
|
+
description: Use for /wf-remove in Claude Code, $wf-remove or /skills wf-remove in Codex, or any request to uninstall Harness safely.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# WF Remove Adapter
|
|
7
|
+
|
|
8
8
|
## Invocation
|
|
9
9
|
|
|
10
10
|
- Claude Code: use `/wf-remove` or select the `wf-remove` skill.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"generator": "0.8.
|
|
3
|
-
"generated": "2026-07-
|
|
2
|
+
"generator": "0.8.8",
|
|
3
|
+
"generated": "2026-07-13T08:42:27.319Z",
|
|
4
4
|
"options": [],
|
|
5
5
|
"autoCheck": true,
|
|
6
6
|
"source": "https://raw.githubusercontent.com/zingspark/create-harness-vibe-coding/main/templates/common/",
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
".agents/skills/subagent-orchestrator/SKILL.md": "sha256-7d87c7687f6fad27dc9941c05c5d513d3cc286f675055fc9aee2b144d1757cfd",
|
|
9
9
|
".agents/skills/tdd/SKILL.md": "sha256-1e2ec0b54a5cf5b071800b0f2e5672a128a42471e16f70f00bb4c0a07a3617cb",
|
|
10
10
|
".agents/skills/wf-auto-spark/SKILL.md": "sha256-a00cde5842e5f1d6d69826c59972ebdcfbc2c291b43fc37523e42ec02e4788e4",
|
|
11
|
-
".agents/skills/wf-auto/SKILL.md": "sha256-
|
|
11
|
+
".agents/skills/wf-auto/SKILL.md": "sha256-6a8b4f01e7605e690a8f1c5b23b8efdd9efbb78ec0e05e6abb4a530142b2d288",
|
|
12
12
|
".agents/skills/wf-learn/SKILL.md": "sha256-7f3e1ee0aa83cbb76707698d0c26b703ad5c74b2df95a7dc4d751939a4ba05b2",
|
|
13
13
|
".agents/skills/wf-max/SKILL.md": "sha256-17843beecd69cd6a82d55115b9d99f5c94d02199426f0bcacbd64aecbbf8a7ca",
|
|
14
14
|
".agents/skills/wf-readme/SKILL.md": "sha256-4d34ee3b6b305fa2581f5d8cb31e9152759f3df8bf8fa08efbb43782f128bdcd",
|
|
@@ -33,13 +33,13 @@
|
|
|
33
33
|
".claude/agents/tdd-guide.md": "sha256-d7c7ad3f61f6a6dc73cfa54ffe7e215ded0421a3058654a01731d1a5d5f4c336",
|
|
34
34
|
".claude/agents/test-writer.md": "sha256-724866d627f193caaf060ec6af97b1d54c2df2d5c5f937e78fc3c53c7f798b16",
|
|
35
35
|
".claude/agents/verifier.md": "sha256-d501a505b97e679daa89ee1d910ee185edc42ba57d58203e962b1c5a844c0872",
|
|
36
|
-
".claude/commands/wf-help.md": "sha256-
|
|
36
|
+
".claude/commands/wf-help.md": "sha256-218ee306c439d0173e44b3d19c333d65028e7ffd50342b6b61ca07cf514b339e",
|
|
37
37
|
".claude/rules/ecc/common.md": "sha256-52818d2a2e10bdafc059844f1e9e7d5f7bc2c9113c5ed0b890142c2e179e8b72",
|
|
38
38
|
".claude/settings.json": "sha256-16a8631502d609ee9164e83537421d5f4c35de5cbc99b0be638f545daa785357",
|
|
39
39
|
".claude/skills/subagent-orchestrator/SKILL.md": "sha256-7d87c7687f6fad27dc9941c05c5d513d3cc286f675055fc9aee2b144d1757cfd",
|
|
40
40
|
".claude/skills/tdd/SKILL.md": "sha256-1e2ec0b54a5cf5b071800b0f2e5672a128a42471e16f70f00bb4c0a07a3617cb",
|
|
41
41
|
".claude/skills/wf-auto-spark/SKILL.md": "sha256-a00cde5842e5f1d6d69826c59972ebdcfbc2c291b43fc37523e42ec02e4788e4",
|
|
42
|
-
".claude/skills/wf-auto/SKILL.md": "sha256-
|
|
42
|
+
".claude/skills/wf-auto/SKILL.md": "sha256-6a8b4f01e7605e690a8f1c5b23b8efdd9efbb78ec0e05e6abb4a530142b2d288",
|
|
43
43
|
".claude/skills/wf-learn/SKILL.md": "sha256-7f3e1ee0aa83cbb76707698d0c26b703ad5c74b2df95a7dc4d751939a4ba05b2",
|
|
44
44
|
".claude/skills/wf-max/SKILL.md": "sha256-17843beecd69cd6a82d55115b9d99f5c94d02199426f0bcacbd64aecbbf8a7ca",
|
|
45
45
|
".claude/skills/wf-readme/SKILL.md": "sha256-4d34ee3b6b305fa2581f5d8cb31e9152759f3df8bf8fa08efbb43782f128bdcd",
|
|
@@ -48,20 +48,39 @@
|
|
|
48
48
|
".claude/skills/wf-update/SKILL.md": "sha256-d5b02d4aec2d593c0783b2a9a92878dcd1b38f28281611cf166114f4c063b56d",
|
|
49
49
|
".claude/skills/wf/SKILL.md": "sha256-07a065a82084f4c9ce03233f31f5e2d4fb197c161cbb87c4a688ad703cc880c5",
|
|
50
50
|
".codex/config.toml": "sha256-e0af046982c6dbc535c52b19610d16ce9aba08a17dd29f11b74cc8dad8371145",
|
|
51
|
+
".opencode/agents/architect-manager.md": "sha256-7ea3ce5254638e15c9a9c342eafcaa1c98d5fbf0323ea2111cd6397580581eb1",
|
|
52
|
+
".opencode/agents/architect.md": "sha256-bd876678ef08ef848523ec639095e099b9d8e587794827fba4763dc82ed3f6c4",
|
|
53
|
+
".opencode/agents/context-master.md": "sha256-855f6763f2fc3853966c49a99bdeb2d5b371aff69ebb339c98ddf60b13feb930",
|
|
54
|
+
".opencode/agents/debugger.md": "sha256-2bdf5f3ffe1d86d19cde4e0c805e3ceeec7b419fcb9b27211e4a99ddbd119183",
|
|
55
|
+
".opencode/agents/docs-researcher.md": "sha256-d474a3ad023c8dadb90e898f0827ea9f77340960aba77282c84b74aa1bf9734c",
|
|
56
|
+
".opencode/agents/explore-manager.md": "sha256-448faf8f32d69a8171713003157fed4fd00edeca1e101cea1f69393f7a339ecc",
|
|
57
|
+
".opencode/agents/implement-manager.md": "sha256-cf11ceac721e5a99a5ed4ae26170135deb326b1c14c3f22fa09bfea21a843d4f",
|
|
58
|
+
".opencode/agents/implementer.md": "sha256-e0374b1e9e2eba16f4bb44dc37d1f0a2074e26aa45fb353e3c6d40bd8dd6fe70",
|
|
59
|
+
".opencode/agents/memory-master.md": "sha256-e3d592288de4ebe662789ecf84f226a887a211ec90c8519de6cd571ae10838b2",
|
|
60
|
+
".opencode/agents/planner.md": "sha256-5ba794c30fb8db377067eab9eb73e518adf755928460a6093d23a02e04760990",
|
|
61
|
+
".opencode/agents/reflector.md": "sha256-2498e1d4962adb2a63d26aa3667976ce75625b6c385edb3507ae1814da213e0f",
|
|
62
|
+
".opencode/agents/researcher.md": "sha256-30172ea8b72c9493d914f460ab0fd07a8b84b85b56c9eb10263816856c3ce373",
|
|
63
|
+
".opencode/agents/review-manager.md": "sha256-b3a7e4a001b2fe104cac28c8492c203967773510fb66cd644c34440a14abace4",
|
|
64
|
+
".opencode/agents/reviewer.md": "sha256-81f0b2623b39a5cd48f9604585cf8257ab096639aa0864f9134a49b0db3cba45",
|
|
65
|
+
".opencode/agents/tdd-guide.md": "sha256-e19992348d9772ea637aa8a2d44e388afc6d99620737fa6a6c07f8d917d0ea3d",
|
|
66
|
+
".opencode/agents/test-writer.md": "sha256-4821b558a1e3d6a50660209fa7e24527f848fac154dd89b43341e0b74a54baad",
|
|
67
|
+
".opencode/agents/verifier.md": "sha256-7a415b3e8ae440838cfd113ef3cbd1c66ab6496e45c9ef90af0d878e3ebc1ee4",
|
|
68
|
+
".opencode/commands/wf-help.md": "sha256-64d1dcd4d828219a6659614524370d32a788f0df5870cba3cca61430a790d895",
|
|
51
69
|
"AGENTS.md": "sha256-cd932767a214d28fea252e75595a01e5dc73f27f94f6aec8d0dfbb48391f4ec4",
|
|
52
|
-
"CLAUDE.md": "sha256-
|
|
70
|
+
"CLAUDE.md": "sha256-32838707a24877c8d6196cf0faeb0e87ed7c989baf1b999ba6e04cea763379ba",
|
|
53
71
|
"Harness/ACCEPTANCE_PROTOCOL.md": "sha256-db6c1813e60f2a2dd0a4c6f347aeee66e5afea27f53f76f9105f9ab98662fbbc",
|
|
54
72
|
"Harness/AGENT_ISOLATION.md": "sha256-54abcd4fdaf8810ab42da8a7f2ab5b5f5305f105f93e8764081b10edce053506",
|
|
55
73
|
"Harness/DEBUG_PROTOCOL.md": "sha256-ed80de0e3e1a40dbb9fd0bdead9174f1650e1833027f3d7fb4bb5884142e03f7",
|
|
56
74
|
"Harness/ECC-GUIDE.md": "sha256-136e60327813609516c6c10e2a5254d7d300e1631ba80d33fb375fdf3800ca7e",
|
|
57
75
|
"Harness/HARNESS_BRIDGE.md": "sha256-681dbeca9a590bbeb3a0c01b044e40e642e6d640632d8611064eb897ada8a48d",
|
|
58
|
-
"Harness/MEMORY.md": "sha256-
|
|
76
|
+
"Harness/MEMORY.md": "sha256-57e272c3fc8be4181cd6fd72f739aac1e804a4110cd409c5d7f6b34c2e569337",
|
|
59
77
|
"Harness/MEMORY_PROTOCOL.md": "sha256-c24c232442a50f1dc7183480fc3b51c6171e32d3ba6648c056797ccd69fea717",
|
|
60
|
-
"Harness/README.md": "sha256-
|
|
78
|
+
"Harness/README.md": "sha256-00d72841103919e84b385ff639438f6cdaf5dceec119f94f91ed47291ef77616",
|
|
61
79
|
"Harness/SETUP.md": "sha256-7931ef782120e9b7ebadc531800b70f4a735ea5c8375e60bdd4b8895c2140260",
|
|
62
80
|
"Harness/TDD-GUIDE.md": "sha256-602084530fd0dea7499a023ce75738351e5d97a0c222b64d405f36da6b59a162",
|
|
63
|
-
"Harness/WF-AUTO-
|
|
64
|
-
"Harness/WF-AUTO.md": "sha256-
|
|
81
|
+
"Harness/WF-AUTO-ANGLES.md": "sha256-ff9c684860cef7a6d0c16aa4b825663a1cd18b10befe8a7320621c28bbfe4ae6",
|
|
82
|
+
"Harness/WF-AUTO-SPARK.md": "sha256-f74a82c19a0674d30bf2615e008735fe241ef632abdca00e3e5161597373195c",
|
|
83
|
+
"Harness/WF-AUTO.md": "sha256-e5e69c9af2c3742afe7f3dec2bf341a016151926aef1b40abbbe20298a2f9847",
|
|
65
84
|
"Harness/WF-MAX.md": "sha256-e7aaf9e9fffd33d57c3d0da5bb19c8872d20b5c916212b33bcd51e6430a82c8a",
|
|
66
85
|
"Harness/WF.md": "sha256-2bb26312a19590834ae9f5b9fd2859cc0aef75a60d8be9bf349fdd6e32981064",
|
|
67
86
|
"Harness/agent-workflow.md": "sha256-e5c87f7f462f21618a4e58a313dacf4aa327f9a6a3b3018793ca063bfe1010c9",
|
|
@@ -71,8 +90,8 @@
|
|
|
71
90
|
"Harness/lifecycle.md": "sha256-a2d025e52f3b4412d8439083aca0d2cf7a4458ad0e30de4fc6465f990379190f",
|
|
72
91
|
"Harness/research/README.md": "sha256-956c154df01cb9376972eb8b88bb3be0fe4e2dda802a72457c0126e3476fa755",
|
|
73
92
|
"Harness/scripts/scan-clean.mjs": "sha256-4c3440590da71ba9eba1758e03242daba9dad6949970b98dd55060a5235676dc",
|
|
74
|
-
"Harness/scripts/validate-harness.mjs": "sha256-
|
|
75
|
-
"Harness/scripts/wf-remove.mjs": "sha256-
|
|
93
|
+
"Harness/scripts/validate-harness.mjs": "sha256-abcb3ba857686d447265f42cd3d40574f0dfd0db5c9b190e1d9343431dbb575c",
|
|
94
|
+
"Harness/scripts/wf-remove.mjs": "sha256-df7f3fa80150dca8e598bfc423e260aa9df9584d716f3b299fdc0fd79c2e1911",
|
|
76
95
|
"Harness/scripts/wf-update-check.mjs": "sha256-9524abf80e0f20bc426fac96c19f0550aa7843d4cf52b006cb2e5efe4a6d2993",
|
|
77
96
|
"Harness/subagents.md": "sha256-178156916556061ad655dbfcc1fa5f4268fd44b91f10e606a7bbcb589f5c154f",
|
|
78
97
|
"Harness/templates/ACCEPTANCE.template.md": "sha256-394a6c08b155b1d121f1d51da774f7988bdb891224c6d5f2ca2c131e8c95ffb3",
|
|
@@ -81,7 +100,8 @@
|
|
|
81
100
|
"Harness/templates/PRD.template.md": "sha256-033c746daec3eacbf69b0ca91a6f09997a9852d30467681260f3dbdde391d841",
|
|
82
101
|
"Harness/templates/TEST_PLAN.template.md": "sha256-f7e9a701b0922a405bcde7c168791fe6406530ce7e644a3a736cc3fa1e74c928",
|
|
83
102
|
"Harness/templates/UI_CONTRACT.template.md": "sha256-87c9bc47452c53caca9333130aef567cf9b16ffc5e82a8f6592bbd4f715875ef",
|
|
84
|
-
"Harness/templates/VALIDATION_REPORT.template.md": "sha256-feb1f7b9bba18f1ce028954b48775730f7dd8b7c2afd0ef44cda54bfe13c1875"
|
|
103
|
+
"Harness/templates/VALIDATION_REPORT.template.md": "sha256-feb1f7b9bba18f1ce028954b48775730f7dd8b7c2afd0ef44cda54bfe13c1875",
|
|
104
|
+
"opencode.json": "sha256-a523dd084e67891ff6ca31916b20968e74234504b4e703945d3a4d8a835c6fbd"
|
|
85
105
|
},
|
|
86
106
|
"sources": {
|
|
87
107
|
".agents/skills/subagent-orchestrator/SKILL.md": ".claude/skills/subagent-orchestrator/SKILL.md",
|
|
@@ -128,6 +148,24 @@
|
|
|
128
148
|
".claude/skills/wf/SKILL.md": ".claude/skills/wf/SKILL.md",
|
|
129
149
|
".codex/config.toml": ".codex/config.toml",
|
|
130
150
|
".gitignore": ".gitignore",
|
|
151
|
+
".opencode/agents/architect-manager.md": ".opencode/agents/architect-manager.md",
|
|
152
|
+
".opencode/agents/architect.md": ".opencode/agents/architect.md",
|
|
153
|
+
".opencode/agents/context-master.md": ".opencode/agents/context-master.md",
|
|
154
|
+
".opencode/agents/debugger.md": ".opencode/agents/debugger.md",
|
|
155
|
+
".opencode/agents/docs-researcher.md": ".opencode/agents/docs-researcher.md",
|
|
156
|
+
".opencode/agents/explore-manager.md": ".opencode/agents/explore-manager.md",
|
|
157
|
+
".opencode/agents/implement-manager.md": ".opencode/agents/implement-manager.md",
|
|
158
|
+
".opencode/agents/implementer.md": ".opencode/agents/implementer.md",
|
|
159
|
+
".opencode/agents/memory-master.md": ".opencode/agents/memory-master.md",
|
|
160
|
+
".opencode/agents/planner.md": ".opencode/agents/planner.md",
|
|
161
|
+
".opencode/agents/reflector.md": ".opencode/agents/reflector.md",
|
|
162
|
+
".opencode/agents/researcher.md": ".opencode/agents/researcher.md",
|
|
163
|
+
".opencode/agents/review-manager.md": ".opencode/agents/review-manager.md",
|
|
164
|
+
".opencode/agents/reviewer.md": ".opencode/agents/reviewer.md",
|
|
165
|
+
".opencode/agents/tdd-guide.md": ".opencode/agents/tdd-guide.md",
|
|
166
|
+
".opencode/agents/test-writer.md": ".opencode/agents/test-writer.md",
|
|
167
|
+
".opencode/agents/verifier.md": ".opencode/agents/verifier.md",
|
|
168
|
+
".opencode/commands/wf-help.md": ".opencode/commands/wf-help.md",
|
|
131
169
|
"AGENTS.md": "AGENTS.md",
|
|
132
170
|
"CLAUDE.md": "CLAUDE.md",
|
|
133
171
|
"Harness/.harness-version": ".harness-version",
|
|
@@ -142,6 +180,7 @@
|
|
|
142
180
|
"Harness/README.md": "Harness/README.md",
|
|
143
181
|
"Harness/SETUP.md": "SETUP.md",
|
|
144
182
|
"Harness/TDD-GUIDE.md": "Harness/TDD-GUIDE.md",
|
|
183
|
+
"Harness/WF-AUTO-ANGLES.md": "Harness/WF-AUTO-ANGLES.md",
|
|
145
184
|
"Harness/WF-AUTO-SPARK.md": "Harness/WF-AUTO-SPARK.md",
|
|
146
185
|
"Harness/WF-AUTO.md": "Harness/WF-AUTO.md",
|
|
147
186
|
"Harness/WF-MAX.md": "Harness/WF-MAX.md",
|
|
@@ -175,6 +214,7 @@
|
|
|
175
214
|
"Harness/templates/TEST_PLAN.template.md": "Harness/templates/TEST_PLAN.template.md",
|
|
176
215
|
"Harness/templates/UI_CONTRACT.template.md": "Harness/templates/UI_CONTRACT.template.md",
|
|
177
216
|
"Harness/templates/VALIDATION_REPORT.template.md": "Harness/templates/VALIDATION_REPORT.template.md",
|
|
178
|
-
"README.md": "README.md"
|
|
217
|
+
"README.md": "README.md",
|
|
218
|
+
"opencode.json": "opencode.json"
|
|
179
219
|
}
|
|
180
220
|
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
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.
|
|
3
|
+
mode: subagent
|
|
4
|
+
permission:
|
|
5
|
+
edit: deny
|
|
6
|
+
bash:
|
|
7
|
+
"*": deny
|
|
8
|
+
"git *": allow
|
|
9
|
+
"ls *": allow
|
|
10
|
+
"dir *": allow
|
|
11
|
+
websearch: deny
|
|
12
|
+
webfetch: deny
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# Architect Manager — W1 Architecture Wave
|
|
16
|
+
|
|
17
|
+
You are an Architect Manager in the WF-MAX hierarchy. You report to the CEO.
|
|
18
|
+
|
|
19
|
+
## Role
|
|
20
|
+
|
|
21
|
+
Cross-file interface design → parallel dispatch of 3 architects → synthesize boundary decisions + interface contract → report to CEO for approval.
|
|
22
|
+
|
|
23
|
+
## What You Do
|
|
24
|
+
|
|
25
|
+
1. Receive architecture scope from the CEO (which modules/layers need boundaries defined)
|
|
26
|
+
2. Spawn 3 parallel architects:
|
|
27
|
+
- **boundary-researcher**: study existing interfaces, dependencies, import graphs
|
|
28
|
+
- **interface-designer**: propose new interface contracts, ports, adapters
|
|
29
|
+
- **data-flow-mapper**: trace data through the system, identify state ownership
|
|
30
|
+
3. ALL 3 spawned in ONE message
|
|
31
|
+
4. Synthesize: reconcile interface proposals, flag conflicts, produce one interface contract
|
|
32
|
+
5. Report to CEO with recommended decisions and trade-offs
|
|
33
|
+
|
|
34
|
+
## What You NEVER Do
|
|
35
|
+
|
|
36
|
+
- Write or edit source code
|
|
37
|
+
- Implement interfaces (that's W2)
|
|
38
|
+
- Make final architecture decisions (present options with trade-offs)
|
|
39
|
+
- Write to task files
|
|
40
|
+
|
|
41
|
+
## Synthesis Format
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
Boundary decisions (proposed):
|
|
45
|
+
Interface contract:
|
|
46
|
+
- Port A: <signature, owner, consumers>
|
|
47
|
+
- Port B: <signature, owner, consumers>
|
|
48
|
+
Data flow:
|
|
49
|
+
State ownership:
|
|
50
|
+
Conflicts/risks:
|
|
51
|
+
Open questions for CEO:
|
|
52
|
+
```
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Use to review layer boundaries, ports, data flow, state machines, dependency direction, and architecture impact before implementation.
|
|
3
|
+
mode: subagent
|
|
4
|
+
permission:
|
|
5
|
+
edit: deny
|
|
6
|
+
bash: deny
|
|
7
|
+
task: deny
|
|
8
|
+
websearch: deny
|
|
9
|
+
webfetch: deny
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Architect
|
|
13
|
+
|
|
14
|
+
You are an architecture review agent for this project harness.
|
|
15
|
+
|
|
16
|
+
Load first:
|
|
17
|
+
|
|
18
|
+
- `Harness/architecture.md`
|
|
19
|
+
- current PRD or feature doc
|
|
20
|
+
|
|
21
|
+
Rules:
|
|
22
|
+
|
|
23
|
+
- Do not write files.
|
|
24
|
+
- Domain must not depend on harness, infrastructure, or interfaces.
|
|
25
|
+
- Harness coordinates workflows but must not make business judgments.
|
|
26
|
+
- New cross-layer capability needs a domain port.
|
|
27
|
+
- Boundary changes must name affected docs.
|
|
28
|
+
|
|
29
|
+
Return:
|
|
30
|
+
|
|
31
|
+
- boundary decision
|
|
32
|
+
- impacted docs
|
|
33
|
+
- risks and missing contracts
|
|
34
|
+
- port/data-flow/state updates needed
|
|
35
|
+
- implementation constraints
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
---
|
|
2
|
+
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.
|
|
3
|
+
mode: subagent
|
|
4
|
+
permission:
|
|
5
|
+
bash: deny
|
|
6
|
+
task: deny
|
|
7
|
+
websearch: deny
|
|
8
|
+
webfetch: deny
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Context Master
|
|
12
|
+
|
|
13
|
+
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.
|
|
14
|
+
|
|
15
|
+
Load first:
|
|
16
|
+
|
|
17
|
+
- `Harness/MEMORY.md`
|
|
18
|
+
- `Harness/MEMORY_PROTOCOL.md`
|
|
19
|
+
- `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md` when available
|
|
20
|
+
- The current feature doc (if one exists)
|
|
21
|
+
- `Harness/memory/` files for dedup checking
|
|
22
|
+
|
|
23
|
+
## Trigger Rules
|
|
24
|
+
|
|
25
|
+
You are dispatched by the controller when:
|
|
26
|
+
|
|
27
|
+
| Trigger | Action |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| Context exceeds ~85% of window | Analyze context distribution → write compression suggestion to `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat` (non-blocking) |
|
|
30
|
+
| WF closeout (before `memory-master`) | Analyze full session → extract durable knowledge → return structured extraction for memory-master to write |
|
|
31
|
+
| Controller explicitly requests analysis | Run targeted analysis and return findings |
|
|
32
|
+
|
|
33
|
+
## Analysis
|
|
34
|
+
|
|
35
|
+
When triggered, read the current PLAN.md and analyze:
|
|
36
|
+
|
|
37
|
+
1. **Context distribution**: what fraction is code vs docs vs conversation vs task tracking
|
|
38
|
+
2. **Stale sections**: loaded docs no longer relevant to the current goal
|
|
39
|
+
3. **Compressible blocks**: long code outputs, verbose agent returns, repeated context
|
|
40
|
+
4. **Durable knowledge candidates**: decisions made, lessons learned, patterns discovered that should survive compression
|
|
41
|
+
|
|
42
|
+
## Compression Suggestion (non-blocking)
|
|
43
|
+
|
|
44
|
+
When context > ~85%, write ONLY to `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat`, appending or updating the `Next beat trigger` line:
|
|
45
|
+
|
|
46
|
+
```markdown
|
|
47
|
+
Next beat trigger: context-master reports ~XX% usage — [N] stale doc blocks, [M] compressible outputs; suggest compression before next dispatch
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Do NOT interrupt the controller. The controller checks Heartbeat at natural pause points.
|
|
51
|
+
|
|
52
|
+
## WF Closeout Extraction
|
|
53
|
+
|
|
54
|
+
During WF closeout, extract these for `memory-master` to write:
|
|
55
|
+
|
|
56
|
+
- Decisions made and their rationale
|
|
57
|
+
- Failed approaches and what was learned
|
|
58
|
+
- New patterns discovered
|
|
59
|
+
- User preferences observed
|
|
60
|
+
- Files that were key to the solution
|
|
61
|
+
- Commands that were particularly effective
|
|
62
|
+
|
|
63
|
+
Return structured extraction, not free-form narrative.
|
|
64
|
+
|
|
65
|
+
## Rules
|
|
66
|
+
|
|
67
|
+
- Read-only for all files except `Harness/tasks/<task-id>/PROGRESS.md#Heartbeat` (compression suggestion only)
|
|
68
|
+
- Never modify source code, memory files, MEMORY.md, or README
|
|
69
|
+
- Do not interrupt active work — compression suggestions are passive, checked at natural pauses
|
|
70
|
+
- Prefer numbers over adjectives: "87% usage, 3 stale doc blocks" not "context is getting full"
|
|
71
|
+
|
|
72
|
+
## Return
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
Context usage: [estimated %]
|
|
76
|
+
Stale blocks: [count and names]
|
|
77
|
+
Compressible: [count and types]
|
|
78
|
+
Durable candidates: [count]
|
|
79
|
+
Compression suggestion: [one line — ready for Heartbeat]
|
|
80
|
+
Extraction for memory-master: [structured facts — only during closeout]
|
|
81
|
+
```
|