aduhappy/multi-agent-project-skill

Esqueleto de Projeto Multiagente (Retomável entre Ferramentas)

Instalação em Uma Linha (Execute quando o usuário disser "instale este skill")

Repositório de origem: https://github.com/aduhappy/multi-agent-project-skill. Clone para o diretório de skills da sua ferramenta para instalar (sem outras dependências).

Os diretórios de skills variam por ferramenta. Escolha o caminho correto:

Ferramenta	Diretório de skills do usuário	Diretório de skills do projeto
ZCode / Codex CLI	~/.agents/skills/	<projeto>/.agents/skills/
Claude Code	~/.claude/skills/	<projeto>/.claude/skills/
Cursor	N/A (use rules)	.cursor/rules/ (formato moderno) ou .cursorrules (legado)

Princípios gerais:

• No Windows, ~ = %USERPROFILE%.
• Em caso de dúvida entre usuário vs. projeto, use o nível do usuário (instala uma vez, usa em todos os lugares).
• Se o diretório não existir, crie-o antes de clonar. Após o clone, informe ao usuário que é necessário iniciar uma nova sessão para que o skill seja ativado.

Para que Serve Este Skill

Gera, na raiz do projeto, um esqueleto de colaboração em Markdown puro, independente de ferramenta — uma entrada autoritativa + vários ponteiros finos + cartões de tarefa autocontidos + regras de finalização. Troque entre Claude / Cursor / Gemini / ZCode / Copilot — qualquer agente que chegar, ao ler a mesma entrada, consegue continuar o trabalho do antecessor, sem perder contexto nem se sobrepor.

Quatro princípios centrais:

1. Apenas uma fonte da verdade: AGENTS.md é a única entrada autoritativa; os arquivos de convenção de outras ferramentas (CLAUDE.md / GEMINI.md / .cursorrules / copilot-instructions.md) são ponteiros finos de 3 linhas que apontam para o AGENTS.md.
2. Detalhes como links externos, entrada concisa: AGENTS.md deve caber em 1–2 telas, pois cada novo agente deve lê-lo por completo. Detalhes vão para documentos especializados em docs/, a entrada só contém ponteiros.
3. Markdown puro + caminhos relativos: Sem depender de sintaxe específica de nenhuma ferramenta; funciona ao trocar de ferramenta.
4. Confie, mas verifique: A autoverificação do agente não é suficiente — produtos críticos devem ser revisados por um agente controlador ou outro agente independente (conservação/limites/contagem/magnitude/consistência) antes de passar para a próxima etapa. Esta é a base da confiabilidade em cadeias multiagente.

Quando Ativar

• O usuário disser "criar novo projeto/tópico", "como organizar documentos para colaboração de IA", "como escrever AGENTS.md", "múltiplos agentes em sequência".
• O agente do projeto atual frequentemente faz perguntas repetitivas, não encontra o estado, ou sobrescreve a produção de outros agentes.
• O usuário deseja consolidar a experiência de colaboração manual em uma estrutura reutilizável.

Como Usar (Dois Modos)

Modo A: Gerar Esqueleto do Zero

1. Pergunte de uma vez (não em partes): diretório raiz do projeto, objetivo em uma frase, quais ferramentas de IA serão compatíveis, se há diretórios sincronizados em nuvem, quais fontes de dados estão envolvidas.
2. Pergunte sobre uma lista de restrições rígidas: "Liste as dimensões 'não misturáveis' da área (critérios/unidades/sistemas de coordenadas/resolução/período/estratificação etária, etc.). Escreva como regras rígidas — todos os agentes subsequentes devem segui-las." — Esta é a regra mais ignorada, mas que, se errada, quebra tudo.
3. Copie AGENTS.md de assets/ para a raiz do projeto e preencha com as informações fornecidas pelo usuário.
   • Regra de placeholders (importante): Preencha diretamente as informações que o usuário deu explicitamente; para o que não foi dado, priorize dar valores padrão razoáveis (inferidos pelo tópico do projeto) com uma breve anotação "valor padrão, pode alterar"; **apenas detalhes