kodelyth-ecc 1.7.0 → 1.7.2

package/wiki/Platform-Support.md

@@ -1,36 +1,32 @@
 # Platform Support
 
-Kodelyth ECC works across 12 AI coding platforms. Feature availability varies by platform.
+Kodelyth ECC installs on 11 AI coding platforms via 13 install targets. Feature depth varies — hooks use Claude Code's native settings format and have no equivalent elsewhere; Cursor's agent system is incompatible with ECC's markdown agent format.
 
 ---
 
 ## Capability Matrix
 
-| Feature | Claude Code | Windsurf | Cursor | Codex CLI | Antigravity | OpenCode | Cline | Roocode | Aider | Kimi | Gemini |
+| Feature | Claude Code | Roo Code | Codex CLI | Aider | Kimi | Windsurf | Antigravity | Gemini CLI | Cursor | Cline | OpenCode |
 |---|---|---|---|---|---|---|---|---|---|---|---|
-| 70 Agents | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| 194 Skills | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| 97 Commands | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Hooks (20+) | Yes | No | No | No | No | No | No | No | No | No | No |
-| MCP Server | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Dashboard | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Memory inject | Yes (auto) | Manual | Manual | Manual | Manual | Manual | Manual | Manual | Manual | Manual | Manual |
-| Compound learning | Yes (auto) | Yes (manual) | Yes (manual) | Yes (manual) | Yes (manual) | Yes (manual) | Yes (manual) | Yes (manual) | Yes (manual) | Yes (manual) | Yes (manual) |
-| Semantic routing | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Devil-mode | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| `/project-launch` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| `/team-review` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| `/security-audit` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| `/devil-mode` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| `/lessons` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-
-**Hooks** are a Claude Code feature — they require the Claude Code hook system (`~/.claude/settings.json`). All other features work on every platform through CLAUDE.md or project-local config files. **MCP Server** and **Dashboard** are available on all platforms (v1.7.0+).
+| 70 Agents | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓* | — |
+| 194 Skills | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | partial | ✓ | ✓ | — | — |
+| 97 Commands | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | — | — | ✓* | — |
+| 22+ Hooks | ✓ | — | — | — | — | — | — | — | — | — | — |
+| Rules | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Auto lessons | ✓ | — | — | — | — | — | — | — | — | — | — |
+| Manual `/lessons` | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+
+\* Cline flattens agents and commands into `.clinerules/` as markdown rules — they provide context but not structured invocation.
+
+**Hooks** require Claude Code's JSON hook system (`~/.claude/settings.json`). No other platform has an equivalent.
+
+**MCP Server** and **Dashboard** (`npx kodelyth-ecc mcp` / `npx kodelyth-ecc dashboard`) are standalone CLI tools that work on every platform.
 
 ---
 
 ## Claude Code
 
-The full ECC experience. All features active. Auto-injected memory and lessons.
+Full feature set. All hooks auto-wired. Memory injected automatically at session start.
 
 **Install:**
 ```bash
@@ -43,342 +39,263 @@ npx kodelyth-ecc
 ├── agents/          → 70 specialist agents
 ├── skills/          → 194 skills
 ├── commands/        → 97 slash commands
-├── rules/           → 14 always-on rules
-└── settings.json    → hooks wired here
+├── rules/           → always-on coding standards + routing
+└── hooks/           → hooks.json (wired into settings.json)
 ```
 
 **Hooks active:**
-- Session start: `read-lessons.js` + `memory inject`
-- Every prompt: `auto-recall` (BM25 search)
-- After every edit: `quality-gate` + `test-reminder`
-- Before every commit: `secret-scan` + `console-check`
-- Before every push: `branch-check`
-- Session end: `capture-correction` + `memory-capture` + `desktop-notify` + `cost-tracker`
+- Session start: `read-lessons.js` + memory inject
+- Every prompt: auto-recall (BM25 search)
+- After edits: quality-gate + test-reminder
+- Before commit: secret-scan + console-check
+- Before push: branch-check
+- Session end: capture-correction + memory-capture + cost-tracker
 
 **Safety hooks (v1.7.0):**
-- `prompt-injection-guard` — Blocks attempted prompt injection
-- `token-budget-enforcer` — Warns when approaching token limit
-
-**Compound learning:** fully automatic — corrections are captured at session end and injected at session start without any user action.
+- `prompt-injection-guard` — blocks prompt injection attempts
+- `token-budget-enforcer` — warns when approaching token limit
 
 ---
 
-## Windsurf (Project)
+## Roo Code
 
