promovaweb/specsfy

specsfy-milestone-governor

Use para projetar o estado dos milestones a partir de specs e backlog, identificar vínculos ausentes, sugerir ajustes e atualizar somente os blocos derivados.

View source
Original skill document

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:

bash
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.
from this repository

More skills

All skills
promovaweb
Community

specsfy-01-inbox

Use quando o usuário enviar uma ideia, pensamento, necessidade, oportunidade ou texto livre para guardar, capturar, anotar ou retomar depois. Preserve o input integral, faça pré-processamento silencioso e crie imediatamente um arquivo timestampado em specs/inbox/. Não faça perguntas, não peça confirmação e não crie backlog, spec, tarefas, testes ou código.

installs
1
GitHub stars
80
Updated
Sep 15
promovaweb
Community

specsfy-03-specify

Use quando o usuário pede para promover uma entrada ou backlog já refinado, criar, iniciar ou consolidar uma especificação nova ou ainda em Draft em spec.md. Use também quando uma transição automática exigir criar ou completar a fonte normativa inicial. Inicializa specs em specs/draft/ e aplica o MCR-10; para mudar spec aprovada use specsfy-update-spec, para captura sem perguntas use specsfy-01-inbox, para refinamento use specsfy-02-backlog e para revisão sem edição use specsfy-04-validate.

installs
1
GitHub stars
80
Updated
Sep 15
promovaweb
Community

specsfy-04-validate

Use quando o usuário pede para validar, revisar, auditar ou checar se specs/{id}-{slug}/spec.md segue o formato rígido Specsfy/2.0 e está pronto para planejar. Use também quando uma transição automática pedir prova do Definition Gate ou nova validação após correção. Use antes do Ato II. Registre gates na seção 13 do mesmo arquivo; não crie checklist, relatório, plan.md ou outro artefato.

installs
1
GitHub stars
80
Updated
Sep 15
promovaweb
Community

specsfy-05-tasks

Use quando o usuário quer quebrar ou decompor a especificação em tarefas, preencher ou atualizar a seção 14. Tarefas de spec.md, ordenar dependências, planejar fatias verticais ou preparar a execução. Use também quando uma transição automática pedir planejamento, replanejamento ou retomada após RED. Use somente para editar o backlog dentro da fonte única; não crie tasks.md, não escreva código nem marque trabalho como concluído.

installs
1
GitHub stars
80
Updated
Sep 15