higgsfield-ai/higgsfield-brandkit

Higgsfield Brandkit

Construa uma identidade coesa e suas aplicações solicitadas. Trate os fatos da marca fornecidos e os ativos oficiais como restrições fixas.

Inicialização

1. Resolva SKILL_ROOT para o diretório instalado desta habilidade e crie um diretório de projeto durável:

   BRANDKIT_WORKDIR="${PWD}/brandkit"
   BRANDKIT_STATE="${BRANDKIT_WORKDIR}/state.json"
   mkdir -p "${BRANDKIT_WORKDIR}"
   

2. Leia os pré-requisitos. Verifique as ferramentas antes do estágio que precisar delas. Nunca instale pacotes do sistema sem a permissão do usuário.

3. Se higgsfield estiver faltando, instale-o somente após permissão:

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

4. Se higgsfield account status falhar com um erro de autenticação ou workspace, peça ao usuário para executar higgsfield auth login ou selecionar um workspace, e aguarde.

5. Inspecione os contratos de modelo ativos antes da geração paga:

   higgsfield model get recraft_v4_1 --json
   higgsfield model get seedream_v5_pro --json
   higgsfield model get gpt_image_2 --json
   

Mapeamento CLI

Operação	Comando
Descobrir um modelo	higgsfield model get <model> --json
Gerar e aguardar	higgsfield generate create <model> ... --wait --json
Retomar um job	higgsfield generate wait <job_id> --json
Enviar um ativo local	higgsfield upload create <path> --json
Importar metadados de site	higgsfield marketing-studio brand-kits fetch --url <url> --wait --json
Ler/escrever estado de aprovação	python3 "$SKILL_ROOT/scripts/brandkit.py" state ...
Renderizar painéis de revisão	python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...
Inspecionar logotipo selecionado	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...
Exportar arquivos de logotipo	python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...
Construir um Brandbook	python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...

Caminhos de imagem locais passados com --image são enviados automaticamente. Mantenha entregáveis HTML, SVG, PPTX e PDF como arquivos de projeto locais, a menos que o usuário solicite explicitamente uma cópia hospedada.

Comportamento voltado ao usuário

• Use o idioma do usuário. Mantenha o raciocínio do Design Brain, prompts, mecânicas de estado, scripts, consulta de modelos e internos de QA como privados.
• Envie no máximo uma frase curta de status por lote de geração visível e depois fique em silêncio até o resultado ficar pronto.
• Faça um conjunto compacto de apenas perguntas bloqueadoras não resolvidas. Nunca repita fatos ou force um questionário completo de identidade para uma tarefa parcial.
• Após cada revisão de paleta, logotipo, tipografia ou downstream, pare e aguarde o feedback comum do usuário.
• Nunca presuma aprovação com base em silêncio, geração bem-sucedida ou sua própria preferência.
• Preserve o texto exato do usuário. Nunca invente posicionamento, valores, alegações, ingredientes, preços, certificações, estatísticas ou conteúdo regulatório.

Fluxo de trabalho principal

1. Classifique a solicitação.

   • apply-existing: use os ativos oficiais fornecidos sem redesenhar.
   • extend-partial: crie apenas os slots faltantes exigidos pela saída solicitada.
   • create-identity: crie um novo logotipo ou identidade somente quando solicitado explicitamente.

2. Leia o estado. Execute:

   python3 "$SKILL_ROOT/scripts/brandkit.py" state \
     --state-file "$BRANDKIT_STATE" --action get_status
   

   O estado local é durável. Nunca cole, edite manualmente ou recrie aprovações quando o arquivo de estado existir.

3. Execute a captação e análise de ativos. Leia captação, análise de ativos, roteamento de estado e payloads de estado exatos. Bloqueie imediatamente cada logotipo oficial, paleta e slot de tipografia declarados pelo usuário.

4. Crie o Brand Lock. Leia Brand Lock. Registre a grafia exata, ativos oficiais, cores, fontes, regras de layout/forma, saídas solicitadas e tratamentos proibidos.

5. Exija apenas os slots que a saída utiliza.

   • apenas-logo → paleta + logotipo para uma nova marca; logotipo oficial sozinho para uma marca existente
   • apenas-paleta → paleta
   • apenas-tipografia → tipografia
   • mockup/merchandising sem texto → logotipo; adicione paleta apenas quando cor/aplicação exigir
   • material social/embalagem/pôster/sinalização com texto → logotipo + paleta + tipografia
   • Brandbook/deck → logotipo + paleta + tipografia

6. Construa slots de fundação faltantes. Leia Design Brain, painéis de conceito, revisões inline e apenas os módulos necessários de paleta, logotipo ou tipografia.

7. Continue a solicitação original assim que seus slots necessários forem aprovados. Nunca peça ao usuário para escolher o escopo novamente.

8. Carregue apenas o módulo de produção solicitado:

   • mockups
   • gráficos para redes sociais
   • pôsteres/banners
   • embalagens
   • sinalização
   • merchandising
   • apresentações
   • Brandbooks

9. QA e aprovação. Leia QA e iteração. Repare apenas a saída com falha. Salve um elemento downstream somente após aprovação explícita com suas dependências de fundação exatas.

Sequência para nova identidade

1. Paleta

Renderize 2–3 opções de paleta exatas como HTML determinístico usando payloads de preview. Mostre capturas de tela PNG mais arquivos HTML editáveis e aguarde. Persista a paleta selecionada com approve_palette antes da geração do logotipo.

2. Marcas de logotipo SVG

