Instalação do Brandfy

Requisitos

O projeto consumidor precisa ter uma raiz definida, permissão para criar ou atualizar arquivos e um AGENTS.md que possa receber o bloco gerenciado do Brandfy. O CLI e as skills usam Node.js 22.20 ou posterior.

ImageMagick, Pandoc e WeasyPrint são necessários somente quando o percurso chegar a exportações raster, ao manual em PDF ou a algum asset que dependa deles. O diagnóstico informa a dependência ausente quando ela for necessária.

Os três comandos públicos

Instale o CLI uma vez:

1
npm install --global @promovaweb/brandfy

Depois, na raiz do projeto que receberá a marca:

1
brandfy install .

O install instala todas as 19 skills, prepara .brandfy/, cria ou confere BRAND.md, deixa brand/README.md como índice, cria os diretórios esperados e atualiza o bloco do AGENTS.md. A conversa de marca começa depois disso com a skill $brandfy.

Quando uma nova versão do Brandfy for publicada, use:

1
brandfy update

O update atualiza as skills, reaplica a estrutura gerenciada sem substituir conteúdo autoral e executa a verificação do setup.

Para conferir a instalação e os arquivos:

1
brandfy doctor

O diagnóstico confere Node.js, as 19 skills, skills-lock.json, .brandfy/config.yaml, BRAND.md, brand/README.md e o bloco do AGENTS.md. Ele também informa se MVP.md foi encontrado na raiz. A ausência do MVP é aceita porque a entrada é opcional.

Depois da instalação

Não execute scripts das skills e não use o gerenciador skills diretamente. A skill $brandfy lê o estado, conversa sobre as lacunas e chama brandfy-setup, brandfy-mvp e todas as especialistas necessárias.

O capítulo Skills do Brandfy explica cada especialista. O capítulo BRAND.md em detalhe explica o manual e o mapa de arquivos que a orquestradora mantém.