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
|
@@ -5,37 +5,38 @@
|
|
|
5
5
|
|
|
6
6
|
## Agents (Sub-agents)
|
|
7
7
|
|
|
8
|
-
- [researcher](../.claude/agents/researcher.md)
|
|
9
|
-
- [docs-researcher](../.claude/agents/docs-researcher.md)
|
|
10
|
-
- [planner](../.claude/agents/planner.md)
|
|
11
|
-
- [architect](../.claude/agents/architect.md)
|
|
12
|
-
- [test-writer](../.claude/agents/test-writer.md)
|
|
8
|
+
- [researcher](../.claude/agents/researcher.md) - product, market, open-source, dependency, pricing, policy, and ecosystem research.
|
|
9
|
+
- [docs-researcher](../.claude/agents/docs-researcher.md) - official docs, API, SDK, config, limits, errors, and examples verification.
|
|
10
|
+
- [planner](../.claude/agents/planner.md) - task split, dependencies, write sets, and dispatch table.
|
|
11
|
+
- [architect](../.claude/agents/architect.md) - boundaries, ports, data-flow, and state impact.
|
|
12
|
+
- [test-writer](../.claude/agents/test-writer.md) - failing tests or manual verification before implementation.
|
|
13
13
|
- [tdd-guide](../.claude/agents/tdd-guide.md) - AC-linked RED tests, browser UI acceptance, and Playwright/CDP evidence before implementation.
|
|
14
|
-
- [implementer](../.claude/agents/implementer.md)
|
|
15
|
-
- [debugger](../.claude/agents/debugger.md)
|
|
16
|
-
- [reviewer](../.claude/agents/reviewer.md)
|
|
17
|
-
- [verifier](../.claude/agents/verifier.md)
|
|
18
|
-
- [
|
|
19
|
-
- [
|
|
20
|
-
- [
|
|
21
|
-
- [
|
|
22
|
-
- [
|
|
23
|
-
- [
|
|
14
|
+
- [implementer](../.claude/agents/implementer.md) - bounded implementation inside declared write set.
|
|
15
|
+
- [debugger](../.claude/agents/debugger.md) - smallest fix for a reproduced failure.
|
|
16
|
+
- [reviewer](../.claude/agents/reviewer.md) - read-only spec/AC and code/architecture/test review.
|
|
17
|
+
- [verifier](../.claude/agents/verifier.md) - verification commands and AC evidence matrix.
|
|
18
|
+
- [reflector](../.claude/agents/reflector.md) - closeout synthesis, contradiction check, and final acceptance gate verdict.
|
|
19
|
+
- [memory-master](../.claude/agents/memory-master.md) - memory writing, dedup, consolidation, and cross-project knowledge extraction.
|
|
20
|
+
- [context-master](../.claude/agents/context-master.md) - context analysis, compression alerts, and session knowledge extraction for memory-master.
|
|
21
|
+
- [explore-manager](../.claude/agents/explore-manager.md) - WF-MAX W0 exploration: spawn 5-10 read-only researchers, synthesize, report to CEO.
|
|
22
|
+
- [architect-manager](../.claude/agents/architect-manager.md) - WF-MAX W1 architecture: spawn 3 architects, synthesize interface contracts, report to CEO.
|
|
23
|
+
- [implement-manager](../.claude/agents/implement-manager.md) - WF-MAX W2 implementation: spawn 5-7 implementers (one file_claim each), merge, report to CEO.
|
|
24
|
+
- [review-manager](../.claude/agents/review-manager.md) - WF-MAX W2R review: spawn 3-4 reviewers (spec/code/security/perf), deduplicate, classify severity, report to CEO.
|
|
24
25
|
|
|
25
26
|
Stack-specific agents can be added after the product shape is known.
|
|
26
27
|
|
|
27
28
|
## Skills (Workflows)
|
|
28
29
|
|
|
29
|
-
- [WF Mode](WF.md)
|
|
30
|
-
- [wf](../.claude/skills/wf/SKILL.md)
|
|
31
|
-
- [subagent-orchestrator](../.claude/skills/subagent-orchestrator/SKILL.md)
|
|
32
|
-
- [wf-readme](../.claude/skills/wf-readme/SKILL.md)
|
|
33
|
-
- [wf-review](../.claude/skills/wf-review/SKILL.md)
|
|
34
|
-
- [wf-update](../.claude/skills/wf-update/SKILL.md)
|
|
35
|
-
- [wf-learn](../.claude/skills/wf-learn/SKILL.md)
|
|
36
|
-
- [wf-max](../.claude/skills/wf-max/SKILL.md)
|
|
37
|
-
- [wf-auto](../.claude/skills/wf-auto/SKILL.md) - perpetual auto-optimization:
|
|
38
|
-
- [wf-auto-spark](../.claude/skills/wf-auto-spark/SKILL.md)
|
|
30
|
+
- [WF Mode](WF.md) - complete role chain: plan, research/docs, architecture, test, implement, validation, cross-review, reflector, acceptance.
|
|
31
|
+
- [wf](../.claude/skills/wf/SKILL.md) - Claude Code WF skill command; mirrored for Codex at `../.agents/skills/wf/SKILL.md`.
|
|
32
|
+
- [subagent-orchestrator](../.claude/skills/subagent-orchestrator/SKILL.md) - controller-led subagent orchestration, parallel read-only passes, review gates, and recovery handoffs.
|
|
33
|
+
- [wf-readme](../.claude/skills/wf-readme/SKILL.md) - README preservation, append-only development sections, structured tables, and approved architecture diagrams.
|
|
34
|
+
- [wf-review](../.claude/skills/wf-review/SKILL.md) - cross-model peer review: invoke the other agent CLI (Codex/Claude) for independent review.
|
|
35
|
+
- [wf-update](../.claude/skills/wf-update/SKILL.md) - GitHub-based incremental harness update, checksum comparison, and safe in-place updates.
|
|
36
|
+
- [wf-learn](../.claude/skills/wf-learn/SKILL.md) - force memory learning cycle: context-master -> memory-master -> project + global memory.
|
|
37
|
+
- [wf-max](../.claude/skills/wf-max/SKILL.md) - WF strict superset: complete role chain plus maximum parallelism, current runtime subagents first, cross-CLI overflow when available.
|
|
38
|
+
- [wf-auto](../.claude/skills/wf-auto/SKILL.md) - perpetual adaptive auto-optimization: evidence-selected probes, dynamic obligations, intent checkpoints, evidence ledger.
|
|
39
|
+
- [wf-auto-spark](../.claude/skills/wf-auto-spark/SKILL.md) - perpetual inspiration mode: external spark search, long-term roadmap with staged milestones, <=50% deviation guard.
|
|
39
40
|
- [tdd](../.claude/skills/tdd/SKILL.md) - acceptance-driven TDD: AC-linked RED tests, real UI clicks for browser-visible behavior, Playwright/CDP evidence, and configured coverage gate.
|
|
40
41
|
- [wf-remove](../.claude/skills/wf-remove/SKILL.md) - safely remove Harness framework files (SAFE/MODIFIED/USER classes), auto-prune empty directories, backup option.
|
|
41
42
|
|
|
@@ -47,15 +48,11 @@ Codex repo-skill mirrors live under `../.agents/skills/` with the same skill nam
|
|
|
47
48
|
|
|
48
49
|
Stack-specific skills can be added after the product shape is known.
|
|
49
50
|
|
|
50
|
-
- [browser-e2e](workflows/browser-e2e.md)
|
|
51
|
-
|
|
52
|
-
Stack-specific skills can be added after the product shape is known.
|
|
53
|
-
|
|
54
51
|
## Rules (Harness Constraints)
|
|
55
52
|
|
|
56
53
|
Located under `.claude/rules/ecc/`, auto-loaded by the CC engine:
|
|
57
54
|
|
|
58
|
-
- [common.md](../.claude/rules/ecc/common.md)
|
|
55
|
+
- [common.md](../.claude/rules/ecc/common.md) - universal harness constraints for context loading, verification, subagents, and security (alwaysApply: true)
|
|
59
56
|
- Language-specific rules pending Claude Code initialization (e.g. python.md, typescript.md, etc.)
|
|
60
57
|
|
|
61
58
|
## Harness (Runtime)
|
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
# {{projectName}}
|
|
2
|
-
|
|
3
|
-
Project development notes belong here.
|
|
4
|
-
|
|
5
|
-
## Development Commands
|
|
6
|
-
|
|
7
|
-
Record the real project commands after bootstrap:
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
# Install dependencies
|
|
11
|
-
# e.g. npm install
|
|
12
|
-
|
|
13
|
-
# Run locally
|
|
14
|
-
# e.g. npm run dev
|
|
15
|
-
|
|
16
|
-
# Run tests
|
|
17
|
-
# e.g. npm test
|
|
18
|
-
|
|
19
|
-
# Build
|
|
20
|
-
# e.g. npm run build
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
Replace the examples with the real commands discovered from this project. If a command is unknown, record the open question in `Harness/tasks/<task-id>/PROGRESS.md`.
|
|
24
|
-
|
|
25
|
-
## Git And Release Notes
|
|
26
|
-
|
|
27
|
-
- Keep branch, commit, pull request, CI, and release conventions in this README.
|
|
28
|
-
- Do not place build scripts, git policy, or project maintenance instructions in `CLAUDE.md`.
|
|
29
|
-
- Keep code architecture notes in `Harness/architecture.md` or feature docs.
|
|
30
|
-
- For README improvements, use `.claude/skills/wf-readme/SKILL.md`; preserve public docs unless a rewrite is approved.
|
|
31
|
-
|
|
1
|
+
# {{projectName}}
|
|
2
|
+
|
|
3
|
+
Project development notes belong here.
|
|
4
|
+
|
|
5
|
+
## Development Commands
|
|
6
|
+
|
|
7
|
+
Record the real project commands after bootstrap:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
# Install dependencies
|
|
11
|
+
# e.g. npm install
|
|
12
|
+
|
|
13
|
+
# Run locally
|
|
14
|
+
# e.g. npm run dev
|
|
15
|
+
|
|
16
|
+
# Run tests
|
|
17
|
+
# e.g. npm test
|
|
18
|
+
|
|
19
|
+
# Build
|
|
20
|
+
# e.g. npm run build
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Replace the examples with the real commands discovered from this project. If a command is unknown, record the open question in `Harness/tasks/<task-id>/PROGRESS.md`.
|
|
24
|
+
|
|
25
|
+
## Git And Release Notes
|
|
26
|
+
|
|
27
|
+
- Keep branch, commit, pull request, CI, and release conventions in this README.
|
|
28
|
+
- Do not place build scripts, git policy, or project maintenance instructions in `CLAUDE.md`.
|
|
29
|
+
- Keep code architecture notes in `Harness/architecture.md` or feature docs.
|
|
30
|
+
- For README improvements, use `.claude/skills/wf-readme/SKILL.md`; preserve public docs unless a rewrite is approved.
|
|
31
|
+
|
|
32
32
|
## Harness
|
|
33
33
|
|
|
34
34
|
The agentic engineering harness lives in `Harness/`.
|
|
35
|
-
|
|
36
|
-
- Follow `Harness/SETUP.md` before normal work while it exists.
|
|
37
|
-
- Start at `Harness/README.md`.
|
|
38
|
-
- Load memory and resource registrations from `Harness/MEMORY.md`.
|
|
39
|
-
- Track active work in `Harness/PROGRESS.md` and `Harness/tasks/<task-id>/PROGRESS.md`.
|
|
35
|
+
|
|
36
|
+
- Follow `Harness/SETUP.md` before normal work while it exists.
|
|
37
|
+
- Start at `Harness/README.md`.
|
|
38
|
+
- Load memory and resource registrations from `Harness/MEMORY.md`.
|
|
39
|
+
- Track active work in `Harness/PROGRESS.md` and `Harness/tasks/<task-id>/PROGRESS.md`.
|
|
40
40
|
- Use `Harness/WF.md` for long, difficult, multi-agent work.
|
|
41
41
|
- Claude Code: invoke the `wf` skill with `/wf`.
|
|
42
42
|
- Codex: invoke the `wf` skill with `$wf` or `/skills`.
|
|
@@ -138,7 +138,7 @@ The harness validator checks for specific structural invariants. When comparing
|
|
|
138
138
|
| `Harness/MEMORY.md` | All common agents registered under `## Agents`; all common harness skills registered under `## Skills`; all 3 `Harness/memory/` files registered under `## Memory Folder`; `Harness/memory/` folder usage guidance; `Project Resource Index` in title |
|
|
139
139
|
| `.claude/rules/ecc/common.md` | Required project-local universal rules. Keep it even when global `~/.claude/rules/ecc/common/` exists; that directory and this file have different scopes. Required sections: `## Context` with the durable communication invariant (`project files are the only durable communication channel`); `## Memory` with three reflection file entries; `## Security` |
|
|
140
140
|
| `Harness/README.md` | `## Keyword Routing` heading; `## Load By Task` table with at minimum the rows: "Need WF mode", "Adding harness to existing project", "Need implementation plan", "Need parallel agents", "Need subagents", "Need durable memory or reflection"; WF routing keywords include `/wf`, `wf mode`, `workflow mode`, and `wk mode`; explicit WF/WK output says subagent docs load immediately; `## Doc Map` with `memory/` and `subagents.md` entries; the durable communication invariant text; `Harness/README.md is the primary router` |
|
|
141
|
-
| `Harness/WF.md` | `WF mode requires
|
|
141
|
+
| `Harness/WF.md` | `WF mode requires the complete role chain by default`; explicit `/wf`, `$wf`, `wf mode`, `workflow mode`, or `wk mode` requires plan, research/docs, architecture, test, implement, validation, cross-review, reflector, and acceptance before closeout; `collaboration decision tree`; `Heartbeat Protocol` |
|
|
142
142
|
| `Harness/extension.md` | `## Non-Invasive Extension Rules` section with the "Preserve existing" rule; `## Agent Contract` section; `## Registration` section |
|
|
143
143
|
| `Harness/dispatch.md` | The durable communication invariant; registered common agent entries; `## Handoff Format` heading |
|
|
144
144
|
| `Harness/context-loading.md` | The durable communication invariant; `Harness/README.md is the primary router`; all 12 subagent context packs (Explorer Pass, Planner, Researcher, Docs Researcher, Architect, Test Writer, Implementer, Reviewer, Debugger, Verifier, Memory Master, Context Master) |
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# Agent Lessons And Patterns
|
|
2
|
-
|
|
3
|
-
Purpose: record reusable lessons from review, debugging, validation, and handoff loops.
|
|
4
|
-
|
|
5
|
-
Write here when:
|
|
6
|
-
- A review/debug loop reveals a reusable prevention pattern.
|
|
7
|
-
- A validation failure exposes a missing regression check.
|
|
8
|
-
- A handoff, dispatch, or context-loading pattern should be repeated or avoided.
|
|
9
|
-
|
|
10
|
-
Entry format, newest first:
|
|
11
|
-
|
|
12
|
-
```markdown
|
|
13
|
-
## YYYY-MM-DD - Short Lesson Name
|
|
14
|
-
|
|
15
|
-
- Lesson: the reusable pattern.
|
|
16
|
-
- Source: review finding, debug loop, failed verification, or handoff.
|
|
17
|
-
- Apply when: the task shape or files where this matters.
|
|
18
|
-
- Regression guard: test, validator check, docs update, or manual evidence to keep it from recurring.
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Keep entries lightweight and actionable. Avoid secrets and speculative lessons.
|
|
1
|
+
# Agent Lessons And Patterns
|
|
2
|
+
|
|
3
|
+
Purpose: record reusable lessons from review, debugging, validation, and handoff loops.
|
|
4
|
+
|
|
5
|
+
Write here when:
|
|
6
|
+
- A review/debug loop reveals a reusable prevention pattern.
|
|
7
|
+
- A validation failure exposes a missing regression check.
|
|
8
|
+
- A handoff, dispatch, or context-loading pattern should be repeated or avoided.
|
|
9
|
+
|
|
10
|
+
Entry format, newest first:
|
|
11
|
+
|
|
12
|
+
```markdown
|
|
13
|
+
## YYYY-MM-DD - Short Lesson Name
|
|
14
|
+
|
|
15
|
+
- Lesson: the reusable pattern.
|
|
16
|
+
- Source: review finding, debug loop, failed verification, or handoff.
|
|
17
|
+
- Apply when: the task shape or files where this matters.
|
|
18
|
+
- Regression guard: test, validator check, docs update, or manual evidence to keep it from recurring.
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Keep entries lightweight and actionable. Avoid secrets and speculative lessons.
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# Tool Usage Reflections
|
|
2
|
-
|
|
3
|
-
Purpose: record repeated tool failures, better command patterns, and environment-specific fixes.
|
|
4
|
-
|
|
5
|
-
Write here when:
|
|
6
|
-
- The same tool/use pattern fails 3+ times in one task or across repeated tasks.
|
|
7
|
-
- A more reliable command pattern replaces a brittle one.
|
|
8
|
-
- The environment needs a durable fix, flag, path rule, shell syntax, or startup sequence.
|
|
9
|
-
|
|
10
|
-
Entry format, newest first:
|
|
11
|
-
|
|
12
|
-
```markdown
|
|
13
|
-
## YYYY-MM-DD - Short Pattern Name
|
|
14
|
-
|
|
15
|
-
- Trigger: what failed or repeated.
|
|
16
|
-
- Better pattern: the command, tool usage, or sequence to use next time.
|
|
17
|
-
- Evidence: command output summary, error text, or affected environment.
|
|
18
|
-
- Scope: when this applies and when it does not.
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Keep entries concise. Do not record secrets, credentials, private tokens, or one-off noise.
|
|
1
|
+
# Tool Usage Reflections
|
|
2
|
+
|
|
3
|
+
Purpose: record repeated tool failures, better command patterns, and environment-specific fixes.
|
|
4
|
+
|
|
5
|
+
Write here when:
|
|
6
|
+
- The same tool/use pattern fails 3+ times in one task or across repeated tasks.
|
|
7
|
+
- A more reliable command pattern replaces a brittle one.
|
|
8
|
+
- The environment needs a durable fix, flag, path rule, shell syntax, or startup sequence.
|
|
9
|
+
|
|
10
|
+
Entry format, newest first:
|
|
11
|
+
|
|
12
|
+
```markdown
|
|
13
|
+
## YYYY-MM-DD - Short Pattern Name
|
|
14
|
+
|
|
15
|
+
- Trigger: what failed or repeated.
|
|
16
|
+
- Better pattern: the command, tool usage, or sequence to use next time.
|
|
17
|
+
- Evidence: command output summary, error text, or affected environment.
|
|
18
|
+
- Scope: when this applies and when it does not.
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Keep entries concise. Do not record secrets, credentials, private tokens, or one-off noise.
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
# User Corrections And Preferences
|
|
2
|
-
|
|
3
|
-
Purpose: record repeated user corrections, durable preferences, and common-sense course corrections.
|
|
4
|
-
|
|
5
|
-
Write here when:
|
|
6
|
-
- The user says "remember", "never", "next time", "always", or "I prefer".
|
|
7
|
-
- The user corrects the same assumption/pattern 2+ times.
|
|
8
|
-
- A correction changes how future work should be scoped, explained, verified, or handed off.
|
|
9
|
-
|
|
10
|
-
Entry format, newest first:
|
|
11
|
-
|
|
12
|
-
```markdown
|
|
13
|
-
## YYYY-MM-DD - Short Preference Name
|
|
14
|
-
|
|
15
|
-
- Correction/preference: the durable instruction.
|
|
16
|
-
- Trigger: what prompted the correction.
|
|
17
|
-
- Apply when: future contexts where this should guide behavior.
|
|
18
|
-
- Avoid: contexts where this should not be over-applied.
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Do not record ordinary chat. If the preference is ambiguous, ask before writing it. Never store secrets.
|
|
1
|
+
# User Corrections And Preferences
|
|
2
|
+
|
|
3
|
+
Purpose: record repeated user corrections, durable preferences, and common-sense course corrections.
|
|
4
|
+
|
|
5
|
+
Write here when:
|
|
6
|
+
- The user says "remember", "never", "next time", "always", or "I prefer".
|
|
7
|
+
- The user corrects the same assumption/pattern 2+ times.
|
|
8
|
+
- A correction changes how future work should be scoped, explained, verified, or handed off.
|
|
9
|
+
|
|
10
|
+
Entry format, newest first:
|
|
11
|
+
|
|
12
|
+
```markdown
|
|
13
|
+
## YYYY-MM-DD - Short Preference Name
|
|
14
|
+
|
|
15
|
+
- Correction/preference: the durable instruction.
|
|
16
|
+
- Trigger: what prompted the correction.
|
|
17
|
+
- Apply when: future contexts where this should guide behavior.
|
|
18
|
+
- Avoid: contexts where this should not be over-applied.
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Do not record ordinary chat. If the preference is ambiguous, ask before writing it. Never store secrets.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://opencode.ai/config.json",
|
|
3
|
+
"instructions": [".claude/rules/ecc/common.md"],
|
|
4
|
+
"permission": {
|
|
5
|
+
"bash": {
|
|
6
|
+
"*": "ask",
|
|
7
|
+
"rm -rf *": "deny",
|
|
8
|
+
"sudo *": "deny",
|
|
9
|
+
"curl *": "deny",
|
|
10
|
+
"wget *": "deny"
|
|
11
|
+
},
|
|
12
|
+
"read": {
|
|
13
|
+
"**/.env*": "deny",
|
|
14
|
+
"**/secrets/**": "deny",
|
|
15
|
+
"**/*.key": "deny",
|
|
16
|
+
"**/*.pem": "deny"
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
}
|