mvpfy-context

사용 방법

설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.

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

시작 전 확인

설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.

원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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

Executar scripts/analyze-existing-project.mjs no diretório consumidor.
Procurar specs, briefs, backlogs, planos, documentos de produto e registros

em arquivos Markdown, YAML e JSON.

Ler manifestos e contar arquivos de programação por linguagem e pasta.
Reconhecer a stack declarada, a existência de uma aplicação e os sinais

técnicos que ajudam a formular o primeiro MVP.

Entregar sugestões de resposta com origem, resumo e grau de confiança.
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:

bash

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.