Idioma: English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Português (BR)
50K+ estrelas | 6K+ forks | 30 contribuidores | 6 idiomas suportados | Vencedor do Hackathon Anthropic
O sistema de otimização de desempenho para harnesses de agentes de IA. De um vencedor do hackathon da Anthropic.
Não são apenas configurações. Um sistema completo: skills, instincts, otimização de memória, aprendizado contínuo, varredura de segurança e desenvolvimento com pesquisa em primeiro lugar. Agentes, hooks, comandos, regras e configurações MCP prontos para produção, desenvolvidos ao longo de 10+ meses de uso intensivo diário construindo produtos reais.
Funciona com Claude Code, Codex, Cowork e outros harnesses de agentes de IA.
Este repositório contém apenas o código. Os guias explicam tudo.
| Tópico | O Que Você Aprenderá |
|---|---|
| Otimização de Tokens | Seleção de modelo, redução de prompt de sistema, processos em segundo plano |
| Persistência de Memória | Hooks que salvam/carregam contexto entre sessões automaticamente |
| Aprendizado Contínuo | Extração automática de padrões das sessões em skills reutilizáveis |
| Loops de Verificação | Checkpoint vs evals contínuos, tipos de avaliador, métricas pass@k |
| Paralelização | Git worktrees, método cascade, quando escalar instâncias |
| Orquestração de Subagentes | O problema de contexto, padrão de recuperação iterativa |
- Arquitetura de instalação seletiva — Pipeline de instalação baseado em manifesto com
install-plan.jseinstall-apply.jspara instalação de componentes direcionada. O state store rastreia o que está instalado e habilita atualizações incrementais. - 6 novos agentes —
typescript-reviewer,pytorch-build-resolver,java-build-resolver,java-reviewer,kotlin-reviewer,kotlin-build-resolverexpandem a cobertura para 10 linguagens. - Novas skills —
pytorch-patternspara fluxos de deep learning,documentation-lookuppara pesquisa de referências de API,bun-runtimeenextjs-turbopackpara toolchains JS modernas, além de 8 skills de domínio operacional emcp-server-patterns. - Infraestrutura de sessão e estado — State store SQLite com CLI de consulta, adaptadores de sessão para gravação estruturada, fundação de evolução de skills para skills auto-aprimoráveis.
- Revisão de orquestração — Pontuação de auditoria de harness tornado determinístico, status de orquestração e compatibilidade de launcher reforçados, prevenção de loop de observer com guarda de 5 camadas.
- Confiabilidade do observer — Correção de explosão de memória com throttling e tail sampling, correção de acesso sandbox, lógica de início preguiçoso e guarda de reentrância.
- 12 ecossistemas de linguagem — Novas regras para Java, PHP, Perl, Kotlin/Android/KMP, C++ e Rust se juntam ao TypeScript, Python, Go e regras comuns existentes.
- Contribuições da comunidade — Traduções para coreano e chinês, hook de segurança InsAIts, otimização de hook biome, skills VideoDB, skills operacionais Evos, instalador PowerShell, suporte ao IDE Antigravity.
- CI reforçado — 19 correções de falhas de teste, aplicação de contagem de catálogo, validação de manifesto de instalação e suíte de testes completa no verde.
- Lançamento focado em harness — O ECC agora é explicitamente enquadrado como um sistema de desempenho de harness de agentes, não apenas um pacote de configurações.
- Revisão de confiabilidade de hooks — Fallback de raiz SessionStart, resumos de sessão na fase Stop e hooks baseados em scripts substituindo frágeis one-liners inline.
- Controles de runtime de hooks —
ECC_HOOK_PROFILE=minimal|standard|stricteECC_DISABLED_HOOKS=...para controle em tempo de execução sem editar arquivos de hook. - Novos comandos de harness —
/harness-audit,/loop-start,/loop-status,/quality-gate,/model-route. - NanoClaw v2 — roteamento de modelo, carregamento a quente de skill, ramificação/busca/exportação/compactação/métricas de sessão.
- Paridade entre harnesses — comportamento unificado em Claude Code, Cursor, OpenCode e Codex app/CLI.
- 997 testes internos passando — suíte completa no verde após refatoração de hook/runtime e atualizações de compatibilidade.
Comece em menos de 2 minutos:
# Adicionar marketplace
/plugin marketplace add affaan-m/everything-claude-code
# Instalar plugin
/plugin install everything-claude-code@everything-claude-code
⚠️ Importante: Plugins do Claude Code não podem distribuirrulesautomaticamente. Instale-as manualmente:
# Clone o repositório primeiro
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
# Instalar dependências (escolha seu gerenciador de pacotes)
npm install # ou: pnpm install | yarn install | bun install
# macOS/Linux
./install.sh typescript # ou python ou golang ou swift ou php
# ./install.sh typescript python golang swift php
# ./install.sh --target cursor typescript
# ./install.sh --target antigravity typescript# Windows PowerShell
.\install.ps1 typescript # ou python ou golang ou swift ou php
# .\install.ps1 typescript python golang swift php
# .\install.ps1 --target cursor typescript
# .\install.ps1 --target antigravity typescript
# O ponto de entrada de compatibilidade npm também funciona multiplataforma
npx ecc-install typescript# Experimente um comando (a instalação do plugin usa forma com namespace)
/everything-claude-code:plan "Adicionar autenticação de usuário"
# Instalação manual (Opção 2) usa a forma mais curta:
# /plan "Adicionar autenticação de usuário"
# Verificar comandos disponíveis
/plugin list everything-claude-code@everything-claude-code✨ Pronto! Você agora tem acesso a 28 agentes, 116 skills e 59 comandos.
Este plugin agora suporta totalmente Windows, macOS e Linux, com integração estreita em principais IDEs (Cursor, OpenCode, Antigravity) e harnesses CLI. Todos os hooks e scripts foram reescritos em Node.js para máxima compatibilidade.
O plugin detecta automaticamente seu gerenciador de pacotes preferido (npm, pnpm, yarn ou bun) com a seguinte prioridade:
- Variável de ambiente:
CLAUDE_PACKAGE_MANAGER - Config do projeto:
.claude/package-manager.json - package.json: campo
packageManager - Arquivo de lock: Detecção por package-lock.json, yarn.lock, pnpm-lock.yaml ou bun.lockb
- Config global:
~/.claude/package-manager.json - Fallback: Primeiro gerenciador disponível (pnpm > bun > yarn > npm)
Para definir seu gerenciador de pacotes preferido:
# Via variável de ambiente
export CLAUDE_PACKAGE_MANAGER=pnpm
# Via config global
node scripts/setup-package-manager.js --global pnpm
# Via config do projeto
node scripts/setup-package-manager.js --project bun
# Detectar configuração atual
node scripts/setup-package-manager.js --detectOu use o comando /setup-pm no Claude Code.
Use flags de runtime para ajustar rigor ou desabilitar hooks específicos temporariamente:
# Perfil de rigor de hooks (padrão: standard)
export ECC_HOOK_PROFILE=standard
# IDs de hooks separados por vírgula para desabilitar
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"everything-claude-code/
|-- agents/ # 28 subagentes especializados para delegação
|-- skills/ # Definições de fluxo de trabalho e conhecimento de domínio
|-- commands/ # Comandos slash para execução rápida
|-- rules/ # Diretrizes sempre seguidas (copiar para ~/.claude/rules/)
|-- hooks/ # Automações baseadas em gatilhos
|-- scripts/ # Scripts Node.js multiplataforma
|-- tests/ # Suíte de testes
|-- contexts/ # Contextos de injeção de prompt de sistema
|-- examples/ # Configurações e sessões de exemplo
|-- mcp-configs/ # Configurações de servidor MCP
Dois modos de gerar skills do Claude Code a partir do seu repositório:
Use o comando /skill-create para análise local sem serviços externos:
/skill-create # Analisar repositório atual
/skill-create --instincts # Também gerar instincts para continuous-learningPara recursos avançados (10k+ commits, PRs automáticos, compartilhamento em equipe):
Instalar GitHub App | ecc.tools
Construído no Claude Code Hackathon (Cerebral Valley x Anthropic, Fev 2026). 1282 testes, 98% de cobertura, 102 regras de análise estática.
# Verificação rápida (sem instalação necessária)
npx ecc-agentshield scan
# Corrigir automaticamente problemas seguros
npx ecc-agentshield scan --fix
# Análise profunda com três agentes Opus 4.6
npx ecc-agentshield scan --opus --stream
# Gerar configuração segura do zero
npx ecc-agentshield initO sistema de aprendizado baseado em instincts aprende automaticamente seus padrões:
/instinct-status # Mostrar instincts aprendidos com confiança
/instinct-import <file> # Importar instincts de outros
/instinct-export # Exportar seus instincts para compartilhar
/evolve # Agrupar instincts relacionados em skillsVersão mínima: v2.1.0 ou posterior
Verifique sua versão:
claude --version# Adicionar este repositório como marketplace
/plugin marketplace add affaan-m/everything-claude-code
# Instalar o plugin
/plugin install everything-claude-code@everything-claude-codeOu adicione diretamente ao seu ~/.claude/settings.json:
{
"extraKnownMarketplaces": {
"everything-claude-code": {
"source": {
"source": "github",
"repo": "affaan-m/everything-claude-code"
}
}
},
"enabledPlugins": {
"everything-claude-code@everything-claude-code": true
}
}Nota: O sistema de plugins do Claude Code não suporta distribuição de
rulesvia plugins. Você precisa instalar as regras manualmente:# Clone o repositório primeiro git clone https://github.com/affaan-m/everything-claude-code.git # Opção A: Regras no nível do usuário (aplica a todos os projetos) mkdir -p ~/.claude/rules cp -r everything-claude-code/rules/common/* ~/.claude/rules/ cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/ # escolha sua stack # Opção B: Regras no nível do projeto (aplica apenas ao projeto atual) mkdir -p .claude/rules cp -r everything-claude-code/rules/common/* .claude/rules/
# Clonar o repositório
git clone https://github.com/affaan-m/everything-claude-code.git
# Copiar agentes para sua config Claude
cp everything-claude-code/agents/*.md ~/.claude/agents/
# Copiar regras (comuns + específicas da linguagem)
cp -r everything-claude-code/rules/common/* ~/.claude/rules/
cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/
# Copiar comandos
cp everything-claude-code/commands/*.md ~/.claude/commands/
# Copiar skills (core vs nicho)
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/Subagentes lidam com tarefas delegadas com escopo limitado.
Skills são definições de fluxo de trabalho invocadas por comandos ou agentes.
Hooks disparam em eventos de ferramenta. Exemplo — avisar sobre console.log:
{
"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] Remova o console.log' >&2"
}]
}Regras são diretrizes sempre seguidas, organizadas em common/ (agnóstico à linguagem) + diretórios específicos por linguagem.
| Quero... | Use este comando | Agente usado |
|---|---|---|
| Planejar um novo recurso | /everything-claude-code:plan "Adicionar auth" |
planner |
| Projetar arquitetura de sistema | /everything-claude-code:plan + agente architect |
architect |
| Escrever código com testes primeiro | /tdd |
tdd-guide |
| Revisar código que acabei de escrever | /code-review |
code-reviewer |
| Corrigir build com falha | /build-fix |
build-error-resolver |
| Executar testes end-to-end | /e2e |
e2e-runner |
| Encontrar vulnerabilidades de segurança | /security-scan |
security-reviewer |
| Remover código morto | /refactor-clean |
refactor-cleaner |
| Atualizar documentação | /update-docs |
doc-updater |
| Revisar código Go | /go-review |
go-reviewer |
| Revisar código Python | /python-review |
python-reviewer |
Começando um novo recurso:
/everything-claude-code:plan "Adicionar autenticação de usuário com OAuth"
→ planner cria blueprint de implementação
/tdd → tdd-guide aplica escrita de testes primeiro
/code-review → code-reviewer verifica seu trabalho
Corrigindo um bug:
/tdd → tdd-guide: escrever teste falhando que reproduz o bug
→ implementar a correção, verificar se o teste passa
/code-review → code-reviewer: detectar regressões
Preparando para produção:
/security-scan → security-reviewer: auditoria OWASP Top 10
/e2e → e2e-runner: testes de fluxo crítico do usuário
/test-coverage → verificar cobertura 80%+
Como verificar quais agentes/comandos estão instalados?
/plugin list everything-claude-code@everything-claude-codeMeus hooks não estão funcionando / Vejo erros "Duplicate hooks file"
Este é o problema mais comum. NÃO adicione um campo "hooks" ao .claude-plugin/plugin.json. O Claude Code v2.1+ carrega automaticamente hooks/hooks.json de plugins instalados. Declarar explicitamente causa erros de detecção de duplicatas.
Posso usar o ECC com Cursor / OpenCode / Codex / Antigravity?
Sim. O ECC é multiplataforma:
- Cursor: Configs pré-traduzidas em
.cursor/ - OpenCode: Suporte completo a plugins em
.opencode/ - Codex: Suporte de primeira classe para app macOS e CLI
- Antigravity: Configuração integrada em
.agent/ - Claude Code: Nativo — este é o alvo principal
Como contribuir com uma nova skill ou agente?
Veja CONTRIBUTING.md. Em resumo:
- Faça um fork do repositório
- Crie sua skill em
skills/seu-nome-de-skill/SKILL.md(com frontmatter YAML) - Ou crie um agente em
agents/seu-agente.md - Envie um PR com uma descrição clara do que faz e quando usar
# Executar todos os testes
node tests/run-all.js
# Executar arquivos de teste individuais
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.jsContribuições são bem-vindas e incentivadas.
Este repositório é um recurso para a comunidade. Se você tem:
- Agentes ou skills úteis
- Hooks inteligentes
- Melhores configurações MCP
- Regras aprimoradas
Por favor contribua! Veja CONTRIBUTING.md para diretrizes.
MIT — consulte o arquivo LICENSE para detalhes.