How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-milestone-governorBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Governar 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.


