SKILL.md
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.mddo projeto, os arquivos existentes
em .brandfy/ e a referência [agents-consumer.md](references/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
--checkdepois da escrita e revisar o
git diff.
- Resumo final: informar arquivos criados, arquivos preservados,
validações e pendências.
Fluxo
- Localizar a raiz do projeto e ler suas instruções.
- Executar:
``bash node <caminho-da-skill>/scripts/setup.mjs --project . ``
- Abrir
.brandfy/config.yamle ajustar nome, país, idioma, destino e fase da
marca com o usuário.
- Quando o briefing ainda estiver incompleto, usar
$brandfy-entrevistapara
conduzir a descoberta e preencher os arquivos sem inventar respostas.
- Preencher
.brandfy/brief.mdapenas com fatos confirmados. Manter lacunas
explícitas, com pergunta e responsável.
- Conferir o bloco delimitado por
brandfy:consumernoAGENTS.md. - Executar:
``bash 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.