-Agents, skills, and commands work. No hooks. Project-local installation.
+Agents, skills, and commands. No hooks.
 
 **Install:**
 ```bash
-npx kodelyth-ecc --target windsurf-project
+npx kodelyth-ecc --target roocode
 ```
 
 **File layout:**
 ```
-.windsurf/
+.roo/
 ├── agents/
 ├── skills/
 ├── commands/
 └── rules/
 ```
 
-**Lessons (manual):** Run `/lessons` at the start of each session to load `tasks/lessons.md`. Without hooks, lessons are not auto-injected.
+**Lessons (manual):** Run `/lessons` at session start to load `tasks/lessons.md`.
 
 ---
 
-## Windsurf (Home)
+## Codex CLI
 
-Global installation for all Windsurf projects.
+Agents, skills, and commands. `image-architect` uses DALL-E 3 natively.
 
 **Install:**
 ```bash
-npx kodelyth-ecc --target windsurf-home
+npx kodelyth-ecc --target codex-home
 ```
 
 **File layout:**
 ```
-~/.windsurf/
+~/.codex/
 ├── agents/
 ├── skills/
 ├── commands/
 └── rules/
 ```
 
-**Lessons:** Run `/lessons` per-project since lessons are project-specific.
+**Image generation:** `image-architect` routes to DALL-E 3 automatically on Codex CLI (no API key required).
 
 ---
 
-## Cursor (Project)
+## Aider
 
-Agents, skills, and commands work. No hooks.
+Agents, skills, and commands. `CONVENTIONS.md` auto-generated at project root.
 
 **Install:**
 ```bash
-npx kodelyth-ecc --target cursor-project
+npx kodelyth-ecc --target aider
 ```
 
 **File layout:**
 ```
-.cursor/
+.aider-ecc/
 ├── agents/
 ├── skills/
 ├── commands/
 └── rules/
+CONVENTIONS.md     → auto-generated, points aider at .aider-ecc/
 ```
 
-**Lessons (manual):** Run `/lessons` at the start of each session.
+**Usage:**
+```bash
+aider --read .aider-ecc/rules/agent-intent-routing.md \
+      --read .aider-ecc/agents/debug-detective.md
+```
 
 ---
 
-## Codex CLI
+## Kimi
 
-Full agents and skills. `image-architect` uses DALL-E 3 natively (no API key required).
+Agents, skills, and commands.
 
 **Install:**
 ```bash
-npx kodelyth-ecc --target codex-home
+npx kodelyth-ecc --target kimi
 ```
 
 **File layout:**
 ```
-~/.codex/
+.kimi/
 ├── agents/
 ├── skills/
 ├── commands/
 └── rules/
 ```
 
-**Image generation:** `image-architect` on Codex CLI routes to DALL-E 3 automatically.
-
-**Command-line usage:**
-```bash
-codex "use debug-detective" < error.log
-codex "use security-reviewer" < app.js
-```
-
 ---
 
-## Google Antigravity
+## Windsurf
 
-Full agents and skills. `image-architect` uses Gemini Imagen 3 natively (no API key required). Deep reasoning models available.
+Agents, skills, and rules. No commands (Windsurf workflows use a different format). A `.windsurfrules` file is generated from the common rules.
 
-**Install:**
+**Install (project):**
 ```bash
-npx kodelyth-ecc --target antigravity
-```
-
-**File layout:**
-```
-~/.antigravity/
-├── agents/
-├── skills/
-├── commands/
-└── rules/
+npx kodelyth-ecc --target windsurf-project
 ```
 
-**Image generation:** `image-architect` on Antigravity routes to Gemini Imagen 3 automatically — the most capable image model in the ECC stack.
-
-**Recommended models (Antigravity-specific):**
-
-| Task | Model |
-|---|---|
-| Most coding work | Gemini 3.1 Pro (Low) |
-| Architecture, security audits, hard bugs | Gemini 3.1 Pro (High) |
-| Claude agent behavior + extended thinking | Claude Sonnet 4.6 (Thinking) |
-| Hardest problems, last resort | Claude Opus 4.6 (Thinking) |
-
----
-
-## OpenCode
-
-Agents, skills, and commands work.
-
-**Install:**
+**Install (global):**
 ```bash
-npx kodelyth-ecc --target opencode
+npx kodelyth-ecc --target windsurf-home
 ```
 
 **File layout:**
 ```
-.opencode/
+.windsurf/
 ├── agents/
 ├── skills/
-├── commands/
 └── rules/
+.windsurfrules     → auto-generated from common rules
 ```
 
 ---
 
