Explorar o MVP com requisitos de desenvolvimento
Esta skill orquestra a entrada do MVP. Ela importa MVP.md como a milestone
1.0, seleciona somente requisitos de desenvolvimento e cria um backlog
candidato para cada um. O contexto de negócio permanece no arquivo de origem.
Em seguida, carrega as skills responsáveis para entrevistar cada backlog e
somente avança quando cada etapa tiver resultado confirmado.
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.
Pronto quando
specs/milestones/M01.md existe e nenhum arquivo preexistente foi
sobrescrito.
- Cada tema desenvolvível tem backlog refinado e spec Draft com
Definition Gate: Pending.
- Nenhum tema contextual gerou backlog, spec ou Inbox.
specsfy milestones sync --project <raiz> rodou, com a tool milestones_sync
quando o agente usar MCP, e
$specsfy-milestone-governor conferiu os vínculos de M01.
- O relato final lista sessão, backlogs, specs, respostas confirmadas e pontos
Pendente.
Carregar o contexto disponível
Resolver a raiz. Antes de ler qualquer arquivo, resolva a raiz do
projeto consumidor. Se ela for um submódulo Git, descubra o superprojeto com
git -C <raiz> rev-parse --show-superproject-working-tree. Saída não vazia
acrescenta somente essa raiz pai à busca; outros pais ficam fora.
Localizar as fontes. Procure MVP.md e BRAND.md como arquivos
regulares na raiz do consumidor e, só se ausentes e a raiz for submódulo,
no superprojeto. O arquivo local tem prioridade. Essas leituras podem ser
feitas em paralelo. MVP.md é contexto declarado e não substitui o que a
pessoa disser. BRAND.md mantém linguagem, público, proposta e limites de
marca coerentes nas perguntas, sem ser copiado para artefatos derivados.
Triar dados sensíveis. Aplique a mesma triagem da Inbox. Se a fonte
tiver credencial, token, chave privada ou dado pessoal sensível, não gere a
milestone nem reproduza o valor em mensagens.
Importar uma única vez, antes da primeira pergunta:
specsfy milestones import-mvp --project <raiz>
Pelo MCP, use a tool milestones_import_mvp. Sem o binário instalado, rode
o script equivalente:
node \
.agents/skills/specsfy-mvp-milestone-interviewer/scripts/importar_mvp.mjs \
--root <raiz>
Ler o resultado. Trate o JSON retornado como a fila ordenada de
backlogs da sessão; cada item traz title, backlog e spec. Leia
PROJECT.md, Inboxes, backlog e specs existentes só quando ajudarem a
evitar repetição ou contradição. Não crie, mova nem altere arquivos de
contexto.
O que o importador faz
- Cria
specs/milestones/M01.md a partir de MVP.md. Se M01.md já existir,
não sobrescreve nenhum arquivo; informe a pessoa responsável.
- Cria backlog e spec somente para temas classificáveis como entregas de
software desenvolvíveis. Visão, público, princípios, contexto, métricas e
outros registros sem comportamento a construir permanecem só em
MVP.md,
sem Inbox e sem cópia para a milestone.
- Aplica defaults apenas diante de rótulo explícito ou formulação inequívoca no
trecho, como
Problema, Público, Resultado, Contexto ou uma frase
objetiva de capacidade, e registra cada default com sua base no backlog e no
JSON. Sem sustentação no trecho, preserva a lacuna em vez de criar valor
plausível.
- Cada backlog guarda um bloco de registros do trecho importado e cita
MVP.md como fonte. O backlog nasce Captured, recebe a spec Draft ao final
e passa a apontar para ela como Promoted; a spec mantém
Definition Gate: Pending.
Filtrar o que será desenvolvido
Antes de carregar $specsfy-02-backlog, classifique o tema:
| Classe |
Quando |
Resultado |
Desenvolvível |
descreve capacidade, tela, fluxo, integração, dado, automação, regra executável ou comportamento do sistema |
backlog e spec Draft |
Contextual |
descreve visão, público, posicionamento, princípio, problema, métrica, premissa, contexto ou limite sem entrega de software |
permanece em MVP.md, sem Inbox, backlog ou spec |
Na dúvida, classifique como desenvolvível somente se o próprio trecho trouxer
verbo ou objeto de construção verificável, como desenvolver, implementar,
criar, permitir, cadastrar, consultar ou integrar. Caso contrário,
mantenha contextual e registre o motivo. Uma descrição de produto não vira
backlog só porque pode ajudar uma implementação futura.
Resolver defaults antes de perguntar
Para cada tema importado:
- Releia o trecho original, os
Defaults aplicados automaticamente, o
backlog e a milestone M01.
- Campo preenchido por declaração explícita do MVP ou formulação inequívoca
registrada pelo importador conta como resposta confirmada.
- Se só existir uma opção materialmente compatível com o MVP, aplique-a como
default óbvio e registre formulação normalizada e fonte, sem pedir
confirmação.
- Mais de uma leitura razoável, conflito entre fontes ou ausência de
informação vira a próxima pergunta numerada, com a sugestão mais compatível
primeiro. Não escolha em silêncio.
- Depois de cada resposta, reavalie todos os campos. Não repita pergunta já
respondida nem confirme default sustentado.
O resultado precisa deixar claro o que foi resolvido automaticamente e o que
ainda depende da pessoa.
Orquestrar as skills da descoberta
Para cada item da fila, em sequência e sem pular responsabilidades. O objetivo
é entrevistar cada backlog antes de qualquer promoção:
- Anuncie
Transição automática: $specsfy-mvp-milestone-interviewer → $specsfy-02-backlog — motivo: entrevistar o backlog derivado do MVP — resultado esperado: backlog refinado com respostas confirmadas
e carregue $specsfy-02-backlog com o caminho do backlog candidato.
- Use primeiro os registros do MVP que acompanham o backlog para preencher o
que já foi declarado. A entrevista adaptativa cobre só lacunas,
ambiguidades ou contradições restantes.
- Se houver informação a guardar ausente ou ambígua, anuncie a transição para
$specsfy-data-discovery, conclua a entrevista de dados e retome o backlog
com .specsfy/DATABASE.md como contexto.
- Ao terminar o refinamento do backlog, retome esta skill, registre a situação
do item na síntese da sessão e carregue
$specsfy-03-specify para criar a
spec Draft baseada nele. A seção 10 mantém a área de menus e navegação
principal: use o que o MVP declarar e marque Pendente quando faltar. Não
implemente código, não execute tarefas e não promova o Definition Gate.
- Passe ao próximo item da fila.
Quando a fila terminar, confirme que cada tema desenvolvível tem backlog e spec
Draft e que nenhum tema contextual gerou artefato. Execute
specsfy milestones sync --project <raiz>, com a tool milestones_sync pelo
MCP, e carregue
$specsfy-milestone-governor para conferir vínculos e progresso de M01. A
geração automática de Drafts não autoriza implementação nem validação final.
Conduzir uma conversa adaptativa
- Comece por finalidade, pessoa atendida e problema observável.
- Depois de cada captura, releia as Inboxes da sessão e mostre uma síntese
curta que separe formulação recebida e hipótese da conversa.
- Monte cada rodada pelo contrato central: uma pergunta numerada, opções
específicas,
Escrever outra resposta, Gere outras opções e Avançar,
com no máximo oito perguntas por área.
- Explore só o necessário para entender jornada, dados indispensáveis,
papéis, regras, integrações, limites, demonstração e validação. Cada
informação a guardar pouco clara passa por
$specsfy-data-discovery antes
do próximo ponto. Não aplique formulário fixo nem repita resposta já
preservada.
- Quando a pessoa encerrar ou adiar uma área, capture a formulação dela e
indique a Inbox correspondente na síntese, sem preencher lacunas por conta
própria.
Preservar a sessão
As respostas da conversa ficam registradas em Inboxes de sessão, separadas dos
temas importados. Essas capturas servem de rastreabilidade da entrevista; os
temas contextuais do MVP continuam sem Inbox.
- Derive uma identificação estável
DESC-AAAAMMDD-<slug> a partir do primeiro
tema recebido.
- Depois de cada resposta, capture o conteúdo semântico em nova Inbox com a
mesma sessão e o próximo turno. Quando a pessoa responder só
1, 2 ou
3, substitua o número pelo texto integral da opção escolhida antes de
montar --input, --summary, --signals e os demais campos. A entrada
literal pode constar na rastreabilidade, mas não serve de contexto da
milestone. Cada hipótese de milestone apresentada para confirmação também
gera uma Inbox. Capturas anteriores nunca são editadas, reunidas ou
substituídas.
- Informe
--sources em toda chamada com o caminho de MVP.md e BRAND.md
consultados, inclusive do superprojeto, ou indique que estavam ausentes.
- Aplique antes de cada escrita a triagem de dados sensíveis do
$specsfy-01-inbox. Se ela impedir a captura, pause a conversa até receber
texto seguro.
- Escreva em Português do Brasil a análise, a síntese, os metadados e qualquer
milestone gerada. Fonte ou resposta em outro idioma fica só como citação,
com a interpretação em Português do Brasil.
specsfy inbox capture \
--input "<texto integral da pessoa>" \
--title "<tema da descoberta>" \
--session "DESC-AAAAMMDD-<slug>" \
--turn "<número sequencial>" \
--sources "<situação de MVP.md e BRAND.md>" \
[campos de análise da Inbox] [--project <raiz>]
Pelo MCP, use a tool inbox_capture. Sem o binário instalado, rode o script
equivalente:
node .agents/skills/specsfy-01-inbox/scripts/capturar_inbox.mjs \
--input "<texto integral da pessoa>" \
--title "<tema da descoberta>" \
--session "DESC-AAAAMMDD-<slug>" \
--turn "<número sequencial>" \
--sources "<situação de MVP.md e BRAND.md>" \
[campos de análise da Inbox] [--root <raiz>]
Encerrar e tratar depois
Ao encerrar, informe a identificação da sessão, M01, a lista ordenada de
backlogs e specs Draft geradas, as respostas confirmadas e os pontos marcados
como Pendente, e lembre que os demais temas continuam em MVP.md. A geração
de specs encerra a importação; implementação, validação final e promoção de
gate ficam para outra etapa autorizada.
Limites
- Não invente respostas, objetivo, condição de saída, fora de escopo ou
vínculos de uma milestone.
- Não sobrescreva a milestone 1.0 nem backlogs existentes.
- Não pule a entrevista de nenhum backlog gerado pelo importador.
- Não implemente código durante a importação nem marque gate como Passed.
- Não trate Inbox como fonte normativa.
- Não use o entrevistador de roadmap para ampliar o MVP sem confirmação.
1---2name: specsfy-mvp-milestone-interviewer3description: Importa MVP.md como a milestone 1.0, cria backlog e spec Draft somente para requisitos de desenvolvimento, mantém o contexto de negócio apenas na fonte e orquestra a entrevista de cada backlog importado. Use quando o projeto tiver um MVP.md a transformar em M01, backlogs e specs Draft. Não use para evolução depois do MVP aceito (specsfy-roadmap-milestone-interviewer), para conferir vínculos de marcos (specsfy-milestone-governor), para implementar ou para aprovar gates.4metadata:5 source: https://skillmd.com/skills/promovaweb/specsfy-mvp-milestone-interviewer6---78# Explorar o MVP com requisitos de desenvolvimento910Esta skill orquestra a entrada do MVP. Ela importa `MVP.md` como a milestone111.0, seleciona somente requisitos de desenvolvimento e cria um backlog12candidato para cada um. O contexto de negócio permanece no arquivo de origem.13Em seguida, carrega as skills responsáveis para entrevistar cada backlog e14somente avança quando cada etapa tiver resultado confirmado.1516## Preparação obrigatória1718Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na19raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.20Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma21pendência.2223## Modo de interação2425Modo de interação: `perguntas`.26Antes de formular qualquer pergunta, leia e aplique o27`Contrato de perguntas numeradas` de `.specsfy/Spec.md`.2829## Pronto quando3031- `specs/milestones/M01.md` existe e nenhum arquivo preexistente foi32 sobrescrito.33- Cada tema desenvolvível tem backlog refinado e spec Draft com34 `Definition Gate: Pending`.35- Nenhum tema contextual gerou backlog, spec ou Inbox.36- `specsfy milestones sync --project <raiz>` rodou, com a tool `milestones_sync`37 quando o agente usar MCP, e38 `$specsfy-milestone-governor` conferiu os vínculos de `M01`.39- O relato final lista sessão, backlogs, specs, respostas confirmadas e pontos40 `Pendente`.4142## Carregar o contexto disponível43441. **Resolver a raiz.** Antes de ler qualquer arquivo, resolva a raiz do45 projeto consumidor. Se ela for um submódulo Git, descubra o superprojeto com46 `git -C <raiz> rev-parse --show-superproject-working-tree`. Saída não vazia47 acrescenta somente essa raiz pai à busca; outros pais ficam fora.482. **Localizar as fontes.** Procure `MVP.md` e `BRAND.md` como arquivos49 regulares na raiz do consumidor e, só se ausentes e a raiz for submódulo,50 no superprojeto. O arquivo local tem prioridade. Essas leituras podem ser51 feitas em paralelo. `MVP.md` é contexto declarado e não substitui o que a52 pessoa disser. `BRAND.md` mantém linguagem, público, proposta e limites de53 marca coerentes nas perguntas, sem ser copiado para artefatos derivados.543. **Triar dados sensíveis.** Aplique a mesma triagem da Inbox. Se a fonte55 tiver credencial, token, chave privada ou dado pessoal sensível, não gere a56 milestone nem reproduza o valor em mensagens.574. **Importar uma única vez,** antes da primeira pergunta:5859 ```bash60 specsfy milestones import-mvp --project <raiz>61 ```6263 Pelo MCP, use a tool `milestones_import_mvp`. Sem o binário instalado, rode64 o script equivalente:6566 ```bash67 node \68 .agents/skills/specsfy-mvp-milestone-interviewer/scripts/importar_mvp.mjs \69 --root <raiz>70 ```71725. **Ler o resultado.** Trate o JSON retornado como a fila ordenada de73 backlogs da sessão; cada item traz `title`, `backlog` e `spec`. Leia74 `PROJECT.md`, Inboxes, backlog e specs existentes só quando ajudarem a75 evitar repetição ou contradição. Não crie, mova nem altere arquivos de76 contexto.7778### O que o importador faz7980- Cria `specs/milestones/M01.md` a partir de `MVP.md`. Se `M01.md` já existir,81 não sobrescreve nenhum arquivo; informe a pessoa responsável.82- Cria backlog e spec somente para temas classificáveis como entregas de83 software desenvolvíveis. Visão, público, princípios, contexto, métricas e84 outros registros sem comportamento a construir permanecem só em `MVP.md`,85 sem Inbox e sem cópia para a milestone.86- Aplica defaults apenas diante de rótulo explícito ou formulação inequívoca no87 trecho, como `Problema`, `Público`, `Resultado`, `Contexto` ou uma frase88 objetiva de capacidade, e registra cada default com sua base no backlog e no89 JSON. Sem sustentação no trecho, preserva a lacuna em vez de criar valor90 plausível.91- Cada backlog guarda um bloco de registros do trecho importado e cita92 `MVP.md` como fonte. O backlog nasce `Captured`, recebe a spec Draft ao final93 e passa a apontar para ela como `Promoted`; a spec mantém94 `Definition Gate: Pending`.9596## Filtrar o que será desenvolvido9798Antes de carregar `$specsfy-02-backlog`, classifique o tema:99100| Classe | Quando | Resultado |101| --- | --- | --- |102| `Desenvolvível` | descreve capacidade, tela, fluxo, integração, dado, automação, regra executável ou comportamento do sistema | backlog e spec Draft |103| `Contextual` | descreve visão, público, posicionamento, princípio, problema, métrica, premissa, contexto ou limite sem entrega de software | permanece em `MVP.md`, sem Inbox, backlog ou spec |104105Na dúvida, classifique como desenvolvível somente se o próprio trecho trouxer106verbo ou objeto de construção verificável, como `desenvolver`, `implementar`,107`criar`, `permitir`, `cadastrar`, `consultar` ou `integrar`. Caso contrário,108mantenha contextual e registre o motivo. Uma descrição de produto não vira109backlog só porque pode ajudar uma implementação futura.110111## Resolver defaults antes de perguntar112113Para cada tema importado:1141151. Releia o trecho original, os `Defaults aplicados automaticamente`, o116 backlog e a milestone `M01`.1172. Campo preenchido por declaração explícita do MVP ou formulação inequívoca118 registrada pelo importador conta como resposta confirmada.1193. Se só existir uma opção materialmente compatível com o MVP, aplique-a como120 default óbvio e registre formulação normalizada e fonte, sem pedir121 confirmação.1224. Mais de uma leitura razoável, conflito entre fontes ou ausência de123 informação vira a próxima pergunta numerada, com a sugestão mais compatível124 primeiro. Não escolha em silêncio.1255. Depois de cada resposta, reavalie todos os campos. Não repita pergunta já126 respondida nem confirme default sustentado.127128O resultado precisa deixar claro o que foi resolvido automaticamente e o que129ainda depende da pessoa.130131## Orquestrar as skills da descoberta132133Para cada item da fila, em sequência e sem pular responsabilidades. O objetivo134é entrevistar cada backlog antes de qualquer promoção:1351361. Anuncie137 `Transição automática: $specsfy-mvp-milestone-interviewer → $specsfy-02-backlog — motivo: entrevistar o backlog derivado do MVP — resultado esperado: backlog refinado com respostas confirmadas`138 e carregue `$specsfy-02-backlog` com o caminho do backlog candidato.1392. Use primeiro os registros do MVP que acompanham o backlog para preencher o140 que já foi declarado. A entrevista adaptativa cobre só lacunas,141 ambiguidades ou contradições restantes.1423. Se houver informação a guardar ausente ou ambígua, anuncie a transição para143 `$specsfy-data-discovery`, conclua a entrevista de dados e retome o backlog144 com `.specsfy/DATABASE.md` como contexto.1454. Ao terminar o refinamento do backlog, retome esta skill, registre a situação146 do item na síntese da sessão e carregue `$specsfy-03-specify` para criar a147 spec Draft baseada nele. A seção 10 mantém a área de menus e navegação148 principal: use o que o MVP declarar e marque `Pendente` quando faltar. Não149 implemente código, não execute tarefas e não promova o Definition Gate.1505. Passe ao próximo item da fila.151152Quando a fila terminar, confirme que cada tema desenvolvível tem backlog e spec153Draft e que nenhum tema contextual gerou artefato. Execute154`specsfy milestones sync --project <raiz>`, com a tool `milestones_sync` pelo155MCP, e carregue156`$specsfy-milestone-governor` para conferir vínculos e progresso de `M01`. A157geração automática de Drafts não autoriza implementação nem validação final.158159## Conduzir uma conversa adaptativa1601611. Comece por finalidade, pessoa atendida e problema observável.1622. Depois de cada captura, releia as Inboxes da sessão e mostre uma síntese163 curta que separe formulação recebida e hipótese da conversa.1643. Monte cada rodada pelo contrato central: uma pergunta numerada, opções165 específicas, `Escrever outra resposta`, `Gere outras opções` e `Avançar`,166 com no máximo oito perguntas por área.1674. Explore só o necessário para entender jornada, dados indispensáveis,168 papéis, regras, integrações, limites, demonstração e validação. Cada169 informação a guardar pouco clara passa por `$specsfy-data-discovery` antes170 do próximo ponto. Não aplique formulário fixo nem repita resposta já171 preservada.1725. Quando a pessoa encerrar ou adiar uma área, capture a formulação dela e173 indique a Inbox correspondente na síntese, sem preencher lacunas por conta174 própria.175176## Preservar a sessão177178As respostas da conversa ficam registradas em Inboxes de sessão, separadas dos179temas importados. Essas capturas servem de rastreabilidade da entrevista; os180temas contextuais do MVP continuam sem Inbox.1811821. Derive uma identificação estável `DESC-AAAAMMDD-<slug>` a partir do primeiro183 tema recebido.1842. Depois de cada resposta, capture o conteúdo semântico em nova Inbox com a185 mesma sessão e o próximo turno. Quando a pessoa responder só `1`, `2` ou186 `3`, substitua o número pelo texto integral da opção escolhida antes de187 montar `--input`, `--summary`, `--signals` e os demais campos. A entrada188 literal pode constar na rastreabilidade, mas não serve de contexto da189 milestone. Cada hipótese de milestone apresentada para confirmação também190 gera uma Inbox. Capturas anteriores nunca são editadas, reunidas ou191 substituídas.1923. Informe `--sources` em toda chamada com o caminho de `MVP.md` e `BRAND.md`193 consultados, inclusive do superprojeto, ou indique que estavam ausentes.1944. Aplique antes de cada escrita a triagem de dados sensíveis do195 `$specsfy-01-inbox`. Se ela impedir a captura, pause a conversa até receber196 texto seguro.1975. Escreva em Português do Brasil a análise, a síntese, os metadados e qualquer198 milestone gerada. Fonte ou resposta em outro idioma fica só como citação,199 com a interpretação em Português do Brasil.200201```bash202specsfy inbox capture \203 --input "<texto integral da pessoa>" \204 --title "<tema da descoberta>" \205 --session "DESC-AAAAMMDD-<slug>" \206 --turn "<número sequencial>" \207 --sources "<situação de MVP.md e BRAND.md>" \208 [campos de análise da Inbox] [--project <raiz>]209```210211Pelo MCP, use a tool `inbox_capture`. Sem o binário instalado, rode o script212equivalente:213214```bash215node .agents/skills/specsfy-01-inbox/scripts/capturar_inbox.mjs \216 --input "<texto integral da pessoa>" \217 --title "<tema da descoberta>" \218 --session "DESC-AAAAMMDD-<slug>" \219 --turn "<número sequencial>" \220 --sources "<situação de MVP.md e BRAND.md>" \221 [campos de análise da Inbox] [--root <raiz>]222```223224## Encerrar e tratar depois225226Ao encerrar, informe a identificação da sessão, `M01`, a lista ordenada de227backlogs e specs Draft geradas, as respostas confirmadas e os pontos marcados228como `Pendente`, e lembre que os demais temas continuam em `MVP.md`. A geração229de specs encerra a importação; implementação, validação final e promoção de230gate ficam para outra etapa autorizada.231232## Limites233234- Não invente respostas, objetivo, condição de saída, fora de escopo ou235 vínculos de uma milestone.236- Não sobrescreva a milestone 1.0 nem backlogs existentes.237- Não pule a entrevista de nenhum backlog gerado pelo importador.238- Não implemente código durante a importação nem marque gate como Passed.239- Não trate Inbox como fonte normativa.240- Não use o entrevistador de roadmap para ampliar o MVP sem confirmação.