MVPFy

O MVPFy é um conjunto de skills para transformar uma ideia em um plano executável do primeiro produto SaaS. A conversa acontece com uma única pergunta por turno, três respostas prontas, 4. Avançar e 5. Conversar mais sobre este tema. Cada resposta é salva antes do próximo turno.

O resultado público do processo é um único arquivo MVP.md. Ele reúne o problema, o público, as personas, a jornada, o escopo da versão 1.0, o modelo SaaS, o preço, os custos, a tecnologia, o marketing, as métricas e as próximas validações.

A entrevista fechada é curta: uma pergunta essencial por etapa e no máximo oito perguntas no total. A etapa SaaS pode usar duas. O restante vira recomendação no MVP.md para manter o foco na versão 1.0.

O MVPFy chama mvpfy-context durante a configuração e no início de cada conversa. Essa skill lê specs, backlogs, briefs, manifestos e arquivos de programação, grava .mvpfy/existing-project.json e prepara sugestões para a entrevista. A leitura é somente de referência. O MVPFy não cria, altera ou migra spec.md, specs/ ou qualquer arquivo do Specsfy.

Versionamento e releases

O arquivo VERSION controla o SemVer do framework. O campo version do package.json e a seção mais recente do CHANGELOG.md precisam usar a mesma versão.

Cada push na main precisa incluir uma nova versão quando trouxer uma melhoria publicável. O workflow release.yml valida os testes, compara a versão com o commit anterior, cria a tag vX.Y.Z e publica a release no GitHub usando as notas da seção correspondente do changelog.

Para conferir antes do push:

npm run release:check

Consulte o fluxo de release para escolher entre patch, minor e major e para entender as recusas do workflow.

Instalação

Na raiz do projeto consumidor, execute:

npx --yes @promovaweb/mvpfy install --project .

O comando instala as skills para Claude Code e Codex, prepara MVP.md e .mvpfy/ e analisa o projeto existente. Um segundo uso preserva respostas e arquivos existentes, renovando apenas o relatório de contexto.

No projeto que receberá as skills, use $mvpfy como porta de entrada.

Skills

| Skill | Função | | --- | --- | | mvpfy | Entrevista, retomada, fila de perguntas e consolidação. | | mvpfy-context | Specs, código, manifestos, stack sugerida e lacunas iniciais. | | mvpfy-problem | Situação, problema, alternativa atual e hipótese. | | mvpfy-audience | Segmento, papéis de compra e personas. | | mvpfy-product | Proposta, jornada, módulos e escopo 1.0. | | mvpfy-saas | Conta, acesso, onboarding, cobrança e ciclo do cliente. | | mvpfy-brand | Categoria, posicionamento, nome e slogan. | | mvpfy-market | Concorrentes, alternativas e preços consultados. | | mvpfy-pricing | Modelo de preço, custos e cenários. | | mvpfy-technology | Laravel, VPS, dados, arquivos, IA e operação. | | mvpfy-marketing | Aquisição, conteúdo, leads, venda e lançamento. | | mvpfy-document | Geração e validação do MVP.md. | | mvpfy-migrate | Atualização do template sem perda de conteúdo. | | mvpfy-progress | Leitura do andamento sem iniciar outra pergunta. | | mvpfy-setup | Instalação, verificação e atualização do projeto consumidor. |

Princípios

• O produto atendido é o primeiro software oferecido como serviço.
• O plano cobre somente a versão 1.0 e separa o que fica para depois.
• A orquestradora exibe uma pergunta por turno com cinco opções fixas.
• A opção 5 abre conversa livre sobre a pergunta atual sem criar outra pergunta.
• O estado vive no projeto consumidor, em .mvpfy/.
• O conteúdo final vive em MVP.md.
• Laravel em VPS é a base técnica preferencial da Promovaweb.

Documentação e ebook

O guia do usuário apresenta o percurso completo. O guia de desenvolvimento explica contratos, scripts e testes. O ebook publica somente o Guia do usuário em

CLI

mvpfy progress --project .
mvpfy install --project .
mvpfy update --project .
mvpfy tui --project .

Use mvpfy progress --json para integração com outros agentes e scripts. Sem subcomando, mvpfy abre a TUI automaticamente. Se o npm global não estiver no PATH, use npx --yes @promovaweb/mvpfy --project . ou instale no prefixo explícito do exemplo e adicione "$HOME/.npm-global/bin" ao PATH.

Validação

npm test
npm run ebook:verify

Licença

MIT.