jahidulislamseo/antigravity-ai-skills

Brief-Management

Briefings sind persistente Arbeitszustände für lokale SEO-Engagements. Ein Briefing pro Standort. Marken-Rollup für die Arbeit an mehreren Standorten. Die Ausgaben geplanter Aufgaben erweitern das Briefing im Laufe der Zeit und bauen eine fortlaufende Historie aller Scans, Audits, Berichte und Erkenntnisse für jedes Unternehmen auf.

---

Struktur

briefs/
  {brand}/
    _brand.brief.md          ← Konfiguration + Rollup über alle Standorte
    reports/                 ← Berichte auf Markenebene (Rollup)
    {location}/
      location.brief.md      ← immer aktuell, immer schlank
      reports/               ← wöchentliche, monatliche, QBR-Berichte
      scans/                 ← Geogrid-Scans, Zitierungsaudits, Seiten-Audits
      drafts/                ← GBP-Beiträge, Antworten auf Bewertungen, die auf Freigabe warten
      alerts/                ← Überwachungsbenachrichtigungen

---

Erstlauf-Erkennung

Dies ist der wichtigste Abschnitt. Wenn ein Benutzer ein bestimmtes Unternehmen erwähnt und kein Briefing existiert, fahren Sie noch nicht mit seiner Anfrage fort. Führen Sie zuerst die Einrichtung durch und kehren Sie dann zu dem zurück, was er angefordert hat.

Erkennung

Bevor Sie Arbeiten für ein bestimmtes Unternehmen durchführen, prüfen Sie auf ein vorhandenes Briefing:

• Claude Code: Suche nach briefs/{brand-slug}/{location-slug}/location.brief.md
• Claude Project: Prüfen Sie die Projekt-Wissensdatenbank auf eine Briefing-Datei für dieses Unternehmen
• Wenn gefunden: Gehen Sie zu Fortsetzen mit einem Briefing
• Wenn nicht gefunden: Gehen Sie zu Erstlauf-Einrichtung

Erstlauf-Einrichtung

Teilen Sie dem Benutzer mit:

"Ich habe noch kein Briefing für [Unternehmensname]. Lassen Sie mich ein paar Details erfassen, damit ich alles von nun an verfolgen kann. Das dauert etwa 2 Minuten."

Stellen Sie dann diese Fragen nacheinander, nicht alle auf einmal:

F1: "Was ist das primäre Keyword, für das Sie ranken möchten? (z. B. 'Klempner Berlin')"

F2: "Wie lautet die Website-URL?"

F3: "Wie weit erstreckt sich das Servicegebiet? (z. B. 5 km, 30 km)"

F4: "Verwalten Sie dies für einen Kunden, oder ist es Ihr eigenes Unternehmen?"

• Wenn Kunde: Fragen Sie: "Wie lautet die E-Mail-Adresse des Kunden für Berichte?"
• Wenn eigenes Unternehmen: Überspringen

F5: "Möchten Sie Benachrichtigungen und Berichte an einen Slack-Channel gesendet bekommen?" (optional, überspringen, wenn sie nein sagen)

Das war's. Fragen Sie nicht nach mehr als diesen, es sei denn, etwas ist wirklich unklar.

Nach den Fragen

1. Briefing-Ordnerstruktur erstellen:

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

2. Identitätsabschnitt aus den Antworten und bereits im Gespräch vorhandenem Kontext befüllen

3. _brand.brief.md-Freigabeblock aus den Antworten zu F4/F5 konfigurieren

4. Automatisch erstes Audit durchführen, nicht um Erlaubnis fragen:

   • LocalSEOData local_audit
   • LocalSEOData business_profile + profile_health
   • LocalSEOData geogrid_scan (7x7, primäres Keyword, angegebener Radius)
   • LocalSEOData citation_audit
   • LocalSEOData review_velocity + google_reviews
   • LocalSEOData competitor_gap

5. Erkenntnisse aus den Auditergebnissen befüllen

6. Nächste Aktion auf die einzelne wichtigste Korrektur setzen

7. Einrichtung geplanter Aufgaben anbieten:

   "Briefing erstellt und erstes Audit abgeschlossen. Ich habe [X kritische, Y wichtige Probleme] gefunden. [Top-Erkenntnis in einem Satz].

   Soll ich automatisierte Überwachung einrichten? Ich kann wöchentliche Ranking-Scans, Bewertungsüberwachung, GBP-Änderungserkennung und monatliche Berichte konfigurieren, die automatisch ausgeführt werden."

   Wenn ja: Aufgabenliste aus tasks/README.md durchgehen, basierend auf Audit-Ergebnissen empfehlen, über /schedule konfigurieren Wenn nein: Mit der ursprünglichen Anfrage fortfahren

8. Dann zu dem zurückkehren, was der Benutzer ursprünglich angefordert hat:

   "Nun lassen Sie mich [ursprüngliche Anfrage]..."

Für Claude Project / Browser-Benutzer

Wenn kein Dateisystemzugriff vorhanden ist: Führen Sie das gleiche Gespräch und Audit durch, geben Sie dann das Briefing als formatierten Text am Ende der Einrichtung aus:

"Hier ist Ihr Briefing. Fügen Sie dies Ihrer Projekt-Wissensdatenbank hinzu, damit ich es beim nächsten Mal habe:" [Briefing-Inhalt]

---

Wann ein Briefing erstellt werden sollte (außerhalb des Ersteinsatzes)

Außerhalb des Ersteinsatzes erstellen Sie ein Briefing während einer Sitzung, wenn:

• Ein Tool-Aufruf für ein Unternehmen ohne Briefing getätigt werden soll
• Der Benutzer explizit darum bittet, eines zu erstellen

Erstellen Sie keine Briefings für:

• Allgemeine lokale SEO-Fragen ohne konkretes Unternehmen
• Tool- oder Fähigkeitserklärungen
• Einzelfragen mit keinen Live-Daten

---

Briefing-Speicherort

Claude Code / Cowork:

briefs/{brand-slug}/{location-slug}/location.brief.md

Claude Project: Laden Sie die Briefing-Datei nach der Erstellung in die Projekt-Wissensdatenbank hoch. Sagen Sie dem Benutzer, er solle dies tun, falls er es noch nicht getan hat.

---

Aktualisieren eines Briefings (manuelle Sitzungen)

Am Ende jeder Sitzung:

1. Sitzungsprotokoll. Eine Zeile: Datum + woran gearbeitet wurde
2. Ausgeführte Tools. Jeder Tool-Aufruf: Datum, Tool, Endpunkt, einzeilige Erkenntnis
3. Erkenntnisse. Neue Probleme, kategorisiert als Kritisch / Wichtig / Überwachen
4. Liefergegenstände. Als erledigt markieren, neue ausstehende hinzufügen
5. Nächste Aktion. Mit dem wichtigsten nächsten Schritt überschreiben

---

Empfang geplanter Aufgabenausgaben

Wenn eine geplante Aufgabe eine Ausgabedatei schreibt:

1. Lesen Sie die Ausgabedatei
2. Fügen Sie eine Zeile zum Sitzungsprotokoll hinzu: [DATUM] | {Aufgabentyp} → {einzeilige Erkenntnis} → siehe {Ausgabepfad}
3. Wenn neue kritische Erkenntnisse: Aktualisieren Sie den Abschnitt Erkenntnisse
4. Aktualisieren Sie die nächste Aktion, wenn die Aufgabe eine höhere Priorität als die aktuelle aufgedeckt hat
5. Aktualisieren Sie die Zeile des Standorts in der Tabelle Standorte in _brand.brief.md

Das Briefing bleibt schlank. Details leben in den Ausgabedateien. Das Briefing ist der Index.

---

Fortsetzen mit einem Briefing

Wenn ein Benutzer zu einem Unternehmen zurückkehrt:

1. Lesen Sie das Briefing
2. Lesen Sie die aktuellste Ausgabedatei in jedem Unterordner für den aktuellen Zustand
3. Fassen Sie in 2-3 Sätzen zusammen: was getan wurde, wichtigste Erkenntnisse, aktueller Zustand
4. Nennen Sie die nächste Aktion
5. Fragen Sie: "Möchten Sie hier weitermachen, oder etwas Bestimmtes?"

Führen Sie keine Tools mit Ergebnissen in scans/ erneut aus, es sei denn, der Benutzer fragt danach oder die Daten sind älter als 30 Tage.

---

Der kumulative Wert

Nach Monaten, in denen geplante Aufgaben in ein Briefing geschrieben haben, ist die Historie abfragbar:

• "Warum sind die Rankings im März gefallen?" liest scans/ für diesen Zeitraum
• "Wie haben sich die Bewertungen in diesem Jahr entwickelt?" liest reports/-Bewertungsmonitore
• "Wann ist dieser Wettbewerber aufgetaucht?" liest Wettbewerbermonitore

Löschen Sie niemals Ausgabedateien. Archivieren Sie, wenn der Ordner unhandlich wird. Die Historie ist der Wert.

---

Lessons-Flywheel

Während jeder Sitzung, manuell oder geplant, achten Sie auf:

• Ein Tool, das Daten zurückgibt, die einer Fähigkeitsdatei widersprechen
• Ein Muster, das bei 3+ Standorten auftritt und nirgendwo dokumentiert ist
• Verhalten von GBP, Algorithmus oder KI-Plattform, das von dokumentierten Erwartungen abweicht
• Ein Tool-Endpunkt, der sich unerwartet verhält

Wenn beobachtet, machen Sie es explizit:

"Mir ist [X] während dieser Sitzung aufgefallen. Dieses Muster ist nicht in den Fähigkeitsdateien. Soll ich es zur Überprüfung zu meta/lessons.md hinzufügen?"

Warten Sie auf Bestätigung. Schreiben Sie dann die Lektion.

---

Multi-Location-Marken

Nach jeder Standortsitzung:

• Aktualisieren Sie die Zeile dieses Standorts in der Tabelle Standorte in _brand.brief.md
• Fügen Sie zu Markennotizen hinzu, nur wenn ein Muster bei 3+ Standorten auftritt

---

Slug-Format

Kleinbuchstaben, Bindestriche, offensichtlich:

• Marke: keystone-insurance, mikes-plumbing
• Standort: berlin, zentrum-münchen, hamburg