kodelyth-ecc 1.5.10 → 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.
Files changed (123) hide show
  1. package/.github/workflows/publish.yml +19 -0
  2. package/AGENTS.md +1 -1
  3. package/CHANGELOG.md +447 -0
  4. package/CLAUDE.md +48 -16
  5. package/README.md +265 -81
  6. package/VERSION +1 -1
  7. package/actions/ecc-review/README.md +243 -0
  8. package/actions/ecc-review/action.yml +158 -0
  9. package/actions/ecc-review/post-comment.js +171 -0
  10. package/actions/ecc-review/run-review.js +285 -0
  11. package/agents/backdoor-hunter.md +260 -0
  12. package/agents/chaos-engineer.md +251 -0
  13. package/agents/code-stealer-detector.md +228 -0
  14. package/agents/jailbreak-tester.md +222 -0
  15. package/agents/license-violation-finder.md +212 -0
  16. package/agents/prompt-injection-hunter.md +126 -0
  17. package/agents/secret-hunter.md +209 -0
  18. package/agents/supply-chain-auditor.md +195 -0
  19. package/bin/kodelyth-ecc.js +875 -1
  20. package/bundles/enterprise.md +172 -0
  21. package/bundles/indie-hacker.md +106 -0
  22. package/bundles/red-team.md +138 -0
  23. package/cat +0 -0
  24. package/commands/dashboard.md +67 -0
  25. package/commands/devil-mode.md +121 -0
  26. package/commands/memory-evolve.md +71 -0
  27. package/commands/replay.md +61 -0
  28. package/commands/route-model.md +48 -0
  29. package/commands/swarm.md +68 -0
  30. package/commands/verify-supply-chain.md +59 -0
  31. package/docs/dashboard.md +211 -0
  32. package/docs/evolve.md +303 -0
  33. package/docs/mcp-clients.md +167 -0
  34. package/docs/mcp.md +178 -0
  35. package/docs/replay.md +244 -0
  36. package/docs/supply-chain.md +207 -0
  37. package/docs/swarm.md +243 -0
  38. package/hooks/hooks.json +52 -0
  39. package/hooks/memory/auto-recall.js +29 -1
  40. package/hooks/safety/README.md +124 -0
  41. package/hooks/safety/lib/patterns.js +179 -0
  42. package/hooks/safety/prompt-injection-guard.js +179 -0
  43. package/hooks/safety/token-budget.js +229 -0
  44. package/install.ps1 +199 -2
  45. package/install.sh +285 -3
  46. package/package.json +30 -4
  47. package/rules/common/agent-intent-routing.md +182 -0
  48. package/rules/common/cost-aware-model-routing.md +152 -0
  49. package/scripts/dashboard/data.js +353 -0
  50. package/scripts/dashboard/server.js +324 -0
  51. package/scripts/dashboard/static/index.html +645 -0
  52. package/scripts/evolve/analyze.js +303 -0
  53. package/scripts/evolve/proposals.js +162 -0
  54. package/scripts/evolve/stats.js +219 -0
  55. package/scripts/mcp/catalog.js +244 -0
  56. package/scripts/mcp/client.js +181 -0
  57. package/scripts/mcp/prompts.js +133 -0
  58. package/scripts/mcp/resources.js +94 -0
  59. package/scripts/mcp/server.js +153 -0
  60. package/scripts/mcp/tools.js +465 -0
  61. package/scripts/replay/bundle.js +191 -0
  62. package/scripts/replay/replay.js +107 -0
  63. package/scripts/router/classify.js +232 -0
  64. package/scripts/supply-chain/manifest.js +154 -0
  65. package/scripts/supply-chain/sbom.js +202 -0
  66. package/scripts/supply-chain/verify.js +102 -0
  67. package/scripts/swarm/build-plan.js +193 -0
  68. package/skills/cost-aware-model-routing/SKILL.md +153 -0
  69. package/skills/kodelyth-quickstart/SKILL.md +7 -0
  70. package/skills/observability-dashboard/SKILL.md +119 -0
  71. package/skills/self-evolving-memory/SKILL.md +175 -0
  72. package/skills/session-replay/SKILL.md +199 -0
  73. package/skills/supply-chain-verification/SKILL.md +201 -0
  74. package/skills/swarm-orchestrator/SKILL.md +177 -0
  75. package/social/card-install.svg +1 -1
  76. package/social/facebook-group/POST.md +121 -0
  77. package/social/facebook-group/fb-1-3am-debug.png +0 -0
  78. package/social/facebook-group/fb-1-3am-debug.svg +97 -0
  79. package/social/facebook-group/fb-2-cpu-upgrade.png +0 -0
  80. package/social/facebook-group/fb-2-cpu-upgrade.svg +132 -0
  81. package/social/facebook-group/fb-3-before-after.png +0 -0
  82. package/social/facebook-group/fb-3-before-after.svg +94 -0
  83. package/social/facebook-v150.svg +5 -5
  84. package/social/github-social-preview.svg +119 -100
  85. package/social/readme-hero.svg +11 -11
  86. package/social/section-agents.svg +57 -0
  87. package/social/section-author.svg +54 -0
  88. package/social/section-dashboard.svg +59 -0
  89. package/social/section-devil.svg +54 -0
  90. package/social/section-hooks.svg +51 -0
  91. package/social/section-install.svg +42 -0
  92. package/social/section-learning.svg +52 -0
  93. package/social/section-mcp.svg +46 -0
  94. package/social/section-memory.svg +57 -0
  95. package/social/section-parallel.svg +72 -0
  96. package/social/section-routing.svg +51 -0
  97. package/social/x-card-agents-grid.svg +6 -6
  98. package/tests/dashboard/data.test.js +235 -0
  99. package/tests/dashboard/server.test.js +240 -0
  100. package/tests/evolve/analyze.test.js +169 -0
  101. package/tests/evolve/proposals.test.js +173 -0
  102. package/tests/evolve/stats.test.js +159 -0
  103. package/tests/mcp/catalog.test.js +98 -0
  104. package/tests/mcp/client.test.js +109 -0
  105. package/tests/mcp/resources-prompts.test.js +70 -0
  106. package/tests/mcp/tools.test.js +159 -0
  107. package/tests/replay/bundle.test.js +181 -0
  108. package/tests/replay/replay.test.js +131 -0
  109. package/tests/router/classify.test.js +164 -0
  110. package/tests/safety/patterns.test.js +94 -0
  111. package/tests/safety/prompt-injection-guard.test.js +111 -0
  112. package/tests/safety/token-budget.test.js +119 -0
  113. package/tests/supply-chain/manifest.test.js +147 -0
  114. package/tests/supply-chain/sbom.test.js +170 -0
  115. package/tests/supply-chain/verify.test.js +146 -0
  116. package/tests/swarm/build-plan.test.js +188 -0
  117. package/wiki/Agent-Reference.md +58 -7
  118. package/wiki/FAQ.md +204 -7
  119. package/wiki/Home.md +104 -28
  120. package/wiki/Hook-Reference.md +1 -1
  121. package/wiki/Installation-Guide.md +109 -6
  122. package/wiki/Platform-Support.md +239 -25
  123. package/wiki/Skill-Reference.md +101 -6
