The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs: fix renamed-repo links, drop stale assessment artifacts (#2058)
fxdvd2dfca21a43a
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex dda1e7132..ec983b4e6 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -52,8 +52,8 @@ Slash commands that invoke useful workflows:```bash# 1. Fork and clone-gh repo fork affaan-m/everything-claude-code --clone-cd everything-claude-code+gh repo fork affaan-m/ECC --clone+cd ECC# 2. Create a branchgit checkout -b feat/my-contribution@@ -499,7 +499,7 @@ How you tested this.## Questions?-- **Issues:** [github.com/affaan-m/everything-claude-code/issues](https://github.com/affaan-m/everything-claude-code/issues)+- **Issues:** [github.com/affaan-m/ECC/issues](https://github.com/affaan-m/ECC/issues)- **X/Twitter:** [@affaanmustafa](https://x.com/affaanmustafa)---diff --git a/EVALUATION.md b/EVALUATION.mddeleted file mode 100644index 929ddf66d..000000000--- a/EVALUATION.md+++ /dev/null@@ -1,122 +0,0 @@-# Repo Evaluation vs Current Setup--**Date:** 2026-03-21-**Branch:** `claude/evaluate-repo-comparison-ASZ9Y`-------## Current Setup (`~/.claude/`)--The active Claude Code installation is near-minimal:--| Component | Current |-|-----------|---------|-| Agents | 0 |-| Skills | 0 installed |-| Commands | 0 |-| Hooks | 1 (Stop: git check) |-| Rules | 0 |-| MCP configs | 0 |--**Installed hooks:**-- `Stop` → `stop-hook-git-check.sh` — blocks session end if there are uncommitted changes or unpushed commits--**Installed permissions:**-- `Skill` — allows skill invocations--**Plugins:** Only `blocklist.json` (no active plugins installed)-------## This Repo (`everything-claude-code` v1.9.0)--| Component | Repo |-|-----------|------|-| Agents | 28 |-| Skills | 116 |-| Commands | 59 |-| Rules sets | 12 languages + common (60+ rule files) |-| Hooks | Comprehensive system (PreToolUse, PostToolUse, SessionStart, Stop) |-| MCP configs | 1 (Context7 + others) |-| Schemas | 9 JSON validators |-| Scripts/CLI | 46+ Node.js modules + multiple CLIs |-| Tests | 58 test files |-| Install profiles | core, developer, security, research, full |-| Supported harnesses | Claude Code, Codex, Cursor, OpenCode |-------## Gap Analysis--### Hooks-- **Current:** 1 Stop hook (git hygiene check)-- **Repo:** Full hook matrix covering:- - Dangerous command blocking (`rm -rf`, force pushes)- - Auto-formatting on file edits- - Dev server tmux enforcement- - Cost tracking- - Session evaluation and governance capture- - MCP health monitoring--### Agents (28 missing)-The repo provides specialized agents for every major workflow:-- Language reviewers: TypeScript, Python, Go, Java, Kotlin, Rust, C++, Flutter-- Build resolvers: Go, Java, Kotlin, Rust, C++, PyTorch-- Workflow agents: planner, tdd-guide, code-reviewer, security-reviewer, architect-- Automation: loop-operator, doc-updater, refactor-cleaner, harness-optimizer--### Skills (116 missing)-Domain knowledge modules covering:-- Language patterns (Python, Go, Kotlin, Rust, C++, Java, Swift, Perl, Laravel, Django)-- Testing strategies (TDD, E2E, coverage)-- Architecture patterns (backend, frontend, API design, database migrations)-- AI/ML workflows (Claude API, eval harness, agent loops, cost-aware pipelines)-- Business workflows (investor materials, market research, content engine)--### Commands (59 missing)-- `/tdd`, `/plan`, `/e2e`, `/code-review` — core dev workflows-- `/sessions`, `/save-session`, `/resume-session` — session persistence-- `/orchestrate`, `/multi-plan`, `/multi-execute` — multi-agent coordination-- `/learn`, `/skill-create`, `/evolve` — continuous improvement-- `/build-fix`, `/verify`, `/quality-gate` — build/quality automation--### Rules (60+ files missing)-Language-specific coding style, patterns, testing, and security guidelines for:-TypeScript, Python, Go, Java, Kotlin, Rust, C++, C#, Swift, Perl, PHP, and common/cross-language rules.-------## Recommendations--### Immediate value (core install)-Run `ecc install --profile core` to get:-- Core agents (code-reviewer, planner, tdd-guide, security-reviewer)-- Essential skills (tdd-workflow, coding-standards, security-review)-- Key commands (/tdd, /plan, /code-review, /build-fix)--### Full install-Run `ecc install --profile full` to get all 28 agents, 116 skills, and 59 commands.--### Hooks upgrade-The current Stop hook is solid. The repo's `hooks.json` adds:-- Dangerous command blocking (safety)-- Auto-formatting (quality)-- Cost tracking (observability)-- Session evaluation (learning)--### Rules-Adding language rules (e.g., TypeScript, Python) provides always-on coding guidelines without relying on per-session prompts.-------## What the Current Setup Does Well--- The `stop-hook-git-check.sh` Stop hook is production-quality and already enforces good git hygiene-- The `Skill` permission is correctly configured-- The setup is clean with no conflicts or cruft-------## Summary--The current setup is essentially a blank slate with one well-implemented git hygiene hook. This repo provides a complete, production-tested enhancement layer covering agents, skills, commands, hooks, and rules — with a selective install system so you can add exactly what you need without bloating the configuration.diff --git a/REPO-ASSESSMENT.md b/REPO-ASSESSMENT.mddeleted file mode 100644index 95b2f7d1c..000000000--- a/REPO-ASSESSMENT.md+++ /dev/null@@ -1,196 +0,0 @@-# Repo & Fork Assessment + Setup Recommendations--**Date:** 2026-03-21-------## What's Available--### Repo: `Infiniteyieldai/everything-claude-code`--This is a **fork of `affaan-m/everything-claude-code`** (the upstream project with 50K+ stars, 6K+ forks).--| Attribute | Value |-|-----------|-------|-| Version | 1.9.0 (current) |-| Status | Clean fork — 1 commit ahead of upstream `main` (the EVALUATION.md doc added in this session) |-| Remote branches | `main`, `claude/evaluate-repo-comparison-ASZ9Y` |-| Upstream sync | Fully synced — last upstream commit merged was the zh-CN docs PR (#728) |-| License | MIT |--**This is the right repo to work from.** It's the latest upstream version with no divergence or merge conflicts.-------### Current `~/.claude/` Installation--| Component | Installed | Available in Repo |-|-----------|-----------|-------------------|-| Agents | 0 | 28 |-| Skills | 0 | 116 |-| Commands | 0 | 59 |-| Rules | 0 | 60+ files (12 languages) |-| Hooks | 1 (git Stop check) | Full PreToolUse/PostToolUse matrix |-| MCP configs | 0 | 1 (Context7) |--The existing Stop hook (`stop-hook-git-check.sh`) is solid — blocks session end on uncommitted/unpushed work. Keep it.-------## Install Profile Recommendations--The repo ships 5 install profiles. Choose based on your primary use case:--### Profile: `core` (Minimum viable setup)-> Fastest to install. Gets you commands, core agents, hooks runtime, and quality workflow.--**Best for:** Trying ECC out, minimal footprint, or a constrained environment.--```bash-node scripts/install-plan.js --profile core-node scripts/install-apply.js-```--**Installs:** rules-core, agents-core, commands-core, hooks-runtime, platform-configs, workflow-quality-------### Profile: `developer` (Recommended for daily dev work)-> The default engineering profile for most ECC users.--**Best for:** General software development across app codebases.--```bash-node scripts/install-plan.js --profile developer-node scripts/install-apply.js-```--**Adds over core:** framework-language skills, database patterns, orchestration commands-------### Profile: `security`-> Baseline runtime + security-specific agents and rules.--**Best for:** Security-focused workflows, code audits, vulnerability reviews.-------### Profile: `research`-> Investigation, synthesis, and publishing workflows.--**Best for:** Content creation, investor materials, market research, cross-posting.-------### Profile: `full`-> Everything — all 18 modules.--**Best for:** Power users who want the complete toolkit.--```bash-node scripts/install-plan.js --profile full-node scripts/install-apply.js-```-------## Priority Additions (High Value, Low Risk)--Regardless of profile, these components add immediate value:--### 1. Core Agents (highest ROI)--| Agent | Why it matters |-|-------|----------------|-| `planner.md` | Breaks complex tasks into implementation plans |-| `code-reviewer.md` | Quality and maintainability review |-| `tdd-guide.md` | TDD workflow (RED→GREEN→IMPROVE) |-| `security-reviewer.md` | Vulnerability detection |-| `architect.md` | System design & scalability decisions |--### 2. Key Commands--| Command | Why it matters |-|---------|----------------|-| `/plan` | Implementation planning before coding |-| `/tdd` | Test-driven workflow |-| `/code-review` | On-demand review |-| `/build-fix` | Automated build error resolution |-| `/learn` | Extract patterns from current session |--### 3. Hook Upgrades (from `hooks/hooks.json`)-The repo's hook system adds these over the current single Stop hook:--| Hook | Trigger | Value |-|------|---------|-------|-| `block-no-verify` | PreToolUse: Bash | Blocks `--no-verify` git flag abuse |-| `pre-bash-git-push-reminder` | PreToolUse: Bash | Pre-push review reminder |-| `doc-file-warning` | PreToolUse: Write | Warns on non-standard doc files |-| `suggest-compact` | PreToolUse: Edit/Write | Suggests compaction at logical intervals |-| Continuous learning observer | PreToolUse: * | Captures tool use patterns for skill improvement |--### 4. Rules (Always-on guidelines)-The `rules/common/` directory provides baseline guidelines that fire on every session:-- `security.md` — Security guardrails-- `testing.md` — 80%+ coverage requirement-- `git-workflow.md` — Conventional commits, branch strategy-- `coding-style.md` — Cross-language style standards-------## What to Do With the Fork--### Option A: Use as upstream tracker (current state)-Keep the fork synced with `affaan-m/everything-claude-code` upstream. Periodically merge upstream changes:-```bash-git fetch upstream-git merge upstream/main-```-Install from the local clone. This is clean and maintainable.--### Option B: Customize the fork-Add personal skills, agents, or commands to the fork. Good for:-- Business-specific domain skills (your vertical)-- Team-specific coding conventions-- Custom hooks for your stack--The fork already has the EVALUATION.md and REPO-ASSESSMENT.md docs — that's fine for a working fork.--### Option C: Install from npm (simplest for fresh machines)-```bash-npx ecc-universal install --profile developer-```-No need to clone the repo. This is the recommended install method for most users.-------## Recommended Setup Steps--1. **Keep the existing Stop hook** — it's doing its job-2. **Run the developer profile install** from the local fork:- ```bash- cd /path/to/everything-claude-code- node scripts/install-plan.js --profile developer- node scripts/install-apply.js- ```-3. **Add language rules** for your primary stack (TypeScript, Python, Go, etc.):- ```bash- node scripts/install-plan.js --add rules/typescript- node scripts/install-apply.js- ```-4. **Enable MCP Context7** for live documentation lookup:- - Copy `mcp-configs/mcp-servers.json` into your project's `.claude/` dir-5. **Review hooks** — enable the `hooks/hooks.json` additions selectively, starting with `block-no-verify` and `pre-bash-git-push-reminder`-------## Summary--| Question | Answer |-|----------|--------|-| Is the fork healthy? | Yes — fully synced with upstream v1.9.0 |-| Other forks to consider? | None visible in this environment; upstream `affaan-m/everything-claude-code` is the source of truth |-| Best install profile? | `developer` for day-to-day dev work |-| Biggest gap in current setup? | 0 agents installed — add at minimum: planner, code-reviewer, tdd-guide, security-reviewer |-| Quickest win? | Run `node scripts/install-plan.js --profile core && node scripts/install-apply.js` |