From 019546523445358036fe77427626b8e37c8e38cf Mon Sep 17 00:00:00 2001 From: Paulo Victor Gomes Date: Sat, 21 Mar 2026 14:01:15 +0100 Subject: [PATCH] basic README --- docs/pt-BR/README.md | 509 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 509 insertions(+) create mode 100644 docs/pt-BR/README.md diff --git a/docs/pt-BR/README.md b/docs/pt-BR/README.md new file mode 100644 index 00000000..56c20ce7 --- /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 + +[![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) + +> **50K+ estrelas** | **6K+ forks** | **30 contribuidores** | **6 idiomas suportados** | **Vencedor do Hackathon Anthropic** + +--- + +
+ +**🌐 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) + +
+ +--- + +**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 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 # 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 + +
+Como verificar quais agentes/comandos estão instalados? + +```bash +/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](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.