mcpField
M
mvpfy-context

mvpfy-context

github.com/promovawebAgent workflows8211 installsUpdated 10w ago
Repository

About mvpfy-context

mvpfy-context is a skill for the MVPFy orchestrator that inspects an existing project and summarizes technical context before setup or when a conversation resumes. It reports evidence-backed suggestions and unresolved questions without changing project files beyond its own .mvpfy artifacts.

Key features

  1. 01Analyze existing project files
  2. 02Find specs and product documents
  3. 03Summarize code by language and folder
  4. 04Identify declared stack and dependencies
  5. 05Return sourced suggestions with confidence
  6. 06Record unanswered questions

Use cases

  1. 01Preparing project context before an MVP interview
  2. 02Resuming a conversation without repeating answered questions
  3. 03Identifying technical details that can inform an initial MVP
  4. 04Separating known implementation facts from open product decisions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/promovaweb/mvpfy --skill mvpfy-context

After installing, type/mvpfy-contextin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlscripts/analyze-existing-project.mjs

Details

From the project README

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.

Comments

Markdown supported