kodelyth-ecc 1.2.2 → 1.3.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/AGENTS.md +101 -181
- package/CHANGELOG.md +32 -0
- package/CLAUDE.md +72 -63
- package/KODELYTH.md +79 -44
- package/README.md +189 -204
- package/VERSION +1 -1
- package/agents/dependency-doctor.md +120 -0
- package/agents/env-debugger.md +154 -0
- package/agents/flake-hunter.md +142 -0
- package/agents/git-rescue.md +133 -0
- package/agents/release-captain.md +190 -0
- package/install.ps1 +9 -9
- package/install.sh +11 -97
- package/package.json +2 -2
- package/rules/common/agent-intent-routing.md +337 -0
- package/skills/agent-handoff/SKILL.md +184 -0
- package/skills/intent-routing/SKILL.md +134 -0
- package/dashboard/lib/agent-tracker.js +0 -366
- package/dashboard/lib/aggregator.js +0 -119
- package/dashboard/lib/cost-calculator.js +0 -50
- package/dashboard/lib/platform-detector.js +0 -89
- package/dashboard/lib/readers/antigravity-reader.js +0 -113
- package/dashboard/lib/readers/claude-reader.js +0 -135
- package/dashboard/lib/readers/codex-reader.js +0 -192
- package/dashboard/lib/readers/cursor-reader.js +0 -135
- package/dashboard/lib/readers/opencode-reader.js +0 -201
- package/dashboard/lib/readers/windsurf-reader.js +0 -146
- package/dashboard/package.json +0 -24
- package/dashboard/public/index.html +0 -1221
- package/dashboard/server.js +0 -119
- package/scripts/agent-tracker-hook.js +0 -81
- package/social/readme-lens.svg +0 -140
- package/social/readme-savings.svg +0 -56
package/README.md
CHANGED
|
@@ -4,57 +4,69 @@
|
|
|
4
4
|
|
|
5
5
|
[](LICENSE)
|
|
6
6
|

|
|
7
|
+

|
|
7
8
|

|
|
8
|
-

|
|
10
|
+

|
|
11
|
+

|
|
12
|
+

|
|
13
|
+

