kodelyth-ecc 1.5.5 → 1.5.7

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,41 @@
 
 All notable changes to Kodelyth ECC are documented here.
 
+## v1.5.7 — Fix zsh inline comment args (May 2026)
+
+### Bug Fix
+
+- **zsh inline comment crash** — `npx kodelyth-ecc --target windsurf-home  # comment` would fail with `Unknown argument: #` in zsh. Unlike bash, zsh does not strip inline `#` comments before passing args to a process. Fixed at two layers: `bin/kodelyth-ecc.js` now filters out `#` and all following args before passing to the installer, and `install.sh` also handles `#*` args with a graceful `break`. This makes copy-pasting commands from documentation with inline comments safe on all shells.
+
+---
+
+## 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.7

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/bin/kodelyth-ecc.js

@@ -20,7 +20,12 @@ const fs            = require('fs');
 const os            = require('os');
 
 const ROOT    = path.join(__dirname, '..');
-const args    = process.argv.slice(2);
+// zsh (unlike bash) passes inline comments as literal args — strip them
+const args    = process.argv.slice(2).filter((a, i, arr) => {
+  if (a.startsWith('#')) return false;          // drop # and everything after
+  const prev = arr.slice(0, i).findIndex(x => x.startsWith('#'));
+  return prev === -1;
+});
 const isWin   = os.platform() === 'win32';
 
 // ── Help shortcut ─────────────────────────────────────────────────────────────

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"
@@ -154,6 +154,10 @@ while [[ $# -gt 0 ]]; do
       echo "  ./install.sh --target cursor-project typescript"
       exit 0
       ;;
+    \#*)
+      # zsh passes inline comments as literal args; skip them and everything after
+      break
+      ;;
     *)
       echo -e "${RED}Unknown argument: $1${RESET}"
       exit 1
@@ -338,15 +342,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 +378,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 +396,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 +481,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.7",
+  "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": {