The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
basic README
Paulo Victor Gomes019546523445
diff --git a/docs/pt-BR/README.md b/docs/pt-BR/README.mdnew file mode 100644index 000000000..56c20ce7a--- /dev/null+++ b/docs/pt-BR/README.md@@ -0,0 +1,509 @@+**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.