Guia completo do usuário

Uma marca costuma começar com material espalhado: um logo usado no site, cores copiadas de apresentações, fontes escolhidas por hábito e explicações que somente uma parte da empresa conhece. O Brandfy reúne esse material, conduz as definições que ainda faltam e grava um sistema que pessoas e agentes conseguem consultar antes de criar uma nova peça.

O Brandfy é uma biblioteca de skills para agentes. Ele não substitui a conversa com os responsáveis pela marca, a pesquisa jurídica nem a revisão de um designer. As skills ajudam a registrar evidências, comparar alternativas, produzir arquivos repetíveis e mostrar o que ainda precisa de aprovação humana.

Leia online ou como parte do guia portátil

Este percurso forma o PDF e o EPUB do Brandfy. Os arquivos Markdown em docs/user/ são a fonte editorial, por isso uma correção feita aqui entra nas duas edições no próximo build. A referência técnica permanece disponível online em docs/develop/ e não entra nesses artefatos.

• O PDF preserva a diagramação e funciona bem para leitura, compartilhamento e impressão.
• O EPUB permite ajustar a fonte e o tamanho em leitores digitais.

Baixe o PDF do guia do usuário ou o EPUB do guia do usuário. A pasta dos ebooks registra a edição vigente e os hashes dos artefatos.

Percurso recomendado

Comece pela instalação e confirme o estado com brandfy doctor. Depois, leia como o Brandfy organiza os arquivos, o guia de BRAND.md e o papel de cada skill. Essa ordem ajuda a separar .brandfy/, BRAND.md e a pasta pública brand/.

O trabalho completo segue esta sequência:

1. Instale e confira o CLI.
2. Entenda os arquivos e as camadas de informação.
3. Leia o guia de BRAND.md e o papel de cada skill.
4. Prepare o projeto consumidor.
5. Conduza a entrevista e o diagnóstico.
6. Construa ou revise o sistema de marca.
7. Gere logos, tokens, webfontes e templates.
8. Compile o manual e o PDF da marca.
9. Audite os arquivos antes de publicar.
10. Oriente outros agentes a usar a marca.
11. Investigue falhas conhecidas.

Uma marca existente pode começar pelo diagnóstico e preservar tudo o que já possui evidência de uso e aprovação. Uma marca nova precisa de entrevista antes da direção verbal e visual, pois o agente não deve completar uma lacuna com uma resposta apenas plausível.

O resultado no repositório

Ao final, o projeto consumidor mantém a origem do trabalho em .brandfy/ e os arquivos utilizáveis em brand/. Um conjunto completo pode conter estratégia, voz, logos vetoriais e raster, favicons, paleta, tokens CSS e JSON, tema Tailwind, webfontes, templates, regras de acessibilidade, licenças, manifesto e manual em PDF.

O relatório .brandfy/audit.md fecha o percurso ao confrontar o manual com os arquivos produzidos. A aprovação automática não dispensa a abertura do PDF, dos logos e de pelo menos uma aplicação de cada canal no tamanho final.