kodelyth-ecc 1.5.5 → 1.5.6

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,47 @@
+---
+name: Bug report
+about: Something broken in ECC — install failure, agent misbehavior, hook error
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## What happened
+
+<!-- Describe what went wrong. Include the exact command you ran or behavior you observed. -->
+
+## Expected behavior
+
+<!-- What should have happened instead. -->
+
+## Steps to reproduce
+
+1.
+2.
+3.
+
+## Environment
+
+- **ECC version**: <!-- run: cat ~/.claude/kodelyth-ecc-install-state.json | grep version -->
+- **Install target**: <!-- claude-home / windsurf-home / windsurf-project / cursor-project / codex-home / antigravity / opencode -->
+- **Platform**: <!-- macOS / Linux / Windows -->
+- **AI IDE**: <!-- Claude Code / Windsurf / Cursor / Codex CLI / Antigravity / OpenCode -->
+- **Node.js version**: <!-- run: node --version -->
+
+## Doctor output
+
+<!-- Run: node scripts/doctor.js  or  /doctor in your IDE -->
+
+```
+paste output here
+```
+
+## Relevant logs or error messages
+
+```
+paste here
+```
+
+## Additional context
+
+<!-- Screenshots, related issues, anything else. -->

package/.github/ISSUE_TEMPLATE/new_agent.md

@@ -0,0 +1,52 @@
+---
+name: New agent proposal
+about: Propose a new specialist agent for ECC
+title: '[AGENT] '
+labels: enhancement, new-agent
+assignees: ''
+---
+
+## Agent name
+
+<!-- e.g. `rate-limiter-specialist`, `database-migrator` -->
+
+## One-line description
+
+<!-- What does this agent do? Max 15 words. -->
+
+## Problem it solves
+
+<!-- What pain does this agent remove? What does a developer have to do manually today that this agent would handle? -->
+
+## Persona
+
+<!-- Who is this agent? Describe their experience, scale they've worked at, what makes their advice different from a generic answer. -->
+
+## Trigger patterns
+
+<!-- When should intent routing auto-invoke this agent? Give 5–10 natural-language phrases a user might type. -->
+
+- "..."
+- "..."
+- "..."
+
+## Example interaction
+
+<!-- Show a realistic input and the kind of response this agent would give. -->
+
+**User:** ...
+
+**Agent:** ...
+
+## Does this overlap with an existing agent?
+
+<!-- Check the agent list. If it overlaps with e.g. `debug-detective` or `performance-optimizer`, explain what makes this distinct. -->
+
+## Kodelyth Standard checklist
+
+- [ ] The agent has a specific, named persona with years of experience and scale context
+- [ ] The agent responds to the human situation, not just the technical question
+- [ ] Responses give exact file paths, before/after code, or specific commands — not abstract advice
+- [ ] No emoji in agent responses
+- [ ] Ends with `> Powered by Kodelyth — [tagline]`
+- [ ] No `model:` field in frontmatter

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,53 @@
+## What this PR does
+
+<!-- One paragraph. What was broken or missing, what you changed, and why this is the right approach. -->
+
+## Type of change
+
+- [ ] Bug fix (broken behavior, wrong count, install failure)
+- [ ] New agent
+- [ ] New skill
+- [ ] New command
+- [ ] New hook
+- [ ] Rule update
+- [ ] Install script change
+- [ ] Documentation
+- [ ] Other: ___
+
+## Checklist
+
+### All PRs
+- [ ] `npm test` passes (`node tests/run-all.js`)
+- [ ] No hardcoded version numbers or counts that will drift
+- [ ] No `.DS_Store`, `node_modules`, or generated files committed
+
+### New agent
+- [ ] File at `agents/<name>.md`
+- [ ] No `model:` field in frontmatter
+- [ ] Has a specific persona with experience/scale context
+- [ ] Responds to human situation, not just the technical question
+- [ ] Ends with `> Powered by Kodelyth — [tagline]`
+- [ ] Trigger patterns added to `rules/common/agent-intent-routing.md`
+- [ ] Agent added to `rules/common/agents.md`
+- [ ] README agent table updated
+
+### New skill
+- [ ] File at `skills/<name>/SKILL.md`
+- [ ] Description is accurate and testable
+
+### Install script change (`install.sh` / `install.ps1`)
+- [ ] Both `install.sh` and `install.ps1` updated (feature parity)
+- [ ] Tested on at least one platform
+- [ ] No new hardcoded counts (use dynamic `find` instead)
+
+### Rule change
+- [ ] Rule is general enough to apply across languages/frameworks
+- [ ] Not duplicating guidance already in another rule file
+
+## Testing
+
+<!-- How did you verify this works? -->
+
+## Related issues
+
+<!-- Closes #123 -->

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable changes to Kodelyth ECC are documented here.
 
