mustard-claude 3.1.34 → 3.1.36
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/dist/commands/update.js +5 -1
- package/dist/commands/update.js.map +1 -1
- package/package.json +1 -1
- package/templates/CLAUDE.md +5 -109
- package/templates/commands/mustard/bugfix/SKILL.md +0 -1
- package/templates/commands/mustard/feature/SKILL.md +63 -321
- package/templates/commands/mustard/git/SKILL.md +25 -545
- package/templates/commands/mustard/knowledge/SKILL.md +8 -75
- package/templates/commands/mustard/resume/SKILL.md +22 -154
- package/templates/commands/mustard/scan/SKILL.md +17 -380
- package/templates/commands/mustard/scan-format/SKILL.md +6 -182
- package/templates/commands/mustard/task/SKILL.md +3 -138
- package/templates/hooks/__tests__/exec-rewave-check.test.js +203 -0
- package/templates/hooks/__tests__/scope-decompose.test.js +99 -0
- package/templates/hooks/__tests__/size-gates.test.js +279 -0
- package/templates/hooks/skill-size-gate.js +156 -0
- package/templates/hooks/spec-size-gate.js +149 -0
- package/templates/pipeline-config.md +102 -0
- package/templates/refs/feature/ac-cross-shell.md +15 -0
- package/templates/refs/feature/existence-gate.md +55 -0
- package/templates/refs/feature/spec-hygiene.md +22 -0
- package/templates/refs/feature/wave-decomposition.md +104 -0
- package/templates/refs/git/git-flow.md +111 -0
- package/templates/refs/git/merge-protocol.md +276 -0
- package/templates/refs/git/submodule-rules.md +106 -0
- package/templates/refs/knowledge/evolve-report.md +100 -0
- package/templates/refs/resume/fix-loop-wave.md +114 -0
- package/templates/refs/resume/handoff-summary.md +54 -0
- package/templates/refs/scan/agent-recipes.md +57 -0
- package/templates/refs/scan/evidence-rules.md +119 -0
- package/templates/refs/scan/scan-protocol.md +366 -0
- package/templates/refs/scan/skill-generation.md +143 -0
- package/templates/refs/task/task-prompts.md +144 -0
- package/templates/scripts/exec-rewave-check.js +304 -0
- package/templates/scripts/scope-decompose.js +3 -11
- package/templates/scripts/skill-validate.js +484 -6
- package/templates/settings.json +29 -0
- package/templates/skills/commit-workflow/SKILL.md +1 -1
- package/templates/skills/karpathy-guidelines/SKILL.md +76 -0
- package/templates/skills/senior-architect/SKILL.md +5 -43
- package/templates/skills/senior-architect/references/workflow-commands.md +53 -0
package/dist/commands/update.js
CHANGED
|
@@ -65,7 +65,7 @@ export async function updateCommand(options) {
|
|
|
65
65
|
backupSpinner.succeed('Backup created');
|
|
66
66
|
}
|
|
67
67
|
// Delete core folders
|
|
68
|
-
const foldersToDelete = ['commands/mustard', 'hooks', 'skills', 'scripts'];
|
|
68
|
+
const foldersToDelete = ['commands/mustard', 'hooks', 'skills', 'scripts', 'refs'];
|
|
69
69
|
const cleanSpinner = ora('Cleaning...').start();
|
|
70
70
|
for (const folder of foldersToDelete) {
|
|
71
71
|
const p = join(claudePath, folder);
|
|
@@ -84,6 +84,10 @@ export async function updateCommand(options) {
|
|
|
84
84
|
total += await copyDir(join(templatesDir, 'skills'), join(claudePath, 'skills'));
|
|
85
85
|
// scripts/
|
|
86
86
|
total += await copyDir(join(templatesDir, 'scripts'), join(claudePath, 'scripts'));
|
|
87
|
+
// refs/ (command progressive-disclosure sidecars — outside commands/ to avoid auto-registration as sub-commands)
|
|
88
|
+
if (existsSync(join(templatesDir, 'refs'))) {
|
|
89
|
+
total += await copyDir(join(templatesDir, 'refs'), join(claudePath, 'refs'));
|
|
90
|
+
}
|
|
87
91
|
// settings.json
|
|
88
92
|
await copyFile(join(templatesDir, 'settings.json'), join(claudePath, 'settings.json'));
|
|
89
93
|
total++;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/templates/CLAUDE.md
CHANGED
|
@@ -82,6 +82,9 @@ node scripts/skill-validate.js --json
|
|
|
82
82
|
|
|
83
83
|
## Recommended Skills
|
|
84
84
|
|
|
85
|
+
**Directive:** Before first `Edit`/`Write` in code-alteration tasks (implement/refactor/fix/bugfix/review), agent MUST invoke `Skill(karpathy-guidelines)` once. Content stays cached for the rest of the agent's context.
|
|
86
|
+
|
|
87
|
+
- `karpathy-guidelines` — 4 princípios anti-slop (carrega em toda alteração de código)
|
|
85
88
|
- `templates-hook-protocol` — Hook stdin/stdout JSON protocol
|
|
86
89
|
- `templates-settings-wiring` — settings.json hook registration
|
|
87
90
|
- `templates-sync-detect` — Subproject discovery and role detection
|
|
@@ -90,114 +93,7 @@ node scripts/skill-validate.js --json
|
|
|
90
93
|
|
|
91
94
|
## Token Economy
|
|
92
95
|
|
|
93
|
-
RTK (Rust Token Killer)
|
|
94
|
-
|
|
95
|
-
- **Hook**: `hooks/rtk-rewrite.js` — transparent, fail-open
|
|
96
|
-
- **Analytics**: `rtk gain` — view token savings; `metrics-report.js` integrates RTK data
|
|
97
|
-
- **Statusline**: Shows real-time savings when RTK is active
|
|
98
|
-
- If RTK is not installed, the hook silently passes through (zero impact)
|
|
99
|
-
|
|
100
|
-
### Cost Optimization Hooks
|
|
101
|
-
|
|
102
|
-
Three enforcement hooks reduce token waste across all projects:
|
|
103
|
-
|
|
104
|
-
| Hook | Matcher | Mode | Effect |
|
|
105
|
-
|------|---------|------|--------|
|
|
106
|
-
| `bash-native-redirect.js` | Bash | strict/warn/off | Blocks grep/ls/cat/head/tail/find → suggests Grep/Glob/Read tools. Warns on piped commands too. |
|
|
107
|
-
| `model-routing-gate.js` | Task | strict/warn/off | Blocks model upgrades vs routing table. Advises when no model specified. |
|
|
108
|
-
| `tool-use-counter.js` | .* + SubagentStart/Stop | hard | Caps Explore agents at 15 tool uses (warn at 12) |
|
|
109
|
-
| `recommended-skills-audit.js` | Task | advisory | Conta skills listados no prompt; warn se >10; não bloqueia |
|
|
110
|
-
|
|
111
|
-
**Environment overrides:**
|
|
112
|
-
- `MUSTARD_BASH_REDIRECT_MODE=warn|strict|off` (default: strict)
|
|
113
|
-
- `MUSTARD_MODEL_GATE_MODE=warn|strict|off` (default: strict)
|
|
114
|
-
- All hooks can be disabled via `MUSTARD_DISABLED_HOOKS=bash-native-redirect,model-routing-gate,tool-use-counter`
|
|
115
|
-
|
|
116
|
-
### Enforcement Hooks
|
|
117
|
-
|
|
118
|
-
**Strict gates** (Wave 9-10): block on real failure
|
|
119
|
-
|
|
120
|
-
| Hook | Matcher | Mode env | Blocks on |
|
|
121
|
-
|------|---------|----------|-----------|
|
|
122
|
-
| `close-gate.js` | Write/Edit `.pipeline-states/*.json` with phase=CLOSE | `MUSTARD_CLOSE_GATE_MODE` (default strict) | build/type/lint/test fail |
|
|
123
|
-
| `close-gate.js` (Wave 10 QA) | same trigger | `MUSTARD_QA_GATE_MODE` (default strict) | no qa.result or qa.result=fail |
|
|
124
|
-
| `review-gate.js` | Bash `git commit` | `MUSTARD_COMMIT_GATE_MODE` (default warn) | secrets staged or build broken |
|
|
125
|
-
|
|
126
|
-
Bug in the hook itself (I/O error, timeout outside child process) still fails open — only real sensor failures block.
|
|
127
|
-
|
|
128
|
-
**Anti-slope hooks** (Wave 11): default warn, opt-in strict
|
|
129
|
-
|
|
130
|
-
| Hook | Mode env | Heuristic |
|
|
131
|
-
|---|---|---|
|
|
132
|
-
| `duplication-check.js` | `MUSTARD_DUPLICATION_MODE` (default warn) | Levenshtein ≥0.85 vs entity-registry |
|
|
133
|
-
| `convention-check.js` | `MUSTARD_CONVENTION_MODE` (default warn) | Rules derived from knowledge.json conf≥0.8 |
|
|
134
|
-
| `regression-guard.js` | `MUSTARD_REGRESSION_MODE` (default **off**) | File-to-test heuristic + re-run |
|
|
135
|
-
|
|
136
|
-
All anti-slope hooks fail-open on bug. Only real signal triggers warn/block.
|
|
137
|
-
|
|
138
|
-
**Downgrade in emergencies:**
|
|
139
|
-
- `MUSTARD_CLOSE_GATE_MODE=warn` — prints warning, allows
|
|
140
|
-
- `MUSTARD_CLOSE_GATE_MODE=off` — skips check
|
|
141
|
-
- `MUSTARD_QA_GATE_MODE=warn` — prints warning when QA absent/fail, allows
|
|
142
|
-
- `MUSTARD_QA_GATE_MODE=off` — skips QA check entirely
|
|
143
|
-
- `MUSTARD_COMMIT_GATE_MODE=strict` — upgrades commit gate to blocking
|
|
144
|
-
- `MUSTARD_COMMIT_GATE_MODE=off` — skips commit gate entirely
|
|
145
|
-
|
|
146
|
-
## Shared Memory Architecture (Wave 4)
|
|
147
|
-
|
|
148
|
-
### Truth source
|
|
149
|
-
`.claude/.harness/events.jsonl` — append-only NDJSON log. All hooks emit events here.
|
|
150
|
-
|
|
151
|
-
### Persistent projections
|
|
152
|
-
| File | Writer | Purpose |
|
|
153
|
-
|------|--------|---------|
|
|
154
|
-
| `knowledge.json` | `session-knowledge.js` + `knowledge-update.js` | Confidence-ranked patterns across sessions |
|
|
155
|
-
| `memory/decisions.json` | `memory-persist.js` | Architectural decisions |
|
|
156
|
-
| `memory/lessons.json` | `memory-persist.js` | Operational lessons |
|
|
157
|
-
| `.pipeline-states/{spec}.json` | Pipeline commands | Current phase (ANALYZE/PLAN/EXECUTE/CLOSE) |
|
|
158
|
-
|
|
159
|
-
### How agents read context
|
|
160
|
-
Via **views** in `scripts/harness-views.js`:
|
|
161
|
-
- `buildAgentVisibility(events, opts)` — parallel agents in current wave + prior findings
|
|
162
|
-
- `buildPipelineState(events, { spec })` — phase + metrics (tool counts, retries, agents) for a spec
|
|
163
|
-
- `buildCrossSessionTimeline(sessionsDir, opts)` — episodic memory across sessions
|
|
164
|
-
- `buildSessionSummary(events)` — roll-up for SessionEnd fold
|
|
165
|
-
|
|
166
|
-
### Removed (Wave 4 — no longer written)
|
|
167
|
-
- `.agent-memory/` (was: per-agent summaries → now: `agent.stop` events in log)
|
|
168
|
-
- `.agent-state/_queue.json` (was: description relay → now: `agent.start` event in log)
|
|
169
|
-
- `.agent-state/{id}.json` (was: active agent tracking → now: `agent.start`/`agent.stop` in log)
|
|
170
|
-
- `.pipeline-states/*.metrics.json` (was: cumulative counters → now: `tool.use` events folded by `buildPipelineState`)
|
|
171
|
-
|
|
172
|
-
### Log rotation
|
|
173
|
-
`harness-init.js` (SessionStart) rotates `.harness/events.jsonl` → `.harness/sessions/{sessionId}.jsonl` and prunes sessions >30 days.
|
|
174
|
-
|
|
175
|
-
### On-Demand Memory Queries (Escape Hatch)
|
|
176
|
-
|
|
177
|
-
The automatic injection in SessionStart/SubagentStart is capped (400-800 chars). If you need more historical context, query the harness directly:
|
|
178
|
-
|
|
179
|
-
```bash
|
|
180
|
-
# Find specific topic in session summary
|
|
181
|
-
node .claude/scripts/harness-views.js --view session-summary --query "JWT" --compact
|
|
182
|
-
|
|
183
|
-
# Get full state of a spec
|
|
184
|
-
node .claude/scripts/harness-views.js --view pipeline-state --spec auth-login --compact
|
|
185
|
-
|
|
186
|
-
# See last N sessions timeline
|
|
187
|
-
node .claude/scripts/harness-views.js --view cross-session-timeline --limit 5 --compact
|
|
188
|
-
|
|
189
|
-
# Active parallel agents in current wave
|
|
190
|
-
node .claude/scripts/harness-views.js --view agent-visibility --compact
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
**When to use:**
|
|
194
|
-
- Exploring a feature area you have partial context on
|
|
195
|
-
- Before making a decision, check if a similar one was made
|
|
196
|
-
- Resuming work on a spec after session gap
|
|
197
|
-
|
|
198
|
-
**When NOT to use:**
|
|
199
|
-
- For patterns already in `knowledge.json` (that's auto-injected)
|
|
200
|
-
- As first action of every task (injection already gives you the top)
|
|
96
|
+
RTK (Rust Token Killer) integrates as core infrastructure via `hooks/rtk-rewrite.js` — transparently rewrites Bash commands through `rtk`, achieving 60-90% token reduction on CLI outputs. Run `rtk gain` for analytics. If RTK is not installed, the hook silently passes through. For cost optimization hooks (`MUSTARD_BASH_REDIRECT_MODE`, model routing gate, tool-use counter) and enforcement hooks (`duplication-check`, `convention-check`, shared memory architecture), see `pipeline-config.md`.
|
|
201
97
|
|
|
202
98
|
## Full Reference
|
|
203
|
-
Rules, pipeline, naming:
|
|
99
|
+
Rules, pipeline, naming: `pipeline-config.md`
|
|
@@ -196,5 +196,4 @@ After EXECUTE (fix + validate) completes:
|
|
|
196
196
|
- NEVER ask "how to fix?" — propose + implement
|
|
197
197
|
- CI test fails: read → fix → re-run — without reporting and waiting
|
|
198
198
|
- MANDATORY: Follow Visual Output, Pipeline State, Task Tracking rules at each phase
|
|
199
|
-
|
|
200
199
|
ULTRATHINK
|