Skip to content

Latest commit

 

History

History
509 lines (370 loc) · 19.5 KB

File metadata and controls

509 lines (370 loc) · 19.5 KB

Idioma: English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Português (BR)

Everything Claude Code

Stars Forks Contributors npm ecc-universal npm ecc-agentshield GitHub App Install License Shell TypeScript Python Go Java Markdown

50K+ estrelas | 6K+ forks | 30 contribuidores | 6 idiomas suportados | Vencedor do Hackathon Anthropic


🌐 Idioma / Language / 语言

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Português (BR)


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.


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 agentestypescript-reviewer, pytorch-build-resolver, java-build-resolver, java-reviewer, kotlin-reviewer, kotlin-build-resolver expandem a cobertura para 10 linguagens.
  • Novas skillspytorch-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 hooksECC_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

# Adicionar marketplace
/plugin marketplace add affaan-m/everything-claude-code

# Instalar plugin
/plugin install everything-claude-code@everything-claude-code

Passo 2: Instalar as Regras (Obrigatório)

⚠️ Importante: Plugins do Claude Code não podem distribuir rules automaticamente. 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

Passo 3: Começar a Usar

# 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.


🌐 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:

# 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:

# 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:

/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 | 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.

# 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:

/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 skills

📋 Requisitos

Versão do Claude Code CLI

Versão mínima: v2.1.0 ou posterior

Verifique sua versão:

claude --version

📥 Instalação

Opção 1: Instalar como Plugin (Recomendado)

# Adicionar este repositório como marketplace
/plugin marketplace add affaan-m/everything-claude-code

# Instalar o plugin
/plugin install everything-claude-code@everything-claude-code

Ou 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 rules via 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/

🔧 Opção 2: Instalação Manual

# 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:

{
  "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 /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

Fluxos de Trabalho Comuns

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%+

❓ FAQ

Como verificar quais agentes/comandos estão instalados?
/plugin list everything-claude-code@everything-claude-code
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. 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

# 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 para diretrizes.


📄 Licença

MIT — consulte o arquivo LICENSE para detalhes.