mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-30 13:43:26 +08:00
510 lines
20 KiB
Markdown
510 lines
20 KiB
Markdown
**Idioma:** [English](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | Português (BR)
|
|
|
|
# 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)
|
|
[](https://www.npmjs.com/package/ecc-universal)
|
|
[](https://www.npmjs.com/package/ecc-agentshield)
|
|
[](https://github.com/marketplace/ecc-tools)
|
|
[](../../LICENSE)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
> **50K+ estrelas** | **6K+ forks** | **30 contribuidores** | **6 idiomas suportados** | **Vencedor do Hackathon Anthropic**
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
**🌐 Idioma / Language / 语言**
|
|
|
|
[**English**](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Português (BR)](README.md)
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
**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.
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="33%">
|
|
<a href="https://x.com/affaanmustafa/status/2012378465664745795">
|
|
<img src="../../assets/images/guides/shorthand-guide.png" alt="The Shorthand Guide to Everything Claude Code" />
|
|
</a>
|
|
</td>
|
|
<td width="33%">
|
|
<a href="https://x.com/affaanmustafa/status/2014040193557471352">
|
|
<img src="../../assets/images/guides/longform-guide.png" alt="The Longform Guide to Everything Claude Code" />
|
|
</a>
|
|
</td>
|
|
<td width="33%">
|
|
<a href="https://x.com/affaanmustafa/status/2033263813387223421">
|
|
<img src="../../assets/images/security/security-guide-header.png" alt="The Shorthand Guide to Everything Agentic Security" />
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><b>Guia Resumido</b><br/>Configuração, fundamentos, filosofia. <b>Leia este primeiro.</b></td>
|
|
<td align="center"><b>Guia Completo</b><br/>Otimização de tokens, persistência de memória, evals, paralelização.</td>
|
|
<td align="center"><b>Guia de Segurança</b><br/>Vetores de ataque, sandboxing, sanitização, CVEs, AgentShield.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
| 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 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:
|
|
|
|
```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)
|
|
/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:
|
|
|
|
```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 <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:
|
|
```bash
|
|
claude --version
|
|
```
|
|
|
|
---
|
|
|
|
## 📥 Instalação
|
|
|
|
### Opção 1: Instalar como Plugin (Recomendado)
|
|
|
|
```bash
|
|
# 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`:
|
|
|
|
```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:
|
|
>
|
|
> ```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 | `/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
|
|
|
|
<details>
|
|
<summary><b>Como verificar quais agentes/comandos estão instalados?</b></summary>
|
|
|
|
```bash
|
|
/plugin list everything-claude-code@everything-claude-code
|
|
```
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>Meus hooks não estão funcionando / Vejo erros "Duplicate hooks file"</b></summary>
|
|
|
|
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.
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>Posso usar o ECC com Cursor / OpenCode / Codex / Antigravity?</b></summary>
|
|
|
|
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
|
|
</details>
|
|
|
|
<details>
|
|
<summary><b>Como contribuir com uma nova skill ou agente?</b></summary>
|
|
|
|
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
|
|
</details>
|
|
|
|
---
|
|
|
|
## 🧪 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.
|