package/README.md CHANGED
@@ -8,9 +8,10 @@
8
8
  ![Antigravity](https://img.shields.io/badge/Antigravity-Ready-00ADD8)
9
9
  ![Cursor](https://img.shields.io/badge/Cursor-Ready-3b82f6)
10
10
  ![Codex](https://img.shields.io/badge/Codex-Ready-10b981)
11
- ![Version](https://img.shields.io/badge/version-1.5.8-orange)
12
- ![Agents](https://img.shields.io/badge/Agents-62-brightgreen)
13
- ![Skills](https://img.shields.io/badge/Skills-188-brightgreen)
11
+ ![Version](https://img.shields.io/badge/version-1.7.0-orange)
12
+ ![Agents](https://img.shields.io/badge/Agents-70-brightgreen)
13
+ ![Devil Mode](https://img.shields.io/badge/Devil%20Mode-new-red)
14
+ ![Skills](https://img.shields.io/badge/Skills-194-brightgreen)
14
15
  ![Memory](https://img.shields.io/badge/Local%20Memory-on-blueviolet)
15
16
  ![Auto Recall](https://img.shields.io/badge/Auto%20Chat%20Recall-on-blueviolet)
16
17
  ![Parallel Agents](https://img.shields.io/badge/Parallel%20Agents-new-red)
@@ -18,17 +19,17 @@
18
19
 
19
20
  </div>
20
21
 
21
- **Kodelyth ECC** is a production-grade AI coding toolkit — **62 specialist agents, 188 skills, 90 commands**, a god-tier **semantic intent-routing system**, and **local self-learning memory** that gets smarter at helping *you* every session.
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 **OpenCode**.
24
+ Works with **Claude Code**, **Windsurf**, **Cursor**, **Codex CLI**, **Google Antigravity**, **OpenCode**, **Cline**, **Roo Code**, **Aider**, **Kimi**, and **Gemini CLI**.
24
25
 
25
- > No dashboard. No telemetry. No cloud. Just rules, agents, skills, and your own private memory store — all on your disk.
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
- ## What Makes ECC Different
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 has **intent routing** baked into the rules layer you describe your problem in plain words, the AI announces which specialist is taking over, and you get senior-grade help without memorizing a directory.
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
- ## Kodelyth MemoryLocal Self-Learning (new in v1.4.0)
273
+ ## Parallel Agents8 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** *(v1.4.1)* | 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. Skips trivial / agent-command prompts. |
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 (new in v1.5.1)
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** | 61 agents | Always-on | Routes your message to the right specialist from the first word. No names needed. |
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. The more corrections you give, the more precisely it matches how you work.
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 | **62** | Specialist subagents — reviewers, planners, debuggers, architects, incident-commander, load-tester, memory, image-architect |
301
- | Skills | **188** | Domain knowledge — patterns, testing, security, DevOps, intent routing, memory |
302
- | Commands | **90** | Slash command workflows (`/tdd`, `/plan`, `/memory`, `/doctor`, `/update`, etc.) |
303
- | Hooks | **20+** | Quality gates, secret scanning, branch checks, memory inject + capture + correction + project DNA |
304
- | Rules | **17** | Always-on coding standards + intent routing + memory protocol + self-improvement workflow |
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 *(v1.5.1)* |
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` *(v1.5.1)* |
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 62 subagents available globally |
444
- | `skills/` | `~/.claude/skills/` | All 188 skills loadable via commands |
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 dashboard** — we removed it in v1.3.0 because it wasn't giving accurate cross-platform data and added confusion. The toolkit is now leaner.
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.5.8 highlights:
735
+ See [CHANGELOG.md](CHANGELOG.md). v1.7.0 highlights:
556
736
 
557
- - **zsh inline comment fix** — `npx kodelyth-ecc --target windsurf-home # comment` no longer crashes. Fixed at two layers: Node.js arg filter + `install.sh` handler.
558
- - **Dynamic install counts** — agent/skill/command counts in `install.sh` and `install.ps1` are now computed from the filesystem at install time. Never wrong again.
559
- - **Ruby + Elixir language rules** — coding-style, patterns, testing, security, and hooks for both languages. Install with `npx kodelyth-ecc ruby elixir`.
560
- - **`/doctor` command** run a health check on your ECC install without leaving your IDE.
561
- - **`/update` command** — upgrade to the latest version automatically; reads your install state so you don't have to remember your original flags.
562
- - **5 new parallel commands** (`/security-audit`, `/pre-release`, `/debug-blitz`, `/refactor-sprint`, `/onboard`) added in v1.5.4.
563
- - **GitHub contribution templates** — bug report, new agent proposal, and PR checklist now live in `.github/`.
564
- - **All agent counts and docs corrected** — `rules/common/agents.md` now lists all 62 agents (was 10), README badges and SVGs updated to v1.5.7.
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. Gemini Imagen 3 on Antigravity, DALL-E 3 on Codex, fal.ai on Claude Code, SVG fallback everywhere
569
- - **Added:** `/project-launch` — 5 founding-team agents fire in parallel for new projects (45 min → 10 min)
570
- - **Added:** `/team-review` — 4 audit agents fire in parallel for existing code (60 min → 15 min)
571
- - **Added:** `/lessons` command — cross-platform lesson loading, works on Windsurf, Cursor, Codex, Antigravity, OpenCode
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 — detects 12 correction signal patterns in session JSONL, encodes them as hard rules to `tasks/lessons.md` automatically at session end
577
- - **Added:** `read-lessons.js` SessionStart hook — injects `tasks/lessons.md` rules + project DNA (stack, framework, package manager, open todos) as session context before first message
578
- - **Added:** `rules/common/self-improvement-workflow.md` — Boris Cherny's internal Claude Code team workflow (6 patterns) + ECC three-layer compound memory architecture
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 (triage, containment, postmortem) — distinct from `debug-detective`
584
- - **Added:** `load-tester` — load/stress testing with k6, Locust, Artillery — distinct from `performance-optimizer`
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:** SessionStart hook injects relevant past memories; Stop hook queues candidates for review
599
- - **Added:** `/memory` slash command + `kodelyth-memory` agent + `memory-protocol` rule
600
- - **Added:** 12 new tests (38 total passing)
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
- v1.3.0 highlights:
776
+ ## Author
604
777
 
605
- - **Removed:** Lens dashboard (was inaccurate across cloud-AI platforms)
606
- - **Added:** God-tier `agent-intent-routing` rule10 priority tiers, 50+ patterns
607
- - **Added:** 5 new agents — `dependency-doctor`, `git-rescue`, `release-captain`, `env-debugger`, `flake-hunter`
608
- - **Added:** 2 new skills — `intent-routing` (routing system docs), `agent-handoff` (chain protocol)
609
- - **Improved:** Cross-platform install parity — full Windows support for all targets
778
+ <div align="center">
779
+ <img src="social/section-author.svg" alt="Shofiqul IslamCreator 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
- Built and maintained by **Kodelyth** — [@sifxprime](https://github.com/sifxprime)
796
+ [![npm](https://img.shields.io/badge/npm-kodelyth--ecc-red.svg)](https://www.npmjs.com/package/kodelyth-ecc)
797
+ [![GitHub](https://img.shields.io/badge/GitHub-sifxprime%2Fkodelyth--ecc-181717.svg)](https://github.com/sifxprime/kodelyth-ecc)
798
+ [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
799
+ [![Node](https://img.shields.io/badge/Node.js-18%2B-339933.svg)](https://nodejs.org)
616
800
 
617
- Powered by **Kodelyth**.
801
+ Built with craft. Zero telemetry. All yours.
618
802
 
619
803
  </div>
package/VERSION CHANGED
@@ -1 +1 @@
1
- 1.5.10
1
+ 1.7.0