kodelyth-ecc 1.4.1 → 1.5.1

package/hooks/memory/read-lessons.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+// =============================================================================
+// Kodelyth ECC — Lessons + Project DNA Hook (SessionStart)
+//
+// Runs at the start of every Claude Code session. Does two things:
+//
+//   1. LESSONS: Reads tasks/lessons.md from the project root (if it exists)
+//      and injects the encoded rules as high-priority context. These are
+//      corrections the user made in past sessions — hard rules, not soft
+//      suggestions. Claude MUST follow them for this session.
+//
+//   2. PROJECT DNA: Detects the tech stack, package manager, and key
+//      conventions from the project root (package.json, go.mod, Cargo.toml,
+//      etc.) and injects a concise project brief so Claude doesn't need to
+//      re-discover basics each session.
+//
+// Output contract: emit { additionalContext: "..." } to stdout.
+// Never block a session — exit 0 even on any error.
+// =============================================================================
+
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+
+let raw = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => { raw += chunk; });
+process.stdin.on('end', run);
+setTimeout(() => { if (!process.stdin.readableEnded) run(); }, 150);
+
+function run() {
+  try {
+    const payload = raw ? JSON.parse(raw) : {};
+    const projectRoot = payload.cwd || payload.project_root || process.cwd();
+
+    const parts = [];
+
+    const lessons = readLessons(projectRoot);
+    if (lessons) parts.push(lessons);
+
+    const dna = buildProjectDNA(projectRoot);
+    if (dna) parts.push(dna);
+
+    if (parts.length === 0) {
+      process.exit(0);
+    }
+
+    process.stdout.write(JSON.stringify({
+      additionalContext: parts.join('\n\n---\n\n'),
+      meta: { source: 'kodelyth-ecc:read-lessons', hasLessons: !!lessons, hasDNA: !!dna },
+    }));
+    process.exit(0);
+  } catch (err) {
+    process.stderr.write(`[ecc:read-lessons] ${err.message}\n`);
+    process.exit(0);
+  }
+}
+
+// ── Read tasks/lessons.md and format as hard rules ────────────────────────
+function readLessons(projectRoot) {
+  const lessonsFile = path.join(projectRoot, 'tasks', 'lessons.md');
+  if (!fs.existsSync(lessonsFile)) return null;
+
+  const content = fs.readFileSync(lessonsFile, 'utf8').trim();
+  if (!content) return null;
+
+  // Extract all bullet rules across all dated sections
+  const rules = content
+    .split('\n')
+    .filter(line => line.match(/^-\s+.{5,}/))
+    .map(line => line.trim())
+    .filter(Boolean);
+
+  if (rules.length === 0) return null;
+
+  return [
+    '## PROJECT LESSONS — HARD RULES (from past corrections)',
+    '',
+    'These rules were encoded from corrections made in previous sessions.',
+    'You MUST follow them for this entire session. They override generic defaults.',
+    '',
+    rules.join('\n'),
+  ].join('\n');
+}
+
+// ── Detect project tech stack and conventions ─────────────────────────────
+function buildProjectDNA(projectRoot) {
+  const facts = [];
+
+  // Node / JS / TS
+  const pkgPath = path.join(projectRoot, 'package.json');
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+      const name = pkg.name || path.basename(projectRoot);
+      facts.push(`Project: ${name} (Node.js / JavaScript)`);
+
+      // Package manager
+      if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml'))) {
+        facts.push('Package manager: pnpm');
+      } else if (fs.existsSync(path.join(projectRoot, 'bun.lockb')) || fs.existsSync(path.join(projectRoot, 'bun.lock'))) {
+        facts.push('Package manager: bun');
+      } else if (fs.existsSync(path.join(projectRoot, 'yarn.lock'))) {
+        facts.push('Package manager: yarn');
+      } else {
+        facts.push('Package manager: npm');
+      }
+
+      // Framework detection
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      const frameworks = [];
+      if (deps.next) frameworks.push(`Next.js ${deps.next}`);
+      if (deps.react) frameworks.push(`React ${deps.react}`);
+      if (deps.vue) frameworks.push(`Vue ${deps.vue}`);
+      if (deps.svelte) frameworks.push(`Svelte`);
+      if (deps.express) frameworks.push(`Express ${deps.express}`);
+      if (deps.fastify) frameworks.push(`Fastify`);
+      if (deps.nestjs || deps['@nestjs/core']) frameworks.push('NestJS');
+      if (deps.typescript || deps['ts-node']) frameworks.push('TypeScript');
+      if (deps.prisma || deps['@prisma/client']) frameworks.push('Prisma');
+      if (deps.drizzle) frameworks.push('Drizzle ORM');
+      if (frameworks.length > 0) facts.push(`Stack: ${frameworks.join(', ')}`);
+
+      // Test runner
+      if (deps.jest) facts.push('Test runner: Jest');
+      else if (deps.vitest) facts.push('Test runner: Vitest');
+      else if (deps.mocha) facts.push('Test runner: Mocha');
+    } catch {}
+  }
+
+  // Go
+  const goModPath = path.join(projectRoot, 'go.mod');
+  if (fs.existsSync(goModPath)) {
+    try {
+      const goMod = fs.readFileSync(goModPath, 'utf8');
+      const moduleLine = goMod.match(/^module (.+)/m);
+      const goVersion  = goMod.match(/^go (.+)/m);
+      facts.push(`Project: ${moduleLine?.[1] || 'Go module'} (Go${goVersion ? ' ' + goVersion[1] : ''})`);
+    } catch {}
+  }
+
+  // Rust
+  const cargoPath = path.join(projectRoot, 'Cargo.toml');
+  if (fs.existsSync(cargoPath)) {
+    try {
+      const cargo = fs.readFileSync(cargoPath, 'utf8');
+      const name  = cargo.match(/^name\s*=\s*"(.+)"/m);
+      facts.push(`Project: ${name?.[1] || 'Rust crate'} (Rust / Cargo)`);
+    } catch {}
+  }
+
+  // Python
+  const reqPath   = path.join(projectRoot, 'requirements.txt');
+  const pyprojPath = path.join(projectRoot, 'pyproject.toml');
+  if (fs.existsSync(reqPath) || fs.existsSync(pyprojPath)) {
+    facts.push('Language: Python');
+    if (fs.existsSync(path.join(projectRoot, 'poetry.lock'))) facts.push('Package manager: Poetry');
+    else if (fs.existsSync(path.join(projectRoot, 'Pipfile.lock'))) facts.push('Package manager: Pipenv');
+    else facts.push('Package manager: pip');
+  }
+
+  // Java / Kotlin
+  if (fs.existsSync(path.join(projectRoot, 'build.gradle')) || fs.existsSync(path.join(projectRoot, 'build.gradle.kts'))) {
+    facts.push('Build: Gradle (Java / Kotlin)');
+  }
+  if (fs.existsSync(path.join(projectRoot, 'pom.xml'))) {
+    facts.push('Build: Maven (Java)');
+  }
+
+  // Existing tasks/todo.md
+  const todoPath = path.join(projectRoot, 'tasks', 'todo.md');
+  if (fs.existsSync(todoPath)) {
+    const todo = fs.readFileSync(todoPath, 'utf8').trim();
+    const openItems = todo.split('\n').filter(l => l.match(/^-\s*\[ \]/)).slice(0, 5);
+    if (openItems.length > 0) {
+      facts.push('');
+      facts.push('Open tasks (from tasks/todo.md):');
+      openItems.forEach(item => facts.push(item.trim()));
+    }
+  }
+
+  if (facts.length === 0) return null;
+
+  return [
+    '## PROJECT DNA (auto-detected)',
+    '',
+    facts.join('\n'),
+  ].join('\n');
+}

