**Idioma:** [English](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | Português (Brasil) | [Türkçe](../tr/README.md) # Everything Claude Code [![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers) [![Forks](https://img.shields.io/github/forks/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/network/members) [![Contributors](https://img.shields.io/github/contributors/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/graphs/contributors) [![npm ecc-universal](https://img.shields.io/npm/dw/ecc-universal?label=ecc-universal%20weekly%20downloads&logo=npm)](https://www.npmjs.com/package/ecc-universal) [![npm ecc-agentshield](https://img.shields.io/npm/dw/ecc-agentshield?label=ecc-agentshield%20weekly%20downloads&logo=npm)](https://www.npmjs.com/package/ecc-agentshield) [![GitHub App Install](https://img.shields.io/badge/GitHub%20App-150%20installs-2ea44f?logo=github)](https://github.com/marketplace/ecc-tools) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE) ![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white) ![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white) ![Python](https://img.shields.io/badge/-Python-3776AB?logo=python&logoColor=white) ![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white) ![Java](https://img.shields.io/badge/-Java-ED8B00?logo=openjdk&logoColor=white) ![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white) > **140K+ estrelas** | **21K+ forks** | **170+ contribuidores** | **12+ ecossistemas de linguagem** | **Vencedor do Hackathon Anthropic** ---
**Idioma / Language / 语言 / Dil** [**English**](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Português (Brasil)](README.md) | [Türkçe](../tr/README.md)
--- **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**, **Cursor**, **OpenCode**, **Gemini** e outros harnesses de agentes de IA. --- ## Os Guias Este repositório contém apenas o código. Os guias explicam tudo.
The Shorthand Guide to Everything Claude Code The Longform Guide to Everything Claude Code The Shorthand Guide to Everything Agentic Security
Guia Resumido
Configuração, fundamentos, filosofia. Leia este primeiro.		 Guia Completo
Otimização de tokens, persistência de memória, evals, paralelização.		 Guia de Segurança
Vetores de ataque, sandboxing, sanitização, CVEs, AgentShield.
| 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 | --- ## O Que Há de Novo ### v1.9.0 — Instalação Seletiva e Expansão de Idiomas (Mar 2026) - **Arquitetura de instalação seletiva** — Pipeline de instalação baseado em manifesto com `install-plan.js` e `install-apply.js` para 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-resolver` expandem a cobertura para 10 linguagens. - **Novas skills** — `pytorch-patterns` para fluxos de deep learning, `documentation-lookup` para pesquisa de referências de API, `bun-runtime` e `nextjs-turbopack` para toolchains JS modernas, além de 8 skills de domínio operacional e `mcp-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. ### v1.8.0 — Sistema de Desempenho de Harness (Mar 2026) - **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|strict` e `ECC_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. --- ## Início Rápido Comece em menos de 2 minutos: ### Passo 1: Instalar o Plugin ```bash # Adicionar marketplace /plugin marketplace add https://github.com/affaan-m/everything-claude-code # Instalar plugin /plugin install ecc@ecc ``` ### Passo 2: Instalar as Regras (Obrigatório) > WARNING: **Importante:** Plugins do Claude Code não podem distribuir `rules` automaticamente. Instale-as manualmente: ```bash # 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 ``` ```powershell # 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 ``` ### Passo 3: Começar a Usar ```bash # Experimente um comando (a instalação do plugin usa forma com namespace) /ecc: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 ecc@ecc ``` **Pronto!** Você agora tem acesso a 28 agentes, 116 skills e 59 comandos. --- ## Suporte Multiplataforma 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. ### Detecção de Gerenciador de Pacotes O plugin detecta automaticamente seu gerenciador de pacotes preferido (npm, pnpm, yarn ou bun) com a seguinte prioridade: 1. **Variável de ambiente**: `CLAUDE_PACKAGE_MANAGER` 2. **Config do projeto**: `.claude/package-manager.json` 3. **package.json**: campo `packageManager` 4. **Arquivo de lock**: Detecção por package-lock.json, yarn.lock, pnpm-lock.yaml ou bun.lockb 5. **Config global**: `~/.claude/package-manager.json` 6. **Fallback**: Primeiro gerenciador disponível (pnpm > bun > yarn > npm) Para definir seu gerenciador de pacotes preferido: ```bash # 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 --detect ``` Ou use o comando `/setup-pm` no Claude Code. ### Controles de Runtime de Hooks Use flags de runtime para ajustar rigor ou desabilitar hooks específicos temporariamente: ```bash # 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" ``` --- ## O Que Está Incluído ``` 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 ``` --- ## Ferramentas do Ecossistema ### Criador de Skills Dois modos de gerar skills do Claude Code a partir do seu repositório: #### Opção A: Análise Local (Integrada) Use o comando `/skill-create` para análise local sem serviços externos: ```bash /skill-create # Analisar repositório atual /skill-create --instincts # Também gerar instincts para continuous-learning ``` #### Opção B: GitHub App (Avançado) Para recursos avançados (10k+ commits, PRs automáticos, compartilhamento em equipe): [Instalar GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools) ### AgentShield — Auditor de Segurança > Construído no Claude Code Hackathon (Cerebral Valley x Anthropic, Fev 2026). 1282 testes, 98% de cobertura, 102 regras de análise estática. ```bash # 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 init ``` ### Aprendizado Contínuo v2 O sistema de aprendizado baseado em instincts aprende automaticamente seus padrões: ```bash /instinct-status # Mostrar instincts aprendidos com confiança /instinct-import # Importar instincts de outros /instinct-export # Exportar seus instincts para compartilhar /evolve # Agrupar instincts relacionados em skills ``` --- ## Requisitos ### Versão do Claude Code CLI **Versão mínima: v2.1.0 ou posterior** Verifique sua versão: ```bash claude --version ``` --- ## Instalação ### Opção 1: Instalar como Plugin (Recomendado) ```bash # Adicionar este repositório como marketplace /plugin marketplace add https://github.com/affaan-m/everything-claude-code # Instalar o plugin /plugin install ecc@ecc ``` Ou adicione diretamente ao seu `~/.claude/settings.json`: ```json { "extraKnownMarketplaces": { "ecc": { "source": { "source": "github", "repo": "affaan-m/everything-claude-code" } } }, "enabledPlugins": { "ecc@ecc": true } } ``` > **Nota:** O sistema de plugins do Claude Code não suporta distribuição de `rules` via plugins. Você precisa instalar as regras manualmente: > > ```bash > # 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/ > ``` --- ### Opção 2: Instalação Manual ```bash # 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/ ``` --- ## Conceitos-Chave ### Agentes Subagentes lidam com tarefas delegadas com escopo limitado. ### Skills Skills são definições de fluxo de trabalho invocadas por comandos ou agentes. ### Hooks Hooks disparam em eventos de ferramenta. Exemplo — avisar sobre 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] Remova o console.log' >&2" }] } ``` ### Regras Regras são diretrizes sempre seguidas, organizadas em `common/` (agnóstico à linguagem) + diretórios específicos por linguagem. --- ## Qual Agente Devo Usar? | Quero... | Use este comando | Agente usado | |----------|-----------------|--------------| | Planejar um novo recurso | `/ecc:plan "Adicionar auth"` | planner | | Projetar arquitetura de sistema | `/ecc: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 | ### Fluxos de Trabalho Comuns **Começando um novo recurso:** ``` /ecc: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%+ ``` --- ## FAQ
Como verificar quais agentes/comandos estão instalados? ```bash /plugin list ecc@ecc ```
Meus 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](CONTRIBUTING.md). Em resumo: 1. Faça um fork do repositório 2. Crie sua skill em `skills/seu-nome-de-skill/SKILL.md` (com frontmatter YAML) 3. Ou crie um agente em `agents/seu-agente.md` 4. Envie um PR com uma descrição clara do que faz e quando usar
--- ## Executando Testes ```bash # 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.js ``` --- ## Contribuindo **Contribuiçõ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](CONTRIBUTING.md) para diretrizes. --- ## Licença MIT — consulte o [arquivo LICENSE](../../LICENSE) para detalhes.