-## Cline (VS Code Extension)
+## Antigravity
 
-VS Code integration via Cline extension.
+Agents (installed as `.agent/skills/`), commands (as `.agent/workflows/`), rules. Four core ECC skills are copied into rules as always-on context. The full 194-skill directory is not installed (Antigravity has no separate skills system).
 
 **Install:**
 ```bash
-npx kodelyth-ecc --target cline
+npx kodelyth-ecc --target antigravity
 ```
 
 **File layout:**
 ```
-.cline/
-├── agents/
-├── skills/
-├── commands/
-└── rules/
+.agent/
+├── skills/          → 70 agents (mapped to Antigravity's skills system)
+├── workflows/       → 97 commands (mapped to Antigravity's workflows)
+└── rules/           → rules + 4 featured ECC skills as context
 ```
 
-**Native VS Code integration:** Commands and agents accessible within the VS Code editor. Full keyboard shortcut support.
+**Image generation:** `image-architect` routes to Gemini Imagen 3 natively.
 
 ---
 
-## Roocode (Web IDE)
+## Gemini CLI
 
-Web-based IDE integration.
+Agents, skills, and rules. No commands. A `GEMINI.md` is generated pointing to the installed content.
 
-**Install:**
+**Install (project):**
 ```bash
-npx kodelyth-ecc --target roocode
+npx kodelyth-ecc --target gemini-project
+```
+
+**Install (global):**
+```bash
+npx kodelyth-ecc --target gemini-home
 ```
 
 **File layout:**
 ```
-.roocode/
+.gemini/
 ├── agents/
 ├── skills/
-├── commands/
-└── rules/
+├── rules/
+└── GEMINI.md        → auto-generated context file
 ```
 
-**Browser-based:** All features work in the web IDE. Memory and lessons stored in browser local storage.
-
 ---
 
-## Aider (Git-Native)
+## Cursor
 
-Aider-specific integration with full git awareness.
+Rules and skills only. Cursor's agent system uses a different YAML format that is not compatible with ECC's markdown agents.
 
 **Install:**
 ```bash
-npx kodelyth-ecc --target aider
+npx kodelyth-ecc --target cursor-project
 ```
 
 **File layout:**
 ```
-.aider/
-├── agents/
+.cursor/
 ├── skills/
-├── commands/
-└── rules/
+└── rules/           → flattened from all rule directories
 ```
 
-**Git-aware:** Aider's native git integration automatically applies ECC's git-rescue and release-captain agents.
-
 ---
 
-## Kimi (Chinese Platform)
+## Cline
 
-Chinese AI platform support.
+Rules, agents, and commands all flattened into `.clinerules/` as markdown context files. No separate skills directory.
 
 **Install:**
 ```bash
-npx kodelyth-ecc --target kimi
+npx kodelyth-ecc --target cline
 ```
 
 **File layout:**
 ```
-.kimi/
-├── agents/
-├── skills/
-├── commands/
-└── rules/
+.clinerules/
+├── (all rule .md files)
+├── (all agent .md files — flattened)
+└── (all command .md files — flattened)
 ```
 
-**Chinese documentation:** Agents and skills auto-translate to Chinese UI labels.
+Cline reads everything in `.clinerules/` as persistent context, so agents and commands are available as reference material even though they aren't structured invocations.
 
 ---
 
-## Gemini (Project and Home)
-
-Dual-entry support for Gemini projects and global installation.
+## OpenCode
 
-**Install (project-local):**
-```bash
-npx kodelyth-ecc --target gemini-project
-```
+Rules only. OpenCode has no agent or skill directory concept.
 
-**Install (global):**
+**Install:**
 ```bash
-npx kodelyth-ecc --target gemini-home
-```
-
-**File layout (project):**
-```
-.gemini/
-├── agents/
-├── skills/
-├── commands/
-└── rules/
+npx kodelyth-ecc --target opencode
 ```
 
-**File layout (home):**
+**File layout:**
 ```
-~/.gemini/
-├── agents/
-├── skills/
-├── commands/
-└── rules/
+.opencode/
+└── rules/           → flattened from all rule directories
 ```
 
-**Image generation:** `image-architect` routes to Gemini Imagen 3.
-
 ---
 
 ## Lessons on Non-Claude-Code Platforms
 
