Milestones no Specsfy: organize MVP, roadmap e progresso

Comece pelo MVP

Use $specsfy-mvp-milestone-interviewer depois de apresentar a ideia do produto. A conversa começa com a finalidade, quem será atendido e qual jornada precisa funcionar. Depois de cada resposta, o agente resume o entendimento e faz a próxima pergunta que falta para definir o menor produto utilizável.

A entrevista termina quando você puder confirmar uma frase como: “o MVP estará pronto quando uma equipe comercial conseguir capturar um lead, consultá-lo e atribuir uma responsável em ambiente publicado”.

O agente propõe normalmente de quatro a oito milestones. Para cada uma, você aprova objetivo, condição de saída, fora de escopo, dependências e specs iniciais. Só depois disso ele cria ou reorganiza os arquivos.

Arquivos do projeto

1
PROJECT.md
2
specs.md
3
specs/
4
├── milestones/
5
│   ├── M01.md
6
│   └── M02.md
7
├── backlog/
8
└── <estado>/<NNNN>-<slug>/spec.md

specs.md é o mapa do projeto: mostra a sequência das specs, o estado de cada uma e os marcos vinculados. A fonte de comportamento continua em cada spec.md, o objetivo e a condição de saída ficam no arquivo de milestone.

Vincule specs e backlog

Inclua o campo Milestones nas tabelas de uma spec ou de um item do backlog:

1
| Milestones | M02, M04 |

Uma spec possui uma milestone principal na maioria dos casos. Ela pode ter outro vínculo quando a mesma capacidade contribui para dois estados reais do produto. O backlog aparece no marco como trabalho relacionado, mas não aumenta o percentual de conclusão.

Atualize o mapa automaticamente

Depois de alterar relações ou status, execute:

1
specsfy milestones sync --project .

O comando atualiza blocos identificados em specs.md e em specs/milestones/MNN.md. Texto fora desses blocos continua seu. Um marco referenciado por spec ou backlog e ainda sem arquivo recebe um esqueleto, para você completar na entrevista.

specsfy transition também sincroniza o mapa depois de mover uma spec. Use o comando direto quando tiver alterado vínculos no Markdown ou refinado backlog.

Cinco usos do comando

1
# Criar ou atualizar o índice no projeto atual.
2
specsfy milestones sync
3

4
# Declarar explicitamente a raiz do projeto atual.
5
specsfy milestones sync --project .
6

7
# Consumir o resultado em outra automação local.
8
specsfy milestones sync --project . --json
9

10
# Atualizar um projeto em outro diretório.
11
specsfy milestones sync --project ../crm
12

13
# Atualizar relações depois de editar uma spec ou backlog.
14
specsfy milestones sync --project .

O progresso considera specs com Status: Complete. A milestone só é concluída quando suas specs necessárias estiverem completas e você confirmar que a condição de saída foi demonstrada ou validada.

Planeje o que vem depois

Quando o MVP estiver aceito, use $specsfy-roadmap-milestone-interviewer. Ele parte dos limites já aprovados e organiza evolução, integrações, automações e hipóteses que dependem de uso real. Se uma resposta mudar o núcleo do MVP, o agente pede confirmação e encaminha a alteração da spec para $specsfy-update-spec.

Para revisar o mapa existente e encontrar relações ausentes, use $specsfy-milestone-governor. Ele sincroniza a projeção, aponta lacunas e propõe ajustes, não altera objetivo ou condição de saída sem sua confirmação.