package/install.sh

@@ -47,7 +47,7 @@ echo -e "${RED}${BOLD}  ║   DANGER LEVEL: GOD TIER    ·    NOT FOR JUNIOR DEV
 echo -e "${RED}${BOLD}  ╚══════════════════════════════════════════════════════════════╝${RESET}"
 echo ""
 echo -e "${BOLD}  Kodelyth ECC — The most dangerous AI coding toolkit on the planet${RESET}"
-echo -e "${CYAN}  59 specialist agents  ·  188 skills  ·  80 commands  ·  18+ hooks  ·  intent routing  ·  local memory${RESET}"
+echo -e "${CYAN}  61 specialist agents  ·  188 skills  ·  80 commands  ·  20+ hooks  ·  intent routing  ·  compound memory${RESET}"
 echo -e "${CYAN}  Any language  ·  Any framework  ·  Any scale  ·  300B-level quality${RESET}"
 echo ""
 echo -e "  github.com/sifxprime/kodelyth-ecc"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kodelyth-ecc",
-  "version": "1.4.1",
-  "description": "Production-grade AI coding toolkit — 59 agents, 188 skills, 80 commands, god-tier intent routing, local self-learning memory with auto chat detection. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, and OpenCode.",
+  "version": "1.5.1",
+  "description": "Production-grade AI coding toolkit \u2014 61 agents, 188 skills, 80 commands, god-tier intent routing, local self-learning memory with auto chat detection, incident response, load testing. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, and OpenCode.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",
   "repository": {
@@ -22,6 +22,8 @@
     "memory",
     "self-learning",
     "auto-recall",
+    "incident-response",
+    "load-testing",
     "kodelyth"
   ],
   "bin": {

package/rules/common/agent-intent-routing.md

@@ -134,7 +134,33 @@ Trigger if the user describes **what they're about to build** before they start.
 
 ## Priority 4 — Performance & Scale
 
-### `performance-optimizer` — Slowness / bottleneck
+### `incident-commander` — Production is down or degraded
+
+Route here FIRST for any active production incident. This takes priority over `debug-detective` when the incident is live in production.
+
+| Signal | Examples |
+|---|---|
+| Production down | "production is down", "outage", "site is down", "service unavailable" |
+| P0 / P1 | "P0", "P1", "incident", "on-call", "pagerduty fired", "alert triggered" |
+| Blast radius | "10% of users affected", "all requests failing", "error rate spiked" |
+| Active degradation | "production is throwing 500s", "latency is through the roof", "database is down" |
+| Postmortem | "postmortem", "incident review", "blameless review", "what went wrong" |
+
+**Counter-signals:** development bug (not production), staging environment, local testing — route to `debug-detective` instead.
+
+### `load-tester` — Load, stress, and capacity testing
+
+| Signal | Examples |
+|---|---|
+| Load test request | "load test", "stress test", "performance test", "capacity test" |
+| Tools | "k6", "Locust", "Artillery", "wrk", "Gatling", "hey", "ab test" |
+| Capacity planning | "how many users can we handle", "what's our breaking point", "max RPS" |
+| Pre-launch validation | "will this hold under load", "ready for launch traffic", "scale test" |
+| Soak test | "soak test", "memory leak under load", "sustained load test" |
+
+**Counter-signal:** "make this code faster" → `performance-optimizer`. Load-tester handles test design, not code optimization.
+
+### `performance-optimizer` — Slowness / bottleneck in code
 
 | Signal | Examples |
 |---|---|
@@ -284,6 +310,8 @@ Use the chain: `forker` → `sanitizer` → `packager`.
 | `migration-guide` (plan made) | `pr-test-analyzer` after PR is up |
 | `architect` (design done) | `code-architect` for the first feature |
 | `performance-optimizer` (bottleneck found) | `tdd-guide` for a perf regression test |
+| `load-tester` (bottleneck found) | `performance-optimizer` to fix the code |
+| `incident-commander` (incident resolved) | `debug-detective` for deeper root cause, then postmortem |
 
 ### Parallel suggestions
 
@@ -321,6 +349,10 @@ If the user has a multi-faceted concern, name the parallel agents:
 | "Add accessibility to this form" | `ux-reviewer` | a11y |
 | "Plan the v2 redesign" | `planner` → `architect` | Plan + design |
 | "open source this project" | `opensource-forker` | OSS chain start |
+| "production is down, getting 500s" | `incident-commander` | Active production incident |
+| "will this hold under 10k concurrent users" | `load-tester` | Capacity / load testing question |
+| "run a load test before launch" | `load-tester` | Pre-launch load validation |
+| "postmortem for yesterday's outage" | `incident-commander` | Postmortem workflow |
 
 ---
 

package/rules/common/self-improvement-workflow.md

@@ -0,0 +1,126 @@
+# Self-Improvement Workflow — Compound Learning System
+
+This rule encodes the workflow used by the Claude Code team internally, extended with ECC's three-layer compound memory architecture. Every session makes Claude more aligned with how YOU think and work.
+
+---
+
+## 1. Plan Node Default
+
+Enter plan mode for ANY non-trivial task (3+ steps, architectural decisions, or anything that touches more than 2 files):
+
+- Write the plan to `tasks/todo.md` with checkable items before writing a single line of code
+- If something goes sideways mid-task: STOP, re-plan, do not keep pushing
+- Use plan mode for verification steps, not just building
+- Write detailed specs upfront — ambiguity at start = bugs at end
+- Check plan with the user before executing when scope is large
+
+## 2. Subagent Strategy
+
+The 61 ECC specialist agents exist so the main context window stays clean:
+
+- Offload research, exploration, and parallel analysis to subagents
+- For complex problems: throw more compute via agents, not more tokens in main context
+- One task per subagent — focused execution beats monolithic threads
+- Intent routing picks the right specialist automatically — trust it
+
+## 3. Self-Improvement Loop (CRITICAL)
+
+**After ANY correction from the user — no matter how small — encode it permanently.**
+
+When the user says something like "no, don't do that", "use X instead", "I told you to", "wrong approach", "stop doing X":
+
+1. **Acknowledge** the correction in one line
+2. **Apply** it immediately in the current response
+3. **Encode** it: mentally append the rule to `tasks/lessons.md` in the project root
+
+The AI MUST track corrections within a session and apply them consistently from that point forward. The `capture-correction.js` hook writes them to disk automatically at session end.
+
+### How lessons compound
+
+```
+Session 1:  User corrects "use pnpm not npm" → lesson written
+Session 2:  Claude reads lesson → never uses npm again in this project
+Session 3+: New lessons stack → Claude increasingly matches YOUR style
+Month 3:    Claude works like a team member who has been here for years
+```
+
+**Review and extend lessons** at `tasks/lessons.md` — edit them freely, they are yours.
+
+## 4. Verification Before Done
+
+Never mark a task complete without proving it works:
+
+- Run the actual code, test, or command — do not assume
+- Diff behavior between baseline and your changes when relevant
+- Ask: "Would a staff engineer approve this PR?"
+- Run tests, check logs, demonstrate correctness with evidence
+- If verification fails: fix, do not close the loop
+
+## 5. Demand Elegance (Balanced)
+
+For non-trivial changes, pause before presenting:
+
+- Ask internally: "Is there a more elegant solution?"
+- If the fix feels hacky: "Knowing everything I know now, implement the elegant solution"
+- **Skip this for simple, obvious fixes** — do not over-engineer
+- Challenge your own work before presenting it
+- Three lines of clear code beat a clever one-liner every time
+
+## 6. Autonomous Bug Fixing
+
+When given a bug report: fix it. Do not ask for hand-holding:
+
+- Point at logs, errors, and failing tests — then resolve them
+- Zero context switching required from the user
+- Go fix failing CI tests without being told how
+- Use `debug-detective` for root cause analysis (never patch symptoms)
+- Use `silent-failure-hunter` when there is no error message
+
+---
+
+## Task Management Protocol
+
+When starting any non-trivial task:
+
+1. **Plan First** — write plan to `tasks/todo.md` with checkable items
+2. **Verify Plan** — check in before starting implementation on large tasks
+3. **Track Progress** — mark items complete as you go
+4. **Explain Changes** — high-level summary at each step
+5. **Document Results** — add review section to `tasks/todo.md`
+6. **Capture Lessons** — `tasks/lessons.md` is updated automatically by the correction hook
+
+---
+
+## Three-Layer Compound Memory Architecture
+
+ECC uses three compounding memory layers — together they make Claude increasingly match how you think:
+
+### Layer 1 — Project Lessons (`tasks/lessons.md`)
+- Per-project. Human-readable. Hard rules.
+- Written automatically when you correct Claude (via `capture-correction.js` Stop hook)
+- Injected at session start (via `read-lessons.js` SessionStart hook)
+- Edit freely — these are YOUR rules for this project
+- Example: "Always use pnpm. Never npm. Never yarn."
+
+### Layer 2 — Global Memory (`~/.kodelyth/memory/`)
+- Cross-project. BM25 fuzzy search. Solution patterns.
+- Captures solutions from every session
+- Auto-recalls relevant past solutions on every prompt you type
+- Example: "Last time you had a CORS issue in Express, you added this middleware..."
+
+### Layer 3 — Intent Routing (`rules/common/agent-intent-routing.md`)
+- Always-on. 61 specialists. Zero setup.
+- Routes your message to the right expert from the first word
+- No agent names needed — just describe the problem
+
+**Combined effect**: Layer 1 knows your project rules. Layer 2 knows your past solutions. Layer 3 knows your intent. Together they eliminate the ramp-up cost of every session.
+
+---
+
+## Core Principles
+
+- **Simplicity First** — make every change as simple as possible, impact minimal code
+- **No Laziness** — find root causes, no temporary fixes, senior developer standards
+- **Minimal Impact** — changes touch only what's necessary, avoid introducing bugs
+- **Immutability** — create new objects, never mutate existing ones
+- **No Guessing** — if uncertain, ask. Never fabricate facts or behavior.

package/social/card-agents.svg

@@ -1,96 +1,91 @@
-<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg" font-family="'Segoe UI', system-ui, -apple-system, sans-serif">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 700 420" width="700" height="420" font-family="'Segoe UI', system-ui, -apple-system, sans-serif">
   <defs>
-    <linearGradient id="bg2" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#0a0a0f"/>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#050811"/>
       <stop offset="100%" style="stop-color:#0d1117"/>
     </linearGradient>
-    <linearGradient id="acc2" x1="0%" y1="0%" x2="100%" y2="0%">
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
       <stop offset="0%" style="stop-color:#7c3aed"/>
       <stop offset="100%" style="stop-color:#2563eb"/>
     </linearGradient>
+    <linearGradient id="mem" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#059669"/>
+      <stop offset="100%" style="stop-color:#0891b2"/>
+    </linearGradient>
   </defs>
 
-  <rect width="1200" height="630" fill="url(#bg2)"/>
-  <rect x="0" y="0" width="1200" height="4" fill="url(#acc2)"/>
-
-  <!-- Grid -->
-  <g opacity="0.03" stroke="#ffffff" stroke-width="1">
-    <line x1="0" y1="126" x2="1200" y2="126"/>
-    <line x1="0" y1="252" x2="1200" y2="252"/>
-    <line x1="0" y1="378" x2="1200" y2="378"/>
-    <line x1="0" y1="504" x2="1200" y2="504"/>
-    <line x1="240" y1="0" x2="240" y2="630"/>
-    <line x1="480" y1="0" x2="480" y2="630"/>
-    <line x1="720" y1="0" x2="720" y2="630"/>
-    <line x1="960" y1="0" x2="960" y2="630"/>
-  </g>
+  <rect width="700" height="420" fill="url(#bg)" rx="12"/>
+  <rect x="0" y="0" width="700" height="3" fill="url(#accent)" rx="2"/>
 
   <!-- Header -->
-  <text x="60" y="80" font-size="15" font-weight="700" letter-spacing="4" fill="#7c3aed">KODELYTH ECC</text>
-  <text x="60" y="130" font-size="52" font-weight="900" letter-spacing="-1" fill="#ffffff">Meet Your AI Team.</text>
-  <text x="60" y="175" font-size="18" fill="#64748b">6 Kodelyth-exclusive agents. Each one a decade-experienced specialist.</text>
+  <text x="28" y="42" font-size="18" font-weight="800" fill="#ffffff">61 Agents — The Complete Roster</text>
+  <text x="28" y="62" font-size="11.5" fill="#6e7681">Every specialist you need. Intent routing picks the right one automatically.</text>
+
+  <!-- Category: Debugging -->
+  <text x="28" y="90" font-size="9.5" fill="#484f58" letter-spacing="1.5">DEBUGGING</text>
+  <rect x="28" y="98" width="196" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="28" y="98" width="2.5" height="56" rx="1" fill="#dc2626"/>
+  <text x="40" y="116" font-size="11" font-weight="700" fill="#f87171">debug-detective</text>
+  <text x="40" y="131" font-size="10.5" fill="#6e7681">Root cause, never symptoms</text>
+  <text x="40" y="147" font-size="9" fill="#30363d">CLAIM · EVIDENCE · TEST</text>
 
-  <rect x="60" y="195" width="1080" height="1" fill="#1e293b"/>
+  <rect x="234" y="98" width="196" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="234" y="98" width="2.5" height="56" rx="1" fill="#dc2626"/>
+  <text x="246" y="116" font-size="11" font-weight="700" fill="#f87171">silent-failure-hunter</text>
+  <text x="246" y="131" font-size="10.5" fill="#6e7681">Swallowed errors, bad fallbacks</text>
+  <text x="246" y="147" font-size="9" fill="#30363d">Error Propagation</text>
 
-  <!-- Agent cards — Row 1 -->
-  <!-- Card 1: kodelyth-advisor -->
-  <rect x="60" y="215" width="320" height="130" rx="8" fill="#0f172a" stroke="#1e293b" stroke-width="1"/>
-  <rect x="60" y="215" width="4" height="130" rx="2" fill="#7c3aed"/>
-  <text x="80" y="248" font-size="14" font-weight="700" fill="#a78bfa">kodelyth-advisor</text>
-  <text x="80" y="270" font-size="12" fill="#475569">The Master Guide</text>
-  <text x="80" y="298" font-size="12" fill="#94a3b8">Reads your situation. Tells you</text>
-  <text x="80" y="316" font-size="12" fill="#94a3b8">exactly what to do. No guessing.</text>
-  <text x="80" y="334" font-size="11" fill="#334155">Guidance · Direction · Clarity</text>
+  <rect x="440" y="98" width="232" height="56" rx="6" fill="#0d2b1d" stroke="#059669" stroke-opacity="0.4" stroke-width="1"/>
+  <rect x="440" y="98" width="2.5" height="56" rx="1" fill="url(#mem)"/>
+  <text x="452" y="116" font-size="11" font-weight="700" fill="#10b981">kodelyth-memory</text>
+  <rect x="568" y="102" width="36" height="14" rx="7" fill="#059669" fill-opacity="0.3" stroke="#059669" stroke-opacity="0.5" stroke-width="1"/>
+  <text x="586" y="113" font-size="8" fill="#10b981" text-anchor="middle" font-weight="700">NEW</text>
+  <text x="452" y="131" font-size="10.5" fill="#6e7681">Self-learning memory + BM25</text>
+  <text x="452" y="147" font-size="9" fill="#30363d">Memory · Auto-Recall</text>
 
-  <!-- Card 2: debug-detective -->
-  <rect x="400" y="215" width="320" height="130" rx="8" fill="#0f172a" stroke="#1e293b" stroke-width="1"/>
-  <rect x="400" y="215" width="4" height="130" rx="2" fill="#dc2626"/>
-  <text x="420" y="248" font-size="14" font-weight="700" fill="#f87171">debug-detective</text>
-  <text x="420" y="270" font-size="12" fill="#475569">The Root Cause Hunter</text>
-  <text x="420" y="298" font-size="12" fill="#94a3b8">Never guesses. Traces every bug</text>
-  <text x="420" y="316" font-size="12" fill="#94a3b8">to its exact origin. Always.</text>
-  <text x="420" y="334" font-size="11" fill="#334155">Debugging · Analysis · Evidence</text>
+  <!-- Category: Security & Quality -->
+  <text x="28" y="172" font-size="9.5" fill="#484f58" letter-spacing="1.5">SECURITY &amp; QUALITY</text>
+  <rect x="28" y="180" width="196" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="28" y="180" width="2.5" height="56" rx="1" fill="#f59e0b"/>
+  <text x="40" y="198" font-size="11" font-weight="700" fill="#fcd34d">security-reviewer</text>
+  <text x="40" y="213" font-size="10.5" fill="#6e7681">OWASP · secrets · injection</text>
+  <text x="40" y="229" font-size="9" fill="#30363d">Security</text>
 
-  <!-- Card 3: ux-reviewer -->
-  <rect x="740" y="215" width="320" height="130" rx="8" fill="#0f172a" stroke="#1e293b" stroke-width="1"/>
-  <rect x="740" y="215" width="4" height="130" rx="2" fill="#0891b2"/>
-  <text x="760" y="248" font-size="14" font-weight="700" fill="#67e8f9">ux-reviewer</text>
-  <text x="760" y="270" font-size="12" fill="#475569">The Interface Guardian</text>
-  <text x="760" y="298" font-size="12" fill="#94a3b8">Reviews UI for real users.</text>
-  <text x="760" y="316" font-size="12" fill="#94a3b8">WCAG 2.1 AA. Never touches design.</text>
-  <text x="760" y="334" font-size="11" fill="#334155">UX · Accessibility · Behavior</text>
+  <rect x="234" y="180" width="196" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="234" y="180" width="2.5" height="56" rx="1" fill="#8b5cf6"/>
+  <text x="246" y="198" font-size="11" font-weight="700" fill="#c4b5fd">code-reviewer</text>
+  <text x="246" y="213" font-size="10.5" fill="#6e7681">Quality, patterns, best practices</text>
+  <text x="246" y="229" font-size="9" fill="#30363d">Review</text>
 
-  <!-- Agent cards — Row 2 -->
-  <!-- Card 4: api-guardian -->
-  <rect x="60" y="360" width="320" height="130" rx="8" fill="#0f172a" stroke="#1e293b" stroke-width="1"/>
-  <rect x="60" y="360" width="4" height="130" rx="2" fill="#f59e0b"/>
-  <text x="80" y="393" font-size="14" font-weight="700" fill="#fcd34d">api-guardian</text>
-  <text x="80" y="415" font-size="12" fill="#475569">The Contract Protector</text>
-  <text x="80" y="443" font-size="12" fill="#94a3b8">Catches breaking API changes</text>
-  <text x="80" y="461" font-size="12" fill="#94a3b8">before they reach production.</text>
-  <text x="80" y="479" font-size="11" fill="#334155">API · Versioning · Contracts</text>
+  <rect x="440" y="180" width="232" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="440" y="180" width="2.5" height="56" rx="1" fill="#10b981"/>
+  <text x="452" y="198" font-size="11" font-weight="700" fill="#6ee7b7">pair-programmer</text>
+  <text x="452" y="213" font-size="10.5" fill="#6e7681">Catches wrong approach pre-code</text>
+  <text x="452" y="229" font-size="9" fill="#30363d">Planning</text>
 
-  <!-- Card 5: pair-programmer -->
-  <rect x="400" y="360" width="320" height="130" rx="8" fill="#0f172a" stroke="#1e293b" stroke-width="1"/>
-  <rect x="400" y="360" width="4" height="130" rx="2" fill="#10b981"/>
-  <text x="420" y="393" font-size="14" font-weight="700" fill="#6ee7b7">pair-programmer</text>
-  <text x="420" y="415" font-size="12" fill="#475569">The Pre-Code Thinker</text>
-  <text x="420" y="443" font-size="12" fill="#94a3b8">Catches the wrong approach</text>
-  <text x="420" y="461" font-size="12" fill="#94a3b8">before a single line is written.</text>
-  <text x="420" y="479" font-size="11" fill="#334155">Planning · Design · Prevention</text>
+  <!-- Category: Infrastructure -->
+  <text x="28" y="254" font-size="9.5" fill="#484f58" letter-spacing="1.5">INFRASTRUCTURE &amp; OPERATIONS</text>
+  <rect x="28" y="262" width="196" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="28" y="262" width="2.5" height="56" rx="1" fill="#22d3ee"/>
+  <text x="40" y="280" font-size="11" font-weight="700" fill="#a5f3fc">git-rescue</text>
+  <text x="40" y="295" font-size="10.5" fill="#6e7681">Recovers any broken git state</text>
+  <text x="40" y="311" font-size="9" fill="#30363d">Git</text>
 
-  <!-- Card 6: migration-guide -->
-  <rect x="740" y="360" width="320" height="130" rx="8" fill="#0f172a" stroke="#1e293b" stroke-width="1"/>
-  <rect x="740" y="360" width="4" height="130" rx="2" fill="#8b5cf6"/>
-  <text x="760" y="393" font-size="14" font-weight="700" fill="#c4b5fd">migration-guide</text>
-  <text x="760" y="415" font-size="12" fill="#475569">The Migration Specialist</text>
-  <text x="760" y="443" font-size="12" fill="#94a3b8">React, Next.js, Python, Node,</text>
-  <text x="760" y="461" font-size="12" fill="#94a3b8">TypeScript, Java — all covered.</text>
-  <text x="760" y="479" font-size="11" fill="#334155">Upgrades · Migrations · Planning</text>
+  <rect x="234" y="262" width="196" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="234" y="262" width="2.5" height="56" rx="1" fill="#f97316"/>
+  <text x="246" y="280" font-size="11" font-weight="700" fill="#fdba74">release-captain</text>
+  <text x="246" y="295" font-size="10.5" fill="#6e7681">Semver · changelog · publish</text>
+  <text x="246" y="311" font-size="9" fill="#30363d">Release</text>
 
-  <!-- Bottom -->
-  <text x="60" y="568" font-size="14" fill="#475569">Plus 47 more specialist agents — reviewers, builders, security experts, testers.</text>
-  <text x="60" y="596" font-size="13" fill="#334155">github.com/sifxprime/kodelyth-ecc · Free · Open Source</text>
+  <rect x="440" y="262" width="232" height="56" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <rect x="440" y="262" width="2.5" height="56" rx="1" fill="#6366f1"/>
+  <text x="452" y="280" font-size="11" font-weight="700" fill="#a5b4fc">env-debugger</text>
+  <text x="452" y="295" font-size="10.5" fill="#6e7681">"Works on my machine" hunter</text>
+  <text x="452" y="311" font-size="9" fill="#30363d">Environment</text>
 
-  <rect x="0" y="626" width="1200" height="4" fill="url(#acc2)"/>
+  <!-- Footer -->
+  <line x1="28" y1="334" x2="672" y2="334" stroke="#21262d" stroke-width="1"/>
+  <rect x="28" y="348" width="644" height="42" rx="6" fill="#161b22" stroke="#21262d" stroke-width="1"/>
+  <text x="350" y="364" font-size="11" fill="#484f58" text-anchor="middle">+ 47 more: ux-reviewer · tdd-guide · flake-hunter · api-guardian · dependency-doctor</text>
+  <text x="350" y="382" font-size="11" fill="#484f58" text-anchor="middle">performance-optimizer · typescript-reviewer · go-reviewer · rust-reviewer · and more</text>
 </svg>