kodelyth-ecc 1.5.9 → 1.7.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/.github/workflows/publish.yml +19 -0
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +455 -0
- package/CLAUDE.md +48 -16
- package/README.md +265 -81
- package/VERSION +1 -1
- package/actions/ecc-review/README.md +243 -0
- package/actions/ecc-review/action.yml +158 -0
- package/actions/ecc-review/post-comment.js +171 -0
- package/actions/ecc-review/run-review.js +285 -0
- package/agents/backdoor-hunter.md +260 -0
- package/agents/chaos-engineer.md +251 -0
- package/agents/code-stealer-detector.md +228 -0
- package/agents/jailbreak-tester.md +222 -0
- package/agents/license-violation-finder.md +212 -0
- package/agents/prompt-injection-hunter.md +126 -0
- package/agents/secret-hunter.md +209 -0
- package/agents/supply-chain-auditor.md +195 -0
- package/bin/kodelyth-ecc.js +875 -1
- package/bundles/enterprise.md +172 -0
- package/bundles/indie-hacker.md +106 -0
- package/bundles/red-team.md +138 -0
- package/cat +0 -0
- package/commands/dashboard.md +67 -0
- package/commands/devil-mode.md +121 -0
- package/commands/memory-evolve.md +71 -0
- package/commands/replay.md +61 -0
- package/commands/route-model.md +48 -0
- package/commands/swarm.md +68 -0
- package/commands/verify-supply-chain.md +59 -0
- package/docs/dashboard.md +211 -0
- package/docs/evolve.md +303 -0
- package/docs/mcp-clients.md +167 -0
- package/docs/mcp.md +178 -0
- package/docs/replay.md +244 -0
- package/docs/supply-chain.md +207 -0
- package/docs/swarm.md +243 -0
- package/hooks/hooks.json +52 -0
- package/hooks/memory/auto-recall.js +29 -1
- package/hooks/safety/README.md +124 -0
- package/hooks/safety/lib/patterns.js +179 -0
- package/hooks/safety/prompt-injection-guard.js +179 -0
- package/hooks/safety/token-budget.js +229 -0
- package/install.ps1 +199 -2
- package/install.sh +286 -4
- package/package.json +30 -4
- package/rules/common/agent-intent-routing.md +182 -0
- package/rules/common/cost-aware-model-routing.md +152 -0
- package/scripts/dashboard/data.js +353 -0
- package/scripts/dashboard/server.js +324 -0
- package/scripts/dashboard/static/index.html +645 -0
- package/scripts/evolve/analyze.js +303 -0
- package/scripts/evolve/proposals.js +162 -0
- package/scripts/evolve/stats.js +219 -0
- package/scripts/mcp/catalog.js +244 -0
- package/scripts/mcp/client.js +181 -0
- package/scripts/mcp/prompts.js +133 -0
- package/scripts/mcp/resources.js +94 -0
- package/scripts/mcp/server.js +153 -0
- package/scripts/mcp/tools.js +465 -0
- package/scripts/replay/bundle.js +191 -0
- package/scripts/replay/replay.js +107 -0
- package/scripts/router/classify.js +232 -0
- package/scripts/supply-chain/manifest.js +154 -0
- package/scripts/supply-chain/sbom.js +202 -0
- package/scripts/supply-chain/verify.js +102 -0
- package/scripts/swarm/build-plan.js +193 -0
- package/skills/cost-aware-model-routing/SKILL.md +153 -0
- package/skills/kodelyth-quickstart/SKILL.md +7 -0
- package/skills/observability-dashboard/SKILL.md +119 -0
- package/skills/self-evolving-memory/SKILL.md +175 -0
- package/skills/session-replay/SKILL.md +199 -0
- package/skills/supply-chain-verification/SKILL.md +201 -0
- package/skills/swarm-orchestrator/SKILL.md +177 -0
- package/social/card-install.svg +1 -1
- package/social/facebook-group/POST.md +121 -0
- package/social/facebook-group/fb-1-3am-debug.png +0 -0
- package/social/facebook-group/fb-1-3am-debug.svg +97 -0
- package/social/facebook-group/fb-2-cpu-upgrade.png +0 -0
- package/social/facebook-group/fb-2-cpu-upgrade.svg +132 -0
- package/social/facebook-group/fb-3-before-after.png +0 -0
- package/social/facebook-group/fb-3-before-after.svg +94 -0
- package/social/facebook-v150.svg +5 -5
- package/social/github-social-preview.svg +119 -100
- package/social/readme-hero.svg +11 -11
- package/social/section-agents.svg +57 -0
- package/social/section-author.svg +54 -0
- package/social/section-dashboard.svg +59 -0
- package/social/section-devil.svg +54 -0
- package/social/section-hooks.svg +51 -0
- package/social/section-install.svg +42 -0
- package/social/section-learning.svg +52 -0
- package/social/section-mcp.svg +46 -0
- package/social/section-memory.svg +57 -0
- package/social/section-parallel.svg +72 -0
- package/social/section-routing.svg +51 -0
- package/social/x-card-agents-grid.svg +6 -6
- package/tests/dashboard/data.test.js +235 -0
- package/tests/dashboard/server.test.js +240 -0
- package/tests/evolve/analyze.test.js +169 -0
- package/tests/evolve/proposals.test.js +173 -0
- package/tests/evolve/stats.test.js +159 -0
- package/tests/mcp/catalog.test.js +98 -0
- package/tests/mcp/client.test.js +109 -0
- package/tests/mcp/resources-prompts.test.js +70 -0
- package/tests/mcp/tools.test.js +159 -0
- package/tests/replay/bundle.test.js +181 -0
- package/tests/replay/replay.test.js +131 -0
- package/tests/router/classify.test.js +164 -0
- package/tests/safety/patterns.test.js +94 -0
- package/tests/safety/prompt-injection-guard.test.js +111 -0
- package/tests/safety/token-budget.test.js +119 -0
- package/tests/supply-chain/manifest.test.js +147 -0
- package/tests/supply-chain/sbom.test.js +170 -0
- package/tests/supply-chain/verify.test.js +146 -0
- package/tests/swarm/build-plan.test.js +188 -0
- package/wiki/Agent-Reference.md +58 -7
- package/wiki/FAQ.md +204 -7
- package/wiki/Home.md +104 -28
- package/wiki/Hook-Reference.md +1 -1
- package/wiki/Installation-Guide.md +109 -6
- package/wiki/Platform-Support.md +239 -25
- package/wiki/Skill-Reference.md +101 -6
package/README.md
CHANGED
|
@@ -8,9 +8,10 @@
|
|
|
8
8
|