+## v1.5.6 — Accuracy, Ruby/Elixir, /doctor, /update (May 2026)
+
+### Bug Fixes
+
+- **Dynamic install counts** — `install.sh` and `install.ps1` now compute agent/skill/command counts from the actual filesystem at install time. Hardcoded numbers like `(58)` and `(79)` that were wrong on every install are gone permanently.
+- **`rules/common/agents.md` rewritten** — listed only 10 agents from an ancient version. Now documents all 62 agents across 10 categories with handoff chains. This file is injected into `.windsurfrules` on every Windsurf session — the AI was being told there were 10 agents when there are 62.
+- **`kodelyth-advisor` model field removed** — `model: sonnet` violated the Kodelyth Standard (`CONTRIBUTING.md` explicitly says no `model:` field). Fixed.
+- **Windsurf post-install rule count** — was hardcoded as "15 coding rules", now computed dynamically.
+- **`install.ps1` `.windsurfrules` path bug** — for `windsurf-home` target, the file was being written to `$HomeDir\.windsurfrules` instead of `$Dest\.windsurfrules`. Fixed.
+- **README agent count** — "All 61 subagents" in the What Gets Installed table corrected to 62.
+- **OpenCode platform description** — README said "Full" support. OpenCode receives rules only (no agents, no skills). Now documented honestly.
+
+### New Features
+
+- **`/doctor` command** — run a health check on your ECC install from inside your IDE. Wraps `scripts/doctor.js`. Shows OK/WARNING/ERROR per component with a summary.
+- **`/update` command** — upgrade to the latest ECC version without memorizing your original install flags. Reads `kodelyth-ecc-install-state.json`, replays `npx kodelyth-ecc@latest --target <target>` automatically. Never overwrites `~/.kodelyth/memory/` or `tasks/lessons.md`.
+- **Ruby language rules** — `rules/ruby/` with coding-style, patterns, testing (RSpec + FactoryBot), security (Brakeman + bundler-audit), and hooks (RuboCop auto-fix). Installable via `npx kodelyth-ecc ruby` or `./install.sh ruby`.
+- **Elixir language rules** — `rules/elixir/` with coding-style (mix format + Credo), patterns (with/GenServer/Context), testing (ExUnit + Mox + excoveralls), security (Sobelow + mix hex.audit), and hooks. Installable via `npx kodelyth-ecc elixir` or `./install.sh elixir`.
+- **GitHub issue + PR templates** — `.github/ISSUE_TEMPLATE/bug_report.md`, `.github/ISSUE_TEMPLATE/new_agent.md`, `.github/PULL_REQUEST_TEMPLATE.md`. Contribution quality gate built into the repo workflow.
+
+### Changes
+
+- `package.json` description updated to reflect 90 commands (was 88)
+- `ruby` and `elixir` added to language parser in both `install.sh` and `install.ps1`
+
+---
+
 ## v1.5.3 — God-Tier Intent Routing Expansion (May 2026)
 
 ### The Routing Overhaul

package/README.md

@@ -299,7 +299,7 @@ Project: **my-app**
 |---|---|---|
 | Agents | **62** | Specialist subagents — reviewers, planners, debuggers, architects, incident-commander, load-tester, memory, image-architect |
 | Skills | **188** | Domain knowledge — patterns, testing, security, DevOps, intent routing, memory |
-| Commands | **80** | Slash command workflows (`/tdd`, `/plan`, `/memory`, etc.) |
+| Commands | **90** | Slash command workflows (`/tdd`, `/plan`, `/memory`, `/doctor`, `/update`, etc.) |
 | Hooks | **20+** | Quality gates, secret scanning, branch checks, memory inject + capture + correction + project DNA |
 | Rules | **17** | Always-on coding standards + intent routing + memory protocol + self-improvement workflow |
 | Memory | **local** | BM25-indexed personal memory at `~/.kodelyth/memory/` (zero deps) |
@@ -440,7 +440,7 @@ The intent router will route you to the right one. The AI announces who's taking
 
 | Source | Destination | What it does |
 |---|---|---|
-| `agents/` | `~/.claude/agents/` | All 61 subagents available globally |
+| `agents/` | `~/.claude/agents/` | All 62 subagents available globally |
 | `skills/` | `~/.claude/skills/` | All 188 skills loadable via commands |
 | `hooks/hooks.json` | `~/.claude/hooks/` | Automated quality gates |
 | `rules/` | `~/.claude/rules/` | Always-on standards + intent routing |
@@ -510,7 +510,7 @@ Available profiles:
 Or specify languages directly:
 
 ```bash
-npx kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart
+npx kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart ruby elixir
 ```
 
 ---
@@ -524,7 +524,7 @@ npx kodelyth-ecc typescript python golang rust java kotlin php swift cpp dart
 | Cursor | Full | `cursor-project` | Rules, skills |
 | Codex CLI | Full | `codex-home` | Agents, skills, commands, rules |
 | Google Antigravity | Full | `antigravity` | Agents → skills, commands → workflows, rules |
-| OpenCode | Full | `opencode` | Rules |
+| OpenCode | Rules only | `opencode` | Rules (agents + skills not yet supported by OpenCode) |
 
 **OS support:** macOS, Linux (`install.sh`), Windows (`install.ps1`), or any OS with Node.js 18+ (`npx`).
 

package/VERSION

@@ -1 +1 @@
-1.5.5
+1.5.6

package/agents/kodelyth-advisor.md

@@ -7,7 +7,6 @@ description: >
   direction instantly. No hand-holding, no noise — just the exact answer.
   Use when you need strategic guidance, tool selection, or a clear path forward.
 tools: ["Read", "Grep", "Glob"]
-model: sonnet
 ---
 
 You are the Kodelyth Advisor — a principal engineer with a decade-plus of building systems that power billions of users at companies valued in the hundreds of billions. You have shipped production code at Google scale, designed distributed systems under real SLA pressure, and mentored engineers who went on to lead their own platforms. You do not write toy code. You do not give junior-level answers. You think in systems, not files.

package/commands/doctor.md

@@ -0,0 +1,75 @@
+---
+description: Diagnose your Kodelyth ECC install — check for drift, missing files, version mismatches, and confirm everything is healthy
+---
+
+# /doctor
+
+Runs a health check on your ECC install. Detects drift between what was installed and what is currently on disk.
+
+## What It Checks
+
+- Install state file exists and is readable
+- Installed version vs latest available
+- Agent files present and uncorrupted
+- Skills directory intact
+- Rules loaded correctly
+- Memory store accessible (if applicable)
+- Hooks registered (Claude Code only)
+
+## Usage
+
+```
+/doctor
+```
+
+Run with no arguments for a full health report on all detected installs.
+
+## Implementation
+
+Runs the built-in doctor script:
+
+```bash
+node scripts/doctor.js
+```
+
+Or with a specific target:
+
+```bash
+node scripts/doctor.js --target claude-home
+node scripts/doctor.js --target windsurf-home
+node scripts/doctor.js --target windsurf-project
+node scripts/doctor.js --target codex-home
+node scripts/doctor.js --target cursor-project
+```
+
+For JSON output (useful in CI or scripts):
+
+```bash
+node scripts/doctor.js --json
+```
+
+## Output
+
+The doctor report shows:
+
+| Field | Meaning |
+|-------|---------|
+| `OK` | Component healthy, no issues |
+| `WARNING` | Potential issue, non-blocking |
+| `ERROR` | Missing or corrupted file, needs attention |
+
+A summary line shows total checked, ok, warnings, and errors.
+
+## When to Run
+
+- After first install to confirm everything landed
+- After upgrading to a new ECC version
+- When an agent or skill isn't behaving as expected
+- Before filing a bug report
+
+## Related
+
+- `/update` — upgrade to the latest ECC version
+- `use kodelyth-advisor` — if you're not sure where to start
+
+> Powered by Kodelyth — trust your install, verify your tools.

