kodelyth-ecc 1.2.2 → 1.4.0

package/KODELYTH.md

@@ -2,68 +2,103 @@
 
 Kodelyth ECC is built and maintained by **Kodelyth** — a brand focused on making AI-powered developer tooling smarter, faster, and production-grade for real-world use at scale.
 
-## What Kodelyth Added — v1.2.0
+## What's New in v1.3.0
 
-### Agents (6 exclusive)
+### Removed: Lens Dashboard
 
-| Agent | Added | Description |
-|---|---|---|
-| `kodelyth-advisor` | v1.0.0 | Master guide — reads your intent and points you to the right tool instantly |
-| `debug-detective` | v1.0.0 | Root-cause hunter — traces every bug through evidence, never guesses |
-| `ux-reviewer` | v1.0.0 | UX and WCAG 2.1 AA reviewer — catches what users feel before they feel it |
-| `api-guardian` | v1.1.0 | API contract protector — classifies every change as BREAKING/SAFE/WARN |
-| `pair-programmer` | v1.1.0 | Pre-code thinking partner — catches wrong approaches before a line is written |
-| `migration-guide` | v1.1.0 | Framework migration specialist — full playbooks for React, Next.js, Python, Java, Go |
+The bundled Kodelyth Lens dashboard has been removed. It tried to track usage across Claude Code, Windsurf, Cursor, Codex, OpenCode, and Antigravity — but cloud-AI platforms (Windsurf, Antigravity, parts of Cursor) don't expose token/cost data locally, which led to inaccurate or hardcoded zeros in the dashboard.
 
-### Skills (4 exclusive)
+The toolkit is now leaner and **does only what it does honestly**: ship rules, agents, and skills your AI loads on every session.
 
-| Skill | Added | Description |
-|---|---|---|
-| `kodelyth-quickstart` | v1.0.0 | Plain-language onboarding guide — up and running in 10 minutes |
-| `smart-debug` | v1.0.0 | Structured 5-step debugging framework — ends guess-and-check forever |
-| `git-mastery` | v1.1.0 | Trunk-based dev, gitflow, Ship/Show/Ask, rebase, bisect, monorepos |
-| `observability` | v1.1.0 | Structured logging, Four Golden Signals, OpenTelemetry, SLOs |
+### Added: God-Tier Intent Routing
 
-### Hooks (3 new in v1.1.0)
+A new rule (`rules/common/agent-intent-routing.md`) auto-loads with every session and maps user intent → specialist agent across 10 priority tiers, 50+ pattern groups.
 
-| Hook | Trigger | What it does |
-|---|---|---|
-| `test-reminder` | After code file edit | Reminds you to write tests when no test file was touched |
-| `smart-suggest` | After each response | Reads session signals and suggests the next logical agent |
-| `branch-name-check` | Before `git checkout -b` | Blocks non-standard branch names |
+Now the user just describes their problem in plain words and the AI:
+
+1. Announces which specialist is taking over (`→ Routing to <agent>`)
+2. Behaves as that agent
+3. Teaches the user the explicit form (`Tip: type "use <agent>"`)
+
+No more memorizing 59 agent names.
 
-### Kodelyth Lens — AI Usage Dashboard (v1.2.0)
+### Added: 5 New Specialist Agents
 
-Built-in zero-dependency dashboard at `~/.kodelyth/lens/`. Reads from 6 platforms:
+| Agent | What it does |
+|---|---|
+| `dependency-doctor` | Diagnoses npm/pip/cargo/maven dep hell, CVEs, lockfile drift |
+| `git-rescue` | Recovers broken git states without destroying history |
+| `release-captain` | Owns the release ritual — semver, tagging, publishing, rollback |
+| `env-debugger` | "Works on my machine" hunter — env, config, secrets, layers |
+| `flake-hunter` | Stabilizes flaky tests — never adds blind retries |
 
-- **Claude Code** — full local JSONL session logs
-- **Codex CLI** — SQLite threads database
-- **Windsurf** — workspaceStorage and Cascade files
-- **Cursor** — workspaceStorage and chat files
-- **OpenCode** — local JSONL/JSON session files
-- **Antigravity** — ECC project detection (AI sessions server-side)
+### Added: 2 New Meta Skills
 
