Pitch: Starter AI Rules

Uma coisa que fica evidente depois de algum tempo é que simplesmente entregar uma tarefa e esperar que a ferramenta entenda todo o contexto do projeto nem sempre funciona bem.

A IA pode criar uma solução que funciona, mas foge do padrão do projeto. Pode alterar arquivos que não precisava, esquecer testes, deixar a documentação desatualizada ou até tomar decisões questionáveis relacionadas à segurança.

Pensando nisso criei um projetinho simples chamado Starter AI Rules, open source, que propõe uma forma simples de estabelecer regras para ferramentas de programação assistida por IA.

O Objetivo é manter um conjunto de regras que acompanham o projeto e deixam claro como o desenvolvimento deve acontecer.

Por exemplo:

alterar somente o que foi solicitado
manter testes junto com as alterações
atualizar a documentação quando necessário
não expor credenciais ou informações sensíveis
validar entradas
respeitar a arquitetura e os padrões existentes
manter o contexto do projeto atualizado

O projeto organiza essas regras de forma modular e versionada, para que possam evoluir junto com o código. Também existe uma preocupação em manter as regras curtas e específicas, evitando arquivos enormes de instruções que acabam se tornando difíceis de manter.

Outro ponto interessante é que a proposta não está presa a uma única ferramenta. O projeto foi pensado para funcionar com Cursor, GitHub Copilot, Claude Code e ferramentas semelhantes, além de prever compatibilidade com formatos como .mdc e AGENTS.md.

No fundo, a ideia é tratar as instruções dadas às ferramentas de programação como parte do próprio projeto.

Assim como temos padrões de código, documentação, testes e decisões de arquitetura versionadas no Git, faz sentido que as regras usadas durante o desenvolvimento também estejam no repositório e possam ser discutidas e melhoradas pela equipe.

O projeto ainda está no começo e acredito que a contribuição da comunidade pode ajudar bastante a definir quais regras realmente fazem diferença no dia a dia.

Quem trabalha com Cursor, Copilot, Claude Code ou outras ferramentas desse tipo e já passou por problemas de contexto, alterações desnecessárias ou código fora dos padrões do projeto, fica o convite para conhecer, testar e contribuir.

Tanto as regras quanto a documentação estão disponíveis em português e inglês. Para as ferramentas isso não faz diferença prática, mas optei por manter os dois idiomas para facilitar a leitura, a personalização das regras e principalmente a contribuição de desenvolvedores de diferentes comunidades.

Sugestões, issues, pull requests e principalmente experiências reais de uso são muito bem-vindas.