The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs: salvage ECC onboarding guide commands
Affaan Mustafa10d160b95e50
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex ad52a4e7c..947349fbf 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -11,7 +11,7 @@{"name": "ecc","source": "./",- "description": "The most comprehensive Claude Code plugin — 54 agents, 207 skills, 70 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning",+ "description": "The most comprehensive Claude Code plugin — 54 agents, 208 skills, 72 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning","version": "2.0.0-rc.1","author": {"name": "Affaan Mustafa",diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex 1fe2e5a80..443fc68a0 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ecc","version": "2.0.0-rc.1",- "description": "Battle-tested Claude Code plugin for engineering teams — 54 agents, 207 skills, 70 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use",+ "description": "Battle-tested Claude Code plugin for engineering teams — 54 agents, 208 skills, 72 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use","author": {"name": "Affaan Mustafa","url": "https://x.com/affaanmustafa"diff --git a/AGENTS.md b/AGENTS.mdindex 5011c4a99..ffb243c7d 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 54 specialized agents, 207 skills, 70 commands, and automated hook workflows for software development.+This is a **production-ready AI coding plugin** providing 54 specialized agents, 208 skills, 72 commands, and automated hook workflows for software development.**Version:** 2.0.0-rc.1@@ -147,8 +147,8 @@ Troubleshoot failures: check test isolation → verify mocks → fix implementat```agents/ — 54 specialized subagents-skills/ — 207 workflow skills and domain knowledge-commands/ — 70 slash commands+skills/ — 208 workflow skills and domain knowledge+commands/ — 72 slash commandshooks/ — Trigger-based automationsrules/ — Always-follow guidelines (common + per-language)scripts/ — Cross-platform Node.js utilitiesdiff --git a/README.md b/README.mdindex dc47acdaf..037651177 100644--- a/README.md+++ b/README.md@@ -89,7 +89,7 @@ This repo is the raw code only. The guides explain everything.### v2.0.0-rc.1 — Surface Refresh, Operator Workflows, and ECC 2.0 Alpha (Apr 2026)- **Dashboard GUI** — New Tkinter-based desktop application (`ecc_dashboard.py` or `npm run dashboard`) with dark/light theme toggle, font customization, and project logo in header and taskbar.-- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 54 agents, 207 skills, and 70 legacy command shims.+- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 54 agents, 208 skills, and 72 legacy command shims.- **Operator and outbound workflow expansion** — `brand-voice`, `social-graph-ranker`, `connections-optimizer`, `customer-billing-ops`, `ecc-tools-cost-audit`, `google-workspace-ops`, `project-flow-ops`, and `workspace-surface-audit` round out the operator lane.- **Media and launch tooling** — `manim-video`, `remotion-video-creation`, and upgraded social publishing surfaces make technical explainers and launch content part of the same system.- **Framework and product surface growth** — `nestjs-patterns`, richer Codex/OpenCode install surfaces, and expanded cross-harness packaging keep the repo usable beyond Claude Code alone.@@ -358,7 +358,7 @@ If you stacked methods, clean up in this order:/plugin list ecc@ecc```-**That's it!** You now have access to 54 agents, 207 skills, and 70 legacy command shims.+**That's it!** You now have access to 54 agents, 208 skills, and 72 legacy command shims.### Dashboard GUI@@ -1350,8 +1350,8 @@ The configuration is automatically detected from `.opencode/opencode.json`.| Feature | Claude Code | OpenCode | Status ||---------|-------------|----------|--------|| Agents | PASS: 54 agents | PASS: 12 agents | **Claude Code leads** |-| Commands | PASS: 70 commands | PASS: 35 commands | **Claude Code leads** |-| Skills | PASS: 207 skills | PASS: 37 skills | **Claude Code leads** |+| Commands | PASS: 72 commands | PASS: 35 commands | **Claude Code leads** |+| Skills | PASS: 208 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** || MCP Servers | PASS: 14 servers | PASS: Full | **Full parity** |@@ -1455,8 +1455,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** | 54 | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |-| **Commands** | 70 | Shared | Instruction-based | 35 |-| **Skills** | 207 | Shared | 10 (native format) | 37 |+| **Commands** | 72 | Shared | Instruction-based | 35 |+| **Skills** | 208 | 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 || **Rules** | 34 (common + lang) | 34 (YAML frontmatter) | Instruction-based | 13 instructions |diff --git a/README.zh-CN.md b/README.zh-CN.mdindex cd666327b..6b0e1c119 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -160,7 +160,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"/plugin list ecc@ecc```-**完成!** 你现在可以使用 54 个代理、207 个技能和 70 个命令。+**完成!** 你现在可以使用 54 个代理、208 个技能和 72 个命令。### multi-* 命令需要额外配置diff --git a/agent.yaml b/agent.yamlindex ee58d0f5b..0de0e2d00 100644--- a/agent.yaml+++ b/agent.yaml@@ -152,6 +152,7 @@ commands:- cpp-build- cpp-review- cpp-test+ - ecc-guide- evolve- fastapi-review- feature-dev@@ -190,6 +191,7 @@ commands:- pm2- projects- promote+ - project-init- prp-commit- prp-implement- prp-plandiff --git a/commands/ecc-guide.md b/commands/ecc-guide.mdnew file mode 100644index 000000000..a1a6c20b7--- /dev/null+++ b/commands/ecc-guide.md@@ -0,0 +1,93 @@+---+description: Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository surface.+---++# /ecc-guide++Use this command as a conversational map of Everything Claude Code. It should help the user discover the right ECC surface for their task without dumping the entire README or stale catalog counts.++## Usage++```text+/ecc-guide+/ecc-guide setup+/ecc-guide skills+/ecc-guide commands+/ecc-guide hooks+/ecc-guide install+/ecc-guide find: <query>+/ecc-guide <feature-or-file-name>+```++## Operating Rules++1. Read current repository files before answering when the checkout is available.+2. Prefer current filesystem/catalog data over hard-coded counts.+3. Keep the first answer short, then offer specific drill-down paths.+4. Link users to canonical files instead of copying long sections.+5. Do not invent commands, skills, agents, or install profiles that are not present.++## What To Inspect++Use these files as the canonical map:++- `README.md` for install paths, reset/uninstall guidance, and high-level positioning+- `AGENTS.md` for contributor and project-structure guidance+- `agent.yaml` for exported agent and command surface+- `commands/` for maintained slash-command shims+- `skills/*/SKILL.md` for reusable skill workflows+- `agents/*.md` for delegated agent roles+- `hooks/README.md` and `hooks/hooks.json` for hook behavior+- `manifests/install-*.json` for selective install modules, components, and profiles+- `scripts/ci/catalog.js --json` for live catalog counts when running inside ECC++## Response Patterns++### No Arguments++Give a compact menu:++- setup and install+- choosing skills+- command compatibility shims+- agents and delegation+- hooks and safety+- troubleshooting an install+- finding a specific feature++Then ask what they want to do next.++### Topic Lookup++For topics like `skills`, `commands`, `hooks`, `install`, or `agents`:++1. Summarize the current surface in 3-6 bullets.+2. Point to the canonical directories/files.+3. Suggest one or two commands that can verify the state.+4. Avoid exhaustive lists unless the user asks for one.++### Search Mode++For `find: <query>`:++1. Search the relevant files with `rg`.+2. Group results by surface: skills, commands, agents, rules, docs, hooks.+3. Return the strongest matches first with file paths.+4. Recommend the next action for each match.++### Feature Lookup++For a specific feature name:++1. Check exact paths first, such as `skills/<name>/SKILL.md`, `commands/<name>.md`, and `agents/<name>.md`.+2. If exact lookup fails, search with `rg`.+3. Explain what the feature does, when to use it, and what file is canonical.+4. Mention adjacent features only when they reduce confusion.++## Related Commands++- `/project-init` for stack-aware ECC onboarding of a target project+- `/harness-audit` for deterministic repo readiness scoring+- `/skill-health` for skill quality checks+- `/skill-create` for extracting a new skill from local git history+- `/security-scan` for Claude/OpenCode configuration security reviewdiff --git a/commands/project-init.md b/commands/project-init.mdnew file mode 100644index 000000000..73de40228--- /dev/null+++ b/commands/project-init.md@@ -0,0 +1,86 @@+---+description: Detect a project's stack and produce a dry-run ECC onboarding plan using the repository's install manifests and stack mappings.+---++# /project-init++Create a safe, reviewable ECC onboarding plan for the current project. This command should start in dry-run mode and only write files after explicit user approval.++## Usage++```text+/project-init+/project-init --dry-run+/project-init --target claude+/project-init --target cursor+/project-init --skills continuous-learning-v2,security-review+/project-init --config ecc-install.json+```++## Safety Rules++1. Default to dry-run. Do not modify `CLAUDE.md`, settings files, rules, skills, or install state until the user approves the concrete plan.+2. Preserve existing project guidance. If `CLAUDE.md`, `.claude/settings.local.json`, `.cursor/`, `.codex/`, `.gemini/`, `.opencode/`, `.codebuddy/`, `.joycode/`, or `.qwen/` already exists, inspect it and propose a merge/append plan instead of overwriting.+3. Use ECC's installer and manifest tooling. Do not hand-copy files or clone arbitrary remotes as an install shortcut.+4. Keep permissions narrow. Any generated settings should match detected build/test/lint tools and avoid broad shell access.+5. Report exactly what would change before applying anything.++## Detection Inputs++Read the current project root and detect stack signals from:++- package manager files: `package.json`, `package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`, `bun.lockb`+- language manifests: `pyproject.toml`, `requirements.txt`, `go.mod`, `Cargo.toml`, `pom.xml`, `build.gradle`, `build.gradle.kts`+- framework files: `next.config.*`, `vite.config.*`, `tailwind.config.*`, `Dockerfile`, `docker-compose.yml`+- ECC config: `ecc-install.json`+- optional stack map: `config/project-stack-mappings.json` in the ECC repo++When the ECC checkout is available, use `config/project-stack-mappings.json` as the stack-to-rules/skills reference. If the file is unavailable, fall back to the installed ECC manifests and explicit user choices.++## Planning Flow++1. Identify the target harness. Default to `claude` unless the user asks for `cursor`, `codex`, `gemini`, `opencode`, `codebuddy`, `joycode`, or `qwen`.+2. Detect stacks from project files and show the evidence for each match.+3. Resolve the smallest useful ECC plan:+ - project has an `ecc-install.json`: `node scripts/install-plan.js --config ecc-install.json --json`+ - user named a profile: `node scripts/install-plan.js --profile <profile> --target <target> --json`+ - user named skills: `node scripts/install-plan.js --skills <skill-ids> --target <target> --json`+ - only language stacks are detected: use the legacy language install dry-run with those language names+4. Run a dry-run apply command before writing:++```bash+node scripts/install-apply.js --target <target> --dry-run --json <language-or-profile-args>+```++5. Summarize detected stacks, selected modules/components/skills, target paths, skipped unsupported modules, and files that would be changed.+6. Ask for approval before applying the non-dry-run command.++## Output Contract++Return:++1. detected stack evidence+2. proposed target harness+3. exact dry-run command used+4. exact apply command to run after approval+5. files/directories that would be created or changed+6. warnings about existing files, broad permissions, missing scripts, or unsupported targets++## CLAUDE.md Guidance++If the user wants a `CLAUDE.md` starter, generate it separately from the installer plan and keep it minimal:++- build command, if detected+- test command, if detected+- lint/typecheck command, if detected+- dev server command, if detected+- repo-specific notes from existing package scripts or manifests++Never replace an existing `CLAUDE.md` without showing a diff and receiving approval.++## Related++- `config/project-stack-mappings.json` for stack-to-surface hints+- `scripts/install-plan.js` for deterministic plan resolution+- `scripts/install-apply.js` for dry-run and apply operations+- `/ecc-guide` for interactive feature discovery before installingdiff --git a/config/project-stack-mappings.json b/config/project-stack-mappings.jsonnew file mode 100644index 000000000..04e66747a--- /dev/null+++ b/config/project-stack-mappings.json@@ -0,0 +1,539 @@+{+ "version": 1,+ "description": "Maps project indicator files to ECC skills, rules, hooks, and default commands. Used by /project-init to auto-configure projects.",+ "stacks": [+ {+ "id": "typescript",+ "name": "TypeScript / JavaScript",+ "indicators": [+ { "file": "tsconfig.json" },+ { "file": "tsconfig.*.json" },+ { "file": "package.json", "contains": "typescript" }+ ],+ "rules": ["common", "typescript"],+ "skills": [+ "coding-standards",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["npx tsc --noEmit", "npm run build"],+ "test": ["npm test", "npx jest", "npx vitest"],+ "lint": ["npx eslint .", "npx tsc --noEmit"],+ "format": ["npx prettier --write ."]+ },+ "permissions": {+ "allow": ["npx tsc", "npx eslint", "npx prettier", "npm test", "npm run *", "npx jest", "npx vitest"],+ "deny": ["npm publish"]+ }+ },+ {+ "id": "javascript",+ "name": "JavaScript (Node.js)",+ "indicators": [+ { "file": "package.json" },+ { "file": ".eslintrc*" },+ { "file": "eslint.config.*" }+ ],+ "rules": ["common", "typescript"],+ "skills": [+ "coding-standards",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["npm run build"],+ "test": ["npm test", "npx jest", "npx vitest"],+ "lint": ["npx eslint ."],+ "format": ["npx prettier --write ."]+ },+ "permissions": {+ "allow": ["npx eslint", "npx prettier", "npm test", "npm run *", "npx jest", "npx vitest"],+ "deny": ["npm publish"]+ }+ },+ {+ "id": "react",+ "name": "React",+ "indicators": [+ { "file": "package.json", "contains": "\"react\":" }+ ],+ "rules": ["common", "typescript", "web"],+ "skills": [+ "coding-standards",+ "frontend-patterns",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["npm run build"],+ "test": ["npm test", "npx jest", "npx vitest"],+ "lint": ["npx eslint ."],+ "format": ["npx prettier --write ."]+ },+ "permissions": {+ "allow": ["npx eslint", "npx prettier", "npm test", "npm run *", "npx jest", "npx vitest"],+ "deny": ["npm publish"]+ }+ },+ {+ "id": "nextjs",+ "name": "Next.js",+ "indicators": [+ { "file": "next.config.*" },+ { "file": "package.json", "contains": "\"next\":" }+ ],+ "rules": ["common", "typescript", "web"],+ "skills": [+ "coding-standards",+ "frontend-patterns",+ "backend-patterns",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["npm run build", "npx next build"],+ "test": ["npm test", "npx jest", "npx vitest"],+ "lint": ["npx next lint", "npx eslint ."],+ "format": ["npx prettier --write ."],+ "dev": ["npm run dev", "npx next dev"]+ },+ "permissions": {+ "allow": ["npx next *", "npx eslint", "npx prettier", "npm test", "npm run *", "npx jest", "npx vitest"],+ "deny": ["npm publish"]+ }+ },+ {+ "id": "golang",+ "name": "Go",+ "indicators": [+ { "file": "go.mod" },+ { "file": "go.sum" }+ ],+ "rules": ["common", "golang"],+ "skills": [+ "golang-patterns",+ "golang-testing",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["go build ./..."],+ "test": ["go test ./..."],+ "lint": ["golangci-lint run", "go vet ./..."],+ "format": ["gofmt -w ."]+ },+ "permissions": {+ "allow": ["go build *", "go test *", "go vet *", "go mod *", "go run *", "golangci-lint *", "gofmt *"],+ "deny": []+ }+ },+ {+ "id": "python",+ "name": "Python",+ "indicators": [+ { "file": "pyproject.toml" },+ { "file": "setup.py" },+ { "file": "setup.cfg" },+ { "file": "requirements.txt" },+ { "file": "Pipfile" },+ { "file": "poetry.lock" }+ ],+ "rules": ["common", "python"],+ "skills": [+ "python-patterns",+ "python-testing",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["python -m build", "pip install -e ."],+ "test": ["pytest", "python -m pytest"],+ "lint": ["ruff check .", "flake8", "mypy ."],+ "format": ["ruff format .", "black ."]+ },+ "permissions": {+ "allow": ["python *", "pip install *", "pytest *", "ruff *", "black *", "mypy *", "flake8 *"],+ "deny": ["pip install --user *"]+ }+ },+ {+ "id": "rust",+ "name": "Rust",+ "indicators": [+ { "file": "Cargo.toml" },+ { "file": "Cargo.lock" }+ ],+ "rules": ["common", "rust"],+ "skills": [+ "rust-patterns",+ "rust-testing",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["cargo build"],+ "test": ["cargo test"],+ "lint": ["cargo clippy -- -D warnings"],+ "format": ["cargo fmt"]+ },+ "permissions": {+ "allow": ["cargo build *", "cargo test *", "cargo clippy *", "cargo fmt *", "cargo run *", "cargo check *"],+ "deny": ["cargo publish"]+ }+ },+ {+ "id": "java",+ "name": "Java",+ "indicators": [+ { "file": "pom.xml" },+ { "file": "build.gradle" },+ { "file": "build.gradle.kts" }+ ],+ "rules": ["common", "java"],+ "skills": [+ "java-coding-standards",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["./mvnw compile", "./gradlew build", "mvn compile", "gradle build"],+ "test": ["./mvnw test", "./gradlew test", "mvn test", "gradle test"],+ "lint": ["./mvnw checkstyle:check", "./gradlew checkstyleMain"],+ "format": ["./mvnw spotless:apply", "./gradlew spotlessApply"]+ },+ "permissions": {+ "allow": ["./mvnw *", "./gradlew *", "mvn *", "gradle *", "java *"],+ "deny": ["./mvnw deploy", "./gradlew publish", "mvn deploy", "gradle publish"]+ }+ },+ {+ "id": "springboot",+ "name": "Spring Boot (Java/Kotlin)",+ "indicators": [+ { "file": "pom.xml", "contains": "spring-boot" },+ { "file": "build.gradle", "contains": "spring-boot" },+ { "file": "build.gradle.kts", "contains": "spring-boot" }+ ],+ "rules": ["common", "java"],+ "skills": [+ "springboot-patterns",+ "springboot-tdd",+ "springboot-verification",+ "springboot-security",+ "java-coding-standards",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["./mvnw compile", "./gradlew build"],+ "test": ["./mvnw test", "./gradlew test"],+ "lint": ["./mvnw checkstyle:check"],+ "format": ["./mvnw spotless:apply"],+ "dev": ["./mvnw spring-boot:run", "./gradlew bootRun"]+ },+ "permissions": {+ "allow": ["./mvnw *", "./gradlew *", "mvn *", "gradle *", "java *"],+ "deny": ["./mvnw deploy", "./gradlew publish", "mvn deploy", "gradle publish"]+ }+ },+ {+ "id": "kotlin",+ "name": "Kotlin",+ "indicators": [+ { "file": "build.gradle.kts" },+ { "file": "settings.gradle.kts" },+ { "file": "build.gradle", "contains": "kotlin" }+ ],+ "rules": ["common", "kotlin"],+ "skills": [+ "kotlin-patterns",+ "kotlin-testing",+ "kotlin-coroutines-flows",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["./gradlew build"],+ "test": ["./gradlew test"],+ "lint": ["./gradlew ktlintCheck", "./gradlew detekt"],+ "format": ["./gradlew ktlintFormat"]+ },+ "permissions": {+ "allow": ["./gradlew *", "gradle *", "kotlin *"],+ "deny": ["./gradlew publish"]+ }+ },+ {+ "id": "swift",+ "name": "Swift / SwiftUI",+ "indicators": [+ { "file": "Package.swift" },+ { "file": "*.xcodeproj" },+ { "file": "*.xcworkspace" },+ { "file": "Podfile" }+ ],+ "rules": ["common", "swift"],+ "skills": [+ "swiftui-patterns",+ "swift-concurrency-6-2",+ "swift-actor-persistence",+ "swift-protocol-di-testing",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["swift build", "xcodebuild build"],+ "test": ["swift test", "xcodebuild test"],+ "lint": ["swiftlint"],+ "format": ["swiftformat ."]+ },+ "permissions": {+ "allow": ["swift build *", "swift test *", "swift run *", "xcodebuild *", "swiftlint *", "swiftformat *"],+ "deny": []+ }+ },+ {+ "id": "dart-flutter",+ "name": "Dart / Flutter",+ "indicators": [+ { "file": "pubspec.yaml" },+ { "file": "pubspec.lock" }+ ],+ "rules": ["common", "dart"],+ "skills": [+ "dart-flutter-patterns",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["flutter build", "dart compile"],+ "test": ["flutter test", "dart test"],+ "lint": ["dart analyze"],+ "format": ["dart format ."]+ },+ "permissions": {+ "allow": ["flutter *", "dart *"],+ "deny": ["flutter pub publish"]+ }+ },+ {+ "id": "php-laravel",+ "name": "PHP / Laravel",+ "indicators": [+ { "file": "composer.json" },+ { "file": "artisan" },+ { "file": "composer.lock" }+ ],+ "rules": ["common", "php"],+ "skills": [+ "laravel-patterns",+ "laravel-tdd",+ "laravel-verification",+ "laravel-security",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["composer install"],+ "test": ["php artisan test", "vendor/bin/phpunit", "vendor/bin/pest"],+ "lint": ["vendor/bin/phpstan analyse", "vendor/bin/pint"],+ "format": ["vendor/bin/pint"]+ },+ "permissions": {+ "allow": ["php artisan *", "composer *", "vendor/bin/*"],+ "deny": []+ }+ },+ {+ "id": "ruby",+ "name": "Ruby / Rails",+ "indicators": [+ { "file": "Gemfile" },+ { "file": "Gemfile.lock" },+ { "file": "Rakefile" }+ ],+ "rules": ["common"],+ "skills": [+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["bundle install"],+ "test": ["bundle exec rspec", "bundle exec rake test"],+ "lint": ["bundle exec rubocop"],+ "format": ["bundle exec rubocop -A"]+ },+ "permissions": {+ "allow": ["bundle exec *", "rails *", "rake *", "ruby *"],+ "deny": ["gem push"]+ }+ },+ {+ "id": "csharp-dotnet",+ "name": "C# / .NET",+ "indicators": [+ { "file": "*.csproj" },+ { "file": "*.sln" },+ { "file": "global.json" }+ ],+ "rules": ["common", "csharp"],+ "skills": [+ "dotnet-patterns",+ "csharp-testing",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["dotnet build"],+ "test": ["dotnet test"],+ "lint": ["dotnet format --verify-no-changes"],+ "format": ["dotnet format"]+ },+ "permissions": {+ "allow": ["dotnet build *", "dotnet test *", "dotnet run *", "dotnet format *"],+ "deny": ["dotnet nuget push"]+ }+ },+ {+ "id": "cpp",+ "name": "C / C++",+ "indicators": [+ { "file": "CMakeLists.txt" },+ { "file": "Makefile" },+ { "file": "meson.build" },+ { "file": "*.vcxproj" }+ ],+ "rules": ["common", "cpp"],+ "skills": [+ "cpp-coding-standards",+ "cpp-testing",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["cmake --build build", "make"],+ "test": ["ctest --test-dir build", "make test"],+ "lint": ["clang-tidy -p build"],+ "format": ["clang-format -i **/*.cpp **/*.h **/*.c **/*.hpp"]+ },+ "permissions": {+ "allow": ["cmake *", "make *", "ctest *", "clang-tidy *", "clang-format *", "gcc *", "g++ *"],+ "deny": []+ }+ },+ {+ "id": "perl",+ "name": "Perl",+ "indicators": [+ { "file": "cpanfile" },+ { "file": "Makefile.PL" },+ { "file": "Build.PL" },+ { "file": "dist.ini" }+ ],+ "rules": ["common", "perl"],+ "skills": [+ "perl-patterns",+ "perl-testing",+ "perl-security",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["perl Makefile.PL && make", "perl Build.PL && ./Build"],+ "test": ["prove -lr t/", "make test"],+ "lint": ["perlcritic lib/"],+ "format": ["perltidy -b lib/**/*.pl"]+ },+ "permissions": {+ "allow": ["perl *", "prove *", "make *", "perlcritic *", "perltidy *"],+ "deny": []+ }+ },+ {+ "id": "django",+ "name": "Django (Python)",+ "indicators": [+ { "file": "manage.py" },+ { "file": "requirements.txt", "contains": "django" },+ { "file": "pyproject.toml", "contains": "django" }+ ],+ "rules": ["common", "python"],+ "skills": [+ "django-patterns",+ "django-tdd",+ "django-verification",+ "django-security",+ "python-patterns",+ "python-testing",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["pip install -e ."],+ "test": ["python manage.py test", "pytest"],+ "lint": ["ruff check .", "mypy ."],+ "format": ["ruff format .", "black ."],+ "dev": ["python manage.py runserver"]+ },+ "permissions": {+ "allow": ["python *", "pip install *", "pytest *", "ruff *", "black *", "mypy *"],+ "deny": []+ }+ },+ {+ "id": "android",+ "name": "Android (Kotlin/Java)",+ "indicators": [+ { "file": "settings.gradle.kts", "contains": "android" },+ { "file": "build.gradle", "contains": "android" },+ { "file": "AndroidManifest.xml" }+ ],+ "rules": ["common", "kotlin"],+ "skills": [+ "android-clean-architecture",+ "kotlin-patterns",+ "kotlin-testing",+ "kotlin-coroutines-flows",+ "compose-multiplatform-patterns",+ "tdd-workflow",+ "verification-loop"+ ],+ "commands": {+ "build": ["./gradlew assembleDebug"],+ "test": ["./gradlew testDebugUnitTest"],+ "lint": ["./gradlew lint", "./gradlew ktlintCheck"],+ "format": ["./gradlew ktlintFormat"]+ },+ "permissions": {+ "allow": ["./gradlew *", "adb *"],+ "deny": []+ }+ },+ {+ "id": "docker",+ "name": "Docker / Containerized",+ "indicators": [+ { "file": "Dockerfile" },+ { "file": "docker-compose.yml" },+ { "file": "docker-compose.yaml" },+ { "file": "compose.yml" },+ { "file": "compose.yaml" }+ ],+ "rules": [],+ "skills": [+ "docker-patterns",+ "deployment-patterns"+ ],+ "commands": {+ "build": ["docker compose build", "docker build ."],+ "test": ["docker compose run --rm app test"],+ "dev": ["docker compose up"]+ },+ "permissions": {+ "allow": ["docker compose *", "docker build *"],+ "deny": ["docker push"]+ }+ }+ ]+}diff --git a/docs/zh-CN/AGENTS.md b/docs/zh-CN/AGENTS.mdindex 654434533..b6f15070f 100644--- a/docs/zh-CN/AGENTS.md+++ b/docs/zh-CN/AGENTS.md@@ -1,6 +1,6 @@# Everything Claude Code (ECC) — 智能体指令-这是一个**生产就绪的 AI 编码插件**,提供 54 个专业代理、207 项技能、70 条命令以及自动化钩子工作流,用于软件开发。+这是一个**生产就绪的 AI 编码插件**,提供 54 个专业代理、208 项技能、72 条命令以及自动化钩子工作流,用于软件开发。**版本:** 2.0.0-rc.1@@ -147,8 +147,8 @@```agents/ — 54 个专业子代理-skills/ — 207 个工作流技能和领域知识-commands/ — 70 个斜杠命令+skills/ — 208 个工作流技能和领域知识+commands/ — 72 个斜杠命令hooks/ — 基于触发的自动化rules/ — 始终遵循的指导方针(通用 + 每种语言)scripts/ — 跨平台 Node.js 实用工具diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.mdindex e508c07b3..d1ec31d93 100644--- a/docs/zh-CN/README.md+++ b/docs/zh-CN/README.md@@ -224,7 +224,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"/plugin list ecc@ecc```-**搞定!** 你现在可以使用 54 个智能体、207 项技能和 70 个命令了。+**搞定!** 你现在可以使用 54 个智能体、208 项技能和 72 个命令了。***@@ -1133,8 +1133,8 @@ opencode| 功能特性 | Claude Code | OpenCode | 状态 ||---------|-------------|----------|--------|| 智能体 | PASS: 54 个 | PASS: 12 个 | **Claude Code 领先** |-| 命令 | PASS: 70 个 | PASS: 35 个 | **Claude Code 领先** |-| 技能 | PASS: 207 项 | PASS: 37 项 | **Claude Code 领先** |+| 命令 | PASS: 72 个 | PASS: 35 个 | **Claude Code 领先** |+| 技能 | PASS: 208 项 | PASS: 37 项 | **Claude Code 领先** || 钩子 | PASS: 8 种事件类型 | PASS: 11 种事件 | **OpenCode 更多!** || 规则 | PASS: 29 条 | PASS: 13 条指令 | **Claude Code 领先** || MCP 服务器 | PASS: 14 个 | PASS: 完整 | **完全对等** |@@ -1241,8 +1241,8 @@ ECC 是**第一个最大化利用每个主要 AI 编码工具的插件**。以| 功能特性 | Claude Code | Cursor IDE | Codex CLI | OpenCode ||---------|------------|------------|-----------|----------|| **智能体** | 54 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |-| **命令** | 70 | 共享 | 基于指令 | 35 |-| **技能** | 207 | 共享 | 10 (原生格式) | 37 |+| **命令** | 72 | 共享 | 基于指令 | 35 |+| **技能** | 208 | 共享 | 10 (原生格式) | 37 || **钩子事件** | 8 种类型 | 15 种类型 | 暂无 | 11 种类型 || **钩子脚本** | 20+ 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 || **规则** | 34 (通用 + 语言) | 34 (YAML 前页) | 基于指令 | 13 条指令 |diff --git a/skills/ecc-guide/SKILL.md b/skills/ecc-guide/SKILL.mdnew file mode 100644index 000000000..353c564ce--- /dev/null+++ b/skills/ecc-guide/SKILL.md@@ -0,0 +1,189 @@+---+name: ecc-guide+description: Guide users through ECC's current agents, skills, commands, hooks, rules, install profiles, and project onboarding by reading the live repository surface before answering.+origin: community+---++# ECC Guide++Use this skill when a user needs help understanding, navigating, installing, or choosing parts of Everything Claude Code.++## When To Use++Use this skill when the user:++- asks what ECC includes+- wants help finding a skill, command, agent, hook, rule, or install profile+- is new to the repository and needs a guided path+- asks "how do I do X with ECC?"+- asks which ECC components fit a project+- needs a lightweight explanation of how commands, skills, agents, hooks, and rules relate+- is confused by install paths, duplicate installs, reset/uninstall, or selective install options++## Core Principle++Answer from current files, not memory. ECC changes quickly, so hard-coded catalog counts, feature lists, and install instructions go stale.++When the ECC repository is available, inspect the relevant files before giving a concrete answer:++```bash+node scripts/ci/catalog.js --json+find skills -maxdepth 2 -name SKILL.md | sort+find commands -maxdepth 1 -name '*.md' | sort+find agents -maxdepth 1 -name '*.md' | sort+node scripts/install-plan.js --list-profiles+node scripts/install-plan.js --list-components --json+```++Use the smallest set of reads needed for the user's question.++## Repository Map++- `README.md`: install paths, uninstall/reset guidance, public positioning, FAQs+- `AGENTS.md`: contributor guidance and project structure+- `agent.yaml`: exported gitagent surface and command list+- `commands/`: maintained slash-command compatibility shims+- `skills/*/SKILL.md`: reusable workflows and domain playbooks+- `agents/*.md`: delegated subagent role prompts+- `rules/`: language and harness rules+- `hooks/README.md`, `hooks/hooks.json`, `scripts/hooks/`: hook behavior and safety gates+- `manifests/install-*.json`: selective install modules, components, profiles, and target support+- `docs/`: harness guides, architecture notes, translated docs, release docs++## Response Style++Lead with the answer, then give the next action. Most users do not need a full catalog dump.++Good first response shape:++1. what to use+2. why it fits+3. exact file or command to inspect+4. one next command or question++Avoid:++- listing every skill or command by default+- repeating large README sections+- recommending retired command shims when a skill-first path exists+- claiming a component exists without checking the filesystem+- replacing install guidance with manual copy commands when the managed installer supports the target++## Common Tasks++### New User Onboarding++Give a short menu:++- install or reset ECC+- pick skills for a project+- understand commands vs skills+- inspect hooks and safety behavior+- run a harness audit+- find a specific workflow++Point to `README.md` for install/reset and `/project-init` for project-specific onboarding.++### Feature Discovery++For "what should I use for X?":++1. Search `skills/`, `commands/`, and `agents/`.+2. Prefer skills as the primary workflow surface.+3. Use commands only when they are a maintained compatibility shim or a user explicitly wants slash-command behavior.+4. Mention agents when delegation is useful.++Useful searches:++```bash+rg -n "<query>" skills commands agents docs+find skills -maxdepth 2 -name SKILL.md | sort+```++### Install Guidance++Use managed install paths:++```bash+node scripts/install-plan.js --list-profiles+node scripts/install-plan.js --profile minimal --target claude --json+node scripts/install-apply.js --profile minimal --target claude --dry-run+```++For specific skill installs:++```bash+node scripts/install-plan.js --skills <skill-id> --target claude --json+node scripts/install-apply.js --skills <skill-id> --target claude --dry-run+```++Warn users not to stack plugin installs and full manual/profile installs unless they intentionally want duplicate surfaces.++### Project Onboarding++Use `/project-init` when the user wants ECC configured for a target repo. The expected sequence is:++1. detect the stack from project files+2. resolve a dry-run install plan+3. inspect existing `CLAUDE.md` and settings files+4. ask before applying changes+5. keep generated guidance minimal and repo-specific++### Troubleshooting++Ask for the target harness and install path first, then inspect:++- plugin install metadata+- `.claude/`, `.cursor/`, `.codex/`, `.gemini/`, `.opencode/`, `.codebuddy/`, `.joycode/`, or `.qwen/`+- `hooks/hooks.json`+- install-state files+- relevant command/skill files++For repo health, suggest:++```bash+npm run harness:audit -- --format text+npm run observability:ready+npm test+```++## Output Templates++### Short Recommendation++```text+Use <skill-or-command>. It fits because <reason>.++Canonical file: <path>+Verify with: <command>+Next: <one concrete action>+```++### Search Results++```text+Best matches:+- <path>: <why it matters>+- <path>: <why it matters>++Recommendation: <which one to use first and why>+```++### Install Plan Summary++```text+Detected: <stack evidence>+Target: <harness>+Plan: <profile/modules/skills>+Dry run: <command>+Would change: <paths>+Needs approval before apply: <yes/no>+```++## Related Surfaces++- `/project-init`: stack-aware onboarding plan for a target repo+- `/harness-audit`: deterministic readiness scorecard+- `/skill-health`: skill quality review+- `/skill-create`: generate a new skill from local git history+- `/security-scan`: inspect Claude/OpenCode configuration security