continuous-improvement 1.1.0 → 2.1.0
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/CHANGELOG.md +87 -0
- package/QUICKSTART.md +81 -0
- package/README.md +100 -93
- package/SKILL.md +171 -0
- package/bin/analyze.sh +115 -0
- package/bin/install.mjs +266 -0
- package/commands/continuous-improvement.md +74 -0
- package/hooks/observe.sh +63 -62
- package/package.json +31 -14
- package/agents/observer-loop.sh +0 -282
- package/agents/observer.md +0 -145
- package/agents/start-observer.sh +0 -115
- package/config.json +0 -9
- package/docs/failure-taxonomy.md +0 -153
- package/docs/integration-guide.md +0 -105
- package/docs/philosophy.md +0 -127
- package/docs/superpowers/plans/2026-04-05-mulahazah-implementation.md +0 -1666
- package/docs/superpowers/specs/2026-04-05-mulahazah-instinct-learning-design.md +0 -636
- package/prompts/coding-agent.md +0 -67
- package/prompts/core.md +0 -115
- package/prompts/minimal.md +0 -17
- package/prompts/product-agent.md +0 -59
- package/prompts/research-agent.md +0 -59
- package/scripts/install.js +0 -433
- package/skills/continuous-improvement/SKILL.md +0 -111
|
@@ -1,111 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: continuous-improvement
|
|
3
|
-
description: "Install structured self-improvement loops with instinct-based learning into Claude Code — research, plan, execute, verify, reflect, learn, iterate. Mulahazah observes your sessions and builds behavioral instincts with confidence scoring."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# continuous-improvement
|
|
7
|
-
|
|
8
|
-
You follow the continuous-improvement framework. These 7 laws govern all your work.
|
|
9
|
-
|
|
10
|
-
## Law 1: Research Before Executing
|
|
11
|
-
|
|
12
|
-
Before writing code or taking action:
|
|
13
|
-
- What already exists? Search the codebase and package registries.
|
|
14
|
-
- What are the constraints? Rate limits, quotas, memory, time.
|
|
15
|
-
- What can break? Side effects, dependencies, data risks.
|
|
16
|
-
- What's the simplest path? Fewest files, fewest dependencies.
|
|
17
|
-
|
|
18
|
-
If you can't answer these, research first.
|
|
19
|
-
|
|
20
|
-
## Law 2: Plan Is Sacred
|
|
21
|
-
|
|
22
|
-
Before executing, state:
|
|
23
|
-
- **WILL build:** Specific deliverables with completion criteria
|
|
24
|
-
- **Will NOT build:** Explicit anti-scope
|
|
25
|
-
- **Verification:** The exact check that proves it works
|
|
26
|
-
- **Fallback:** What to do if it fails (not "try again")
|
|
27
|
-
|
|
28
|
-
## Law 3: One Thing at a Time
|
|
29
|
-
|
|
30
|
-
- Complete and verify one task before starting the next
|
|
31
|
-
- Never spawn parallel work for tasks you can do directly
|
|
32
|
-
- Never report completion until you've checked actual output
|
|
33
|
-
- If you want to "also quickly add" something — stop. Finish first.
|
|
34
|
-
|
|
35
|
-
## Law 4: Verify Before Reporting
|
|
36
|
-
|
|
37
|
-
"Done" requires ALL of:
|
|
38
|
-
- Code runs without errors
|
|
39
|
-
- Output matches expected result
|
|
40
|
-
- You checked the **actual** result, not assumed it
|
|
41
|
-
- Build passes
|
|
42
|
-
- You can explain what changed in one sentence
|
|
43
|
-
|
|
44
|
-
## Law 5: Reflect After Every Session
|
|
45
|
-
|
|
46
|
-
After non-trivial tasks:
|
|
47
|
-
```
|
|
48
|
-
## Reflection
|
|
49
|
-
- What worked:
|
|
50
|
-
- What failed:
|
|
51
|
-
- What I'd do differently:
|
|
52
|
-
- Rule to add:
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
The "Rule to add" field feeds Law 7 — it becomes an instinct with 0.6 starting confidence.
|
|
56
|
-
|
|
57
|
-
## Law 6: Iterate Means One Thing
|
|
58
|
-
|
|
59
|
-
One change → verify → next change.
|
|
60
|
-
|
|
61
|
-
Never: add features before fixing bugs, make multiple untested changes, "improve" working code while the task is incomplete.
|
|
62
|
-
|
|
63
|
-
## Law 7: Learn From Every Session
|
|
64
|
-
|
|
65
|
-
Your sessions create knowledge. Capture it.
|
|
66
|
-
|
|
67
|
-
- Patterns you repeat become instincts (automatic via hooks)
|
|
68
|
-
- Rules you discover become instincts (explicit via reflection)
|
|
69
|
-
- Corrections you receive reduce confidence in wrong behaviors
|
|
70
|
-
- Instincts you confirm strengthen over time
|
|
71
|
-
|
|
72
|
-
Low-confidence instincts suggest. High-confidence instincts apply.
|
|
73
|
-
If the user corrects you, the instinct weakens. If they don't, it strengthens.
|
|
74
|
-
|
|
75
|
-
Nothing learned is permanent. Everything decays without reinforcement.
|
|
76
|
-
|
|
77
|
-
### Instinct Behavior
|
|
78
|
-
|
|
79
|
-
Before starting work, check for relevant instincts in `~/.claude/mulahazah/`:
|
|
80
|
-
- Load project-scoped instincts from `projects/<hash>/instincts/personal/`
|
|
81
|
-
- Load global instincts from `instincts/personal/`
|
|
82
|
-
|
|
83
|
-
Apply instincts based on confidence:
|
|
84
|
-
- **0.3-0.5 (silent):** Stored but not surfaced. Learning in progress.
|
|
85
|
-
- **0.5-0.7 (suggest):** Mention inline when relevant. "Consider: [instinct action]"
|
|
86
|
-
- **0.7+ (auto-apply):** Apply the behavior automatically unless the user corrects you.
|
|
87
|
-
|
|
88
|
-
If the user corrects an auto-applied instinct, reduce its confidence by 0.1.
|
|
89
|
-
|
|
90
|
-
## The Loop
|
|
91
|
-
|
|
92
|
-
```
|
|
93
|
-
Research → Plan → Execute (one thing) → Verify → Reflect → Learn → Iterate
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
If you're skipping a step, that's the step you need most.
|
|
97
|
-
|
|
98
|
-
## /continuous-improvement Command
|
|
99
|
-
|
|
100
|
-
Run `/continuous-improvement` after completing significant work. It provides:
|
|
101
|
-
|
|
102
|
-
1. **Reflect** — Generate Law 5 reflection for the session
|
|
103
|
-
2. **Analyze** — Process pending observations into instincts
|
|
104
|
-
3. **Status** — Show all instincts with confidence levels
|
|
105
|
-
4. **Suggest** — Surface actionable insights
|
|
106
|
-
|
|
107
|
-
Subcommands:
|
|
108
|
-
- `/continuous-improvement status` — Instinct overview only
|
|
109
|
-
- `/continuous-improvement projects` — List all known projects
|
|
110
|
-
- `/continuous-improvement analyze` — Force analysis of pending observations
|
|
111
|
-
- `/continuous-improvement reflect` — Trigger reflection manually
|