diff --git a/.agents/AGENTS.md b/.agents/AGENTS.md index 21ca71e..c3d35ee 100644 --- a/.agents/AGENTS.md +++ b/.agents/AGENTS.md @@ -7,3 +7,12 @@ ## 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/`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao) ou no [`README.md`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/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`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/CHANGELOG.md). +- **Lista de Arquivos Obrigatórios a Serem Alterados**: + 1. [`app/build.gradle.kts`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/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`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/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`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/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`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/README.md): Atualizar o número da Versão Atual na lista de documentação técnica do projeto. +