-Features:
-- Agent leaderboard with call counts and platform breakdown
-- Intent detection — 12 categories, 50+ patterns — infers agent usage from natural language
-- ECC savings banner — shows actual cost vs. estimated without-ECC
-- 30-day cost chart, cache hit rate, today vs. all-time stats
-- Only shows installed platforms — nothing shown for platforms you don't have
+| Skill | What it does |
+|---|---|
+| `intent-routing` | Documents the routing system, priority tiers, design rules for new agents |
+| `agent-handoff` | Standard multi-agent chain protocol with 10 documented chains |
+
+---
+
+## Kodelyth Exclusives — The 11 Agents That Define ECC
+
+| Agent | Job |
+|---|---|
+| `kodelyth-advisor` | Master guide — picks the right tool when you don't know where to start |
+| `pair-programmer` | The engineer who sits next to you **before** you write the code |
+| `debug-detective` | Never guesses — traces every bug to root cause through evidence |
+| `silent-failure-hunter` | Finds bugs that don't throw errors |
+| `ux-reviewer` | Reviews UX behavior + WCAG 2.1 AA accessibility |
+| `api-guardian` | Detects breaking API changes before they ship |
+| `migration-guide` | Framework / language version upgrades, phase by phase |
+| `dependency-doctor` | Dep hell — CVE triage, lockfile diagnosis, safe upgrade plans |
+| `git-rescue` | Broken git states, lost commits, bad rebases — without destroying history |
+| `release-captain` | Owns the release ritual, semver, rollback rehearsal |
+| `env-debugger` | "Works on my machine" — environment, config, secrets layers |
+| `flake-hunter` | Flaky test stabilization — root cause, not retries |
+
+---
 
-### Install Improvements (v1.2.0)
+## Kodelyth-Authored Skills
 
-- `npx github:sifxprime/kodelyth-ecc` — works from any machine with Node.js 18+
-- `--target windsurf-project` and `--target windsurf-home` — full Windsurf support
-- Auto-generates `.windsurfrules` from all common rules (Cascade reads it automatically)
-- Non-interactive install works (CI, Docker, headless environments)
-- `go` normalized to `golang` in language argument parser
+| Skill | Description |
+|---|---|
+| `kodelyth-quickstart` | Plain-language onboarding guide |
+| `smart-debug` | Structured 5-step debugging framework |
+| `git-mastery` | Trunk-based dev, rebase, bisect, monorepos |
+| `observability` | Structured logging, Four Golden Signals, OpenTelemetry, SLOs |
+| `intent-routing` | How auto-routing works, priority tiers, design rules |
+| `agent-handoff` | Standard multi-agent chain protocol |
+
+---
+
+## Hooks (15+)
+
+| Hook | Trigger | What it does |
+|---|---|---|
+| `session-start` | Session boot | Loads context from previous session |
+| `pre-commit` | Before `git commit` | Catches `console.log`, secrets, bad commit messages |
+| `quality-gate` | After file edit | Runs type checks and formatting |
+| `git-push-reminder` | Before `git push` | Prompts review |
+| `config-protection` | Before linter config edit | Blocks weakening of standards |
+| `desktop-notify` | Long task complete | macOS notification |
+| `mcp-health-check` | Before MCP call | Validates server health |
+| `test-reminder` | Code edit without tests | Prompts to write tests |
+| `smart-suggest` | After response | Suggests next logical agent |
+| `branch-name-check` | Before branch create | Blocks non-standard names |
+
+---
 
 ## Kodelyth Philosophy
 
 - **Smart defaults** — the system guides you to the right tool without you needing to know everything upfront
 - **Production quality** — every enhancement is battle-tested, not theoretical
 - **Zero friction** — good tools get out of the way and let you build
-- **Real data** — Lens shows your actual usage, no hardcoding, no placeholders
+- **No magic, no telemetry** — everything is markdown your AI reads on every session; nothing phones home
+- **Honest about limits** — if we can't measure something accurately, we don't pretend (this is why Lens was removed)
+
+---
 
 ## Credits