jahidulislamseo/antigravity-ai-skills

Gestion des briefs

Les briefs sont un état de travail persistant pour les engagements SEO locaux. Un brief par établissement. Consolidation de la marque pour le travail multi-localisations. Les sorties des tâches planifiées prolongent le brief au fil du temps, créant un historique cumulatif de chaque scan, audit, rapport et constatation pour chaque entreprise.

---

Structure

briefs/
  {marque}/
    _brand.brief.md          ← configuration + consolidation de toutes les localisations
    reports/                 ← rapports de consolidation au niveau de la marque
    {localisation}/
      location.brief.md      ← toujours à jour, toujours concis
      reports/               ← rapports hebdomadaires, mensuels, trimestriels
      scans/                 ← scans géogrille, audits de citations, audits de pages
      drafts/                ← publications GBP, réponses aux avis en attente d'approbation
      alerts/                ← alertes de surveillance

---

Détection de première exécution

Ceci est la section la plus importante. Lorsqu'un utilisateur mentionne une entreprise spécifique et qu'aucun brief n'existe, ne procédez pas encore à sa demande. Exécutez d'abord la configuration, puis revenez à ce qu'il a demandé.

Détection

Avant d'effectuer tout travail pour une entreprise spécifique, vérifiez l'existence d'un brief :

• Claude Code : cherchez briefs/{slug-marque}/{slug-localisation}/location.brief.md
• Projet Claude : vérifiez la base de connaissances du Projet pour un fichier de brief pour cette entreprise
• Si trouvé : allez à Reprise à partir d'un brief
• Si non trouvé : allez à Configuration de première exécution

Configuration de première exécution

Dites à l'utilisateur :

« Je n'ai pas encore de brief pour [Nom de l'entreprise]. Laissez-moi obtenir quelques informations pour que je puisse tout suivre à l'avenir. Cela prend environ 2 minutes. »

Puis posez ces questions une à la fois, pas toutes en même temps :

Q1 : « Quel est le mot-clé principal pour lequel vous souhaitez vous classer ? (ex. 'plombier buffalo ny') »

Q2 : « Quelle est l'URL du site web ? »

Q3 : « Jusqu'où s'étend la zone de service ? (ex. 5 miles, 20 miles) »

Q4 : « Gérez-vous cela pour un client, ou s'agit-il de votre propre entreprise ? »

• Si client, demandez : « Quel est l'email du client pour les rapports ? »
• Si propre entreprise, passez

