| name | merge-com-dev |
| description | Fazer o merge de uma branch de task no padrão `task-DD-MM-YYYY-<hash_alfanumerico_10>` com a branch local `dev`. Skill agnóstica de linguagem e framework — opera apenas em Git. Usar quando o desenvolvedor pedir `merge com dev`, solicitar merge da branch atual da task para `dev` ou quiser validar esse fluxo com `--dry-run`. |
Objetivo
Garantir um fluxo determinístico e seguro para merge local de branches de task em dev.
Fluxo
- Confirmar que a branch atual segue o padrão
task-DD-MM-YYYY-<hash_alfanumerico_10>.
- Confirmar que o worktree Git está limpo antes de trocar de branch.
- Executar
rtk python .ia/skills/merge-com-dev/merge_task_branch_with_dev.py.
- Informar ao desenvolvedor o nome da branch de task mergeada e que o HEAD final fica em
dev.
- Perguntar ao desenvolvedor se deseja excluir a branch mergeada.
- Se houver confirmação explícita, executar
rtk python .ia/skills/merge-com-dev/merge_task_branch_with_dev.py --delete-merged-branch <nome_da_branch_task>.
Regras obrigatórias
- Regra global: nenhuma skill pode criar, editar, mover ou remover arquivos sob o módulo de IA/agentes do projeto (se existir); demandas sobre esse módulo devem ser tratadas como análise, especificação, backlog ou orientação operacional, sem implementação direta nesse diretório.
- O script
.ia/skills/merge-com-dev/merge_task_branch_with_dev.py é a fonte de verdade para a automação.
- Esta automação é a única exceção permitida à regra geral que proíbe
git commit pela IA; a permissão existe apenas quando o merge for disparado pelo script Python oficial versionado.
- Usar
--dry-run quando a intenção for apenas validar a branch alvo, o estado do repositório e a ação planejada.
- Não fazer
push.
- Não executar o merge se houver alterações locais não commitadas.
- Não excluir a branch mergeada sem confirmação explícita do desenvolvedor.
- Falhar explicitamente se a branch atual não seguir o padrão de task aprovado pelo projeto.
- Branches antigas com
DD_MM_YYYY só podem ser tratadas como legado quando derivadas de tasks históricas já existentes.
Checklist de qualidade
- A branch atual começa com
task-.
- O sufixo da branch tem exatamente 10 caracteres alfanuméricos.
- A branch
dev existe localmente.
- O merge é executado localmente em
dev, sem operações remotas.
- A exclusão da branch mergeada só acontece após confirmação e usando o modo explícito
--delete-merged-branch.
Referências locais
AGENTS.md.ia/skills/branch-task-aprovada/SKILL.md.ia/skills/merge-com-dev/merge_task_branch_with_dev.py