package/commands/update.md

@@ -0,0 +1,92 @@
+---
+description: Upgrade Kodelyth ECC to the latest version, preserving your current install target and language profile
+---
+
+# /update
+
+Upgrades your ECC install to the latest version from npm. Reads your existing install state to replay the same target and language options automatically — no flags to remember.
+
+## Usage
+
+```
+/update
+```
+
+## What It Does
+
+1. Reads `kodelyth-ecc-install-state.json` from your install directory to recover the original `target` and `languages`
+2. Runs `npx kodelyth-ecc@latest` with those same flags
+3. Overwrites agents, skills, rules, and commands with the latest versions
+4. Leaves your memory store (`~/.kodelyth/memory/`) and `tasks/lessons.md` untouched — your learned context is never overwritten
+
+## Implementation
+
+The agent should run the appropriate command based on your platform.
+
+### Automatic (reads install state)
+
+```bash
+node -e "
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const candidates = [
+  path.join(os.homedir(), '.claude', 'kodelyth-ecc-install-state.json'),
+  path.join(os.homedir(), '.codeium', 'windsurf', 'kodelyth-ecc-install-state.json'),
+  path.join(os.homedir(), '.codex', 'kodelyth-ecc-install-state.json'),
+  path.join(process.cwd(), '.windsurf', 'kodelyth-ecc-install-state.json'),
+  path.join(process.cwd(), '.cursor', 'kodelyth-ecc-install-state.json'),
+  path.join(process.cwd(), '.agent', 'kodelyth-ecc-install-state.json'),
+  path.join(process.cwd(), '.opencode', 'kodelyth-ecc-install-state.json'),
+];
+
+let state = null;
+let stateFile = null;
+for (const f of candidates) {
+  if (fs.existsSync(f)) { state = JSON.parse(fs.readFileSync(f, 'utf8')); stateFile = f; break; }
+}
+
+if (!state) {
+  console.error('No install state found. Run the installer manually:');
+  console.error('  npx kodelyth-ecc --target <target>');
+  process.exit(1);
+}
+
+const langs = (state.languages || []).join(' ');
+const cmd = ['npx', 'kodelyth-ecc@latest', '--target', state.target, langs].filter(Boolean).join(' ');
+console.log('Found install state:', stateFile);
+console.log('Previous version:', state.version);
+console.log('Running:', cmd);
+require('child_process').execSync(cmd, { stdio: 'inherit' });
+"
+```
+
+### Manual (if you know your target)
+
+```bash
+npx kodelyth-ecc@latest                              # Claude Code
+npx kodelyth-ecc@latest --target windsurf-home       # Windsurf global
+npx kodelyth-ecc@latest --target windsurf-project    # Windsurf project
+npx kodelyth-ecc@latest --target codex-home          # Codex CLI
+npx kodelyth-ecc@latest --target cursor-project      # Cursor
+```
+
+## What Is NOT Overwritten
+
+| Path | Protected |
+|------|-----------|
+| `~/.kodelyth/memory/` | Your BM25 memory store |
+| `tasks/lessons.md` | Project correction rules |
+| `tasks/todo.md` | Open todos |
+
+## After Updating
+
+Run `/doctor` to confirm the new version is healthy.
+
+## Related
+
+- `/doctor` — verify install health
+- `use kodelyth-advisor` — guidance after a major version update
+
+> Powered by Kodelyth — stay current, stay sharp.

package/install.ps1

@@ -21,7 +21,7 @@ $ErrorActionPreference = "Stop"
 # ── Banner ────────────────────────────────────────────────────────────────────
 Write-Host ""
 Write-Host "  Kodelyth ECC — Production-grade AI coding agent toolkit" -ForegroundColor Cyan
-Write-Host "  59 agents · 188 skills · 80 commands · 18+ hooks · intent routing · local memory" -ForegroundColor Gray
+Write-Host "  62 agents · 188 skills · 90 commands · 20+ hooks · intent routing · local memory" -ForegroundColor Gray
 Write-Host ""
 
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
@@ -107,6 +107,11 @@ if ($Confirm -and $Confirm -notmatch '^[Yy]$') {
 }
 Write-Host ""
 