Leia otimizador de prompt de logotipo. Produza exatamente três mecanismos distintos apenas de símbolo e um prompt Recraft para cada um. Escreva cada prompt longo em um arquivo e submeta separadamente:

higgsfield generate create recraft_v4_1 \
  --model_type vector \
  --colors @"${BRANDKIT_WORKDIR}/logo-colors.json" \
  --background_color '#F7F7F5' \
  --aspect_ratio 1:1 \
  --resolution 2k \
  --wait --json < "${BRANDKIT_WORKDIR}/logo-candidate-1.txt"

Use as URLs SVG retornadas diretamente para revisão. Após a seleção, inspecione o SVG exato sem alterá-lo:

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<URL SVG Recraft selecionada ou caminho local absoluto>"

Persista o job ID exato, URL SVG, nome, revisão da paleta e a impressão digital geométrica canônica retornada com approve_logo.

3. Tipografia

Proponha 2–3 pares de exibição/corpo únicos usando fontes fornecidas ou Google Fonts verificadas. Renderize o nome real da marca e texto de amostra através do script de preview. Persista apenas o par selecionado com approve_typography.

Fluxos interativos sempre param para seleções de paleta, logotipo e tipografia. O modo explícito sem perguntas pode escolher e persistir uma paleta, mas ainda mostra todos os três candidatos de logotipo SVG e para para a seleção do logotipo pelo usuário; marcas exatas nunca são auto-aprovadas.

Invariantes de consistência

• Reutilize a mesma fonte de logotipo aprovada em todos os lugares. Nunca redesenhe um SVG oficial ou selecionado quando o posicionamento/exportação determinística for possível.
• Um logotipo gerado depende da revisão da paleta usada para criá-lo. Alterar essa paleta invalida o logotipo gerado e seus dependentes; alterar a tipografia não invalida a marca símbolo.
• Alterar um slot de fundação invalida apenas elementos downstream que listam esse slot em required_slots.
• Copie os mesmos valores do Brand Lock em cada prompt de geração relacionado: hex exato, funções da fonte, linguagem de forma, posicionamento, espaço livre, composição e tratamentos proibidos.
• Use o modo vetorial Recraft V4.1 apenas para novas marcas de logotipo.
• Use Seedream como o gerador principal de mockups fotorrealistas. Use GPT Image 2 apenas para o estágio controlado que adiciona texto legível ou detalhes gráficos exatos.
• Use construção SVG/PPTX/HTML determinística local para texto exato e layouts editáveis. Não peça a um modelo de imagem para falsificar arquivos editáveis.
• Não prometa arquivos nativos Figma, Canva, PSD, AI ou EPS.

Scripts determinísticos

Crie arquivos de entrada JSON em "$BRANDKIT_WORKDIR"; nunca interpole texto do usuário diretamente em argumentos de shell.

python3 "$SKILL_ROOT/scripts/brandkit.py" preview \
  --input "$BRANDKIT_WORKDIR/reviews.json" \
  --output-dir "$BRANDKIT_WORKDIR/reviews"

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export \
  --input "$BRANDKIT_WORKDIR/logo-export.json" \
  --output-dir "$BRANDKIT_WORKDIR/logo"

python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build \
  --state-file "$BRANDKIT_STATE" \
  --input "$BRANDKIT_WORKDIR/brandbook.json" \
  --output-dir "$BRANDKIT_WORKDIR/brandbook"

Para exportação de logotipo, carregue payloads de exportação de logotipo. Para Brandbooks, use apenas o construtor incluído; nunca substitua por um gerador improvisado de PowerPoint ou PDF após uma falha de contrato determinístico.

Política de falha

• Repita uma solicitação de Recraft ou geração de imagem com falha uma vez, com o mesmo conceito bloqueado e contrato corrigido. Pare após a segunda falha equivalente.
• Se o preview ou exportação de logotipo falhar duas vezes, relate o erro concreto; nunca o substitua por uma reescrita SVG ad-hoc.
• Se o modelo de Brandbook, fonte ou contrato de conversão falhar, pare imediatamente. Não produza um fallback visualmente diferente e o chame de canônico.
• Se a tipografia exata ou a fidelidade do logotipo oficial não puder ser preservada, divulgue a limitação em vez de alegar conclusão.
• Nunca exponha tokens de autenticação brutos ou credenciais em arquivos, logs ou chat.

Entrega

Para Brandbooks, siga o contrato de resposta estrito em brandbook: apenas link/caminho PPTX, link/caminho PDF e aviso de instalação de fonte.

Para outras saídas, retorne:

1. Os arquivos visuais e previews solicitados.
2. Um resumo compacto do Brand Lock.
3. Rótulos de formato editável versus achatado.
4. Limitações de fontes necessárias/importação.
5. Nomes de variantes estáveis para revisões direcionadas.

Índice de referências

• Pré-requisitos — dependências locais por estágio e comandos de instalação.
• Captação — perguntas mínimas e roteamento de entrada.
• Análise de ativos — classificação e medição oficial/de referência.
• Roteamento de estado e payloads de estado — aprovações persistentes.
• Brand Lock — restrições visuais canônicas.
• Design Brain — direção de arte privada.
• Painéis de conceito, payloads de preview e revisões inline — estágios de seleção.
• Logotipo, otimizador de prompt de logotipo e payloads de exportação de logotipo — geração SVG e variantes determinísticas.
• Paleta e tipografia — slots de fundação.
• Mockups, gráficos para redes sociais, pôsteres/banners, embalagens, sinalização e merchandising — aplicações.
• Apresentações e Brandbooks — documentos editáveis.
• QA e iteração — pré-voo, reparo, aprovação e manifesto de entrega.