About specsfy-milestone-governor
specsfy-milestone-governor is a Specsfy skill for projecting and reviewing milestone status from project specifications and backlog files. It helps teams distinguish demonstrable milestone outcomes from individual capabilities and work that is still being refined.
Key features
- 01Sync milestone projections from project files
- 02Review links among specs, backlog, and milestones
- 03Identify missing exit conditions and dependencies
- 04Require confirmation before structural changes
- 05Check completion against demonstrated outcomes
Use cases
- 01Refresh milestone status from completed specifications
- 02Find specs or backlog items linked to missing milestones
- 03Assess whether a milestone has verified exit criteria
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ promovaweb/ specsfy --skill specsfy-milestone-governorAfter installing, type/specsfy-milestone-governorin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMEGovernar milestones a partir das fontes do projeto
Preparação obrigatória
Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na
raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.
Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma
pendência.
Modo de interação
Modo de interação: perguntas.
Antes de formular qualquer pergunta, leia e aplique o
Contrato de perguntas numeradas de .specsfy/Spec.md.
Leia specs.md, specs/milestones/, specs/backlog/ e as specs existentes.
Milestone, spec e backlog possuem responsabilidades distintas: o marco descreve
um estado demonstrável; a spec define uma capacidade; o backlog registra
trabalho ainda refinável.
Projetar o estado atual
Execute:
specsfy milestones sync --project .
O comando atualiza somente blocos marcados em specs.md e nos arquivos de
milestone. Ele calcula specs completas pelo Status: Complete e mostra itens
de backlog sem usá-los para fechar o marco.
Analisar e sugerir
Depois da projeção, procure por:
- spec ou backlog ligado a um marco inexistente;
- milestone sem condição de saída confirmada;
- spec sem milestone quando sua finalidade já for conhecida;
- dependência que torna a ordem atual incoerente;
- conjunto de specs que parece formar um novo estado demonstrável.
Explique a sugestão, o material que a sustenta e o efeito no mapa. Peça
confirmação antes de mudar relações estruturais. Para falta de descoberta do
MVP, encaminhe a conversa para $specsfy-mvp-milestone-interviewer; para
evolução posterior, use $specsfy-roadmap-milestone-interviewer.
Concluir um marco
Uma milestone só pode ser declarada concluída quando suas specs necessárias estiverem completas e a pessoa responsável confirmar a condição de saída por uma demonstração, teste de aceite ou outra verificação registrada. O comando de sincronização informa progresso; ele não substitui essa confirmação.
Limites
- Não alterar texto humano fora dos blocos gerados.
- Não mover specs, editar gates, tarefas ou código.
- Não usar uma lista de tarefas fechadas como aceite da milestone.