concluir-marco

Propósito: Criar registro histórico da versão entregue, arquivar artefatos do milestone (roadmap + requisitos) e preparar para o próximo milestone. Saída: Milestone arquivado (roadmap + requisitos), PROJECT.md evoluído, tag git criado.

<execution_context> Carregar estes arquivos AGORA (antes de prosseguir):

• @./.claude/framework/workflows/complete-milestone.md (workflow principal)
• @./.claude/framework/templates/milestone-archive.md (template de arquivo) </execution_context>

Entrada do usuário:

• Versão: {{version}} (ex: "1.0", "1.1", "2.0")

Seguir o workflow complete-milestone.md:

1. Verificar auditoria:

   • Procurar .planning/v{{version}}-MILESTONE-AUDIT.md
   • Se ausente ou desatualizado: recomendar /auditar-marco primeiro
   • Se status da auditoria for gaps_found: recomendar /planejar-lacunas primeiro
   • Se status da auditoria for passed: prosseguir para o passo 1

   ## Verificação Pré-voo
   
   {Se não houver v{{version}}-MILESTONE-AUDIT.md:}
   ⚠ Nenhuma auditoria de milestone encontrada. Execute `/auditar-marco` primeiro para verificar
   cobertura de requisitos, integração entre fases e fluxos E2E.
   
   {Se a auditoria tiver lacunas:}
   ⚠ Auditoria de milestone encontrou lacunas. Execute `/planejar-lacunas` para criar
   fases que fechem as lacunas, ou prossiga assim mesmo para aceitar como dívida técnica.
   
   {Se a auditoria passou:}
   ✓ Auditoria de milestone aprovada. Prosseguindo com a conclusão.
   

2. Verificar prontidão:

   • Checar se todas as fases do milestone têm planos concluídos (SUMMARY.md existe)
   • Apresentar escopo e estatísticas do milestone
   • Aguardar confirmação

3. Coletar estatísticas:

   • Contar fases, planos, tarefas
   • Calcular intervalo git, alterações de arquivo, LOC
   • Extrair cronograma do git log
   • Apresentar resumo, confirmar

4. Extrair realizações:

   • Ler todos os arquivos SUMMARY.md das fases no intervalo do milestone
   • Extrair 4-6 realizações principais
   • Apresentar para aprovação

5. Arquivar milestone:

   • Criar .planning/milestones/v{{version}}-ROADMAP.md
   • Extrair detalhes completos das fases do ROADMAP.md
   • Preencher template milestone-archive.md
   • Atualizar ROADMAP.md para resumo de uma linha com link

6. Arquivar requisitos:

   • Criar .planning/milestones/v{{version}}-REQUIREMENTS.md
   • Marcar todos os requisitos v1 como completos (checkboxes marcados)
   • Registrar resultados dos requisitos (validado, ajustado, descartado)
   • Deletar .planning/REQUIREMENTS.md (novo será criado para o próximo milestone)

7. Atualizar PROJECT.md:

   • Adicionar seção "Estado Atual" com versão entregue
   • Adicionar seção "Objetivos do Próximo Milestone"
   • Arquivar conteúdo anterior em <details> (se v1.1+)

8. Commit e tag:

   • Stagear: MILESTONES.md, PROJECT.md, ROADMAP.md, STATE.md, arquivos de arquivo
   • Commit: chore: archive v{{version}} milestone
   • Tag: git tag -a v{{version}} -m "[resumo do milestone]"
   • Perguntar sobre push da tag

9. Oferecer próximos passos:

   • /novo-marco — iniciar próximo milestone (questionamento → pesquisa → requisitos → roadmap)

<success_criteria>

• Milestone arquivado em .planning/milestones/v{{version}}-ROADMAP.md
• Requisitos arquivados em .planning/milestones/v{{version}}-REQUIREMENTS.md
• .planning/REQUIREMENTS.md deletado (novo para próximo milestone)
• ROADMAP.md colapsado para entrada de uma linha
• PROJECT.md atualizado com estado atual
• Tag git v{{version}} criado
• Commit bem-sucedido
• Usuário conhece os próximos passos (incluindo necessidade de novos requisitos) </success_criteria>