|
|
9
9
|

|
|
10
10
|

|
|
11
|
-

|
|
12
|
+

|
|
13
|
+

|
|
14
|
+

|
|
14
15
|

|
|
15
16
|

|
|
16
17
|

|
|
@@ -18,17 +19,17 @@
|
|
|
18
19
|
|
|
19
20
|
</div>
|
|
20
21
|
|
|
21
|
-
**Kodelyth ECC** is a production-grade AI coding toolkit — **
|
|
22
|
+
**Kodelyth ECC** is a production-grade AI coding toolkit — **70 specialist agents (incl. an 8-agent devil-mode adversarial crew), 194 skills, 97 commands**, a god-tier **semantic intent-routing system**, local self-learning memory, MCP server, swarm orchestrator, and an observability dashboard — all local, zero telemetry.
|
|
22
23
|
|
|
23
|
-
Works with **Claude Code**, **Windsurf**, **Cursor**, **Codex CLI**, **Google Antigravity**, and **
|
|
24
|
+
Works with **Claude Code**, **Windsurf**, **Cursor**, **Codex CLI**, **Google Antigravity**, **OpenCode**, **Cline**, **Roo Code**, **Aider**, **Kimi**, and **Gemini CLI**.
|
|
24
25
|
|
|
25
|
-
> No
|
|
26
|
+
> No telemetry. No cloud. Just rules, agents, skills, MCP server, and your own private memory store — all on your disk. The local dashboard gives you full visibility without sending anything anywhere.
|
|
26
27
|
|
|
27
28
|
---
|
|
28
29
|
|
|
29
|
-
##
|
|
30
|
+
## Why ECC ≠ Another Agent Collection
|
|
30
31
|
|
|
31
|
-
Most "AI agent kits" are folders of markdown files you have to remember the names of. ECC
|
|
32
|
+
Most "AI agent kits" are folders of markdown files you have to remember the names of. **ECC is infrastructure** — a layered system where intent routing, compound memory, parallel orchestration, and quality hooks all reinforce each other.
|
|
32
33
|
|
|
33
34
|
```
|
|
34
35
|
You: "I've been staring at this NullPointerException for two hours,
|
|
@@ -42,12 +43,48 @@ AI: → Routing to debug-detective (your error + frustration matches the bug-
|
|
|
42
43
|
First, can you share the full stack trace and...
|
|
43
44
|
```
|
|
44
45
|
|
|
45
|
-
You never typed `use debug-detective`. You didn't have to.
|
|
46
|
+
You never typed `use debug-detective`. You didn't have to. The toolkit read the intent, picked the specialist, and announced the routing. Next time you can invoke it directly — but you don't have to remember names to get senior-grade help.
|
|
47
|
+
|
|
48
|
+
### The Layer Stack
|
|
49
|
+
|
|
50
|
+
| Layer | What it does | Other kits |
|
|
51
|
+
|---|---|---|
|
|
52
|
+
| **Intent routing** | Plain-language → right specialist via 10-tier priority rules | Mostly missing — you memorize names |
|
|
53
|
+
| **70 agents** | Specialists with playbooks, severity calibration, real commands | Often persona-only ("you are a senior engineer...") |
|
|
54
|
+
| **194 skills** | Domain knowledge files agents read on demand | Rarely separated from agents |
|
|
55
|
+
| **97 commands** | Slash workflows (`/tdd`, `/devil-mode`, `/team-review`) | Limited or none |
|
|
56
|
+
| **8 parallel commands** | Fire 3-8 agents simultaneously, aggregate results | Rare |
|
|
57
|
+
| **Compound memory** | BM25 local recall + auto-inject + project lessons | Cloud-only or absent |
|
|
58
|
+
| **22+ hooks** | Quality gates, secret scan, project-DNA detection | Often missing |
|
|
59
|
+
| **12 IDE platforms** | Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, Roo Code, Aider, Kimi, Gemini CLI (project + home) | 1-2 platforms typical |
|
|
60
|
+
| **Zero telemetry** | Everything stays on your disk; verifiable | Many kits phone home |
|
|
61
|
+
|
|
62
|
+
### Quick Comparison vs Other Kits
|
|
63
|
+
|
|
64
|
+
| Feature | **Kodelyth ECC** | `agency-agents` | `awesome-claude-agents` | Generic prompt libs |
|
|
65
|
+
|---|---|---|---|---|
|
|
66
|
+
| Specialist agents | **70** | ~30 | ~20 | Varies |
|
|
67
|
+
| Skills as separate layer | ✅ 194 | ❌ | ❌ | ❌ |
|
|
68
|
+
| Slash commands | ✅ 97 | Some | Some | ❌ |
|
|
69
|
+
| **Parallel multi-agent commands** | ✅ 8 (incl. `/devil-mode`) | ❌ | ❌ | ❌ |
|
|
70
|
+
| **Intent routing (plain language → agent)** | ✅ 10-tier rule | ❌ | ❌ | ❌ |
|
|
71
|
+
| **Local BM25 self-learning memory** | ✅ | ❌ | ❌ | ❌ |
|
|
72
|
+
| **Compound learning from corrections** | ✅ `tasks/lessons.md` | ❌ | ❌ | ❌ |
|
|
73
|
+
| **Adversarial / red-team agents** | ✅ 8 (devil-mode) | ❌ | ❌ | ❌ |
|
|
74
|
+
| Quality hooks | ✅ 22+ | Some | ❌ | ❌ |
|
|
75
|
+
| IDE platforms | **12** (Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, Roo Code, Aider, Kimi, Gemini CLI) | 1-2 | 1 | Varies |
|
|
76
|
+
| Telemetry | ❌ none | Varies | ❌ | Varies |
|
|
77
|
+
| Test coverage | ✅ 336 tests | ❌ | ❌ | ❌ |
|
|
78
|
+
| Distributed via | `npx`, curl, clone | Manual | Manual | Manual |
|
|
46
79
|
|
|
47
80
|
---
|
|
48
81
|
|
|
49
82
|
## Install
|
|
50
83
|
|
|
84
|
+
<div align="center">
|
|
85
|
+
<img src="social/section-install.svg" alt="Install — One command, 12 platforms, any OS" width="900"/>
|
|
86
|
+
</div>
|
|
87
|
+
|
|
51
88
|
### Option 1 — npx from npm (recommended, any platform)
|
|
52
89
|
|
|
53
90
|
```bash
|
|
@@ -58,6 +95,12 @@ npx kodelyth-ecc --target cursor-project # Cursor IDE
|
|
|
58
95
|
npx kodelyth-ecc --target codex-home # Codex CLI
|
|
59
96
|
npx kodelyth-ecc --target antigravity # Google Antigravity
|
|
60
97
|
npx kodelyth-ecc --target opencode # OpenCode
|
|
98
|
+
npx kodelyth-ecc --target cline # Cline (VS Code)
|
|
99
|
+
npx kodelyth-ecc --target roocode # Roo Code (VS Code)
|
|
100
|
+
npx kodelyth-ecc --target aider # Aider terminal agent
|
|
101
|
+
npx kodelyth-ecc --target kimi # Kimi Code
|
|
102
|
+
npx kodelyth-ecc --target gemini-project # Gemini CLI (project)
|
|
103
|
+
npx kodelyth-ecc --target gemini-home # Gemini CLI (global)
|
|
61
104
|
```
|
|
62
105
|
|
|
63
106
|
Node.js 18+ required. [Download Node](https://nodejs.org) if you don't have it.
|
|
@@ -82,6 +125,26 @@ With a target:
|
|
|
82
125
|
curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash -s -- --target windsurf-project
|
|
83
126
|
```
|
|
84
127
|
|
|
128
|
+
### Power Bundles
|
|
129
|
+
|
|
130
|
+
Pre-configured for who you actually are:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
npx kodelyth-ecc --bundle indie-hacker # Solo founder / SaaS — ship fast, validate, harden
|
|
134
|
+
npx kodelyth-ecc --bundle red-team # Security engineer — devil-mode + adversarial workflows
|
|
135
|
+
npx kodelyth-ecc --bundle enterprise # Compliance / audit team — SBOM, license, supply chain
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
Each bundle installs the full ECC toolkit (all 70 agents, 194 skills, 97 commands, 22+ hooks), adds a `BUNDLE.md` cheat sheet, and biases the AI toward audience-fit workflows on every session.
|
|
139
|
+
|
|
140
|
+
Combine with any target:
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
npx kodelyth-ecc --bundle red-team --target windsurf-project
|
|
144
|
+
npx kodelyth-ecc --bundle enterprise --target codex-home
|
|
145
|
+
npx kodelyth-ecc --bundle indie-hacker --target antigravity
|
|
146
|
+
```
|
|
147
|
+
|
|
85
148
|
### Option 4 — Clone and run
|
|
86
149
|
|
|
87
150
|
```bash
|
|
@@ -99,8 +162,48 @@ cd kodelyth-ecc
|
|
|
99
162
|
|
|
100
163
|
---
|
|
101
164
|
|
|
165
|
+
## MCP Server — Universal Adapter
|
|
166
|
+
|
|
167
|
+
<div align="center">
|
|
168
|
+
<img src="social/section-mcp.svg" alt="MCP Server — universal adapter for any agent framework" width="900"/>
|
|
169
|
+
</div>
|
|
170
|
+
|
|
171
|
+
Run ECC as a Model Context Protocol server and consume it from Claude Desktop, LangGraph, AutoGen, CrewAI, OpenAI Agents SDK, Cursor, Windsurf — anything that speaks MCP.
|
|
172
|
+
|
|
173
|
+
```bash
|
|
174
|
+
npx kodelyth-ecc mcp # stdio JSON-RPC server
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
What it exposes (all local, zero telemetry):
|
|
178
|
+
|
|
179
|
+
- **16 tools** — `route_intent`, `recall_memory`, `capture_memory`, `list_agents`, `get_skill`, `audit_skill_match`, …
|
|
180
|
+
- **6 prompts** — full intent routing rule, agents/skills/commands overviews, handoff chains, devil-mode
|
|
181
|
+
- **365 resources** — every agent, skill, command, rule, and bundle addressable via `kodelyth://...` URIs
|
|
182
|
+
|
|
183
|
+
Drop into Claude Desktop in 30 seconds:
|
|
184
|
+
|
|
185
|
+
```jsonc
|
|
186
|
+
// claude_desktop_config.json
|
|
187
|
+
{
|
|
188
|
+
"mcpServers": {
|
|
189
|
+
"kodelyth-ecc": {
|
|
190
|
+
"command": "npx",
|
|
191
|
+
"args": ["-y", "kodelyth-ecc", "mcp"]
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
Full reference: [`docs/mcp.md`](docs/mcp.md).
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
102
201
|
## How Intent Routing Works
|
|
103
202
|
|
|
203
|
+
<div align="center">
|
|
204
|
+
<img src="social/section-routing.svg" alt="Intent routing — plain language to the right specialist agent" width="900"/>
|
|
205
|
+
</div>
|
|
206
|
+
|
|
104
207
|
The toolkit ships with a single rule file (`rules/common/agent-intent-routing.md`) that the AI loads automatically on every session. It maps **what you say** to **the right specialist agent** across 10 priority tiers.
|
|
105
208
|
|
|
106
209
|
### Two activation paths
|
|
@@ -167,7 +270,86 @@ See `skills/agent-handoff/SKILL.md` for the full handoff protocol and standard c
|
|
|
167
270
|
|
|
168
271
|
---
|
|
169
272
|
|
|
170
|
-
##
|
|
273
|
+
## Parallel Agents — 8 Commands, Minutes Not Hours
|
|
274
|
+
|
|
275
|
+
<div align="center">
|
|
276
|
+
<img src="social/section-parallel.svg" alt="Parallel agents — fire multiple specialists simultaneously" width="900"/>
|
|
277
|
+
</div>
|
|
278
|
+
|
|
279
|
+
Eight commands fire multiple specialist agents simultaneously and aggregate their results into a single structured report.
|
|
280
|
+
|
|
281
|
+
| Command | Agents Fired | Time Saved |
|
|
282
|
+
|---|---|---|
|
|
283
|
+
| `/project-launch` | architect + pair-programmer + security-reviewer + tdd-guide + ux-reviewer | 45 min → 10 min |
|
|
284
|
+
| `/team-review` | code-reviewer + security-reviewer + performance-optimizer + api-guardian | 60 min → 15 min |
|
|
285
|
+
| `/security-audit` | security-reviewer + dependency-doctor + api-guardian | 30 min → 8 min |
|
|
286
|
+
| `/debug-blitz` | debug-detective + silent-failure-hunter + env-debugger | 60 min → 15 min |
|
|
287
|
+
| `/refactor-sprint` | refactor-cleaner + code-simplifier + type-design-analyzer + tdd-guide | 45 min → 12 min |
|
|
288
|
+
| `/pre-release` | release-captain + security-reviewer + code-reviewer | 30 min → 8 min |
|
|
289
|
+
| `/onboard` | code-explorer + architect + doc-updater | 45 min → 12 min |
|
|
290
|
+
| `/devil-mode` | 8 adversarial agents (see below) | Hours → 20 min |
|
|
291
|
+
|
|
292
|
+
Each command waits for all agents to complete, then returns a single **Team Review Report** with findings bucketed by severity: CRITICAL → HIGH → MEDIUM → LOW.
|
|
293
|
+
|
|
294
|
+
---
|
|
295
|
+
|
|
296
|
+
## Devil Mode — 8 Adversarial Agents
|
|
297
|
+
|
|
298
|
+
<div align="center">
|
|
299
|
+
<img src="social/section-devil.svg" alt="Devil Mode — 8 adversarial agents, red-team your own code" width="900"/>
|
|
300
|
+
</div>
|
|
301
|
+
|
|
302
|
+
8 adversarial agents that read your codebase the way an attacker would. Fire them in parallel with `/devil-mode`:
|
|
303
|
+
|
|
304
|
+
```
|
|
305
|
+
/devil-mode --pre-public # before going open-source — full secret/license/IP sweep
|
|
306
|
+
/devil-mode --pre-launch # before launch — adds AI red-team + chaos planning
|
|
307
|
+
/devil-mode --all # all 8 adversarial agents in parallel
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
The crew: `prompt-injection-hunter`, `supply-chain-auditor`, `secret-hunter`, `license-violation-finder`, `jailbreak-tester`, `code-stealer-detector`, `backdoor-hunter`, `chaos-engineer`. Each ships with real bash-grep patterns, severity calibration, and remediation playbooks — not theatrical personas.
|
|
311
|
+
|
|
312
|
+
---
|
|
313
|
+
|
|
314
|
+
## Live Dashboard — Full Visibility, Localhost Only
|
|
315
|
+
|
|
316
|
+
<div align="center">
|
|
317
|
+
<img src="social/section-dashboard.svg" alt="Dashboard — localhost observability, zero telemetry" width="900"/>
|
|
318
|
+
</div>
|
|
319
|
+
|
|
320
|
+
**You have a working, real-time dashboard.** One command launches it:
|
|
321
|
+
|
|
322
|
+
```bash
|
|
323
|
+
npx kodelyth-ecc dashboard
|
|
324
|
+
# Opens http://127.0.0.1:5747 in your browser
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
What's inside:
|
|
328
|
+
|
|
329
|
+
| Tab | What you see |
|
|
330
|
+
|---|---|
|
|
331
|
+
| **Overview** | Agent count, memory stats, session count, recent activity |
|
|
332
|
+
| **Memory** | Browse, search, and manage your local BM25 memory store |
|
|
333
|
+
| **Evolve** | Self-improving memory — review AI-proposed refinements |
|
|
334
|
+
| **Catalog** | Full searchable index of all 70 agents, 194 skills, 97 commands |
|
|
335
|
+
| **Sessions** | Browse past session excerpts and exported bundles |
|
|
336
|
+
|
|
337
|
+
Security design:
|
|
338
|
+
- **GET-only** — no write endpoints accessible from the UI
|
|
339
|
+
- **Localhost-bound** — refuses connections from non-localhost Host headers (DNS rebinding protection)
|
|
340
|
+
- **Hardened headers** — `Content-Security-Policy`, `X-Frame-Options`, `X-Content-Type-Options` on every response
|
|
341
|
+
- **Zero telemetry** — no external network calls ever leave your machine
|
|
342
|
+
- **Max 10 SSE clients** — connection cap prevents resource exhaustion
|
|
343
|
+
|
|
344
|
+
Full reference: [`docs/dashboard.md`](docs/dashboard.md).
|
|
345
|
+
|
|
346
|
+
---
|
|
347
|
+
|
|
348
|
+
## Kodelyth Memory — Local Self-Learning
|
|
349
|
+
|
|
350
|
+
<div align="center">
|
|
351
|
+
<img src="social/section-memory.svg" alt="Kodelyth Memory — local BM25 self-learning memory" width="900"/>
|
|
352
|
+
</div>
|
|
171
353
|
|
|
172
354
|
The first time you solve a hard problem, ECC remembers what worked. The next time you hit something similar, your AI surfaces the past solution before you ask.
|
|
173
355
|
|
|
@@ -196,7 +378,7 @@ Session 2 (August, new project):
|
|
|
196
378
|
| **Storage** | `~/.kodelyth/memory/memories.jsonl` — append-only log on your disk only. Override with `KODELYTH_MEMORY_DIR`. |
|
|
197
379
|
| **Retrieval** | BM25 keyword + tag search. Pure JS, sub-millisecond, no embeddings, no network. |
|
|
198
380
|
| **Session-start injection** | A SessionStart hook builds a cache-friendly context block: stable prefix (your patterns + recent project memories) → variable suffix (relevant to current task). |
|
|
199
|
-
| **Auto chat detection**
|
|
381
|
+
| **Auto chat detection** | A `UserPromptSubmit` hook watches every message you type, runs BM25 search on it, and injects relevant memories **before the AI responds**. Per-session repeat suppression. |
|
|
200
382
|
| **Cost win** | The stable prefix sits in the prompt cache. Anthropic charges 10% on cached tokens (5-min TTL); OpenAI auto-caches prefixes ≥1024 tokens. Long sessions become dramatically cheaper. |
|
|
201
383
|
|
|
202
384
|
### Privacy
|
|
@@ -224,7 +406,11 @@ See `skills/kodelyth-memory/SKILL.md` for the full design + CLI reference.
|
|
|
224
406
|
|
|
225
407
|
---
|
|
226
408
|
|
|
227
|
-
## Compound Learning System — Self-Improvement Loop
|
|
409
|
+
## Compound Learning System — Self-Improvement Loop
|
|
410
|
+
|
|
411
|
+
<div align="center">
|
|
412
|
+
<img src="social/section-learning.svg" alt="Compound learning — every correction stacks, Claude matches your style" width="900"/>
|
|
413
|
+
</div>
|
|
228
414
|
|
|
229
415
|
Every correction you give Claude gets encoded into your project permanently. The toolkit gets smarter every session without any effort from you.
|
|
230
416
|
|
|
@@ -253,7 +439,7 @@ Month 3: You try another tool
|
|
|
253
439
|
|---|---|---|---|
|
|
254
440
|
| **Project Lessons** | `tasks/lessons.md` | Per-project | Hard rules from your corrections. Injected at session start as mandatory context. |
|
|
255
441
|
| **Global Memory** | `~/.kodelyth/memory/` | Cross-project | BM25 fuzzy recall of past solutions. Auto-fires on every prompt you type. |
|
|
256
|
-
| **Intent Routing** |
|
|
442
|
+
| **Intent Routing** | 70 agents | Always-on | Routes your message to the right specialist from the first word. No names needed. |
|
|
257
443
|
|
|
258
444
|
### How it works under the hood
|
|
259
445
|
|
|
@@ -261,22 +447,15 @@ Month 3: You try another tool
|
|
|
261
447
|
- Scans session JSONL for 12 correction signal patterns (`"no don't"`, `"use X instead"`, `"stop doing Y"`, `"we always"`, `"wrong approach"`, etc.)
|
|
262
448
|
- Extracts them as plain-language rules
|
|
263
449
|
- Appends them to `tasks/lessons.md` with date grouping
|
|
264
|
-
- Creates the file automatically if it doesn't exist
|
|
265
450
|
|
|
266
451
|
**`read-lessons.js`** — SessionStart hook, fires first before any other hook:
|
|
267
452
|
- Reads `tasks/lessons.md` and formats rules as `PROJECT LESSONS — HARD RULES` block
|
|
268
453
|
- Detects project DNA automatically: Node.js + framework (Next.js, React, NestJS, etc.), Go, Rust, Python, Java/Gradle, package manager (pnpm/bun/yarn/npm), test runner
|
|
269
454
|
- Surfaces open `tasks/todo.md` items into session context
|
|
270
|
-
- All injected as `additionalContext` — Claude sees it before your first message
|
|
271
|
-
|
|
272
|
-
**`rules/common/self-improvement-workflow.md`** — always-on rule:
|
|
273
|
-
- Boris Cherny's (Claude Code creator) internal team workflow, all 6 patterns
|
|
274
|
-
- Plan Node Default, Subagent Strategy, Self-Improvement Loop, Verification Before Done, Demand Elegance, Autonomous Bug Fixing
|
|
275
|
-
- Extended with ECC's three-layer compound memory protocol
|
|
276
455
|
|
|
277
456
|
### `tasks/lessons.md` — your project's rulebook
|
|
278
457
|
|
|
279
|
-
Edit it freely. Add rules manually. Remove rules that no longer apply. It's a plain markdown file at `tasks/lessons.md` in your project root.
|
|
458
|
+
Edit it freely. Add rules manually. Remove rules that no longer apply. It's a plain markdown file at `tasks/lessons.md` in your project root.
|
|
280
459
|
|
|
281
460
|
```markdown
|
|
282
461
|
# Claude Lessons
|
|
@@ -297,17 +476,22 @@ Project: **my-app**
|
|
|
297
476
|
|
|
298
477
|
| Component | Count | Description |
|
|
299
478
|
|---|---|---|
|
|
300
|
-
| Agents | **
|
|
301
|
-
| Skills | **
|
|
302
|
-
| Commands | **
|
|
303
|
-
|
|
|
304
|
-
|
|
|
479
|
+
| Agents | **70** | Specialist subagents — reviewers, planners, debuggers, architects, devil-mode adversarial crew, incident-commander, load-tester, memory, image-architect |
|
|
480
|
+
| Skills | **194** | Domain knowledge — patterns, testing, security, DevOps, intent routing, memory |
|
|
481
|
+
| Commands | **97** | Slash command workflows (`/tdd`, `/plan`, `/memory`, `/devil-mode`, `/doctor`, `/update`, etc.) |
|
|
482
|
+
| Parallel commands | **8** | `/devil-mode`, `/team-review`, `/security-audit`, `/debug-blitz`, `/refactor-sprint`, `/pre-release`, `/onboard`, `/project-launch` |
|
|
483
|
+
| Hooks | **22+** | Quality gates, secret scanning, branch checks, memory inject + capture + correction + project DNA |
|
|
484
|
+
| Rules | **14** | Always-on coding standards + intent routing + memory protocol + self-improvement workflow |
|
|
305
485
|
| Memory | **local** | BM25-indexed personal memory at `~/.kodelyth/memory/` (zero deps) |
|
|
306
486
|
|
|
307
487
|
---
|
|
308
488
|
|
|
309
489
|
## Agent Arsenal
|
|
310
490
|
|
|
491
|
+
<div align="center">
|
|
492
|
+
<img src="social/section-agents.svg" alt="70 specialist agents — one for every situation" width="900"/>
|
|
493
|
+
</div>
|
|
494
|
+
|
|
311
495
|
### Kodelyth Exclusives — The 16 Agents That Make ECC
|
|
312
496
|
|
|
313
497
|
| Agent | One-line job |
|
|
@@ -329,14 +513,6 @@ Project: **my-app**
|
|
|
329
513
|
| `flake-hunter` | Stabilizes flaky tests — never adds blind retries |
|
|
330
514
|
| `image-architect` | AI image generation — Gemini/DALL-E/fal.ai/SVG, platform-aware |
|
|
331
515
|
|
|
332
|
-
### Parallel Commands — New in v1.5.2
|
|
333
|
-
|
|
334
|
-
| Command | What it does | Time saved |
|
|
335
|
-
|---|---|---|
|
|
336
|
-
| `/project-launch` | Fires 5 founding-team agents simultaneously on a new project | 45 min → 10 min |
|
|
337
|
-
| `/team-review` | Fires 4 audit agents simultaneously on existing code | 60 min → 15 min |
|
|
338
|
-
| `/lessons` | Loads project lessons on any platform (cross-platform) | Works everywhere |
|
|
339
|
-
|
|
340
516
|
### Agent Categories
|
|
341
517
|
|
|
342
518
|
| Category | Agents |
|
|
@@ -359,14 +535,18 @@ Project: **my-app**
|
|
|
359
535
|
|
|
360
536
|
## Hooks — Always Running in Background
|
|
361
537
|
|
|
538
|
+
<div align="center">
|
|
539
|
+
<img src="social/section-hooks.svg" alt="22+ automated quality hooks — PreToolUse, PostToolUse, Stop" width="900"/>
|
|
540
|
+
</div>
|
|
541
|
+
|
|
362
542
|
Once installed (Claude Code target), these hooks run automatically with zero configuration:
|
|
363
543
|
|
|
364
544
|
| Hook | What it does |
|
|
365
545
|
|---|---|
|
|
366
|
-
| Session start — lessons | Reads `tasks/lessons.md` and injects your hard rules + project DNA as context
|
|
546
|
+
| Session start — lessons | Reads `tasks/lessons.md` and injects your hard rules + project DNA as context |
|
|
367
547
|
| Session start — memory | Loads relevant past solutions from global BM25 memory |
|
|
368
548
|
| Auto chat recall | Watches every prompt, injects relevant memories before AI responds |
|
|
369
|
-
| Correction capture | Detects when you correct Claude, encodes the rule to `tasks/lessons.md`
|
|
549
|
+
| Correction capture | Detects when you correct Claude, encodes the rule to `tasks/lessons.md` |
|
|
370
550
|
| Pre-commit | Catches `console.log`, secrets, bad commit messages |
|
|
371
551
|
| Quality gate | Runs type checks and formatting after edits |
|
|
372
552
|
| Git push reminder | Prompts review before pushing |
|
|
@@ -440,8 +620,8 @@ The intent router will route you to the right one. The AI announces who's taking
|
|
|
440
620
|
|
|
441
621
|
| Source | Destination | What it does |
|
|
442
622
|
|---|---|---|
|
|
443
|
-
| `agents/` | `~/.claude/agents/` | All
|
|
444
|
-
| `skills/` | `~/.claude/skills/` | All
|
|
623
|
+
| `agents/` | `~/.claude/agents/` | All 70 subagents available globally |
|
|
624
|
+
| `skills/` | `~/.claude/skills/` | All 194 skills loadable via commands |
|
|
445
625
|
| `hooks/hooks.json` | `~/.claude/hooks/` | Automated quality gates |
|
|
446
626
|
| `rules/` | `~/.claude/rules/` | Always-on standards + intent routing |
|
|
447
627
|
| `commands/` | `~/.claude/commands/` | Slash commands (`/tdd`, `/plan`, etc.) |
|
|
@@ -534,9 +714,9 @@ npx kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart ru
|
|
|
534
714
|
|
|
535
715
|
ECC is **100% local files**. No telemetry, no cloud, no account, no tracking. Everything is markdown your AI reads on every session.
|
|
536
716
|
|
|
537
|
-
- **No
|
|
538
|
-
- **No phoning home** — install scripts copy files and exit. That's it.
|
|
717
|
+
- **No phoning home** — install scripts copy files and exit. MCP server, dashboard, swarm, and replay all stay on localhost.
|
|
539
718
|
- **You own everything** — fork the repo, edit any agent, write your own.
|
|
719
|
+
- **Verifiable** — `npx kodelyth-ecc verify` checks your install against the sha256 manifest.
|
|
540
720
|
|
|
541
721
|
---
|
|
542
722
|
|
|
@@ -552,68 +732,72 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for templates, checklists, and the full K
|
|
|
552
732
|
|
|
553
733
|
## Changelog
|
|
554
734
|
|
|
555
|
-
See [CHANGELOG.md](CHANGELOG.md). v1.
|
|
735
|
+
See [CHANGELOG.md](CHANGELOG.md). v1.7.0 highlights:
|
|
556
736
|
|
|
557
|
-
- **
|
|
558
|
-
- **
|
|
559
|
-
- **
|
|
560
|
-
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
- **
|
|
737
|
+
- **MCP Server** — 16 tools, 6 prompts, 365 resources; stdio JSON-RPC; zero telemetry; works with Claude Desktop, LangGraph, AutoGen, CrewAI, OpenAI Agents SDK
|
|
738
|
+
- **Dashboard hardening** — DNS rebinding protection, shell injection fix (`execFileSync`), CSP on all responses, SSE client cap (max 10), TOCTOU fixes
|
|
739
|
+
- **Devil Mode** — 8 adversarial agents, `--pre-public` / `--pre-launch` / `--all` flags, real bash-grep patterns and remediation playbooks
|
|
740
|
+
- **336 tests** passing across 24 test files
|
|
741
|
+
|
|
742
|
+
v1.5.8 highlights:
|
|
743
|
+
|
|
744
|
+
- **zsh inline comment fix** — `npx kodelyth-ecc --target windsurf-home # comment` no longer crashes.
|
|
745
|
+
- **Dynamic install counts** — agent/skill/command counts computed from filesystem at install time.
|
|
746
|
+
- **Ruby + Elixir language rules** — coding-style, patterns, testing, security, and hooks.
|
|
747
|
+
- **`/doctor` command** — health check on your ECC install without leaving your IDE.
|
|
748
|
+
- **`/update` command** — upgrade to the latest version automatically.
|
|
749
|
+
- **5 new parallel commands** (`/security-audit`, `/pre-release`, `/debug-blitz`, `/refactor-sprint`, `/onboard`).
|
|
565
750
|
|
|
566
751
|
v1.5.2 highlights:
|
|
567
752
|
|
|
568
|
-
- **Added:** `image-architect` agent — platform-aware AI image generation
|
|
569
|
-
- **Added:** `/project-launch` — 5 founding-team agents fire in parallel
|
|
570
|
-
- **Added:** `/team-review` — 4 audit agents fire in parallel
|
|
571
|
-
- **Added:** `/lessons` command — cross-platform lesson loading
|
|
572
|
-
- **Updated:** intent routing with image generation, parallel commands, and lessons patterns
|
|
753
|
+
- **Added:** `image-architect` agent — platform-aware AI image generation (Gemini Imagen 3, DALL-E 3, fal.ai, SVG)
|
|
754
|
+
- **Added:** `/project-launch` — 5 founding-team agents fire in parallel (45 min → 10 min)
|
|
755
|
+
- **Added:** `/team-review` — 4 audit agents fire in parallel (60 min → 15 min)
|
|
756
|
+
- **Added:** `/lessons` command — cross-platform lesson loading
|
|
573
757
|
|
|
574
758
|
v1.5.1 highlights:
|
|
575
759
|
|
|
576
|
-
- **Added:** `capture-correction.js` Stop hook —
|
|
577
|
-
- **Added:** `read-lessons.js` SessionStart hook — injects
|
|
578
|
-
- **Added:** `rules/common/self-improvement-workflow.md` —
|
|
579
|
-
- **Architecture:** Three-layer compound memory — `tasks/lessons.md` (project-local) + `~/.kodelyth/memory/` (global BM25) + 61 agents (intent routing)
|
|
760
|
+
- **Added:** `capture-correction.js` Stop hook — auto-encodes corrections to `tasks/lessons.md`
|
|
761
|
+
- **Added:** `read-lessons.js` SessionStart hook — injects lessons + project DNA before first message
|
|
762
|
+
- **Added:** `rules/common/self-improvement-workflow.md` — 6-pattern self-improvement loop
|
|
580
763
|
|
|
581
764
|
v1.5.0 highlights:
|
|
582
765
|
|
|
583
|
-
- **Added:** `incident-commander` — production incident response
|
|
584
|
-
- **Added:** `load-tester` — load/stress testing with k6, Locust, Artillery
|
|
585
|
-
- **Updated:** All 9 social SVGs refreshed for v1.5.0 feature set
|
|
586
|
-
- **Updated:** Complete wiki rewrite (all 7 files) — 6-platform matrix, all 61 agents documented
|
|
587
|
-
- **Updated:** Intent routing with new incident/load patterns and 2 new chains
|
|
588
|
-
|
|
589
|
-
v1.4.1 highlights:
|
|
590
|
-
|
|
591
|
-
- **Added:** Auto chat detection — `UserPromptSubmit` hook watches every prompt, auto-injects relevant memories
|
|
592
|
-
- **Added:** Per-session repeat suppression (no memory shown twice in same session)
|
|
593
|
-
- **Added:** 9 new tests (47 total passing)
|
|
766
|
+
- **Added:** `incident-commander` — production incident response
|
|
767
|
+
- **Added:** `load-tester` — load/stress testing with k6, Locust, Artillery
|
|
594
768
|
|
|
595
769
|
v1.4.0 highlights:
|
|
596
770
|
|
|
597
771
|
- **Added:** `kodelyth-memory` — local self-learning memory (BM25, zero deps, cache-friendly)
|
|
598
|
-
- **Added:**
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
- **Honest disclosure:** "Self-learning" means smarter context retrieval, not model fine-tuning
|
|
772
|
+
- **Added:** Auto chat detection hook, SessionStart injection, Stop hook queue
|
|
773
|
+
|
|
774
|
+
---
|
|
602
775
|
|
|
603
|
-
|
|
776
|
+
## Author
|
|
604
777
|
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
778
|
+
<div align="center">
|
|
779
|
+
<img src="social/section-author.svg" alt="Shofiqul Islam — Creator of Kodelyth ECC" width="900"/>
|
|
780
|
+
</div>
|
|
781
|
+
|
|
782
|
+
**Kodelyth ECC** is designed and maintained by **Shofiqul Islam** — full-stack engineer and AI tooling builder.
|
|
783
|
+
|
|
784
|
+
| Platform | Link |
|
|
785
|
+
|---|---|
|
|
786
|
+
| GitHub | [@sifxprime](https://github.com/sifxprime) |
|
|
787
|
+
| X / Twitter | [@sifxprime](https://x.com/sifxprime) |
|
|
788
|
+
| Facebook | [facebook.com/sifxprime](https://facebook.com/sifxprime) |
|
|
789
|
+
| Instagram | [@sifxprime](https://instagram.com/sifxprime) |
|
|
790
|
+
| npm | [npmjs.com/package/kodelyth-ecc](https://www.npmjs.com/package/kodelyth-ecc) |
|
|
610
791
|
|
|
611
792
|
---
|
|
612
793
|
|
|
613
794
|
<div align="center">
|
|
614
795
|
|
|
615
|
-
|
|
796
|
+
[](https://www.npmjs.com/package/kodelyth-ecc)
|
|
797
|
+
[](https://github.com/sifxprime/kodelyth-ecc)
|
|
798
|
+
[](LICENSE)
|
|
799
|
+
[](https://nodejs.org)
|
|
616
800
|
|
|
617
|
-
|
|
801
|
+
Built with craft. Zero telemetry. All yours.
|
|
618
802
|
|
|
619
803
|
</div>
|
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.7.0
|