Guia ECC

Use esta habilidade quando um usuário precisar de ajuda para entender, navegar, instalar ou escolher partes do ECC.

Quando Usar

Use esta habilidade quando o usuário:

• perguntar o que o ECC inclui
• quiser ajuda para encontrar uma habilidade, comando, agente, hook, regra ou perfil de instalação
• for novo no repositório e precisar de um caminho guiado
• perguntar "como faço X com o ECC?"
• perguntar quais componentes do ECC se encaixam em um projeto
• precisar de uma explicação leve de como comandos, habilidades, agentes, hooks e regras se relacionam
• estiver confuso com caminhos de instalação, instalações duplicadas, opções de reset/desinstalação ou instalação seletiva

Princípio Central

Responda com base nos arquivos atuais, não na memória. O ECC muda rapidamente, então contagens de catálogo, listas de recursos e instruções de instalação codificadas ficam desatualizadas.

Quando o repositório ECC estiver disponível, inspecione os arquivos relevantes antes de dar uma resposta concreta:

node scripts/ci/catalog.js --json
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
find agents -maxdepth 1 -name '*.md' | sort
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-components --json

Use o menor conjunto de leituras necessário para a pergunta do usuário.

Mapa do Repositório

• README.md: caminhos de instalação, orientação de desinstalação/reset, posicionamento público, FAQs
• AGENTS.md: orientação para contribuidores e estrutura do projeto
• agent.yaml: superfície de gitagent exportada e lista de comandos
• commands/: shims de compatibilidade de comandos slash mantidos
• skills/*/SKILL.md: fluxos de trabalho reutilizáveis e playbooks de domínio
• agents/*.md: prompts de função de subagente delegados
• rules/: regras de linguagem e harness
• hooks/README.md, hooks/hooks.json, scripts/hooks/: comportamento de hook e portões de segurança
• manifests/install-*.json: módulos de instalação seletiva, componentes, perfis e suporte a destino
• docs/: guias de harness, notas de arquitetura, documentação traduzida, documentação de lançamento

Estilo de Resposta

Comece com a resposta, depois dê a próxima ação. A maioria dos usuários não precisa de uma lista completa do catálogo.

Formato de boa primeira resposta:

1. o que usar
2. por que se encaixa
3. arquivo ou comando exato para inspecionar
4. um próximo comando ou pergunta

Evite:

• listar todas as habilidades ou comandos por padrão
• repetir grandes seções de README
• recomendar shims de comando aposentados quando um caminho baseado em habilidade existe
• afirmar que um componente existe sem verificar o sistema de arquivos
• substituir a orientação de instalação por comandos de cópia manual quando o instalador gerenciado suporta o destino

Tarefas Comuns

Integração de Novos Usuários

Dê um menu curto:

• instalar ou resetar o ECC
• escolher habilidades para um projeto
• entender comandos vs. habilidades
• inspecionar hooks e comportamento de segurança
• executar uma auditoria de harness
• encontrar um fluxo de trabalho específico

Aponte para README.md para instalação/reset e /project-init para integração específica de projeto.

Descoberta de Recursos

Para "o que devo usar para X?":

1. Pesquise skills/, commands/ e agents/.
2. Prefira habilidades como a superfície principal do fluxo de trabalho.
3. Use comandos apenas quando forem um shim de compatibilidade mantido ou quando um usuário explicitamente desejar o comportamento de comando slash.
4. Mencione agentes quando a delegação for útil.

Pesquisas úteis:

rg -n "<query>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort

Orientação de Instalação

Use caminhos de instalação gerenciados:

node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --profile minimal --target claude --json
node scripts/install-apply.js --profile minimal --target claude --dry-run

Para instalações de habilidades específicas:

node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run

Avise os usuários para não empilharem instalações de plugins e instalações manuais/de perfil completas, a menos que queiram intencionalmente superfícies duplicadas.

Integração de Projetos

Use /project-init quando o usuário quiser que o ECC seja configurado para um repositório de destino. A sequência esperada é:

1. detectar a stack a partir dos arquivos do projeto
2. resolver um plano de instalação de teste (dry-run)
3. inspecionar os arquivos CLAUDE.md e de configurações existentes
4. perguntar antes de aplicar alterações
5. manter a orientação gerada mínima e específica do repositório

Solução de Problemas

Peça primeiro o harness e o caminho de instalação de destino, depois inspecione:

• metadados de instalação de plugins
• .claude/, .cursor/, .codex/, .gemini/, .opencode/, .codebuddy/, .joycode/, ou .qwen/
• hooks/hooks.json
• arquivos de estado de instalação
• arquivos de comando/habilidade relevantes

Para a saúde do repositório, sugira:

npm run harness:audit -- --format text
npm run observability:ready

…