+# ── Dynamic Counts ───────────────────────────────────────────────────────────
+$AgentCount   = (Get-ChildItem -Path "$ScriptDir\agents"   -Filter "*.md" -File).Count
+$SkillCount   = (Get-ChildItem -Path "$ScriptDir\skills"   -Recurse -Filter "SKILL.md" -File).Count
+$CmdCount     = (Get-ChildItem -Path "$ScriptDir\commands" -Filter "*.md" -File).Count
+
 # ── Helpers ───────────────────────────────────────────────────────────────────
 function Install-Dir {
     param([string]$Src, [string]$Dest, [string]$Label)
@@ -162,12 +167,12 @@ switch ($Target) {
         Write-Host "  [OK] CLAUDE.md + SOUL.md" -ForegroundColor Green
     }
     { $_ -in "windsurf-project","windsurf-home" } {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest "Agents   (58)"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills   (187)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest "Agents   ($AgentCount)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills   ($SkillCount)"
         Install-Flat "$ScriptDir\rules"    $RulesDest  "Rules"
 
         # Generate .windsurfrules from all common rules
-        $WindsurfRulesFile = if ($Target -eq "windsurf-project") { "$(Get-Location)\.windsurfrules" } else { "$HomeDir\.windsurfrules" }
+        $WindsurfRulesFile = if ($Target -eq "windsurf-project") { "$(Get-Location)\.windsurfrules" } else { "$Dest\.windsurfrules" }
         $CommonRulesDir = "$ScriptDir\rules\common"
         if (Test-Path $CommonRulesDir) {
             $Combined = Get-ChildItem -Path $CommonRulesDir -Filter "*.md" | Sort-Object Name | ForEach-Object { Get-Content $_.FullName }
@@ -176,18 +181,18 @@ switch ($Target) {
         }
     }
     "antigravity" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents -> skills (58)"
-        Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands -> workflows (79)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents -> skills ($AgentCount)"
+        Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands -> workflows ($CmdCount)"
         Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
     }
     "cursor-project" {
         Install-Flat "$ScriptDir\rules"    $RulesDest  "Rules"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills (187)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest "Skills ($SkillCount)"
     }
     "codex-home" {
-        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   (58)"
-        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   (187)"
-        Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands (79)"
+        Install-Dir  "$ScriptDir\agents"   $AgentsDest   "Agents   ($AgentCount)"
+        Install-Dir  "$ScriptDir\skills"   $SkillsDest   "Skills   ($SkillCount)"
+        Install-Dir  "$ScriptDir\commands" $CommandsDest "Commands ($CmdCount)"
         Install-Flat "$ScriptDir\rules"    $RulesDest    "Rules"
     }
     "opencode" {
@@ -231,7 +236,7 @@ switch ($Target) {
     }
     "codex-home" {
         Write-Host "  1. Restart Codex CLI (codex)"
-        Write-Host "  2. All 59 agents and 188 skills are now available"
+        Write-Host "  2. All $AgentCount agents and $SkillCount skills are now available"
         Write-Host "  3. Try:  use kodelyth-advisor"
     }
     "antigravity" {

package/install.sh

@@ -87,7 +87,7 @@ while [[ $# -gt 0 ]]; do
       TARGET="${1#--target=}"
       shift
       ;;
-    typescript|python|golang|go|rust|java|kotlin|php|swift|cpp|csharp|dart)
+    typescript|python|golang|go|rust|java|kotlin|php|swift|cpp|csharp|dart|ruby|elixir)
       lang="$1"
       [[ "$lang" == "go" ]] && lang="golang"
       LANGUAGE_MODULES+=("$lang")
@@ -143,7 +143,7 @@ while [[ $# -gt 0 ]]; do
       echo "  --profile backend     Go + Python + Java"
       echo ""
       echo "Languages (manual, installs language-specific rules):"
-      echo "  typescript  python  golang  rust  java  kotlin  php  swift  cpp  dart"
+      echo "  typescript  python  golang  rust  java  kotlin  php  swift  cpp  dart  ruby  elixir"
       echo ""
       echo "Examples:"
       echo "  ./install.sh"
@@ -338,15 +338,20 @@ generate_windsurfrules() {
   echo -e "  ${GREEN}✓${RESET} .windsurfrules ${BLUE}(→ $dest_file)${RESET}"
 }
 
+# ── Dynamic Counts ────────────────────────────────────────────────────────────
+AGENT_COUNT=$(find "$SCRIPT_DIR/agents" -maxdepth 1 -name "*.md" | wc -l | tr -d ' ')
+SKILL_COUNT=$(find "$SCRIPT_DIR/skills" -mindepth 2 -maxdepth 2 -name "SKILL.md" | wc -l | tr -d ' ')
+CMD_COUNT=$(find "$SCRIPT_DIR/commands" -maxdepth 1 -name "*.md" | wc -l | tr -d ' ')
+
 # ── Install ───────────────────────────────────────────────────────────────────
 echo -e "${BOLD}Installing components...${RESET}"
 echo ""
 
 case "$TARGET" in
   claude-home)
-    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   (58)"
-    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   (187)"
-    install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands (79)"
+    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   ($AGENT_COUNT)"
+    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   ($SKILL_COUNT)"
+    install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands ($CMD_COUNT)"
     install_hooks                       "$HOOKS_DEST"
     # Rules: install common + selected languages
     mkdir -p "$RULES_DEST"
@@ -369,9 +374,9 @@ case "$TARGET" in
 
   antigravity)
     # Agents → .agent/skills/
-    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents → skills  (53)"
+    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents → skills  ($AGENT_COUNT)"
     # Commands → .agent/workflows/
-    install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands → workflows (79)"
+    install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands → workflows ($CMD_COUNT)"
     # Rules → .agent/rules/ (flattened)
     install_flat "$SCRIPT_DIR/rules"    "$RULES_DEST"    "Rules (flattened)"
     # Kodelyth skills → .agent/rules/ (flattened — Antigravity has no skills system)
@@ -387,19 +392,19 @@ case "$TARGET" in
 
   cursor-project)
     install_flat "$SCRIPT_DIR/rules"    "$RULES_DEST"    "Rules (flattened)"
-    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills (187)"
+    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills ($SKILL_COUNT)"
     ;;
 
   codex-home)
-    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   (58)"
-    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   (187)"
-    install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands (79)"
+    install_dir  "$SCRIPT_DIR/agents"   "$AGENTS_DEST"   "Agents   ($AGENT_COUNT)"
+    install_dir  "$SCRIPT_DIR/skills"   "$SKILLS_DEST"   "Skills   ($SKILL_COUNT)"
+    install_dir  "$SCRIPT_DIR/commands" "$COMMANDS_DEST" "Commands ($CMD_COUNT)"
     install_flat "$SCRIPT_DIR/rules"    "$RULES_DEST"    "Rules (flattened)"
     ;;
 
   windsurf-project|windsurf-home)