|
|
11
14
|
|
|
12
15
|
</div>
|
|
13
16
|
|
|
14
|
-
**Kodelyth ECC** is a
|
|
17
|
+
**Kodelyth ECC** is a production-grade AI coding toolkit — **58 specialist agents, 187 skills, 79 commands**, and a god-tier **intent-routing system** that auto-detects what you need and hands you the right specialist before you finish typing.
|
|
15
18
|
|
|
16
|
-
Works with **Claude Code**, **
|
|
19
|
+
Works with **Claude Code**, **Windsurf**, **Cursor**, **Codex CLI**, **Google Antigravity**, and **OpenCode**.
|
|
20
|
+
|
|
21
|
+
> No dashboard. No telemetry. No cloud. Just rules, agents, and skills your AI loads on every session.
|
|
17
22
|
|
|
18
23
|
---
|
|
19
24
|
|
|
20
|
-
##
|
|
25
|
+
## What Makes ECC Different
|
|
21
26
|
|
|
22
|
-
|
|
27
|
+
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.
|
|
23
28
|
|
|
24
|
-
|
|
29
|
+
```
|
|
30
|
+
You: "I've been staring at this NullPointerException for two hours,
|
|
31
|
+
I'm losing my mind."
|
|
25
32
|
|
|
26
|
-
|
|
27
|
-
|
|
33
|
+
AI: → Routing to debug-detective (your error + frustration matches the bug-tracking signal)
|
|
34
|
+
|
|
35
|
+
That kind of bug is exhausting — let's trace it properly so we
|
|
36
|
+
fix the root cause, not the symptom.
|
|
37
|
+
|
|
38
|
+
First, can you share the full stack trace and...
|
|
28
39
|
```
|
|
29
40
|
|
|
30
|
-
|
|
41
|
+
You never typed `use debug-detective`. You didn't have to.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Install
|
|
46
|
+
|
|
47
|
+
### Option 1 — npx from npm (recommended, any platform)
|
|
31
48
|
|
|
32
49
|
```bash
|
|
33
|
-
npx kodelyth-ecc
|
|
50
|
+
npx kodelyth-ecc # Claude Code (default)
|
|
51
|
+
npx kodelyth-ecc --target windsurf-project # Windsurf (per-project)
|
|
34
52
|
npx kodelyth-ecc --target windsurf-home # Windsurf (global)
|
|
35
|
-
npx kodelyth-ecc --target antigravity # Google Antigravity
|
|
36
53
|
npx kodelyth-ecc --target cursor-project # Cursor IDE
|
|
37
54
|
npx kodelyth-ecc --target codex-home # Codex CLI
|
|
55
|
+
npx kodelyth-ecc --target antigravity # Google Antigravity
|
|
38
56
|
npx kodelyth-ecc --target opencode # OpenCode
|
|
39
57
|
```
|
|
40
58
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
---
|
|
59
|
+
Node.js 18+ required. [Download Node](https://nodejs.org) if you don't have it.
|
|
44
60
|
|
|
45
61
|
### Option 2 — npx from GitHub (always latest commit)
|
|
46
62
|
|
|
47
|
-
Use this if you want the very latest unreleased version directly from the main branch.
|
|
48
|
-
|
|
49
63
|
```bash
|
|
50
64
|
npx github:sifxprime/kodelyth-ecc
|
|
51
65
|
```
|
|
52
66
|
|
|
53
|
-
Same `--target` flags
|
|
54
|
-
|
|
55
|
-
---
|
|
67
|
+
Same `--target` flags work.
|
|
56
68
|
|
|
57
|
-
### Option 3 — curl (macOS / Linux)
|
|
69
|
+
### Option 3 — curl (macOS / Linux only)
|
|
58
70
|
|
|
59
71
|
```bash
|
|
60
72
|
curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash
|
|
@@ -66,81 +78,76 @@ With a target:
|
|
|
66
78
|
curl -fsSL https://raw.githubusercontent.com/sifxprime/kodelyth-ecc/main/install.sh | bash -s -- --target windsurf-project
|
|
67
79
|
```
|
|
68
80
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
### Option 4 — clone and run (all platforms)
|
|
81
|
+
### Option 4 — Clone and run
|
|
72
82
|
|
|
73
83
|
```bash
|
|
74
84
|
git clone https://github.com/sifxprime/kodelyth-ecc.git
|
|
75
85
|
cd kodelyth-ecc
|
|
76
86
|
|
|
77
87
|
# macOS / Linux
|
|
78
|
-
./install.sh
|
|
79
|
-
./install.sh --target windsurf-project
|
|
80
|
-
./install.sh --target antigravity # Google Antigravity
|
|
88
|
+
./install.sh # Claude Code (default)
|
|
89
|
+
./install.sh --target windsurf-project # Windsurf
|
|
81
90
|
|
|
82
91
|
# Windows (PowerShell)
|
|
83
92
|
.\install.ps1
|
|
84
93
|
.\install.ps1 -Target windsurf-project
|
|
85
|
-
.\install.ps1 -Target codex-home
|
|
86
94
|
```
|
|
87
95
|
|
|
88
96
|
---
|
|
89
97
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
## Kodelyth Lens — AI Usage Dashboard
|
|
98
|
+
## How Intent Routing Works
|
|
95
99
|
|
|
96
|
-
|
|
100
|
+
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.
|
|
97
101
|
|
|
98
|
-
|
|
102
|
+
### Two activation paths
|
|
99
103
|
|
|
100
|
-
|
|
104
|
+
**1. Explicit** — type it directly:
|
|
105
|
+
```
|
|
106
|
+
use debug-detective
|
|
107
|
+
@code-reviewer
|
|
108
|
+
invoke security-reviewer
|
|
109
|
+
```
|
|
101
110
|
|
|
102
|
-
|
|
111
|
+
**2. Implicit** — just describe your problem; the AI routes you:
|
|
103
112
|
|
|
104
|
-
|
|
|
113
|
+
| What you write | Auto-routed to |
|
|
105
114
|
|---|---|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
113
|
-
|
|
115
|
+
| "I'm stuck, no idea where to start" | `kodelyth-advisor` |
|
|
116
|
+
| "I've been debugging this for hours" | `debug-detective` |
|
|
117
|
+
| "Should I use Context or Zustand?" | `pair-programmer` |
|
|
118
|
+
| "Build failed on Vercel" | `build-error-resolver` |
|
|
119
|
+
| "Is this JWT signing secure?" | `security-reviewer` |
|
|
120
|
+
| "Why is this so slow?" | `performance-optimizer` |
|
|
121
|
+
| "Plan the v2 migration" | `planner` + `migration-guide` |
|
|
122
|
+
| "Tests pass locally but fail on CI" | `flake-hunter` + `env-debugger` |
|
|
123
|
+
| "I lost my commits after `reset --hard`" | `git-rescue` |
|
|
124
|
+
| "npm install is failing" | `dependency-doctor` |
|
|
125
|
+
| "Cut a 1.4 release" | `release-captain` |
|
|
126
|
+
| "Add accessibility to this form" | `ux-reviewer` |
|
|
127
|
+
| "Open-source this project" | `opensource-forker` (chain) |
|
|
128
|
+
|
|
129
|
+
The AI **always announces** which agent is taking over (`→ Routing to <agent>`) and **always teaches** you the explicit form for next time (`Tip: type "use <agent>"`). No silent personality changes.
|
|
130
|
+
|
|
131
|
+
### Multi-agent chains
|
|
132
|
+
|
|
133
|
+
Real problems span multiple specialties. ECC ships standard handoff chains:
|
|
114
134
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
| Codex CLI | `~/.codex/state_5.sqlite` | SQLite threads table |
|
|
119
|
-
| Windsurf | `~/Library/Application Support/Windsurf/` | Cloud AI (server-side) |
|
|
120
|
-
| Antigravity | `~/Library/Application Support/Antigravity/` | Cloud AI (server-side) |
|
|
121
|
-
| Cursor | `~/.cursor/` | Local workspace data |
|
|
122
|
-
| OpenCode | `~/.opencode/` | Local session files |
|
|
123
|
-
|
|
124
|
-
Only installed platforms appear in the dashboard — nothing shown for platforms you don't have.
|
|
125
|
-
|
|
126
|
-
### Manual start
|
|
127
|
-
|
|
128
|
-
```bash
|
|
129
|
-
node ~/.kodelyth/lens/server.js
|
|
130
|
-
# → http://localhost:3456
|
|
135
|
+
```
|
|
136
|
+
pair-programmer → tdd-guide → code-reviewer → security-reviewer
|
|
137
|
+
(approach) (write tests) (review impl) (auth, validation)
|
|
131
138
|
```
|
|
132
139
|
|
|
133
|
-
|
|
140
|
+
```
|
|
141
|
+
debug-detective → tdd-guide → refactor-cleaner
|
|
142
|
+
(root cause) (regression test) (cleanup)
|
|
143
|
+
```
|
|
134
144
|
|
|
135
|
-
```bash
|
|
136
|
-
CLAUDE_DIR=~/.claude # Custom Claude Code data dir
|
|
137
|
-
CURSOR_DIR=... # Custom Cursor data dir
|
|
138
|
-
WINDSURF_DIR=... # Custom Windsurf data dir
|
|
139
|
-
CODEX_DIR=~/.codex # Custom Codex data dir
|
|
140
|
-
OPENCODE_DIR=~/.opencode # Custom OpenCode data dir
|
|
141
|
-
ANTIGRAVITY_DIR=... # Custom Antigravity data dir
|
|
142
|
-
PORT=3456 # Dashboard port (default: 3456)
|
|
143
145
|
```
|
|
146
|
+
opensource-forker → opensource-sanitizer → opensource-packager → release-captain
|
|
147
|
+
(clean fork) (strip secrets) (README, license) (cut v0.1.0)
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
See `skills/agent-handoff/SKILL.md` for the full handoff protocol and standard chains.
|
|
144
151
|
|
|
145
152
|
---
|
|
146
153
|
|
|
@@ -148,116 +155,55 @@ PORT=3456 # Dashboard port (default: 3456)
|
|
|
148
155
|
|
|
149
156
|
| Component | Count | Description |
|
|
150
157
|
|---|---|---|
|
|
151
|
-
| Agents | **
|
|
152
|
-
| Skills | **
|
|
158
|
+
| Agents | **58** | Specialist subagents — reviewers, planners, debuggers, architects, doctors |
|
|
159
|
+
| Skills | **187** | Domain knowledge — patterns, testing, security, DevOps, intent routing |
|
|
153
160
|
| Commands | **79** | Slash command workflows (`/tdd`, `/plan`, `/code-review`, etc.) |
|
|
154
|
-
| Hooks | **15+** |
|
|
155
|
-
| Rules | **15** |
|
|
161
|
+
| Hooks | **15+** | Quality gates, session memory, secret scanning, branch checks |
|
|
162
|
+
| Rules | **15** | Always-on coding standards + the intent routing rule |
|
|
156
163
|
|
|
157
164
|
---
|
|
158
165
|
|
|
159
166
|
## Agent Arsenal
|
|
160
167
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
### Kodelyth Exclusives
|
|
164
|
-
|
|
165
|
-
### `kodelyth-advisor` — The Master Guide
|
|
166
|
-
A decade-seasoned principal engineer who reads your emotional state, understands what you're struggling with, and gives you the exact tool or approach needed. No hand-holding, no noise — direct senior-grade direction.
|
|
167
|
-
|
|
168
|
-
```
|
|
169
|
-
use kodelyth-advisor
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
### `debug-detective` — The Root Cause Hunter
|
|
173
|
-
Never guesses. Traces every bug to its exact origin through a structured hypothesis protocol. Covers JS/TS, Python, Go, Rust, SQL — with advanced techniques like binary search debug, git bisect, and minimal reproducers.
|
|
174
|
-
|
|
175
|
-
```
|
|
176
|
-
use debug-detective
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
### `ux-reviewer` — The Interface Guardian
|
|
180
|
-
Reviews frontend code for usability, interaction logic, and WCAG 2.1 AA accessibility. Never touches design aesthetic — only behavior. Catches what real users will feel before they feel it.
|
|
181
|
-
|
|
182
|
-
```
|
|
183
|
-
use ux-reviewer
|
|
184
|
-
```
|
|
185
|
-
|
|
186
|
-
### `api-guardian` — The API Contract Protector
|
|
187
|
-
Detects breaking API changes before they ship. Classifies every change as BREAKING / SAFE / WARN, generates a consumer impact report, and enforces versioning, deprecation headers, and idempotency.
|
|
188
|
-
|
|
189
|
-
```
|
|
190
|
-
use api-guardian
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
### `pair-programmer` — The Pre-Code Thinking Partner
|
|
194
|
-
The engineer who sits next to you before you start coding. Catches the wrong approach, over-engineered solutions, and missed edge cases — before a single line is written.
|
|
168
|
+
### Kodelyth Exclusives — The 11 Agents That Make ECC
|
|
195
169
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
170
|
+
| Agent | One-line job |
|
|
171
|
+
|---|---|
|
|
172
|
+
| `kodelyth-advisor` | Master guide — picks the right tool when you don't know where to start |
|
|
173
|
+
| `pair-programmer` | The engineer who sits next to you **before** you write the code |
|
|
174
|
+
| `debug-detective` | Never guesses — traces every bug to root cause |
|
|
175
|
+
| `silent-failure-hunter` | Finds bugs that don't throw errors |
|
|
176
|
+
| `ux-reviewer` | Reviews UX behavior + WCAG 2.1 AA accessibility (never touches design) |
|
|
177
|
+
| `api-guardian` | Detects breaking API changes before they ship |
|
|
178
|
+
| `migration-guide` | Framework / language version upgrades, phase by phase |
|
|
179
|
+
| `dependency-doctor` | npm/pip/cargo/maven hell — CVE triage, lockfile diagnosis |
|
|
180
|
+
| `git-rescue` | Recovers from broken git states without destroying history |
|
|
181
|
+
| `release-captain` | Owns the release ritual — semver, tagging, publishing, rollback |
|
|
182
|
+
| `env-debugger` | "Works on my machine" hunter — env, config, secrets, layers |
|
|
183
|
+
| `flake-hunter` | Stabilizes flaky tests — never adds blind retries |
|
|
208
184
|
|
|
209
185
|
### Agent Categories
|
|
210
186
|
|
|
211
187
|
| Category | Agents |
|
|
212
188
|
|---|---|
|
|
213
|
-
| Guidance | `kodelyth-advisor`, `pair-programmer`, `planner`, `architect`, `code-architect`, `chief-of-staff`, `migration-guide` |
|
|
214
|
-
| Code Review | `code-reviewer`, `typescript-reviewer`, `python-reviewer`, `go-reviewer`, `rust-reviewer`, `java-reviewer`, `kotlin-reviewer`, `cpp-reviewer`, `csharp-reviewer`, `flutter-reviewer` |
|
|
215
|
-
| Build
|
|
216
|
-
| Debugging | `debug-detective`, `silent-failure-hunter` |
|
|
217
|
-
|
|
|
218
|
-
|
|
|
219
|
-
| Quality | `refactor-cleaner`, `code-simplifier`, `
|
|
220
|
-
| Testing | `tdd-guide`, `e2e-runner`, `pr-test-analyzer` |
|
|
221
|
-
| Documentation | `doc-updater`, `docs-lookup`, `comment-analyzer` |
|
|
222
|
-
|
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
## How Agent Detection Works
|
|
227
|
-
|
|
228
|
-
Agents activate in two ways — you do not always need to type `use agent-name`.
|
|
229
|
-
|
|
230
|
-
**1. Explicit** — type it directly in your conversation:
|
|
231
|
-
```
|
|
232
|
-
use debug-detective
|
|
233
|
-
@code-reviewer
|
|
234
|
-
invoke security-reviewer
|
|
235
|
-
```
|
|
236
|
-
|
|
237
|
-
**2. Automatic intent detection** — Kodelyth Lens reads your prompts and infers which agent matches:
|
|
238
|
-
|
|
239
|
-
| What you write | Agent triggered |
|
|
240
|
-
|---|---|
|
|
241
|
-
| "this bug won't fix", "I'm getting an error", "it's broken" | `debug-detective` |
|
|
242
|
-
| "review this", "check my code", "LGTM?" | `code-reviewer` |
|
|
243
|
-
| "it's slow", "taking too long", "optimize" | `performance-optimizer` |
|
|
244
|
-
| "is this secure", "SQL injection", "auth" | `security-reviewer` |
|
|
245
|
-
| "the build failed", "compile error", "type error" | `build-error-resolver` |
|
|
246
|
-
| "write a test", "TDD", "coverage" | `tdd-guide` |
|
|
247
|
-
| "the UI feels off", "accessibility", "WCAG" | `ux-reviewer` |
|
|
248
|
-
| "plan this feature", "architecture", "design" | `planner` / `architect` |
|
|
249
|
-
| "I'm not sure where to start", "what should I do" | `kodelyth-advisor` |
|
|
250
|
-
| "refactor", "clean up", "dead code" | `refactor-cleaner` |
|
|
251
|
-
| "document this", "add comments" | `doc-updater` |
|
|
252
|
-
| "migrate", "upgrade framework", "breaking change" | `migration-guide` |
|
|
253
|
-
|
|
254
|
-
Intent detection runs across all platforms — Claude Code, Windsurf, Cursor, Codex — anywhere Kodelyth Lens can read conversation logs. The dashboard shows both explicit and auto-detected agent activations in the leaderboard.
|
|
189
|
+
| **Guidance** | `kodelyth-advisor`, `pair-programmer`, `planner`, `architect`, `code-architect`, `chief-of-staff`, `migration-guide` |
|
|
190
|
+
| **Code Review** | `code-reviewer`, `typescript-reviewer`, `python-reviewer`, `go-reviewer`, `rust-reviewer`, `java-reviewer`, `kotlin-reviewer`, `cpp-reviewer`, `csharp-reviewer`, `flutter-reviewer`, `database-reviewer`, `healthcare-reviewer` |
|
|
191
|
+
| **Build Fixers** | `build-error-resolver`, `go-build-resolver`, `rust-build-resolver`, `java-build-resolver`, `kotlin-build-resolver`, `cpp-build-resolver`, `dart-build-resolver`, `pytorch-build-resolver`, `dependency-doctor`, `env-debugger` |
|
|
192
|
+
| **Debugging** | `debug-detective`, `silent-failure-hunter`, `flake-hunter` |
|
|
193
|
+
| **Security & API** | `security-reviewer`, `api-guardian` |
|
|
194
|
+
| **Performance** | `performance-optimizer` |
|
|
195
|
+
| **Quality** | `refactor-cleaner`, `code-simplifier`, `type-design-analyzer` |
|
|
196
|
+
| **Testing** | `tdd-guide`, `e2e-runner`, `pr-test-analyzer`, `flake-hunter` |
|
|
197
|
+
| **Documentation** | `doc-updater`, `docs-lookup`, `comment-analyzer` |
|
|
198
|
+
| **Release & Ops** | `release-captain`, `git-rescue` |
|
|
199
|
+
| **Open Source** | `opensource-forker`, `opensource-packager`, `opensource-sanitizer` |
|
|
200
|
+
| **Specialized** | `seo-specialist`, `ux-reviewer`, `code-explorer` |
|
|
255
201
|
|
|
256
202
|
---
|
|
257
203
|
|
|
258
204
|
## Hooks — Always Running in Background
|
|
259
205
|
|
|
260
|
-
Once installed, these hooks run automatically with zero configuration:
|
|
206
|
+
Once installed (Claude Code target), these hooks run automatically with zero configuration:
|
|
261
207
|
|
|
262
208
|
| Hook | What it does |
|
|
263
209
|
|---|---|
|
|
@@ -266,8 +212,7 @@ Once installed, these hooks run automatically with zero configuration:
|
|
|
266
212
|
| Quality gate | Runs type checks and formatting after edits |
|
|
267
213
|
| Git push reminder | Prompts review before pushing |
|
|
268
214
|
| Config protection | Blocks weakening of linter/formatter configs |
|
|
269
|
-
|
|
|
270
|
-
| Desktop notify | macOS notification when Claude finishes a long task |
|
|
215
|
+
| Desktop notify | macOS notification when a long task finishes |
|
|
271
216
|
| MCP health check | Validates MCP servers before calling them |
|
|
272
217
|
| Test reminder | Prompts to write tests when code is edited without tests |
|
|
273
218
|
| Smart suggest | After each response, suggests the next logical agent |
|
|
@@ -278,11 +223,13 @@ Once installed, these hooks run automatically with zero configuration:
|
|
|
278
223
|
## Usage After Install
|
|
279
224
|
|
|
280
225
|
### Start here (new users)
|
|
226
|
+
|
|
281
227
|
```
|
|
282
228
|
/kodelyth-quickstart
|
|
283
229
|
```
|
|
284
230
|
|
|
285
|
-
### Core workflows
|
|
231
|
+
### Core workflows — explicit invocation
|
|
232
|
+
|
|
286
233
|
```bash
|
|
287
234
|
use kodelyth-advisor # Not sure what to do? Start here
|
|
288
235
|
use pair-programmer # Think through approach before writing code
|
|
@@ -295,9 +242,19 @@ use ux-reviewer # Review frontend UX and accessibility
|
|
|
295
242
|
use migration-guide # Upgrading a framework or language version
|
|
296
243
|
use tdd-guide # Write tests the right way
|
|
297
244
|
use performance-optimizer # Diagnose and fix slowness
|
|
245
|
+
use dependency-doctor # npm/pip/cargo dep hell
|
|
246
|
+
use git-rescue # Broken git state, lost commits, bad rebase
|
|
247
|
+
use release-captain # Cut a clean release with rollback plan
|
|
248
|
+
use env-debugger # "Works on my machine" — env/config/secrets
|
|
249
|
+
use flake-hunter # Stabilize flaky tests
|
|
298
250
|
```
|
|
299
251
|
|
|
300
|
-
###
|
|
252
|
+
### Or just describe your problem
|
|
253
|
+
|
|
254
|
+
The intent router will route you to the right one. The AI announces who's taking over, helps you, and tells you the explicit name for next time.
|
|
255
|
+
|
|
256
|
+
### Load language patterns (skills)
|
|
257
|
+
|
|
301
258
|
```bash
|
|
302
259
|
/typescript-patterns # TypeScript + React + Next.js
|
|
303
260
|
/python-patterns # Python best practices
|
|
@@ -308,54 +265,55 @@ use performance-optimizer # Diagnose and fix slowness
|
|
|
308
265
|
```
|
|
309
266
|
|
|
310
267
|
### Advanced skills
|
|
268
|
+
|
|
311
269
|
```bash
|
|
312
270
|
/git-mastery # Trunk-based dev, rebase, bisect, monorepos
|
|
313
271
|
/observability # Structured logging, metrics, OpenTelemetry, SLOs
|
|
314
272
|
/smart-debug # Systematic debugging framework
|
|
273
|
+
/intent-routing # How the auto-routing system works
|
|
274
|
+
/agent-handoff # Standard multi-agent handoff chains
|
|
315
275
|
```
|
|
316
276
|
|
|
317
277
|
---
|
|
318
278
|
|
|
319
279
|
## What Gets Installed
|
|
320
280
|
|
|
321
|
-
### Claude Code
|
|
281
|
+
### Claude Code — `~/.claude/`
|
|
322
282
|
|
|
323
283
|
| Source | Destination | What it does |
|
|
324
284
|
|---|---|---|
|
|
325
|
-
| `agents/` | `~/.claude/agents/` | All
|
|
326
|
-
| `skills/` | `~/.claude/skills/` | All
|
|
327
|
-
| `hooks/hooks.json` | `~/.claude/hooks/` | Automated quality gates
|
|
328
|
-
| `rules/` | `~/.claude/rules/` | Always-on
|
|
285
|
+
| `agents/` | `~/.claude/agents/` | All 58 subagents available globally |
|
|
286
|
+
| `skills/` | `~/.claude/skills/` | All 187 skills loadable via commands |
|
|
287
|
+
| `hooks/hooks.json` | `~/.claude/hooks/` | Automated quality gates |
|
|
288
|
+
| `rules/` | `~/.claude/rules/` | Always-on standards + intent routing |
|
|
329
289
|
| `commands/` | `~/.claude/commands/` | Slash commands (`/tdd`, `/plan`, etc.) |
|
|
330
|
-
| `dashboard/` | `~/.kodelyth/lens/` | Kodelyth Lens usage dashboard |
|
|
331
290
|
|
|
332
|
-
### Windsurf
|
|
291
|
+
### Windsurf — `.windsurf/` (project) or `~/.codeium/windsurf/` (global)
|
|
333
292
|
|
|
334
293
|
| Source | Destination | Notes |
|
|
335
294
|
|---|---|---|
|
|
336
295
|
| `agents/` | `.windsurf/agents/` | Call with `use <agent-name>` in Cascade |
|
|
337
296
|
| `skills/` | `.windsurf/skills/` | Domain knowledge, loadable via chat |
|
|
338
297
|
| `rules/` | `.windsurf/rules/` | Flattened rule files |
|
|
339
|
-
| `rules/common/` | `.windsurfrules` | Concatenated — Windsurf reads this automatically |
|
|
340
|
-
|
|
341
|
-
The `.windsurfrules` file is auto-generated from all common rules and loaded by Windsurf Cascade on every session. No manual setup needed.
|
|
298
|
+
| `rules/common/` | `.windsurfrules` | Concatenated — Windsurf reads this automatically every session |
|
|
342
299
|
|
|
343
|
-
###
|
|
300
|
+
### Cursor — `.cursor/` in project root
|
|
344
301
|
|
|
345
|
-
| Source | Destination |
|
|
346
|
-
|
|
347
|
-
| `
|
|
348
|
-
| `skills/` |
|
|
349
|
-
| `commands/` | `~/.codex/commands/` | Slash commands |
|
|
350
|
-
| `rules/` | `~/.codex/rules/` | Coding standards (flattened) |
|
|
302
|
+
| Source | Destination |
|
|
303
|
+
|---|---|
|
|
304
|
+
| `rules/` | `.cursor/rules/` |
|
|
305
|
+
| `skills/` | `.cursor/skills/` |
|
|
351
306
|
|
|
352
|
-
###
|
|
307
|
+
### Codex CLI — `~/.codex/`
|
|
353
308
|
|
|
354
|
-
| Source | Destination |
|
|
355
|
-
|
|
356
|
-
| `
|
|
309
|
+
| Source | Destination |
|
|
310
|
+
|---|---|
|
|
311
|
+
| `agents/` | `~/.codex/agents/` |
|
|
312
|
+
| `skills/` | `~/.codex/skills/` |
|
|
313
|
+
| `commands/` | `~/.codex/commands/` |
|
|
314
|
+
| `rules/` | `~/.codex/rules/` |
|
|
357
315
|
|
|
358
|
-
### Antigravity
|
|
316
|
+
### Antigravity — `.agent/` in project root
|
|
359
317
|
|
|
360
318
|
| Source | Destination |
|
|
361
319
|
|---|---|
|
|
@@ -363,6 +321,12 @@ The `.windsurfrules` file is auto-generated from all common rules and loaded by
|
|
|
363
321
|
| `commands/` | `.agent/workflows/` |
|
|
364
322
|
| `rules/` | `.agent/rules/` |
|
|
365
323
|
|
|
324
|
+
### OpenCode — `.opencode/` in project root
|
|
325
|
+
|
|
326
|
+
| Source | Destination |
|
|
327
|
+
|---|---|
|
|
328
|
+
| `rules/` | `.opencode/rules/` |
|
|
329
|
+
|
|
366
330
|
---
|
|
367
331
|
|
|
368
332
|
## Install Profiles — Language Bundles
|
|
@@ -370,15 +334,9 @@ The `.windsurfrules` file is auto-generated from all common rules and loaded by
|
|
|
370
334
|
Works with any target:
|
|
371
335
|
|
|
372
336
|
```bash
|
|
373
|
-
# Claude Code
|
|
374
|
-
|
|
375
|
-
npx
|
|
376
|
-
|
|
377
|
-
# Windsurf
|
|
378
|
-
npx github:sifxprime/kodelyth-ecc --target windsurf-project --profile nextjs
|
|
379
|
-
|
|
380
|
-
# Antigravity
|
|
381
|
-
npx github:sifxprime/kodelyth-ecc --target antigravity --profile python-api
|
|
337
|
+
npx kodelyth-ecc --profile nextjs # Claude Code
|
|
338
|
+
npx kodelyth-ecc --target windsurf-project --profile nextjs # Windsurf
|
|
339
|
+
npx kodelyth-ecc --target antigravity --profile python-api # Antigravity
|
|
382
340
|
```
|
|
383
341
|
|
|
384
342
|
Available profiles:
|
|
@@ -391,9 +349,10 @@ Available profiles:
|
|
|
391
349
|
| `mobile` | Kotlin + Swift rules |
|
|
392
350
|
| `backend` | Go + Python + Java rules |
|
|
393
351
|
|
|
394
|
-
|
|
352
|
+
Or specify languages directly:
|
|
353
|
+
|
|
395
354
|
```bash
|
|
396
|
-
npx
|
|
355
|
+
npx kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart
|
|
397
356
|
```
|
|
398
357
|
|
|
399
358
|
---
|
|
@@ -404,21 +363,47 @@ npx github:sifxprime/kodelyth-ecc typescript python golang rust java kotlin php
|
|
|
404
363
|
|---|---|---|---|
|
|
405
364
|
| Claude Code | Full | `claude-home` (default) | Agents, skills, commands, hooks, rules |
|
|
406
365
|
| Windsurf | Full | `windsurf-project` / `windsurf-home` | Agents, skills, rules, `.windsurfrules` |
|
|
407
|
-
| Google Antigravity | Full | `antigravity` | Agents → skills, commands → workflows, rules |
|
|
408
366
|
| Cursor | Full | `cursor-project` | Rules, skills |
|
|
409
367
|
| Codex CLI | Full | `codex-home` | Agents, skills, commands, rules |
|
|
368
|
+
| Google Antigravity | Full | `antigravity` | Agents → skills, commands → workflows, rules |
|
|
410
369
|
| OpenCode | Full | `opencode` | Rules |
|
|
411
370
|
|
|
371
|
+
**OS support:** macOS, Linux (`install.sh`), Windows (`install.ps1`), or any OS with Node.js 18+ (`npx`).
|
|
372
|
+
|
|
373
|
+
---
|
|
374
|
+
|
|
375
|
+
## Privacy & Philosophy
|
|
376
|
+
|
|
377
|
+
ECC is **100% local files**. No telemetry, no cloud, no account, no tracking. Everything is markdown your AI reads on every session.
|
|
378
|
+
|
|
379
|
+
- **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.
|
|
380
|
+
- **No phoning home** — install scripts copy files and exit. That's it.
|
|
381
|
+
- **You own everything** — fork the repo, edit any agent, write your own.
|
|
382
|
+
|
|
412
383
|
---
|
|
413
384
|
|
|
414
385
|
## Contributing
|
|
415
386
|
|
|
416
|
-
We welcome new agents, skills, and
|
|
387
|
+
We welcome new agents, skills, hooks, and intent routing patterns that meet the **Kodelyth Standard** — specialist personas, model-agnostic, production-grade examples.
|
|
388
|
+
|
|
389
|
+
When adding a new agent, also update `rules/common/agent-intent-routing.md` with your trigger patterns so the intent router knows when to call you.
|
|
417
390
|
|
|
418
391
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for templates, checklists, and the full Kodelyth Standard.
|
|
419
392
|
|
|
420
393
|
---
|
|
421
394
|
|
|
395
|
+
## Changelog
|
|
396
|
+
|
|
397
|
+
See [CHANGELOG.md](CHANGELOG.md). v1.3.0 highlights:
|
|
398
|
+
|
|
399
|
+
- **Removed:** Lens dashboard (was inaccurate across cloud-AI platforms)
|
|
400
|
+
- **Added:** God-tier `agent-intent-routing` rule — 10 priority tiers, 50+ patterns
|
|
401
|
+
- **Added:** 5 new agents — `dependency-doctor`, `git-rescue`, `release-captain`, `env-debugger`, `flake-hunter`
|
|
402
|
+
- **Added:** 2 new skills — `intent-routing` (routing system docs), `agent-handoff` (chain protocol)
|
|
403
|
+
- **Improved:** Cross-platform install parity — full Windows support for all targets
|
|
404
|
+
|
|
405
|
+
---
|
|
406
|
+
|
|
422
407
|
<div align="center">
|
|
423
408
|
|
|
424
409
|
Built and maintained by **Kodelyth** — [@sifxprime](https://github.com/sifxprime)
|
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.3.0
|