Q5 : « Souhaitez-vous recevoir des alertes et des rapports sur un canal Slack ? » (facultatif, passez s'il dit non)

C'est tout. Ne demandez pas plus que cela, sauf si quelque chose est réellement ambigu.

Après les questions

1. Créez la structure de dossiers du brief :

   • briefs/{slug-marque}/{slug-localisation}/location.brief.md
   • briefs/{slug-marque}/{slug-localisation}/reports/
   • briefs/{slug-marque}/{slug-localisation}/scans/
   • briefs/{slug-marque}/{slug-localisation}/drafts/
   • briefs/{slug-marque}/{slug-localisation}/alerts/
   • briefs/{slug-marque}/_brand.brief.md

2. Remplissez la section Identité à partir des réponses et de tout contexte déjà présent dans la conversation

3. Configurez le bloc d'approbation de _brand.brief.md à partir des réponses Q4/Q5

4. Exécutez automatiquement un audit initial, ne demandez pas la permission :

   • LocalSEOData local_audit
   • LocalSEOData business_profile + profile_health
   • LocalSEOData geogrid_scan (7x7, mot-clé principal, rayon indiqué)
   • LocalSEOData citation_audit
   • LocalSEOData review_velocity + google_reviews
   • LocalSEOData competitor_gap

5. Remplissez les Constatations à partir des résultats de l'audit

6. Définissez la Prochaine action comme la correction la plus prioritaire

7. Proposez la configuration de tâches planifiées :

   « Brief créé et audit initial effectué. J'ai trouvé [X problèmes critiques, Y problèmes importants]. [Constatation principale en une phrase].

   Voulez-vous que je configure une surveillance automatisée ? Je peux configurer des scans de classement hebdomadaires, la surveillance des avis, la détection des modifications GBP et des rapports mensuels à exécuter automatiquement. »

   Si oui, parcourez la liste des tâches de tasks/README.md, recommandez en fonction des constatations de l'audit, configurez via /schedule Si non, procédez à la demande originale

8. Revenez ensuite à ce que l'utilisateur a demandé initialement :

   « Maintenant, laissez-moi [demande originale]... »

Pour les utilisateurs de Projet Claude / Navigateur

Si aucun accès au système de fichiers : exécutez la même conversation et le même audit, puis produisez le brief sous forme de texte formaté à la fin de la configuration :

« Voici votre brief. Ajoutez-le à la base de connaissances de votre Projet pour que je l'aie la prochaine fois : » [contenu du brief]

---

Quand créer un brief (hors première exécution)

En dehors de la première exécution, créez un brief en cours de session si :

• Un appel d'outil est sur le point d'être effectué pour une entreprise sans brief
• L'utilisateur demande explicitement d'en créer un

Ne créez pas de briefs pour :

• Des questions générales de SEO local sans entreprise spécifique
• Des explications d'outils ou de compétences
• Des réponses à une seule question sans données en direct

---

Emplacement du brief

Claude Code / Cowork :

briefs/{slug-marque}/{slug-localisation}/location.brief.md

Projet Claude : Téléchargez le fichier de brief dans la base de connaissances du Projet après la création. Dites à l'utilisateur de le faire s'il ne l'a pas fait.

---

Mise à jour d'un brief (sessions manuelles)

À la fin de chaque session :

1. Journal de session. Une ligne : date + ce qui a été travaillé
2. Outils exécutés. Chaque appel d'outil : date, outil, point d'accès, constatation en une ligne
3. Constatations. Nouveaux problèmes, classés Critique / Important / Surveiller
4. Livrables. Marquez comme terminés, ajoutez de nouveaux en attente
5. Prochaine action. Remplacez par l'étape suivante la plus importante

---

Réception des sorties de tâches planifiées

Lorsqu'une tâche planifiée écrit un fichier de sortie :

1. Lisez le fichier de sortie
2. Ajoutez une ligne au Journal de session : [DATE] | {type de tâche} → {constatation en une ligne} → voir {chemin de sortie}
3. Si de nouvelles constatations critiques : mettez à jour la section Constatations
4. Mettez à jour la Prochaine action si la tâche a révélé une priorité plus élevée que la précédente
5. Mettez à jour la ligne de la table Localisations dans _brand.brief.md pour cette localisation

Le brief reste concis. Les détails vivent dans les fichiers de sortie. Le brief est l'index.

---

Reprise à partir d'un brief

Lorsqu'un utilisateur revient sur une entreprise :

1. Lisez le brief
2. Lisez le fichier de sortie le plus récent dans chaque sous-dossier pour l'état actuel
3. Résumez en 2-3 phrases : ce qui a été fait, les principales constatations, l'état actuel
4. Indiquez la Prochaine action
5. Demandez : « Voulez-vous reprendre là ou faire quelque chose de spécifique ? »

Ne réexécutez pas les outils avec des résultats dans scans/ sauf si l'utilisateur le demande ou si les données datent de plus de 30 jours.

---

La valeur cumulative

Après des mois de tâches planifiées écrivant dans un brief, l'historique est interrogeable :

• « Pourquoi les classements ont-ils chuté en mars ? » lit scans/ pour cette période
• « Comment les avis ont-ils évolué cette année ? » lit reports/ les surveillances d'avis
• « Quand ce concurrent est-il apparu ? » lit les surveillances de concurrents

Ne supprimez jamais les fichiers de sortie. Archivez si le dossier devient encombrant. L'historique est la valeur.

---

Roue des leçons

Pendant chaque session, manuelle ou planifiée, surveillez :

• Un outil renvoyant des données qui contredisent un fichier de compétence
• Un motif émergeant dans 3 localisations ou plus non documenté ailleurs
• Un comportement de GBP, d'algorithme ou de plateforme IA différant des attentes documentées
• Un point d'accès d'outil se comportant de manière inattendue

Lorsqu'observé, explicitez-le :

« J'ai remarqué [X] pendant cette session. Ce motif n'est pas dans les fichiers de compétences. Voulez-vous que je l'ajoute à meta/lessons.md pour examen ? »

Attendez la confirmation. Puis rédigez la leçon.

---

Marques multi-localisations

Après chaque session de localisation :

• Mettez à jour la ligne de cette localisation dans la table Localisations de _brand.brief.md
• Ajoutez aux Notes au niveau de la marque uniquement si un motif apparaît dans 3 localisations ou plus

---

Format de slug

Minuscules, traits d'union, évidents :

• Marque : keystone-insurance, mikes-plumbing
• Localisation : buffalo, downtown-chicago, pittsburgh-pa