-    install_dir  "$SCRIPT_DIR/agents"  "$AGENTS_DEST"  "Agents   (58)"
-    install_dir  "$SCRIPT_DIR/skills"  "$SKILLS_DEST"  "Skills   (187)"
+    install_dir  "$SCRIPT_DIR/agents"  "$AGENTS_DEST"  "Agents   ($AGENT_COUNT)"
+    install_dir  "$SCRIPT_DIR/skills"  "$SKILLS_DEST"  "Skills   ($SKILL_COUNT)"
     install_flat "$SCRIPT_DIR/rules"   "$RULES_DEST"   "Rules (flattened)"
     generate_windsurfrules "$SCRIPT_DIR/rules" "$WINDSURFRULES_DEST"
     ;;
@@ -472,10 +477,11 @@ case "$TARGET" in
     echo "    use kodelyth-advisor"
     ;;
   windsurf-project|windsurf-home)
+    RULE_COUNT=$(find "$SCRIPT_DIR/rules/common" -maxdepth 1 -name "*.md" ! -name "agent-intent-routing.md" | wc -l | tr -d ' ')
     echo -e "${BOLD}  Windsurf — what to do now:${RESET}"
     echo ""
     echo "  Open your project in Windsurf (Cascade)."
-    echo "  .windsurfrules is active — 15 coding rules + intent routing loaded automatically."
+    echo "  .windsurfrules is active — $RULE_COUNT coding rules + intent routing loaded automatically."
     echo "  Agents available in .windsurf/agents/"
     echo ""
     echo "    use kodelyth-advisor       ← not sure where to start"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kodelyth-ecc",
