jahidulislamseo/antigravity-ai-skills

Gerenciamento de Briefs

Briefs são estados de trabalho persistentes para engajamentos de SEO Local. Um brief por localização. Consolidação de marca para trabalho em várias localizações. Saídas de tarefas agendadas estendem o brief ao longo do tempo, construindo um histórico cumulativo de cada varredura, auditoria, relatório e descoberta para cada negócio.

---

Estrutura

briefs/
  {marca}/
    _marca.brief.md          ← config + consolidação em todas as localizações
    reports/                 ← relatórios consolidados da marca
    {localizacao}/
      localizacao.brief.md   ← sempre atual, sempre enxuto
      reports/               ← relatórios semanais, mensais, trimestrais
      scans/                 ← varreduras de grade geográfica, auditorias de citação, auditorias de página
      drafts/                ← posts do GBP, respostas a avaliações aguardando aprovação
      alerts/                ← alertas de monitoramento

---

Detecção de Primeira Execução

Esta é a seção mais importante. Quando um usuário menciona um negócio específico e nenhum brief existe, não prossiga com a solicitação ainda. Execute a configuração primeiro, depois retorne ao que foi solicitado.

Detecção

Antes de realizar qualquer trabalho para um negócio específico, verifique se existe um brief:

• Claude Code: procure por briefs/{slug-da-marca}/{slug-da-localizacao}/localizacao.brief.md
• Projeto Claude: verifique a base de conhecimento do Projeto em busca de um arquivo de brief para este negócio
• Se encontrado: vá para Retomando a partir de um Brief
• Se não encontrado: vá para Configuração de Primeira Execução

Configuração de Primeira Execução

Diga ao usuário:

"Ainda não tenho um brief para [Nome do Negócio]. Deixe-me obter alguns detalhes para que eu possa acompanhar tudo daqui para frente. Isso leva cerca de 2 minutos."

Em seguida, faça estas perguntas uma de cada vez, não todas de uma vez:

P1: "Qual é a palavra-chave principal que você deseja ranquear? (ex.: 'encanador bufalo ny')"

P2: "Qual é o URL do site?"

P3: "Até onde se estende a área de serviço? (ex.: 5 milhas, 20 milhas)"

P4: "Você está gerenciando isso para um cliente, ou é para o seu próprio negócio?"

• Se for cliente, pergunte: "Qual é o e-mail do cliente para os relatórios?"
• Se for próprio negócio, pule

P5: "Você quer receber alertas e relatórios em um canal do Slack?" (opcional, pule se disser não)

É só isso. Não pergunte mais do que isso, a menos que algo seja genuinamente ambíguo.

Após as Perguntas

1. Crie a estrutura de pastas do brief:

   • briefs/{slug-da-marca}/{slug-da-localizacao}/localizacao.brief.md
   • briefs/{slug-da-marca}/{slug-da-localizacao}/reports/
   • briefs/{slug-da-marca}/{slug-da-localizacao}/scans/
   • briefs/{slug-da-marca}/{slug-da-localizacao}/drafts/
   • briefs/{slug-da-marca}/{slug-da-localizacao}/alerts/
   • briefs/{slug-da-marca}/_marca.brief.md

2. Preencha a seção Identidade a partir das respostas e de qualquer contexto já presente na conversa

3. Configure o bloco de aprovação em _marca.brief.md a partir das respostas das P4/P5

4. Execute a auditoria inicial automaticamente, não peça permissão:

   • LocalSEOData local_audit
   • LocalSEOData business_profile + profile_health
   • LocalSEOData geogrid_scan (7x7, palavra-chave principal, raio informado)
   • LocalSEOData citation_audit
   • LocalSEOData review_velocity + google_reviews
   • LocalSEOData competitor_gap

5. Preencha Descobertas a partir dos resultados da auditoria

6. Defina Próxima Ação como a correção de maior prioridade

7. Ofereça a configuração de tarefas agendadas:

   "Brief criado e auditoria inicial concluída. Encontrei [X problemas críticos, Y problemas importantes]. [Principal descoberta em uma frase].

   Quer que eu configure o monitoramento automatizado? Posso configurar varreduras semanais de ranking, monitoramento de avaliações, detecção de alterações no GBP e relatórios mensais para executar automaticamente."

   Se sim, percorra a lista de tarefas em tasks/README.md, recomende com base nos resultados da auditoria, configure via /schedule Se não, prossiga com a solicitação original

