AGENTS.md

Este repositório é um template genérico para desenvolvimento assistido por IA.

Objetivo

Manter o projeto simples, configurável e fácil de reutilizar como base.

Regras de trabalho

• Sempre leia README.md ou README.pt-BR.md e docs/ai/AGENTS.md antes de editar.
• Preserve mudanças do usuário e não reverta arquivos sem pedir.
• Use apply_patch para alterações manuais.
• Prefira comandos não destrutivos.
• Prefira links Markdown relativos.
• Ignore .env e .env.* quando eles não fizerem parte da tarefa.
• Antes de executar qualquer fluxo que rode o projeto, rode make stop.
• Consulte o Makefile e make help para descobrir os comandos disponíveis.
• Depois de mudanças de workflow ou execução, valide o make.

Convenções

• Mantenha o template genérico e independente de linguagem.
• Se o trabalho envolver documentação, mantenha o texto curto e prático.
• Se algo depender de processo em execução, pare a instância anterior antes de iniciar outra.

Ferramentas

Claude

• Use CLAUDE.md como ponteiro curto.
• Mantenha o arquivo curto e alinhado com este guia central.

Gemini

• Use GEMINI.md como ponteiro curto.
• Mantenha o arquivo curto e alinhado com este guia central.

GitHub Copilot

• Use .github/copilot-instructions.md como entrada curta do repositório.

Cursor

• Use .cursor/rules/template.mdc como regra curta do Cursor neste repositório.
• Mantenha as rules alinhadas com este guia central.

Estado do projeto

• Não há código de implementação no template ainda.
• O repositório guarda a estrutura de documentação e ferramentas para servir como template.

Skills

• As skills locais do projeto vivem em skills/README.md.
• Quando houver uma skill, ela deve ficar em uma pasta própria com SKILL.md.

Make

• O contrato de make vive no Makefile.
• O make help é a referência rápida para os comandos disponíveis.