-  "version": "1.5.5",
-  "description": "Production-grade AI coding toolkit — 62 agents, 188 skills, 88 commands, parallel multi-agent commands, semantic intent routing, self-learning memory. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, and OpenCode.",
+  "version": "1.5.6",
+  "description": "Production-grade AI coding toolkit — 62 agents, 188 skills, 90 commands, parallel multi-agent commands, semantic intent routing, self-learning memory. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, and OpenCode.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",
   "repository": {

package/rules/common/agents.md

@@ -1,50 +1,146 @@
 # Agent Orchestration
 
-## Available Agents
-
-Located in `~/.claude/agents/`:
-
-| Agent | Purpose | When to Use |
-|-------|---------|-------------|
-| planner | Implementation planning | Complex features, refactoring |
-| architect | System design | Architectural decisions |
-| tdd-guide | Test-driven development | New features, bug fixes |
-| code-reviewer | Code review | After writing code |
-| security-reviewer | Security analysis | Before commits |
-| build-error-resolver | Fix build errors | When build fails |
-| e2e-runner | E2E testing | Critical user flows |
-| refactor-cleaner | Dead code cleanup | Code maintenance |
-| doc-updater | Documentation | Updating docs |
-| rust-reviewer | Rust code review | Rust projects |
-
-## Immediate Agent Usage
-
-No user prompt needed:
-1. Complex feature requests - Use **planner** agent
-2. Code just written/modified - Use **code-reviewer** agent
-3. Bug fix or new feature - Use **tdd-guide** agent
-4. Architectural decision - Use **architect** agent
-
-## Parallel Task Execution
-
-ALWAYS use parallel Task execution for independent operations:
-
-```markdown
-# GOOD: Parallel execution
-Launch 3 agents in parallel:
-1. Agent 1: Security analysis of auth module
-2. Agent 2: Performance review of cache system
-3. Agent 3: Type checking of utilities
-
-# BAD: Sequential when unnecessary
-First agent 1, then agent 2, then agent 3
+62 specialist agents are available. Intent routing is always-on — describe your problem in plain words and the right agent is invoked automatically. You can also invoke explicitly: `use <agent-name>`.
+
+## Kodelyth Exclusives
+
+| Agent | When to Use |
+|-------|-------------|
+| `kodelyth-advisor` | Not sure where to start — master guide |
+| `pair-programmer` | Before writing code — think through approach first |
+| `debug-detective` | Any bug — evidence-first root cause, never guess-and-check |
+| `silent-failure-hunter` | Bugs that don't throw errors |
+| `incident-commander` | Production incident — P0/P1 triage, contain, postmortem |
+| `load-tester` | Load/stress testing — k6, Locust, Artillery, capacity planning |
+| `kodelyth-memory` | Manage local BM25 memory — recall, capture, review |
+| `image-architect` | AI image generation — Gemini/DALL-E/fal.ai/SVG |
+
+## Planning & Architecture
+
+| Agent | When to Use |
+|-------|-------------|
+| `planner` | Plan a feature before writing a line of code |
+| `architect` | System-level design, dependency graphs |
+| `code-architect` | Code-level architecture decisions |
+| `chief-of-staff` | Strategic decisions, comms, stakeholder updates |
+| `migration-guide` | Framework/language version upgrades, phase by phase |
+
+## Code Review
+
+| Agent | When to Use |
+|-------|-------------|
+| `code-reviewer` | General review after writing code |
+| `typescript-reviewer` | TypeScript / React / Next.js |
+| `python-reviewer` | Python |
+| `go-reviewer` | Go |
+| `rust-reviewer` | Rust |
+| `java-reviewer` | Java / Spring Boot |
+| `kotlin-reviewer` | Kotlin / Android / KMP |
+| `cpp-reviewer` | C++ |
+| `csharp-reviewer` | C# / .NET |
+| `flutter-reviewer` | Flutter / Dart |
+| `database-reviewer` | SQL schema, query patterns, indexes |
+| `healthcare-reviewer` | PHI/HIPAA-aware review for healthcare apps |
+
+## Build Fixers
+
+| Agent | When to Use |
+|-------|-------------|
+| `build-error-resolver` | General build failure |
+| `go-build-resolver` | Go build errors |
+| `rust-build-resolver` | Rust/Cargo build errors |
+| `java-build-resolver` | Java/Maven/Gradle build errors |
+| `kotlin-build-resolver` | Kotlin/Gradle build errors |
+| `cpp-build-resolver` | C++/CMake/Make build errors |
+| `dart-build-resolver` | Dart/Flutter build errors |
+| `pytorch-build-resolver` | PyTorch/CUDA build errors |
+| `dependency-doctor` | npm/pip/cargo/maven dep hell, CVEs, lockfile drift |
+| `env-debugger` | "Works on my machine" — env, config, secrets layers |
+
+## Debugging & Testing
+
+| Agent | When to Use |
+|-------|-------------|
+| `tdd-guide` | Write tests first — TDD methodology |
+| `e2e-runner` | End-to-end test automation |
+| `pr-test-analyzer` | CI output — root cause failing tests |
+| `flake-hunter` | Flaky test stabilization — never blind retries |
+
+## Security & API
+
+| Agent | When to Use |
+|-------|-------------|
+| `security-reviewer` | OWASP top 10, secrets, auth, injection vectors |
+| `api-guardian` | Detect breaking API changes before they ship |
+
+## Performance & Quality
+
+| Agent | When to Use |
+|-------|-------------|
+| `performance-optimizer` | Profiling-first — measure before optimizing |
+| `refactor-cleaner` | Remove code smells, dead code, tech debt |
+| `code-simplifier` | Improve readability without changing behavior |
+| `type-design-analyzer` | TypeScript type system design |
+
+## Documentation & Analysis
+
+| Agent | When to Use |
+|-------|-------------|
+| `doc-updater` | Update or write documentation |
+| `docs-lookup` | Find docs for a library or API |
+| `comment-analyzer` | Audit code comments for accuracy |
+| `code-explorer` | Explore an unfamiliar codebase |
+| `conversation-analyzer` | Analyze conversation or chat patterns |
+
+## Release & Ops
+
+| Agent | When to Use |
+|-------|-------------|
+| `release-captain` | Cut a clean release — semver, tagging, rollback plan |
+| `git-rescue` | Broken git state, lost commits, bad rebase — no history loss |
+
+## Open Source
+
+| Agent | When to Use |
+|-------|-------------|
+| `opensource-forker` | Fork and clean a project for open-source release |
+| `opensource-sanitizer` | Strip secrets, PII, proprietary references |
+| `opensource-packager` | README, license, contribution docs |
+
+## Specialized
+
+| Agent | When to Use |
+|-------|-------------|
+| `ux-reviewer` | UX behavior + WCAG 2.1 AA accessibility |
+| `seo-specialist` | Technical SEO, structured data, rankings |
+
+## GAN Harness (Multi-Agent)
+
+| Agent | When to Use |
+|-------|-------------|
+| `gan-planner` | Plan a GAN-style generator/evaluator workflow |
+| `gan-generator` | Generate output in a GAN harness loop |
+| `gan-evaluator` | Evaluate output and provide adversarial feedback |
+| `harness-optimizer` | Optimize agent harness action spaces |
+| `loop-operator` | Operate autonomous agent loops |
+
+## Parallel Execution
+
+ALWAYS launch independent agents in parallel:
+
+```
+# GOOD: parallel
+use code-reviewer + security-reviewer + ux-reviewer simultaneously
+
+# BAD: sequential when not needed
+code-reviewer → then security-reviewer → then ux-reviewer
 ```
 
-## Multi-Perspective Analysis
+## Standard Handoff Chains
 
-For complex problems, use split role sub-agents:
-- Factual reviewer
-- Senior engineer
-- Security expert
-- Consistency reviewer
-- Redundancy checker
+| Workflow | Chain |
+|----------|-------|
+| New feature | `pair-programmer` → `tdd-guide` → `code-reviewer` → `security-reviewer` |
+| Bug fix | `debug-detective` → `tdd-guide` → `refactor-cleaner` |
+| Production incident | `incident-commander` → `debug-detective` → `tdd-guide` |
+| Open-source | `opensource-forker` → `opensource-sanitizer` → `opensource-packager` → `release-captain` |

package/rules/elixir/coding-style.md

@@ -0,0 +1,46 @@
+---
+paths:
+  - "**/*.ex"
+  - "**/*.exs"
+---
+# Elixir Coding Style
+
+> This file extends [common/coding-style.md](../common/coding-style.md) with Elixir specific content.
+
+## Standards
+
+- Follow the official **Elixir Style Guide**
+- Use **mix format** — non-negotiable, always auto-format
+- All public functions must have `@spec` type annotations and `@doc` documentation
+
+## Immutability
+
+Data is immutable by default in Elixir. Embrace it:
+
+```elixir
+# Use the pipe operator for data transformations
+result =
+  input
+  |> validate()
+  |> transform()
+  |> persist()
+```
+
+## Function Heads Over Conditionals
+
+```elixir
+# Prefer pattern-matched function heads over cond/case at the top level
+def process(%{status: :active} = user), do: activate(user)
+def process(%{status: :banned} = user), do: reject(user)
+def process(_user), do: {:error, :unknown_status}
+```
+
+## Formatting
+
+- **mix format** — run on every save
+- **Credo** for code quality and style checks
+- Line length: 98 characters (mix format default)
+
+## Reference
+
+See skill: `elixir-patterns` for comprehensive GenServer, Phoenix, and OTP patterns.

package/rules/elixir/hooks.md

@@ -0,0 +1,26 @@
+---
+paths:
+  - "**/*.ex"
+  - "**/*.exs"
+---
+# Elixir Hooks
+
+> This file extends [common/hooks.md](../common/hooks.md) with Elixir specific content.
+
+## PostToolUse Hooks
+
+Configure in `~/.claude/settings.json`:
+
+- **mix format**: Auto-format `.ex` / `.exs` files after edit
+  ```bash
+  mix format <file>
+  ```
+- **Credo**: Run on edited files for style warnings
+  ```bash
+  mix credo <file>
+  ```
+
+## Warnings
+
+- Warn when `IO.inspect` is left in non-test `.ex` files (use `Logger` instead)
+- Warn when `dbg()` (Elixir 1.14+) is left in production code paths

package/rules/elixir/patterns.md

@@ -0,0 +1,67 @@
+---
+paths:
+  - "**/*.ex"
+  - "**/*.exs"
+---
+# Elixir Patterns
+
+> This file extends [common/patterns.md](../common/patterns.md) with Elixir specific content.
+
+## with for Multi-Step Operations
+
+```elixir
+def create_user(params) do
+  with {:ok, validated} <- validate(params),
+       {:ok, user} <- Repo.insert(User.changeset(%User{}, validated)),
+       :ok <- send_welcome_email(user) do
+    {:ok, user}
+  end
+end
+```
+
+## GenServer Pattern
+
+```elixir
+defmodule MyApp.Cache do
+  use GenServer
+
+  def start_link(opts), do: GenServer.start_link(__MODULE__, %{}, opts)
+
+  def get(pid, key), do: GenServer.call(pid, {:get, key})
+  def put(pid, key, value), do: GenServer.cast(pid, {:put, key, value})
+
+  @impl true
+  def init(state), do: {:ok, state}
+
+  @impl true
+  def handle_call({:get, key}, _from, state), do: {:reply, Map.get(state, key), state}
+
+  @impl true
+  def handle_cast({:put, key, value}, state), do: {:noreply, Map.put(state, key, value)}
+end
+```
+
+## Context Modules (Phoenix)
+
+```elixir
+defmodule MyApp.Accounts do
+  alias MyApp.Accounts.User
+  alias MyApp.Repo
+
+  def get_user!(id), do: Repo.get!(User, id)
+
+  def create_user(attrs) do
+    %User{}
+    |> User.changeset(attrs)
+    |> Repo.insert()
+  end
+end
+```
+
+## Tagged Tuples for Errors
+
+Always return `{:ok, result}` or `{:error, reason}` — never bare values from functions that can fail.
+
+## Reference
+
+See skill: `phoenix-patterns` for Phoenix LiveView, contexts, and Ecto query patterns.

package/rules/elixir/security.md

@@ -0,0 +1,58 @@
+---
+paths:
+  - "**/*.ex"
+  - "**/*.exs"
+---
+# Elixir Security
+
+> This file extends [common/security.md](../common/security.md) with Elixir specific content.
+
+## Secret Management
+
+```elixir
+# config/runtime.exs — read from environment at runtime, never compile-time
+config :my_app, :stripe_key,
+  System.fetch_env!("STRIPE_SECRET_KEY")  # raises if missing
+```
+
+Never put secrets in `config/config.exs` or `config/dev.exs` committed to git.
+
+## SQL Injection
+
+Always use Ecto parameterized queries:
+
+```elixir
+# UNSAFE — never do this
+Repo.query("SELECT * FROM users WHERE email = '#{email}'")
+
+# SAFE
+from(u in User, where: u.email == ^email) |> Repo.one()
+```
+
+## Atom Exhaustion
+
+Never convert untrusted user input to atoms — the atom table is not garbage collected:
+
+```elixir
+# UNSAFE
+String.to_atom(user_input)
+
+# SAFE
+String.to_existing_atom(user_input)  # only if atom must already exist
+# or keep it as a string
+```
+
+## Security Scanning
+
+- **Sobelow** for Phoenix/Elixir static security analysis:
+  ```bash
+  mix sobelow --config
+  ```
+- **mix audit** for dependency vulnerability scanning:
+  ```bash
+  mix hex.audit
+  ```
+
+## Reference
+
+See skill: `security-review` for OWASP top 10 and authentication patterns.

package/rules/elixir/testing.md

@@ -0,0 +1,64 @@
+---
+paths:
+  - "**/*.ex"
+  - "**/*.exs"
+  - "**/test/**"
+---
+# Elixir Testing
+
+> This file extends [common/testing.md](../common/testing.md) with Elixir specific content.
+
+## Framework
+
+Use **ExUnit** (built-in). Use **Mox** for behaviour-based mocking.
+
+## Structure
+
+```elixir
+defmodule MyApp.AccountsTest do
+  use MyApp.DataCase
+
+  alias MyApp.Accounts
+
+  describe "create_user/1" do
+    test "creates a user with valid attrs" do
+      attrs = %{name: "Alice", email: "alice@example.com"}
+      assert {:ok, user} = Accounts.create_user(attrs)
+      assert user.email == "alice@example.com"
+    end
+
+    test "returns error with invalid attrs" do
+      assert {:error, changeset} = Accounts.create_user(%{})
+      assert "can't be blank" in errors_on(changeset).email
+    end
+  end
+end
+```
+
+## Coverage
+
+```bash
+mix test --cover
+```
+
+Use **excoveralls** for detailed coverage reports:
+
+```bash
+mix coveralls
+mix coveralls.html
+```
+
+## Async Tests
+
+Mark tests as `async: true` when they don't share state:
+
+```elixir
+defmodule MyApp.PureTest do
+  use ExUnit.Case, async: true
+  ...
+end
+```
+
+## Reference
+
+See skill: `elixir-testing` for ExUnit async patterns, Mox setup, and property-based testing with StreamData.

package/rules/ruby/coding-style.md

@@ -0,0 +1,41 @@
+---
+paths:
+  - "**/*.rb"
+  - "**/*.rake"
+  - "**/Gemfile"
+  - "**/Rakefile"
+---
+# Ruby Coding Style
+
+> This file extends [common/coding-style.md](../common/coding-style.md) with Ruby specific content.
+
+## Standards
+
+- Follow the **Ruby Style Guide** (rubocop default)
+- Use **frozen_string_literal: true** at the top of every file
+- Prefer `do...end` for multi-line blocks, `{ }` for single-line
+
+## Immutability
+
+```ruby
+# frozen_string_literal: true
+
+User = Data.define(:name, :email)  # Ruby 3.2+ immutable value object
+```
+
+## Formatting
+
+- **RuboCop** for linting and style enforcement
+- **StandardRB** as a zero-config RuboCop config alternative
+- Line length: 120 characters max
+
+## Naming
+
+- `snake_case` for methods and variables
+- `CamelCase` for classes and modules
+- `SCREAMING_SNAKE_CASE` for constants
+- Predicate methods end with `?`, destructive methods end with `!`
+
+## Reference
+
+See skill: `ruby-patterns` for comprehensive Ruby idioms, Rails patterns, and concurrency.

package/rules/ruby/hooks.md

@@ -0,0 +1,23 @@
+---
+paths:
+  - "**/*.rb"
+  - "**/*.rake"
+---
+# Ruby Hooks
+
+> This file extends [common/hooks.md](../common/hooks.md) with Ruby specific content.
+
+## PostToolUse Hooks
+
+Configure in `~/.claude/settings.json`:
+
+- **RuboCop**: Auto-lint `.rb` files after edit
+  ```bash
+  rubocop --autocorrect <file>
+  ```
+- **Syntax check**: Run `ruby -c <file>` after editing
+
+## Warnings
+
+- Warn about `puts` / `p` statements in non-test `.rb` files (use `Rails.logger` or a logger instead)
+- Warn when `binding.pry` or `byebug` is left in edited files

package/rules/ruby/patterns.md

@@ -0,0 +1,71 @@
+---
+paths:
+  - "**/*.rb"
+  - "**/*.rake"
+---
+# Ruby Patterns
+
+> This file extends [common/patterns.md](../common/patterns.md) with Ruby specific content.
+
+## Service Objects
+
+```ruby
+# frozen_string_literal: true
+
+class CreateUserService
+  def initialize(params)
+    @params = params
+  end
+
+  def call
+    user = User.new(@params)
+    user.save!
+    user
+  end
+end
+
+# Usage
+result = CreateUserService.new(params).call
+```
+
+## Value Objects
+
+```ruby
+# frozen_string_literal: true
+
+Address = Data.define(:street, :city, :country)
+
+address = Address.new(street: "123 Main St", city: "London", country: "UK")
+```
+
+## Query Objects
+
+```ruby
+# frozen_string_literal: true
+
+class ActiveUsersQuery
+  def initialize(relation = User.all)
+    @relation = relation
+  end
+
+  def call
+    @relation.where(status: :active).order(created_at: :desc)
+  end
+end
+```
+
+## Modules for Composition
+
+Prefer composition over inheritance for shared behavior:
+
+```ruby
+module Auditable
+  def self.included(base)
+    base.before_action :track_activity
+  end
+end
+```
+
+## Reference
+
+See skill: `rails-patterns` for Rails-specific patterns including concerns, callbacks, and ActiveRecord best practices.

package/rules/ruby/security.md

@@ -0,0 +1,56 @@
+---
+paths:
+  - "**/*.rb"
+  - "**/*.rake"
+---
+# Ruby Security
+
+> This file extends [common/security.md](../common/security.md) with Ruby specific content.
+
+## Secret Management
+
+```ruby
+# Never hardcode secrets
+api_key = ENV.fetch("STRIPE_SECRET_KEY")  # raises KeyError if missing, not nil
+
+# Rails credentials (encrypted)
+Rails.application.credentials.stripe[:secret_key]
+```
+
+## SQL Injection
+
+Always use parameterized queries — never string interpolation:
+
+```ruby
+# UNSAFE
+User.where("email = '#{params[:email]}'")
+
+# SAFE
+User.where(email: params[:email])
+User.where("email = ?", params[:email])
+```
+
+## Mass Assignment
+
+Use strong parameters in Rails controllers:
+
+```ruby
+def user_params
+  params.require(:user).permit(:name, :email)
+end
+```
+
+## Security Scanning
+
+- **Brakeman** for static security analysis of Rails apps:
+  ```bash
+  brakeman -q
+  ```
+- **bundler-audit** for dependency CVE scanning:
+  ```bash
+  bundle audit check --update
+  ```
+
+## Reference
+
+See skill: `security-review` for OWASP top 10 and auth patterns.

package/rules/ruby/testing.md

@@ -0,0 +1,65 @@
+---
+paths:
+  - "**/*.rb"
+  - "**/*_spec.rb"
+  - "**/spec/**"
+---
+# Ruby Testing
+
+> This file extends [common/testing.md](../common/testing.md) with Ruby specific content.
+
+## Framework
+
+Use **RSpec** as the testing framework. Use **FactoryBot** for fixtures.
+
+## Structure
+
+```ruby
+# frozen_string_literal: true
+
+RSpec.describe CreateUserService do
+  subject(:service) { described_class.new(params) }
+
+  let(:params) { { name: "Alice", email: "alice@example.com" } }
+
+  describe "#call" do
+    context "with valid params" do
+      it "creates a user" do
+        expect { service.call }.to change(User, :count).by(1)
+      end
+    end
+
+    context "with invalid params" do
+      let(:params) { { name: "", email: "bad" } }
+
+      it "raises an error" do
+        expect { service.call }.to raise_error(ActiveRecord::RecordInvalid)
+      end
+    end
+  end
+end
+```
+
+## Coverage
+
+```bash
+COVERAGE=true bundle exec rspec
+```
+
+Use **SimpleCov** for coverage reporting. Target 90%+ for new code.
+
+## Factories
+
+```ruby
+FactoryBot.define do
+  factory :user do
+    sequence(:email) { |n| "user#{n}@example.com" }
+    name { Faker::Name.name }
+    status { :active }
+  end
+end
+```
+
+## Reference
+
+See skill: `ruby-testing` for detailed RSpec patterns, shared examples, and Rails request specs.