-On all platforms except Claude Code, the compound learning system requires one manual step per session:
-
-1. Start your session
-2. Type `/lessons`
-3. ECC reads `tasks/lessons.md` and activates all project rules for the session
-
-Claude Code users: this happens automatically via the `read-lessons.js` SessionStart hook.
-
----
-
-## MCP Server Availability (v1.7.0)
-
-All platforms can run the standalone MCP server:
+On all platforms except Claude Code, load project lessons manually at session start:
 
-```bash
-npx kodelyth-ecc mcp --port 5173
 ```
-
-This provides 16 tools and 6 prompts accessible from any MCP-compatible client.
-
----
-
-## Dashboard Availability (v1.7.0)
-
-All platforms can run the standalone dashboard:
-
-```bash
-npx kodelyth-ecc dashboard --port 5173
+/lessons
 ```
 
-Five tabs: Overview, Memory, Evolve, Catalog, Sessions. Zero analytics, localhost only.
+This reads `tasks/lessons.md` and activates all project rules for the session. On Claude Code, this happens automatically via the `read-lessons.js` SessionStart hook.
 
 ---
 
 ## image-architect Platform Routing
 
-| Platform | Image model used |
+| Platform | Image model |
 |---|---|
 | Antigravity | Gemini Imagen 3 (native, no key) |
 | Codex CLI | DALL-E 3 (native, no key) |
-| Gemini | Gemini Imagen 3 (native, no key) |
 | Claude Code | fal.ai MCP → SVG fallback |
-| Windsurf | Native model gen → fal.ai → SVG fallback |
-| Cursor | Native model gen → fal.ai → SVG fallback |
-| Others (Cline, Roocode, Aider, Kimi) | SVG fallback |
+| Windsurf / Cursor | native model gen → fal.ai → SVG fallback |
+| Others | SVG fallback |
 
 ---
 
@@ -386,36 +303,22 @@ Five tabs: Overview, Memory, Evolve, Catalog, Sessions. Zero analytics, localhos
 
 | OS | Supported | Install method |
 |---|---|---|
-| macOS | Yes | `npx` or `./install.sh` |
-| Linux | Yes | `npx` or `./install.sh` |
-| Windows | Yes | `npx` or `./install.ps1` |
-
-All Node.js-based scripts are cross-platform. The `desktop-notify` hook (macOS notification) is macOS-only and silently skips on other platforms.
-
----
-
-## Platform-Specific Notes
-
-**Claude Code:** Best default choice. All features. Most stable. Auto-injected learning.
-
-**Windsurf / Cursor:** Full agent support. Requires manual `/lessons` per session. No hooks, but can wire post-save formatters manually.
-
-**Antigravity:** Deep reasoning models. Gemini Imagen 3 image generation. Best for complex architecture tasks.
-
-**Codex CLI / Aider:** CLI-first workflows. Full agent support. Good for automation and git-aware changes.
+| macOS | ✓ | `npx` or `./install.sh` |
+| Linux | ✓ | `npx` or `./install.sh` |
+| Windows | ✓ | `npx` or `.\install.ps1` |
 
-**Cline / Roocode / Kimi:** Emerging platforms. Full agent support confirmed. Dashboard and MCP server available.
+The `desktop-notify` hook (macOS system notification) is macOS-only and silently skips on other platforms.
 
 ---
 
 ## Choosing a Platform
 
-| Your workflow | Best platform |
+| Workflow | Best platform |
 |---|---|
-| Individual contributor, Claude user | Claude Code |
-| Web dev, rapid iteration, many projects | Windsurf |
-| Enterprise, many languages, deep reasoning | Antigravity |
-| Git-native workflow, automation | Aider |
-| VS Code power user | Cline |
-| Web-only environment | Roocode |
-| Complex architecture, long sessions | Claude Code + Opus 4.6 |
+| Maximum feature set | Claude Code |
+| Git-native automation | Aider |
+| VS Code + Cline extension | Cline or Roo Code |
+| OpenAI stack | Codex CLI |
+| Deep reasoning, complex architecture | Antigravity |
+| Windsurf IDE | Windsurf |
+| Gemini stack | Gemini CLI |

package/wiki/Skill-Reference.md

@@ -40,7 +40,7 @@ Type the skill name with a `/` prefix. Skills load instantly and activate for th
 |---|---|---|
 | Memory Protocol | `/memory` | BM25 recall workflow, capture triggers, review-pending flow |
 | Memory Evolve | `/memory-evolve` | Self-improving memory analysis, pattern extraction (v1.7.0) |
