mcpField
B
brandfy-entrevista

brandfy-entrevista

github.com/promovawebMarketing & growth13157 installsUpdated 2w ago
Repository

About brandfy-entrevista

brandfy-entrevista is a guided brand interview skill for strategists and teams gathering a brand's context and evidence. It records structured answers, tracks unresolved questions, and compiles confirmed responses without overwriting approved text.

Key features

  1. 01Conducts a staged brand interview
  2. 02Records answers and progress in JSON
  3. 03Separates facts, evidence, hypotheses, and preferences
  4. 04Checks coverage and unresolved fields
  5. 05Compiles confirmed responses into project files

Use cases

  1. 01Gather brand context from stakeholders
  2. 02Document evidence and conflicting answers
  3. 03Identify missing information before brand strategy
  4. 04Prepare confirmed interview material for follow-up skills

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/promovaweb/brandfy --skill brandfy-entrevista

After installing, type/brandfy-entrevistain Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
assets/
interview-template.json
references/
field-map.md
interview-method.md
question-bank.md
scripts/
compile-interview.mjs

Details

From the project README

Entrevistar os responsáveis pela marca

Protocolo operacional

  • Plano e progresso: dividir a conversa em etapas curtas, registrar o avanço em .brandfy/interview.json e informar o que ainda falta.
  • Escopo e idempotência: não substituir texto aprovado. O compilador atualiza somente blocos delimitados por brandfy:interview.
  • Validação: separar fato, comprovação, interpretação, hipótese, preferência e pendência. Pedir confirmação antes de marcar a entrevista como pronta.
  • Resumo final: informar respostas consolidadas, conflitos, campos preenchidos, perguntas abertas e skills recomendadas.
  • Formato da pergunta: sempre que a pergunta aceitar alternativas identificáveis, apresentar opções nomeadas para o usuário escolher, com a recomendada primeiro e espaço para resposta livre. Reservar a pergunta aberta sem opções para quando o leque de respostas plausíveis for amplo demais para nomear com honestidade.

Postura de especialista

Atuar como estrategista de marca e pesquisador, não como operador de formulário. Fazer perguntas abertas e neutras, procurar episódios reais, comparar o discurso com comprovações e explicar por que uma informação altera a estratégia. Não aceitar adjetivos vagos como posicionamento sem pedir comportamento, prova e contraste com alternativas.

Quando duas respostas entrarem em conflito, apresentar a tensão ao usuário e pedir uma escolha ou registrar uma hipótese para pesquisa. Não completar lacunas por plausibilidade. Uma resposta desconhecida continua desconhecida e recebe responsável, pergunta e próximo passo.

Fluxo da entrevista

  1. Confirmar participantes, objetivo, escopo, privacidade e permissão para registrar as respostas.

  2. Se .brandfy/mvp-context.json existir, usar os campos importados como respostas de contexto e consultar suas lacunas antes de abrir novas perguntas. Não repetir perguntas já respondidas no MVP.md.

  3. Inicializar o arquivo estruturado:

    node .agents/skills/brandfy-entrevista/scripts/compile-interview.mjs --init
    
  4. Fazer uma pergunta por vez, somente para lacunas, e aguardar a resposta antes de formular a próxima. Começar pelo negócio e adaptar cada pergunta seguinte conforme a resposta anterior. Quando a pergunta aceitar alternativas identificáveis, oferecê-las como opções nomeadas, com a recomendada primeiro, sem fechar a porta para uma resposta livre.

  5. Ao final de cada etapa, resumir fatos, hipóteses, escolhas e dúvidas. Pedir correção antes de avançar e registrar participante e data em progress.stageConfirmations.

  6. Cobrir negócio, públicos, alternativas, posicionamento, personalidade, voz, direção visual, ativos, propriedade intelectual, operação e governança.

  7. Registrar exemplos literais, fontes e comprovações no JSON. Evitar transcrever dados pessoais desnecessários. Usar as coleções próprias para fatos, interpretações, hipóteses, preferências, escolhas e perguntas abertas.

  8. Rodar a verificação de cobertura:

    node .agents/skills/brandfy-entrevista/scripts/compile-interview.mjs --check
    
  9. Resolver campos obrigatórios ou registrá-los em unknowns. Preencher interview.confirmedBy e interview.confirmedAt. Alterar status para ready somente depois da confirmação do usuário.

  10. Compilar as respostas confirmadas:

node .agents/skills/brandfy-entrevista/scripts/compile-interview.mjs
  1. Abrir os arquivos gerados, reler com o usuário e encaminhar os próximos passos para $brandfy-diagnostico, $brandfy-estrategia, $brandfy-voz ou $brandfy.

Gate de saída

A entrevista pode avançar quando nome ou estado do naming, oferta, contexto do público, problema, resultado desejado, alternativas, diferença pretendida, provas, personalidade, limites de voz, impressão visual, aplicações prioritárias e responsável pela aprovação estiverem confirmados ou explicitamente registrados como desconhecidos.

O arquivo compilado é uma base de trabalho, não aprovação automática da estratégia. A skill especialista de cada etapa deve tensionar e validar o conteúdo antes de tratá-lo como definição final.

Comments

Markdown supported