brandfy-setup

Configurar o Brandfy

Protocolo operacional

• Plano e progresso: criar um plano visível e atualizar o estado após a

inspeção, a configuração e a validação.

• Fontes de verdade: ler o AGENTS.md do projeto, os arquivos existentes

em .brandfy/ e a referência agents-consumer.md.

• Escopo e idempotência: preservar configurações e artefatos existentes. O

setup só cria arquivos ausentes, migra o manual legado para BRAND.md e substitui apenas o bloco Brandfy no AGENTS.md.

• Validação: executar o setup com --check depois da escrita e revisar o

git diff.

• Resumo final: informar arquivos criados, arquivos preservados,

validações e pendências.

Fluxo

1. Localizar a raiz do projeto e ler suas instruções.
2. Executar:

   node <caminho-da-skill>/scripts/setup.mjs --project .

1. Abrir .brandfy/config.yaml e ajustar nome, país, idioma, destino e fase da

marca com o usuário.

1. Quando o briefing ainda estiver incompleto, usar $brandfy-entrevista para

conduzir a descoberta e preencher os arquivos sem inventar respostas.

1. Preencher .brandfy/brief.md apenas com fatos confirmados. Manter lacunas

explícitas, com pergunta e responsável.

1. Conferir o bloco delimitado por brandfy:consumer no AGENTS.md.
2. Executar:

   node <caminho-da-skill>/scripts/setup.mjs --project . --check

Depois do setup, abra .brandfy/config.yaml, BRAND.md e brand/README.md para confirmar o destino, o guia e o índice. Um segundo uso deve terminar sem alterações, e qualquer diferença indica configuração incompleta ou bloco do agente antigo.

Em um projeto antigo, o manual que ainda estiver em brand/README.md passa para BRAND.md; uma cópia anterior fica em brand/archive/ quando necessário.

Raciocínio do especialista

Tratar o setup como preparação de governança, não como criação da marca. Confirmar responsáveis por respostas e aprovações, localização das comprovações, arquivos canônicos e forma de resolver pendências. Uma estrutura completa com informação fraca continua sendo um projeto incompleto.