-| Lessons | `/lessons` | Load/save/manage `tasks/lessons.md` on all 12 platforms |
+| Lessons | `/lessons` | Load/save/manage `tasks/lessons.md` on all 11 platforms |
 | Configure ECC | `/configure-ecc` | Customize agents, hooks, and rules for your project |
 | Quickstart | `/kodelyth-quickstart` | 5-minute tour of the entire toolkit |
 

package/.agent/rules/README.md

@@ -1,108 +0,0 @@
-# 规则
-
-## 结构
-
-规则按**通用**层和**语言特定**目录组织：
-
-```
-rules/
-├── common/          # 语言无关的原则（始终安装）
-│   ├── coding-style.md
-│   ├── git-workflow.md
-│   ├── testing.md
-│   ├── performance.md
-│   ├── patterns.md
-│   ├── hooks.md
-│   ├── agents.md
-│   ├── security.md
-│   ├── code-review.md
-│   └── development-workflow.md
-├── zh/              # 中文翻译版本
-│   ├── coding-style.md
-│   ├── git-workflow.md
-│   ├── testing.md
-│   ├── performance.md
-│   ├── patterns.md
-│   ├── hooks.md
-│   ├── agents.md
-│   ├── security.md
-│   ├── code-review.md
-│   └── development-workflow.md
-├── typescript/      # TypeScript/JavaScript 特定
-├── python/          # Python 特定
-├── golang/          # Go 特定
-├── swift/           # Swift 特定
-└── php/             # PHP 特定
-```
-
-- **common/** 包含通用原则 — 无语言特定的代码示例。
-- **zh/** 包含 common 目录的中文翻译版本。
-- **语言目录** 扩展通用规则，包含框架特定的模式、工具和代码示例。每个文件引用其对应的通用版本。
-
-## 安装
-
-### 选项 1：安装脚本（推荐）
-
-```bash
-# 安装通用 + 一个或多个语言特定的规则集
-./install.sh typescript
-./install.sh python
-./install.sh golang
-./install.sh swift
-./install.sh php
-
-# 同时安装多种语言
-./install.sh typescript python
-```
-
-### 选项 2：手动安装
-
-> **重要提示：** 复制整个目录 — 不要使用 `/*` 展开。
-> 通用和语言特定目录包含同名文件。
-> 将它们展开到一个目录会导致语言特定文件覆盖通用规则，
-> 并破坏语言特定文件使用的 `../common/` 相对引用。
-
-```bash
-# 创建目标目录
-mkdir -p ~/.claude/rules
-
-# 安装通用规则（所有项目必需）
-cp -r rules/common ~/.claude/rules/common
-
-# 安装中文翻译版本（可选）
-cp -r rules/zh ~/.claude/rules/zh
-
-# 根据项目技术栈安装语言特定规则
-cp -r rules/typescript ~/.claude/rules/typescript
-cp -r rules/python ~/.claude/rules/python
-cp -r rules/golang ~/.claude/rules/golang
-cp -r rules/swift ~/.claude/rules/swift
-cp -r rules/php ~/.claude/rules/php
-```
-
-## 规则 vs 技能
-
-- **规则** 定义广泛适用的标准、约定和检查清单（如"80% 测试覆盖率"、"禁止硬编码密钥"）。
-- **技能**（`skills/` 目录）为特定任务提供深入、可操作的参考材料（如 `python-patterns`、`golang-testing`）。
-
-语言特定的规则文件在适当的地方引用相关技能。规则告诉你*做什么*；技能告诉你*怎么做*。
-
-## 规则优先级
-
-当语言特定规则与通用规则冲突时，**语言特定规则优先**（特定覆盖通用）。这遵循标准的分层配置模式（类似于 CSS 特异性或 `.gitignore` 优先级）。
-
-- `rules/common/` 定义适用于所有项目的通用默认值。
-- `rules/golang/`、`rules/python/`、`rules/swift/`、`rules/php/`、`rules/typescript/` 等在语言习惯不同时覆盖这些默认值。
-- `rules/zh/` 是通用规则的中文翻译，与英文版本内容一致。
-
-### 示例
-
-`common/coding-style.md` 推荐不可变性作为默认原则。语言特定的 `golang/coding-style.md` 可以覆盖这一点：
-
-> 惯用的 Go 使用指针接收器进行结构体变更 — 参见 [common/coding-style.md](../common/coding-style.md) 了解通用原则，但这里首选符合 Go 习惯的变更方式。
-
-### 带覆盖说明的通用规则
-
-`rules/common/` 中可能被语言特定文件覆盖的规则会被标记：
-
-> **语言说明**：此规则可能会被语言特定规则覆盖；对于某些语言，该模式可能并不符合惯用写法。