disk0Dancer/climate

Fluxo de trabalho de contribuição AGENTS

Este repositório utiliza um fluxo de trabalho de implementação-primeiro para todo o trabalho de recursos.

Sequência obrigatória para qualquer recurso

1. Primeiro, o design
   • Descreva o problema, objetivos, não-objetivos, UX da API/CLI e casos extremos.
   • Adicione ou atualize documentos de design em docs/.
2. Documente o comportamento
   • Atualize a documentação voltada ao usuário (README.md, docs/index.md) quando comandos ou capacidades mudarem.
3. Escreva testes
   • Adicione testes de unidade direcionados para a nova lógica antes/junto com a implementação.
4. Implemente o código
   • Mantenha as alterações cirúrgicas e consistentes com o estilo existente do projeto.
5. Atualize as skills
   • Atualize skills/climate.md e skills/climate-generator/SKILL.md quando o conjunto de comandos ou fluxos de trabalho mudarem.
6. Valide localmente
   • Execute:
     • go build ./...
     • go test ./...
   • Execute testes direcionados durante o desenvolvimento para feedback mais rápido.
7. Valide a saúde da CI
   • Garanta que as verificações do PR estejam verdes antes da mesclagem.
8. Disciplina de commits
   • Commits pequenos e significativos com mensagens claras.
9. Higiene de push e PR
   • Atualize branches, mantenha a descrição/checklist do PR atualizados e responda a comentários de revisão com o hash do commit que aborda cada solicitação.

Regras de qualidade

• Não remova ou enfraqueça testes não relacionados.
• Não introduza mudanças na CLI que quebrem a compatibilidade sem documentação + notas de migração.
• Prefira comportamento determinístico (saída ordenada, iteração estável).
• Mantenha o comportamento gerado/manifesto compatível com versões anteriores quando prático.

Modelo de checklist de recurso

• Documento de design adicionado/atualizado
• README/documentação atualizados
• Skills atualizadas
• Testes adicionados/atualizados
• go build ./... passa
• go test ./... passa
• Verificações da CI verdes