The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
feat: restore hookify command bundle
Affaan Mustafa56bd57c543b6
diff --git a/AGENTS.md b/AGENTS.mdindex 2578dfd79..8fbb6b8ef 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -1,6 +1,6 @@# Everything Claude Code (ECC) — Agent Instructions-This is a **production-ready AI coding plugin** providing 39 specialized agents, 180 skills, 73 commands, and automated hook workflows for software development.+This is a **production-ready AI coding plugin** providing 40 specialized agents, 180 skills, 77 commands, and automated hook workflows for software development.**Version:** 1.10.0@@ -145,9 +145,9 @@ Troubleshoot failures: check test isolation → verify mocks → fix implementat## Project Structure```-agents/ — 39 specialized subagents+agents/ — 40 specialized subagentsskills/ — 180 workflow skills and domain knowledge-commands/ — 73 slash commands+commands/ — 77 slash commandshooks/ — Trigger-based automationsrules/ — Always-follow guidelines (common + per-language)scripts/ — Cross-platform Node.js utilitiesdiff --git a/README.md b/README.mdindex 4f4dfdb34..d434fbba0 100644--- a/README.md+++ b/README.md@@ -236,7 +236,7 @@ For manual install instructions see the README in the `rules/` folder. When copy/plugin list ecc@ecc```-**That's it!** You now have access to 39 agents, 180 skills, and 73 legacy command shims.+**That's it!** You now have access to 40 agents, 180 skills, and 77 legacy command shims.### Multi-model commands require additional setup@@ -1152,8 +1152,8 @@ The configuration is automatically detected from `.opencode/opencode.json`.| Feature | Claude Code | OpenCode | Status ||---------|-------------|----------|--------|-| Agents | PASS: 39 agents | PASS: 12 agents | **Claude Code leads** |-| Commands | PASS: 73 commands | PASS: 31 commands | **Claude Code leads** |+| Agents | PASS: 40 agents | PASS: 12 agents | **Claude Code leads** |+| Commands | PASS: 77 commands | PASS: 31 commands | **Claude Code leads** || Skills | PASS: 180 skills | PASS: 37 skills | **Claude Code leads** || Hooks | PASS: 8 event types | PASS: 11 events | **OpenCode has more!** || Rules | PASS: 29 rules | PASS: 13 instructions | **Claude Code leads** |@@ -1261,8 +1261,8 @@ ECC is the **first plugin to maximize every major AI coding tool**. Here's how e| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode ||---------|------------|------------|-----------|----------|-| **Agents** | 39 | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |-| **Commands** | 73 | Shared | Instruction-based | 31 |+| **Agents** | 40 | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |+| **Commands** | 77 | Shared | Instruction-based | 31 || **Skills** | 180 | Shared | 10 (native format) | 37 || **Hook Events** | 8 types | 15 types | None yet | 11 types || **Hook Scripts** | 20+ scripts | 16 scripts (DRY adapter) | N/A | Plugin hooks |diff --git a/README.zh-CN.md b/README.zh-CN.mdindex efeb72864..cc40da8d7 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -106,7 +106,7 @@ cp -r everything-claude-code/rules/perl ~/.claude/rules//plugin list ecc@ecc```-**完成!** 你现在可以使用 39 个代理、180 个技能和 73 个命令。+**完成!** 你现在可以使用 40 个代理、180 个技能和 77 个命令。### multi-* 命令需要额外配置diff --git a/WORKING-CONTEXT.md b/WORKING-CONTEXT.mdindex ec816172f..e5c1d94da 100644--- a/WORKING-CONTEXT.md+++ b/WORKING-CONTEXT.md@@ -162,3 +162,4 @@ Keep this file detailed for only the current sprint, blockers, and next actions.- 2026-04-05: Direct-ported the safe README-only `#1285` slice into `main` instead of merging the branch: added a small `Community Projects` section so downstream teams can link public work built on ECC without changing install, security, or runtime surfaces. Rejected `#1286` at review because it adds an external third-party GitHub Action (`hashgraph-online/codex-plugin-scanner`) that does not meet the current supply-chain policy.- 2026-04-05: Re-audited `origin/feat/hermes-generated-ops-skills` by full diff. The branch is still not mergeable: it deletes current ECC-native surfaces, regresses packaging/install metadata, and removes newer `main` content. Continued the selective-salvage policy instead of branch merge.- 2026-04-05: Selectively salvaged `skills/frontend-design` from the Hermes branch as a self-contained ECC-native skill, mirrored it into `.agents`, wired it into `framework-language`, and re-synced the catalog to `180` skills after validation. The branch itself remains reference-only until every remaining unique file is either ported intentionally or rejected.+- 2026-04-05: Selectively salvaged the `hookify` command bundle plus the supporting `conversation-analyzer` agent from the Hermes branch. `hookify-rules` already existed as the canonical skill; this pass restores the user-facing command surfaces (`/hookify`, `/hookify-help`, `/hookify-list`, `/hookify-configure`) without pulling in any external runtime or branch-wide regressions. Catalog truth is now `40` agents, `77` commands, and `180` skills.diff --git a/agents/conversation-analyzer.md b/agents/conversation-analyzer.mdnew file mode 100644index 000000000..c39d6a81a--- /dev/null+++ b/agents/conversation-analyzer.md@@ -0,0 +1,52 @@+---+name: conversation-analyzer+description: Use this agent when analyzing conversation transcripts to find behaviors worth preventing with hooks. Triggered by /hookify without arguments.+model: sonnet+tools: [Read, Grep]+---++# Conversation Analyzer Agent++You analyze conversation history to identify problematic Claude Code behaviors that should be prevented with hooks.++## What to Look For++### Explicit Corrections+- "No, don't do that"+- "Stop doing X"+- "I said NOT to..."+- "That's wrong, use Y instead"++### Frustrated Reactions+- User reverting changes Claude made+- Repeated "no" or "wrong" responses+- User manually fixing Claude's output+- Escalating frustration in tone++### Repeated Issues+- Same mistake appearing multiple times in the conversation+- Claude repeatedly using a tool in an undesired way+- Patterns of behavior the user keeps correcting++### Reverted Changes+- `git checkout -- file` or `git restore file` after Claude's edit+- User undoing or reverting Claude's work+- Re-editing files Claude just edited++## Output Format++For each identified behavior:++```yaml+behavior: "Description of what Claude did wrong"+frequency: "How often it occurred"+severity: high|medium|low+suggested_rule:+ name: "descriptive-rule-name"+ event: bash|file|stop|prompt+ pattern: "regex pattern to match"+ action: block|warn+ message: "What to show when triggered"+```++Prioritize high-frequency, high-severity behaviors first.diff --git a/commands/hookify-configure.md b/commands/hookify-configure.mdnew file mode 100644index 000000000..929a85794--- /dev/null+++ b/commands/hookify-configure.md@@ -0,0 +1,14 @@+---+description: Enable or disable hookify rules interactively+---++Interactively enable or disable existing hookify rules.++## Steps++1. Find all `.claude/hookify.*.local.md` files+2. Read the current state of each rule+3. Present the list with current enabled / disabled status+4. Ask which rules to toggle+5. Update the `enabled:` field in the selected rule files+6. Confirm the changesdiff --git a/commands/hookify-help.md b/commands/hookify-help.mdnew file mode 100644index 000000000..f30ae0048--- /dev/null+++ b/commands/hookify-help.md@@ -0,0 +1,46 @@+---+description: Get help with the hookify system+---++Display comprehensive hookify documentation.++## Hook System Overview++Hookify creates rule files that integrate with Claude Code's hook system to prevent unwanted behaviors.++### Event Types++- `bash`: triggers on Bash tool use and matches command patterns+- `file`: triggers on Write/Edit tool use and matches file paths+- `stop`: triggers when a session ends+- `prompt`: triggers on user message submission and matches input patterns+- `all`: triggers on all events++### Rule File Format++Files are stored as `.claude/hookify.{name}.local.md`:++```yaml+---+name: descriptive-name+enabled: true+event: bash|file|stop|prompt|all+action: block|warn+pattern: "regex pattern to match"+---+Message to display when rule triggers.+Supports multiple lines.+```++### Commands++- `/hookify [description]` creates new rules and auto-analyzes the conversation when no description is given+- `/hookify-list` lists configured rules+- `/hookify-configure` toggles rules on or off++### Pattern Tips++- use regex syntax+- for `bash`, match against the full command string+- for `file`, match against the file path+- test patterns before deployingdiff --git a/commands/hookify-list.md b/commands/hookify-list.mdnew file mode 100644index 000000000..b912ce1da--- /dev/null+++ b/commands/hookify-list.md@@ -0,0 +1,21 @@+---+description: List all configured hookify rules+---++Find and display all hookify rules in a formatted table.++## Steps++1. Find all `.claude/hookify.*.local.md` files+2. Read each file's frontmatter:+ - `name`+ - `enabled`+ - `event`+ - `action`+ - `pattern`+3. Display them as a table:++| Rule | Enabled | Event | Pattern | File |+|------|---------|-------|---------|------|++4. Show the rule count and remind the user that `/hookify-configure` can change state later.diff --git a/commands/hookify.md b/commands/hookify.mdnew file mode 100644index 000000000..80969d8cd--- /dev/null+++ b/commands/hookify.md@@ -0,0 +1,50 @@+---+description: Create hooks to prevent unwanted behaviors from conversation analysis or explicit instructions+---++Create hook rules to prevent unwanted Claude Code behaviors by analyzing conversation patterns or explicit user instructions.++## Usage++`/hookify [description of behavior to prevent]`++If no arguments are provided, analyze the current conversation to find behaviors worth preventing.++## Workflow++### Step 1: Gather Behavior Info++- With arguments: parse the user's description of the unwanted behavior+- Without arguments: use the `conversation-analyzer` agent to find:+ - explicit corrections+ - frustrated reactions to repeated mistakes+ - reverted changes+ - repeated similar issues++### Step 2: Present Findings++Show the user:++- behavior description+- proposed event type+- proposed pattern or matcher+- proposed action++### Step 3: Generate Rule Files++For each approved rule, create a file at `.claude/hookify.{name}.local.md`:++```yaml+---+name: rule-name+enabled: true+event: bash|file|stop|prompt|all+action: block|warn+pattern: "regex pattern"+---+Message shown when rule triggers.+```++### Step 4: Confirm++Report created rules and how to manage them with `/hookify-list` and `/hookify-configure`.diff --git a/docs/zh-CN/AGENTS.md b/docs/zh-CN/AGENTS.mdindex a02d9c882..ba75f68a4 100644--- a/docs/zh-CN/AGENTS.md+++ b/docs/zh-CN/AGENTS.md@@ -1,6 +1,6 @@# Everything Claude Code (ECC) — 智能体指令-这是一个**生产就绪的 AI 编码插件**,提供 39 个专业代理、180 项技能、73 条命令以及自动化钩子工作流,用于软件开发。+这是一个**生产就绪的 AI 编码插件**,提供 40 个专业代理、180 项技能、77 条命令以及自动化钩子工作流,用于软件开发。**版本:** 1.10.0@@ -146,9 +146,9 @@## 项目结构```-agents/ — 39 个专业子代理+agents/ — 40 个专业子代理skills/ — 180 个工作流技能和领域知识-commands/ — 73 个斜杠命令+commands/ — 77 个斜杠命令hooks/ — 基于触发的自动化rules/ — 始终遵循的指导方针(通用 + 每种语言)scripts/ — 跨平台 Node.js 实用工具diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.mdindex 5c14b7f7f..cc8320a70 100644--- a/docs/zh-CN/README.md+++ b/docs/zh-CN/README.md@@ -209,7 +209,7 @@ npx ecc-install typescript/plugin list ecc@ecc```-**搞定!** 你现在可以使用 39 个智能体、180 项技能和 73 个命令了。+**搞定!** 你现在可以使用 40 个智能体、180 项技能和 77 个命令了。***@@ -1094,8 +1094,8 @@ opencode| 功能特性 | Claude Code | OpenCode | 状态 ||---------|-------------|----------|--------|-| 智能体 | PASS: 39 个 | PASS: 12 个 | **Claude Code 领先** |-| 命令 | PASS: 73 个 | PASS: 31 个 | **Claude Code 领先** |+| 智能体 | PASS: 40 个 | PASS: 12 个 | **Claude Code 领先** |+| 命令 | PASS: 77 个 | PASS: 31 个 | **Claude Code 领先** || 技能 | PASS: 180 项 | PASS: 37 项 | **Claude Code 领先** || 钩子 | PASS: 8 种事件类型 | PASS: 11 种事件 | **OpenCode 更多!** || 规则 | PASS: 29 条 | PASS: 13 条指令 | **Claude Code 领先** |@@ -1206,8 +1206,8 @@ ECC 是**第一个最大化利用每个主要 AI 编码工具的插件**。以| 功能特性 | Claude Code | Cursor IDE | Codex CLI | OpenCode ||---------|------------|------------|-----------|----------|-| **智能体** | 39 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |-| **命令** | 73 | 共享 | 基于指令 | 31 |+| **智能体** | 40 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |+| **命令** | 77 | 共享 | 基于指令 | 31 || **技能** | 180 | 共享 | 10 (原生格式) | 37 || **钩子事件** | 8 种类型 | 15 种类型 | 暂无 | 11 种类型 || **钩子脚本** | 20+ 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 |