Skill: documentation-sync

Objetivo

Sincronizar documentacao de governanca entre agents, plan e docs para manter o SOT consistente com a execucao real.

Quando usar

• Ao iniciar ou encerrar sprint.
• Ao criar/atualizar ADR.
• Ao reconciliar backlog com issues/PRs de repositorios de implementacao.

Entradas obrigatorias

• plan/dev/sprints/<YYYY-Www>.md ou plan/ops/sprints/<YYYY-Www>.md
• plan/adr/<dominio>/*
• plan/repos.yaml
• AGENTS.md
• CONTRIBUTING.md

Procedimento

1. Validar se stories/tasks da sprint possuem IDs e links de issue/PR.
2. Validar se mudancas arquiteturais da sprint tem ADR vinculada.
3. Validar se tasks em execucao seguem o fluxo issue canonica -> fork -> branch da task -> PR.
4. Validar se o status no Project esta coerente com assign, PR aberta e fechamento manual.
5. Atualizar paginas de governanca e metodo quando houver mudanca de processo.
6. Conferir navegacao no mkdocs.yml na raiz para novos artefatos.
7. Registrar no fechamento da sprint pendencias de sincronizacao.

Saidas esperadas

• Sprint atualizada com status real.
• Rastreabilidade completa (Story -> Task -> Issue/PR -> ADR).
• Documentacao MkDocs refletindo o estado atual.

Criterios de qualidade

• Nenhuma story sem issue.
• Nenhuma task sem story.
• Nenhuma task de implementacao fora do Project.
• Nenhuma task de implementacao sem repositorio canonico, fork e PR rastreaveis.
• Nenhuma decisao arquitetural relevante sem ADR.
• Sem links quebrados nas paginas de governanca.