About brandfy-mvp
brandfy-mvp is a brand strategy skill that imports an MVP document into Brandfy’s managed brand files. It preserves the source and distinguishes documented facts from tentative conclusions and items needing human confirmation.
Key features
- 01Read `MVP.md` and existing brand files
- 02Populate managed blocks in brand documents
- 03Preserve assumptions and unresolved items
- 04Track source sections for derived conclusions
- 05Validate frontmatter and section markers
- 06Refresh imports when `MVP.md` changes
Use cases
- 01Turn an MVP brief into brand context
- 02Prepare source material for brand strategy and identity work
- 03Review open questions before creating brand assets
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ promovaweb/ brandfy --skill brandfy-mvpAfter installing, type/brandfy-mvpin Claude Code to confirm it loaded.
Bundled filesagents/openai.yamlscripts/import-mvp.mjs
Details
From the project READMEImportar o MVP para o Brandfy
Protocolo operacional
- Plano e progresso: conferir a origem, ler o documento, separar camadas e registrar a passagem para a marca.
- Fontes de verdade: ler
MVP.mdna raiz,.brandfy/config.yamle os arquivos existentes embrand/. - Escopo e idempotência: manter o
MVP.mdintacto e atualizar somente blocos gerenciados doBRAND.md, da estratégia e da voz. - Contrato de arquivos: se
brand/README.mdainda for um manual legado, promovê-lo aBRAND.mde deixar o caminho original como índice. - Validação: confirmar o formato do documento, preservar hipóteses e pendências e conferir o mapa de arquivos depois da escrita.
- Resumo final: informar a origem, os fatos aproveitados, as conclusões derivadas, os campos ainda abertos e os próximos especialistas.
Postura de especialista
Atuar como estrategista de marca. O MVP.md descreve produto, público,
operação e contexto comercial; ele não entrega automaticamente uma identidade
visual pronta. Leia os dados, ligue cada conclusão a uma seção de origem e deixe
claro o que ainda precisa de confirmação humana.
Não transformar preço, nome provisório, slogan sugerido ou personalidade recomendada em definição aprovada. Essas informações alimentam exploração de naming, voz, visual e logo até receberem confirmação.
Fluxo
-
Quando
MVP.mdexistir na raiz,$brandfychama o importador interno debrandfy-mvpcom esse arquivo como origem. O usuário não precisa executar o script da especialista. -
Conferir
.brandfy/mvp-context.jsone.brandfy/asset-brief.md. -
Ler o
BRAND.mdgerado na raiz e revisar as conclusões antes de criar logo, paleta, tipografia ou templates. -
Encaminhar a base para as especialistas de estratégia, voz e identidade visual, que transformam o contexto em definições aprovadas.
-
Encaminhar os briefs para as especialistas de logo, tokens, tipografia, assets e aplicações.
-
Atualizar o
BRAND.mde o mapa de arquivos depois que os assets forem criados.
Validação
O fluxo verifica o frontmatter e os marcadores mvpfy:section antes de gravar.
Quando MVP.md muda, $brandfy pode importar o arquivo novamente; a origem
permanece preservada e os blocos gerenciados são recompilados.