Files
gestao_de_manutencao/.agents/AGENTS.md

3.3 KiB

Diretrizes do Projeto - Gestão de Manutenção

Leitura Obrigatória da Documentação

Atualização Pós-Modificação

  • Manutenção da Documentação: Sempre que forem feitas modificações importantes no código (ex.: novas funcionalidades, refatoração de arquitetura, novos fluxos de sincronização, alterações em modelos de dados ou Room DAO/Database, adição de configurações), a IA deve obrigatoriamente atualizar os documentos correspondentes no diretório documentacao/ ou no README.md.
  • Sincronia Código x Docs: A documentação deve refletir com exatidão as mudanças realizadas para evitar inconsistências e garantir a evolução contínua do projeto.

Controle de Versionamento Obrigatório e Atualização do Changelog

  • Incremento de Versão e Registros no Changelog: Sempre que for feita qualquer modificação no código-fonte, correções de bugs, refatoração ou adição de novas funcionalidades no software, a IA deve obrigatoriamente incrementar a versão do aplicativo e atualizar o histórico no arquivo CHANGELOG.md.
  • Lista de Arquivos Obrigatórios a Serem Alterados:
    1. app/build.gradle.kts: Incrementar versionCode (ex.: de 2 para 3) e atualizar versionName seguindo o Semantic Versioning (ex.: 1.1.0 -> 1.1.1 para correções/patches ou 1.2.0 para novas funcionalidades).
    2. CHANGELOG.md: Criar o bloco da nova versão com data no formato ## [X.Y.Z] - YYYY-MM-DD e descrever detalhadamente todas as mudanças nas subseções apropriadas (### Adicionado, ### Corrigido, ### Alterado, ### Removido).
    3. app/src/main/java/com/example/util/DeviceUtils.kt: Atualizar as strings padrão de fallback de versão dentro do método getAppVersion.
    4. README.md: Atualizar o número da Versão Atual na lista de documentação técnica do projeto.