8. Em seguida, retorne ao que o usuário solicitou originalmente:

   "Agora, deixe-me [solicitação original]..."

Para Usuários de Projeto Claude / Navegador

Se não houver acesso ao sistema de arquivos: execute a mesma conversa e auditoria, depois gere o brief como texto formatado ao final da configuração:

"Aqui está o seu brief. Adicione isso à base de conhecimento do seu Projeto para que eu o tenha na próxima vez:" [conteúdo do brief]

---

Quando Criar um Brief (Fora da Primeira Execução)

Fora da primeira execução, crie um brief no meio da sessão se:

• Uma chamada de ferramenta estiver prestes a ser feita para um negócio sem brief
• O usuário solicitar explicitamente a criação de um

Não crie briefs para:

• Perguntas gerais de SEO Local sem um negócio específico
• Explicações de ferramentas ou habilidades
• Respostas a perguntas únicas sem dados em tempo real

---

Localização do Brief

Claude Code / Cowork:

briefs/{slug-da-marca}/{slug-da-localizacao}/localizacao.brief.md

Projeto Claude: Faça upload do arquivo do brief para a base de conhecimento do Projeto após a criação. Diga ao usuário para fazer isso se ainda não o fez.

---

Atualizando um Brief (Sessões Manuais)

Ao final de cada sessão:

1. Registro de Sessão. Uma linha: data + o que foi trabalhado
2. Ferramentas Executadas. Cada chamada de ferramenta: data, ferramenta, endpoint, descoberta em uma linha
3. Descobertas. Novos problemas, categorizados como Crítico / Importante / Monitorar
4. Entregas. Marque como concluídas, adicione novas pendentes
5. Próxima Ação. Substitua pela etapa mais importante a seguir

---

Recebendo Saída de Tarefa Agendada

Quando uma tarefa agendada grava um arquivo de saída:

1. Leia o arquivo de saída
2. Adicione uma linha ao Registro de Sessão: [DATA] | {tipo de tarefa} → {descoberta em uma linha} → ver {caminho da saída}
3. Se houver novas descobertas Críticas: atualize a seção Descobertas
4. Atualize a Próxima Ação se a tarefa revelou uma prioridade maior que a atual
5. Atualize a linha de Tabela de Localizações em _marca.brief.md para esta localização

O brief permanece enxuto. Os detalhes ficam nos arquivos de saída. O brief é o índice.

---

Retomando a partir de um Brief

Quando um usuário retorna a um negócio:

1. Leia o brief
2. Leia o arquivo de saída mais recente em cada subpasta para o estado atual
3. Resuma em 2-3 frases: o que foi feito, principais descobertas, estado atual
4. Informe a Próxima Ação
5. Pergunte: "Quer continuar daqui, ou algo específico?"

Não reexecute ferramentas com resultados em scans/ a menos que o usuário solicite ou os dados tenham mais de 30 dias.

---

O Valor Cumulativo

Após meses de tarefas agendadas gravando em um brief, o histórico é consultável:

• "Por que as classificações caíram em março?" lê scans/ daquele período
• "Como as avaliações têm evoluído este ano?" lê reports/monitores de avaliação
• "Quando este concorrente apareceu?" lê monitores de concorrente

Nunca exclua arquivos de saída. Arquive se a pasta ficar muito grande. O histórico é o valor.

---

Ciclo de Aprendizado (Lessons Flywheel)

Durante cada sessão, manual ou agendada, fique atento a:

• Ferramenta retornando dados que contradizem um arquivo de habilidade
• Um padrão emergindo em 3+ localizações não documentado em nenhum lugar
• Comportamento do GBP, algoritmo ou plataforma de IA diferente das expectativas documentadas
• Um endpoint de ferramenta se comportando inesperadamente

Quando observado, torne explícito:

"Notei [X] durante esta sessão. Esse padrão não está nos arquivos de habilidade. Quer que eu adicione a meta/lessons.md para revisão?"

Aguarde a confirmação. Em seguida, escreva a lição.

---

Marcas com Múltiplas Localizações

Após cada sessão de localização:

• Atualize a linha dessa localização na tabela de Localizações em _marca.brief.md
• Adicione às Notas de Nível de Marca apenas se o padrão aparecer em 3+ localizações

---

Formato do Slug

Minúsculas, hífens, óbvio:

• Marca: keystone-insurance, mikes-plumbing
• Localização: buffalo, downtown-chicago, pittsburgh-pa