mvpfy-context

Contexto de um projeto existente

Esta skill entra antes da entrevista, durante a configuração do projeto e no início de cada retomada da conversa. Ela procura material já criado e entrega um retrato curto para a orquestradora do MVPFy.

Responsabilidade

1. Executar scripts/analyze-existing-project.mjs no diretório consumidor.
2. Procurar specs, briefs, backlogs, planos, documentos de produto e registros em arquivos Markdown, YAML e JSON.
3. Ler manifestos e contar arquivos de programação por linguagem e pasta.
4. Reconhecer a stack declarada, a existência de uma aplicação e os sinais técnicos que ajudam a formular o primeiro MVP.
5. Entregar sugestões de resposta com origem, resumo e grau de confiança.
6. Registrar perguntas que o material não consegue responder.

Limites

• A leitura é somente de contexto. Nenhum arquivo do projeto consumidor é alterado, exceto os artefatos criados dentro de .mvpfy/ pelo próprio MVPFy.
• node_modules, vendor, .git, builds, caches, cobertura, segredos e arquivos binários ficam fora da leitura.
• Um nome de função, uma rota ou uma dependência mostra implementação. Não prova público, problema, proposta de valor, preço ou aceitação do produto.
• Uma sugestão pode preencher uma lacuna técnica. A pessoa ainda confirma escolhas de produto, público e escopo durante a conversa.
• A skill nunca escreve spec.md, não modifica specsfy/ e não transforma código existente em código do MVPFy.

Saída

O relatório fica em .mvpfy/existing-project.json. Ele contém:

• sources.specs: documentos encontrados, tipo, título, caminho e trecho;
• sources.code: arquivos de programação agrupados por linguagem;
• manifests: manifestos lidos e dependências declaradas;
• stack: tecnologias reconhecidas com seus caminhos de origem;
• suggested_answers: campos que o contexto ajuda a responder;
• gaps: perguntas que continuam abertas;
• summary: contagens e leitura geral do projeto.

O estado recebe somente um ponteiro resumido em existing_project_context. A orquestradora lê o relatório completo antes de montar a fila, usa sugestões suficientes para não repetir perguntas e marca como pendente qualquer conclusão que o material não sustente.

Gatilhos da orquestradora

No setup-project.mjs, a skill roda depois da criação inicial de .mvpfy/. No começo de cada conversa com $mvpfy, rode novamente:

node skills/mvpfy-context/scripts/analyze-existing-project.mjs --project .

Depois leia .mvpfy/existing-project.json junto de state.json, answers.jsonl, MVP.md e das fontes de contexto. Se não houver material, continue pelo relato livre da ideia. Se houver, comece pelos campos já explicados e apresente somente a próxima lacuna relevante.