mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-02-13 09:53:08 +08:00
77be80c69b
New skill: /security-scan wraps ecc-agentshield to audit .claude/ configs for vulnerabilities, misconfigs, and injection risks. Covers: CLAUDE.md secrets, settings.json permissions, MCP server risks, hook injection, agent tool restrictions. Produces A-F security grade. Also adds AgentShield section to Ecosystem Tools in README with links to GitHub repo and npm package.
787 lines
28 KiB
Markdown
787 lines
28 KiB
Markdown
**Language:** English | [繁體中文](docs/zh-TW/README.md)
|
|
|
|
# Everything Claude Code
|
|
|
|
[](https://github.com/affaan-m/everything-claude-code/stargazers)
|
|
[](https://github.com/affaan-m/everything-claude-code/network/members)
|
|
[](https://github.com/affaan-m/everything-claude-code/graphs/contributors)
|
|
[](LICENSE)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
> **42K+ stars** | **5K+ forks** | **24 contributors** | **6 languages supported**
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
**🌐 Language / 语言 / 語言**
|
|
|
|
[**English**](README.md) | [简体中文](README.zh-CN.md) | [繁體中文](docs/zh-TW/README.md)
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
**The complete collection of Claude Code configs from an Anthropic hackathon winner.**
|
|
|
|
Production-ready agents, skills, hooks, commands, rules, and MCP configurations evolved over 10+ months of intensive daily use building real products.
|
|
|
|
---
|
|
|
|
## The Guides
|
|
|
|
This repo is the raw code only. The guides explain everything.
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%">
|
|
<a href="https://x.com/affaanmustafa/status/2012378465664745795">
|
|
<img src="https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef" alt="The Shorthand Guide to Everything Claude Code" />
|
|
</a>
|
|
</td>
|
|
<td width="50%">
|
|
<a href="https://x.com/affaanmustafa/status/2014040193557471352">
|
|
<img src="https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0" alt="The Longform Guide to Everything Claude Code" />
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><b>Shorthand Guide</b><br/>Setup, foundations, philosophy. <b>Read this first.</b></td>
|
|
<td align="center"><b>Longform Guide</b><br/>Token optimization, memory persistence, evals, parallelization.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
| Topic | What You'll Learn |
|
|
|-------|-------------------|
|
|
| Token Optimization | Model selection, system prompt slimming, background processes |
|
|
| Memory Persistence | Hooks that save/load context across sessions automatically |
|
|
| Continuous Learning | Auto-extract patterns from sessions into reusable skills |
|
|
| Verification Loops | Checkpoint vs continuous evals, grader types, pass@k metrics |
|
|
| Parallelization | Git worktrees, cascade method, when to scale instances |
|
|
| Subagent Orchestration | The context problem, iterative retrieval pattern |
|
|
|
|
---
|
|
|
|
## What's New
|
|
|
|
### v1.4.1 — Bug Fix (Feb 2026)
|
|
|
|
- **Fixed instinct import content loss** — `parse_instinct_file()` was silently dropping all content after frontmatter (Action, Evidence, Examples sections) during `/instinct-import`. Fixed by community contributor @ericcai0814 ([#148](https://github.com/affaan-m/everything-claude-code/issues/148), [#161](https://github.com/affaan-m/everything-claude-code/pull/161))
|
|
|
|
### v1.4.0 — Multi-Language Rules, Installation Wizard & PM2 (Feb 2026)
|
|
|
|
- **Interactive installation wizard** — New `configure-ecc` skill provides guided setup with merge/overwrite detection
|
|
- **PM2 & multi-agent orchestration** — 6 new commands (`/pm2`, `/multi-plan`, `/multi-execute`, `/multi-backend`, `/multi-frontend`, `/multi-workflow`) for managing complex multi-service workflows
|
|
- **Multi-language rules architecture** — Rules restructured from flat files into `common/` + `typescript/` + `python/` + `golang/` directories. Install only the languages you need
|
|
- **Chinese (zh-CN) translations** — Complete translation of all agents, commands, skills, and rules (80+ files)
|
|
- **GitHub Sponsors support** — Sponsor the project via GitHub Sponsors
|
|
- **Enhanced CONTRIBUTING.md** — Detailed PR templates for each contribution type
|
|
|
|
### v1.3.0 — OpenCode Plugin Support (Feb 2026)
|
|
|
|
- **Full OpenCode integration** — 12 agents, 24 commands, 16 skills with hook support via OpenCode's plugin system (20+ event types)
|
|
- **3 native custom tools** — run-tests, check-coverage, security-audit
|
|
- **LLM documentation** — `llms.txt` for comprehensive OpenCode docs
|
|
|
|
### v1.2.0 — Unified Commands & Skills (Feb 2026)
|
|
|
|
- **Python/Django support** — Django patterns, security, TDD, and verification skills
|
|
- **Java Spring Boot skills** — Patterns, security, TDD, and verification for Spring Boot
|
|
- **Session management** — `/sessions` command for session history
|
|
- **Continuous learning v2** — Instinct-based learning with confidence scoring, import/export, evolution
|
|
|
|
See the full changelog in [Releases](https://github.com/affaan-m/everything-claude-code/releases).
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start
|
|
|
|
Get up and running in under 2 minutes:
|
|
|
|
### Step 1: Install the Plugin
|
|
|
|
```bash
|
|
# Add marketplace
|
|
/plugin marketplace add affaan-m/everything-claude-code
|
|
|
|
# Install plugin
|
|
/plugin install everything-claude-code@everything-claude-code
|
|
```
|
|
|
|
### Step 2: Install Rules (Required)
|
|
|
|
> ⚠️ **Important:** Claude Code plugins cannot distribute `rules` automatically. Install them manually:
|
|
|
|
```bash
|
|
# Clone the repo first
|
|
git clone https://github.com/affaan-m/everything-claude-code.git
|
|
|
|
# Install common rules (required)
|
|
cp -r everything-claude-code/rules/common/* ~/.claude/rules/
|
|
|
|
# Install language-specific rules (pick your stack)
|
|
cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/
|
|
cp -r everything-claude-code/rules/python/* ~/.claude/rules/
|
|
cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
|
|
```
|
|
|
|
### Step 3: Start Using
|
|
|
|
```bash
|
|
# Try a command
|
|
/plan "Add user authentication"
|
|
|
|
# Check available commands
|
|
/plugin list everything-claude-code@everything-claude-code
|
|
```
|
|
|
|
✨ **That's it!** You now have access to 15+ agents, 30+ skills, and 30+ commands.
|
|
|
|
---
|
|
|
|
## 🌐 Cross-Platform Support
|
|
|
|
This plugin now fully supports **Windows, macOS, and Linux**. All hooks and scripts have been rewritten in Node.js for maximum compatibility.
|
|
|
|
### Package Manager Detection
|
|
|
|
The plugin automatically detects your preferred package manager (npm, pnpm, yarn, or bun) with the following priority:
|
|
|
|
1. **Environment variable**: `CLAUDE_PACKAGE_MANAGER`
|
|
2. **Project config**: `.claude/package-manager.json`
|
|
3. **package.json**: `packageManager` field
|
|
4. **Lock file**: Detection from package-lock.json, yarn.lock, pnpm-lock.yaml, or bun.lockb
|
|
5. **Global config**: `~/.claude/package-manager.json`
|
|
6. **Fallback**: First available package manager
|
|
|
|
To set your preferred package manager:
|
|
|
|
```bash
|
|
# Via environment variable
|
|
export CLAUDE_PACKAGE_MANAGER=pnpm
|
|
|
|
# Via global config
|
|
node scripts/setup-package-manager.js --global pnpm
|
|
|
|
# Via project config
|
|
node scripts/setup-package-manager.js --project bun
|
|
|
|
# Detect current setting
|
|
node scripts/setup-package-manager.js --detect
|
|
```
|
|
|
|
Or use the `/setup-pm` command in Claude Code.
|
|
|
|
---
|
|
|
|
## 📦 What's Inside
|
|
|
|
This repo is a **Claude Code plugin** - install it directly or copy components manually.
|
|
|
|
```
|
|
everything-claude-code/
|
|
|-- .claude-plugin/ # Plugin and marketplace manifests
|
|
| |-- plugin.json # Plugin metadata and component paths
|
|
| |-- marketplace.json # Marketplace catalog for /plugin marketplace add
|
|
|
|
|
|-- agents/ # Specialized subagents for delegation
|
|
| |-- planner.md # Feature implementation planning
|
|
| |-- architect.md # System design decisions
|
|
| |-- tdd-guide.md # Test-driven development
|
|
| |-- code-reviewer.md # Quality and security review
|
|
| |-- security-reviewer.md # Vulnerability analysis
|
|
| |-- build-error-resolver.md
|
|
| |-- e2e-runner.md # Playwright E2E testing
|
|
| |-- refactor-cleaner.md # Dead code cleanup
|
|
| |-- doc-updater.md # Documentation sync
|
|
| |-- go-reviewer.md # Go code review
|
|
| |-- go-build-resolver.md # Go build error resolution
|
|
| |-- python-reviewer.md # Python code review (NEW)
|
|
| |-- database-reviewer.md # Database/Supabase review (NEW)
|
|
|
|
|
|-- skills/ # Workflow definitions and domain knowledge
|
|
| |-- coding-standards/ # Language best practices
|
|
| |-- backend-patterns/ # API, database, caching patterns
|
|
| |-- frontend-patterns/ # React, Next.js patterns
|
|
| |-- continuous-learning/ # Auto-extract patterns from sessions (Longform Guide)
|
|
| |-- continuous-learning-v2/ # Instinct-based learning with confidence scoring
|
|
| |-- iterative-retrieval/ # Progressive context refinement for subagents
|
|
| |-- strategic-compact/ # Manual compaction suggestions (Longform Guide)
|
|
| |-- tdd-workflow/ # TDD methodology
|
|
| |-- security-review/ # Security checklist
|
|
| |-- eval-harness/ # Verification loop evaluation (Longform Guide)
|
|
| |-- verification-loop/ # Continuous verification (Longform Guide)
|
|
| |-- golang-patterns/ # Go idioms and best practices
|
|
| |-- golang-testing/ # Go testing patterns, TDD, benchmarks
|
|
| |-- django-patterns/ # Django patterns, models, views (NEW)
|
|
| |-- django-security/ # Django security best practices (NEW)
|
|
| |-- django-tdd/ # Django TDD workflow (NEW)
|
|
| |-- django-verification/ # Django verification loops (NEW)
|
|
| |-- python-patterns/ # Python idioms and best practices (NEW)
|
|
| |-- python-testing/ # Python testing with pytest (NEW)
|
|
| |-- springboot-patterns/ # Java Spring Boot patterns (NEW)
|
|
| |-- springboot-security/ # Spring Boot security (NEW)
|
|
| |-- springboot-tdd/ # Spring Boot TDD (NEW)
|
|
| |-- springboot-verification/ # Spring Boot verification (NEW)
|
|
| |-- configure-ecc/ # Interactive installation wizard (NEW)
|
|
| |-- security-scan/ # AgentShield security auditor integration (NEW)
|
|
|
|
|
|-- commands/ # Slash commands for quick execution
|
|
| |-- tdd.md # /tdd - Test-driven development
|
|
| |-- plan.md # /plan - Implementation planning
|
|
| |-- e2e.md # /e2e - E2E test generation
|
|
| |-- code-review.md # /code-review - Quality review
|
|
| |-- build-fix.md # /build-fix - Fix build errors
|
|
| |-- refactor-clean.md # /refactor-clean - Dead code removal
|
|
| |-- learn.md # /learn - Extract patterns mid-session (Longform Guide)
|
|
| |-- checkpoint.md # /checkpoint - Save verification state (Longform Guide)
|
|
| |-- verify.md # /verify - Run verification loop (Longform Guide)
|
|
| |-- setup-pm.md # /setup-pm - Configure package manager
|
|
| |-- go-review.md # /go-review - Go code review (NEW)
|
|
| |-- go-test.md # /go-test - Go TDD workflow (NEW)
|
|
| |-- go-build.md # /go-build - Fix Go build errors (NEW)
|
|
| |-- skill-create.md # /skill-create - Generate skills from git history (NEW)
|
|
| |-- instinct-status.md # /instinct-status - View learned instincts (NEW)
|
|
| |-- instinct-import.md # /instinct-import - Import instincts (NEW)
|
|
| |-- instinct-export.md # /instinct-export - Export instincts (NEW)
|
|
| |-- evolve.md # /evolve - Cluster instincts into skills
|
|
| |-- pm2.md # /pm2 - PM2 service lifecycle management (NEW)
|
|
| |-- multi-plan.md # /multi-plan - Multi-agent task decomposition (NEW)
|
|
| |-- multi-execute.md # /multi-execute - Orchestrated multi-agent workflows (NEW)
|
|
| |-- multi-backend.md # /multi-backend - Backend multi-service orchestration (NEW)
|
|
| |-- multi-frontend.md # /multi-frontend - Frontend multi-service orchestration (NEW)
|
|
| |-- multi-workflow.md # /multi-workflow - General multi-service workflows (NEW)
|
|
|
|
|
|-- rules/ # Always-follow guidelines (copy to ~/.claude/rules/)
|
|
| |-- README.md # Structure overview and installation guide
|
|
| |-- common/ # Language-agnostic principles
|
|
| | |-- coding-style.md # Immutability, file organization
|
|
| | |-- git-workflow.md # Commit format, PR process
|
|
| | |-- testing.md # TDD, 80% coverage requirement
|
|
| | |-- performance.md # Model selection, context management
|
|
| | |-- patterns.md # Design patterns, skeleton projects
|
|
| | |-- hooks.md # Hook architecture, TodoWrite
|
|
| | |-- agents.md # When to delegate to subagents
|
|
| | |-- security.md # Mandatory security checks
|
|
| |-- typescript/ # TypeScript/JavaScript specific
|
|
| |-- python/ # Python specific
|
|
| |-- golang/ # Go specific
|
|
|
|
|
|-- hooks/ # Trigger-based automations
|
|
| |-- hooks.json # All hooks config (PreToolUse, PostToolUse, Stop, etc.)
|
|
| |-- memory-persistence/ # Session lifecycle hooks (Longform Guide)
|
|
| |-- strategic-compact/ # Compaction suggestions (Longform Guide)
|
|
|
|
|
|-- scripts/ # Cross-platform Node.js scripts (NEW)
|
|
| |-- lib/ # Shared utilities
|
|
| | |-- utils.js # Cross-platform file/path/system utilities
|
|
| | |-- package-manager.js # Package manager detection and selection
|
|
| |-- hooks/ # Hook implementations
|
|
| | |-- session-start.js # Load context on session start
|
|
| | |-- session-end.js # Save state on session end
|
|
| | |-- pre-compact.js # Pre-compaction state saving
|
|
| | |-- suggest-compact.js # Strategic compaction suggestions
|
|
| | |-- evaluate-session.js # Extract patterns from sessions
|
|
| |-- setup-package-manager.js # Interactive PM setup
|
|
|
|
|
|-- tests/ # Test suite (NEW)
|
|
| |-- lib/ # Library tests
|
|
| |-- hooks/ # Hook tests
|
|
| |-- run-all.js # Run all tests
|
|
|
|
|
|-- contexts/ # Dynamic system prompt injection contexts (Longform Guide)
|
|
| |-- dev.md # Development mode context
|
|
| |-- review.md # Code review mode context
|
|
| |-- research.md # Research/exploration mode context
|
|
|
|
|
|-- examples/ # Example configurations and sessions
|
|
| |-- CLAUDE.md # Example project-level config
|
|
| |-- user-CLAUDE.md # Example user-level config
|
|
|
|
|
|-- mcp-configs/ # MCP server configurations
|
|
| |-- mcp-servers.json # GitHub, Supabase, Vercel, Railway, etc.
|
|
|
|
|
|-- marketplace.json # Self-hosted marketplace config (for /plugin marketplace add)
|
|
```
|
|
|
|
---
|
|
|
|
## 🛠️ Ecosystem Tools
|
|
|
|
### Skill Creator
|
|
|
|
Two ways to generate Claude Code skills from your repository:
|
|
|
|
#### Option A: Local Analysis (Built-in)
|
|
|
|
Use the `/skill-create` command for local analysis without external services:
|
|
|
|
```bash
|
|
/skill-create # Analyze current repo
|
|
/skill-create --instincts # Also generate instincts for continuous-learning
|
|
```
|
|
|
|
This analyzes your git history locally and generates SKILL.md files.
|
|
|
|
#### Option B: GitHub App (Advanced)
|
|
|
|
For advanced features (10k+ commits, auto-PRs, team sharing):
|
|
|
|
[Install GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)
|
|
|
|
```bash
|
|
# Comment on any issue:
|
|
/skill-creator analyze
|
|
|
|
# Or auto-triggers on push to default branch
|
|
```
|
|
|
|
Both options create:
|
|
- **SKILL.md files** - Ready-to-use skills for Claude Code
|
|
- **Instinct collections** - For continuous-learning-v2
|
|
- **Pattern extraction** - Learns from your commit history
|
|
|
|
### AgentShield — Security Auditor
|
|
|
|
Scan your Claude Code configuration for vulnerabilities, misconfigurations, and injection risks.
|
|
|
|
```bash
|
|
# Quick scan (no install needed)
|
|
npx ecc-agentshield scan
|
|
|
|
# Auto-fix safe issues
|
|
npx ecc-agentshield scan --fix
|
|
|
|
# Deep analysis with Opus 4.6
|
|
npx ecc-agentshield scan --opus --stream
|
|
|
|
# Generate secure config from scratch
|
|
npx ecc-agentshield init
|
|
```
|
|
|
|
Checks CLAUDE.md, settings.json, MCP servers, hooks, and agent definitions. Produces a security grade (A-F) with actionable findings.
|
|
|
|
Use `/security-scan` in Claude Code to run it, or add to CI with the [GitHub Action](https://github.com/affaan-m/agentshield).
|
|
|
|
[GitHub](https://github.com/affaan-m/agentshield) | [npm](https://www.npmjs.com/package/ecc-agentshield)
|
|
|
|
### 🧠 Continuous Learning v2
|
|
|
|
The instinct-based learning system automatically learns your patterns:
|
|
|
|
```bash
|
|
/instinct-status # Show learned instincts with confidence
|
|
/instinct-import <file> # Import instincts from others
|
|
/instinct-export # Export your instincts for sharing
|
|
/evolve # Cluster related instincts into skills
|
|
```
|
|
|
|
See `skills/continuous-learning-v2/` for full documentation.
|
|
|
|
---
|
|
|
|
## 📋 Requirements
|
|
|
|
### Claude Code CLI Version
|
|
|
|
**Minimum version: v2.1.0 or later**
|
|
|
|
This plugin requires Claude Code CLI v2.1.0+ due to changes in how the plugin system handles hooks.
|
|
|
|
Check your version:
|
|
```bash
|
|
claude --version
|
|
```
|
|
|
|
### Important: Hooks Auto-Loading Behavior
|
|
|
|
> ⚠️ **For Contributors:** Do NOT add a `"hooks"` field to `.claude-plugin/plugin.json`. This is enforced by a regression test.
|
|
|
|
Claude Code v2.1+ **automatically loads** `hooks/hooks.json` from any installed plugin by convention. Explicitly declaring it in `plugin.json` causes a duplicate detection error:
|
|
|
|
```
|
|
Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file
|
|
```
|
|
|
|
**History:** This has caused repeated fix/revert cycles in this repo ([#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103)). The behavior changed between Claude Code versions, leading to confusion. We now have a regression test to prevent this from being reintroduced.
|
|
|
|
---
|
|
|
|
## 📥 Installation
|
|
|
|
### Option 1: Install as Plugin (Recommended)
|
|
|
|
The easiest way to use this repo - install as a Claude Code plugin:
|
|
|
|
```bash
|
|
# Add this repo as a marketplace
|
|
/plugin marketplace add affaan-m/everything-claude-code
|
|
|
|
# Install the plugin
|
|
/plugin install everything-claude-code@everything-claude-code
|
|
```
|
|
|
|
Or add directly to your `~/.claude/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"extraKnownMarketplaces": {
|
|
"everything-claude-code": {
|
|
"source": {
|
|
"source": "github",
|
|
"repo": "affaan-m/everything-claude-code"
|
|
}
|
|
}
|
|
},
|
|
"enabledPlugins": {
|
|
"everything-claude-code@everything-claude-code": true
|
|
}
|
|
}
|
|
```
|
|
|
|
This gives you instant access to all commands, agents, skills, and hooks.
|
|
|
|
> **Note:** The Claude Code plugin system does not support distributing `rules` via plugins ([upstream limitation](https://code.claude.com/docs/en/plugins-reference)). You need to install rules manually:
|
|
>
|
|
> ```bash
|
|
> # Clone the repo first
|
|
> git clone https://github.com/affaan-m/everything-claude-code.git
|
|
>
|
|
> # Option A: User-level rules (applies to all projects)
|
|
> cp -r everything-claude-code/rules/common/* ~/.claude/rules/
|
|
> cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/ # pick your stack
|
|
> cp -r everything-claude-code/rules/python/* ~/.claude/rules/
|
|
> cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
|
|
>
|
|
> # Option B: Project-level rules (applies to current project only)
|
|
> mkdir -p .claude/rules
|
|
> cp -r everything-claude-code/rules/common/* .claude/rules/
|
|
> cp -r everything-claude-code/rules/typescript/* .claude/rules/ # pick your stack
|
|
> ```
|
|
|
|
---
|
|
|
|
### 🔧 Option 2: Manual Installation
|
|
|
|
If you prefer manual control over what's installed:
|
|
|
|
```bash
|
|
# Clone the repo
|
|
git clone https://github.com/affaan-m/everything-claude-code.git
|
|
|
|
# Copy agents to your Claude config
|
|
cp everything-claude-code/agents/*.md ~/.claude/agents/
|
|
|
|
# Copy rules (common + language-specific)
|
|
cp -r everything-claude-code/rules/common/* ~/.claude/rules/
|
|
cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/ # pick your stack
|
|
cp -r everything-claude-code/rules/python/* ~/.claude/rules/
|
|
cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
|
|
|
|
# Copy commands
|
|
cp everything-claude-code/commands/*.md ~/.claude/commands/
|
|
|
|
# Copy skills
|
|
cp -r everything-claude-code/skills/* ~/.claude/skills/
|
|
```
|
|
|
|
#### Add hooks to settings.json
|
|
|
|
Copy the hooks from `hooks/hooks.json` to your `~/.claude/settings.json`.
|
|
|
|
#### Configure MCPs
|
|
|
|
Copy desired MCP servers from `mcp-configs/mcp-servers.json` to your `~/.claude.json`.
|
|
|
|
**Important:** Replace `YOUR_*_HERE` placeholders with your actual API keys.
|
|
|
|
---
|
|
|
|
## 🎯 Key Concepts
|
|
|
|
### Agents
|
|
|
|
Subagents handle delegated tasks with limited scope. Example:
|
|
|
|
```markdown
|
|
---
|
|
name: code-reviewer
|
|
description: Reviews code for quality, security, and maintainability
|
|
tools: ["Read", "Grep", "Glob", "Bash"]
|
|
model: opus
|
|
---
|
|
|
|
You are a senior code reviewer...
|
|
```
|
|
|
|
### Skills
|
|
|
|
Skills are workflow definitions invoked by commands or agents:
|
|
|
|
```markdown
|
|
# TDD Workflow
|
|
|
|
1. Define interfaces first
|
|
2. Write failing tests (RED)
|
|
3. Implement minimal code (GREEN)
|
|
4. Refactor (IMPROVE)
|
|
5. Verify 80%+ coverage
|
|
```
|
|
|
|
### Hooks
|
|
|
|
Hooks fire on tool events. Example - warn about console.log:
|
|
|
|
```json
|
|
{
|
|
"matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
|
|
"hooks": [{
|
|
"type": "command",
|
|
"command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
|
|
}]
|
|
}
|
|
```
|
|
|
|
### Rules
|
|
|
|
Rules are always-follow guidelines, organized into `common/` (language-agnostic) + language-specific directories:
|
|
|
|
```
|
|
rules/
|
|
common/ # Universal principles (always install)
|
|
typescript/ # TS/JS specific patterns and tools
|
|
python/ # Python specific patterns and tools
|
|
golang/ # Go specific patterns and tools
|
|
```
|
|
|
|
See [`rules/README.md`](rules/README.md) for installation and structure details.
|
|
|
|
---
|
|
|
|
## 🧪 Running Tests
|
|
|
|
The plugin includes a comprehensive test suite:
|
|
|
|
```bash
|
|
# Run all tests
|
|
node tests/run-all.js
|
|
|
|
# Run individual test files
|
|
node tests/lib/utils.test.js
|
|
node tests/lib/package-manager.test.js
|
|
node tests/hooks/hooks.test.js
|
|
```
|
|
|
|
---
|
|
|
|
## 🤝 Contributing
|
|
|
|
**Contributions are welcome and encouraged.**
|
|
|
|
This repo is meant to be a community resource. If you have:
|
|
- Useful agents or skills
|
|
- Clever hooks
|
|
- Better MCP configurations
|
|
- Improved rules
|
|
|
|
Please contribute! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
|
|
|
### Ideas for Contributions
|
|
|
|
- Language-specific skills (Rust, C#, Swift, Kotlin) — Go, Python, Java already included
|
|
- Framework-specific configs (Rails, Laravel, FastAPI, NestJS) — Django, Spring Boot already included
|
|
- DevOps agents (Kubernetes, Terraform, AWS, Docker)
|
|
- Testing strategies (different frameworks, visual regression)
|
|
- Domain-specific knowledge (ML, data engineering, mobile)
|
|
|
|
---
|
|
|
|
## Cursor IDE Support
|
|
|
|
ecc-universal includes pre-translated configurations for [Cursor IDE](https://cursor.com). The `.cursor/` directory contains rules, agents, skills, commands, and MCP configs adapted for Cursor's format.
|
|
|
|
### Quick Start (Cursor)
|
|
|
|
```bash
|
|
# Install the package
|
|
npm install ecc-universal
|
|
|
|
# Install for your language(s)
|
|
./install.sh --target cursor typescript
|
|
./install.sh --target cursor python golang
|
|
```
|
|
|
|
### What's Translated
|
|
|
|
| Component | Claude Code → Cursor | Parity |
|
|
|-----------|---------------------|--------|
|
|
| Rules | YAML frontmatter added, paths flattened | Full |
|
|
| Agents | Model IDs expanded, tools → readonly flag | Full |
|
|
| Skills | No changes needed (identical standard) | Identical |
|
|
| Commands | Path references updated, multi-* stubbed | Partial |
|
|
| MCP Config | Env interpolation syntax updated | Full |
|
|
| Hooks | No equivalent in Cursor | See alternatives |
|
|
|
|
See [.cursor/README.md](.cursor/README.md) for details and [.cursor/MIGRATION.md](.cursor/MIGRATION.md) for the full migration guide.
|
|
|
|
---
|
|
|
|
## 🔌 OpenCode Support
|
|
|
|
ECC provides **full OpenCode support** including plugins and hooks.
|
|
|
|
### Quick Start
|
|
|
|
```bash
|
|
# Install OpenCode
|
|
npm install -g opencode
|
|
|
|
# Run in the repository root
|
|
opencode
|
|
```
|
|
|
|
The configuration is automatically detected from `.opencode/opencode.json`.
|
|
|
|
### Feature Parity
|
|
|
|
| Feature | Claude Code | OpenCode | Status |
|
|
|---------|-------------|----------|--------|
|
|
| Agents | ✅ 14 agents | ✅ 12 agents | **Claude Code leads** |
|
|
| Commands | ✅ 30 commands | ✅ 24 commands | **Claude Code leads** |
|
|
| Skills | ✅ 28 skills | ✅ 16 skills | **Claude Code leads** |
|
|
| Hooks | ✅ 3 phases | ✅ 20+ events | **OpenCode has more!** |
|
|
| Rules | ✅ 8 rules | ✅ 8 rules | **Full parity** |
|
|
| MCP Servers | ✅ Full | ✅ Full | **Full parity** |
|
|
| Custom Tools | ✅ Via hooks | ✅ Native support | **OpenCode is better** |
|
|
|
|
### Hook Support via Plugins
|
|
|
|
OpenCode's plugin system is MORE sophisticated than Claude Code with 20+ event types:
|
|
|
|
| Claude Code Hook | OpenCode Plugin Event |
|
|
|-----------------|----------------------|
|
|
| PreToolUse | `tool.execute.before` |
|
|
| PostToolUse | `tool.execute.after` |
|
|
| Stop | `session.idle` |
|
|
| SessionStart | `session.created` |
|
|
| SessionEnd | `session.deleted` |
|
|
|
|
**Additional OpenCode events**: `file.edited`, `file.watcher.updated`, `message.updated`, `lsp.client.diagnostics`, `tui.toast.show`, and more.
|
|
|
|
### Available Commands (24)
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/plan` | Create implementation plan |
|
|
| `/tdd` | Enforce TDD workflow |
|
|
| `/code-review` | Review code changes |
|
|
| `/security` | Run security review |
|
|
| `/build-fix` | Fix build errors |
|
|
| `/e2e` | Generate E2E tests |
|
|
| `/refactor-clean` | Remove dead code |
|
|
| `/orchestrate` | Multi-agent workflow |
|
|
| `/learn` | Extract patterns from session |
|
|
| `/checkpoint` | Save verification state |
|
|
| `/verify` | Run verification loop |
|
|
| `/eval` | Evaluate against criteria |
|
|
| `/update-docs` | Update documentation |
|
|
| `/update-codemaps` | Update codemaps |
|
|
| `/test-coverage` | Analyze coverage |
|
|
| `/go-review` | Go code review |
|
|
| `/go-test` | Go TDD workflow |
|
|
| `/go-build` | Fix Go build errors |
|
|
| `/skill-create` | Generate skills from git |
|
|
| `/instinct-status` | View learned instincts |
|
|
| `/instinct-import` | Import instincts |
|
|
| `/instinct-export` | Export instincts |
|
|
| `/evolve` | Cluster instincts into skills |
|
|
| `/setup-pm` | Configure package manager |
|
|
|
|
### Plugin Installation
|
|
|
|
**Option 1: Use directly**
|
|
```bash
|
|
cd everything-claude-code
|
|
opencode
|
|
```
|
|
|
|
**Option 2: Install as npm package**
|
|
```bash
|
|
npm install ecc-universal
|
|
```
|
|
|
|
Then add to your `opencode.json`:
|
|
```json
|
|
{
|
|
"plugin": ["ecc-universal"]
|
|
}
|
|
```
|
|
|
|
### Documentation
|
|
|
|
- **Migration Guide**: `.opencode/MIGRATION.md`
|
|
- **OpenCode Plugin README**: `.opencode/README.md`
|
|
- **Consolidated Rules**: `.opencode/instructions/INSTRUCTIONS.md`
|
|
- **LLM Documentation**: `llms.txt` (complete OpenCode docs for LLMs)
|
|
|
|
---
|
|
|
|
## 📖 Background
|
|
|
|
I've been using Claude Code since the experimental rollout. Won the Anthropic x Forum Ventures hackathon in Sep 2025 building [zenith.chat](https://zenith.chat) with [@DRodriguezFX](https://x.com/DRodriguezFX) - entirely using Claude Code.
|
|
|
|
These configs are battle-tested across multiple production applications.
|
|
|
|
---
|
|
|
|
## ⚠️ Important Notes
|
|
|
|
### Context Window Management
|
|
|
|
**Critical:** Don't enable all MCPs at once. Your 200k context window can shrink to 70k with too many tools enabled.
|
|
|
|
Rule of thumb:
|
|
- Have 20-30 MCPs configured
|
|
- Keep under 10 enabled per project
|
|
- Under 80 tools active
|
|
|
|
Use `disabledMcpServers` in project config to disable unused ones.
|
|
|
|
### Customization
|
|
|
|
These configs work for my workflow. You should:
|
|
1. Start with what resonates
|
|
2. Modify for your stack
|
|
3. Remove what you don't use
|
|
4. Add your own patterns
|
|
|
|
---
|
|
|
|
## 🌟 Star History
|
|
|
|
[](https://star-history.com/#affaan-m/everything-claude-code&Date)
|
|
|
|
---
|
|
|
|
## 🔗 Links
|
|
|
|
- **Shorthand Guide (Start Here):** [The Shorthand Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2012378465664745795)
|
|
- **Longform Guide (Advanced):** [The Longform Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2014040193557471352)
|
|
- **Follow:** [@affaanmustafa](https://x.com/affaanmustafa)
|
|
- **zenith.chat:** [zenith.chat](https://zenith.chat)
|
|
|
|
---
|
|
|
|
## 📄 License
|
|
|
|
MIT - Use freely, modify as needed, contribute back if you can.
|
|
|
|
---
|
|
|
|
**Star this repo if it helps. Read both guides. Build something great.**
|