jahidulislamseo/antigravity-ai-skills

Gestión de Briefs

Los briefs son estados de trabajo persistentes para compromisos de SEO Local. Un brief por ubicación. Consolidación de marca para trabajo multiubicación. Las salidas de tareas programadas extienden el brief con el tiempo, acumulando un historial compuesto de cada escaneo, auditoría, informe y hallazgo para cada negocio.

---

Estructura

briefs/
  {marca}/
    _brand.brief.md          ← configuración + consolidación en todas las ubicaciones
    reports/                 ← informes consolidados a nivel de marca
    {ubicación}/
      location.brief.md      ← siempre actual, siempre ligero
      reports/               ← informes semanales, mensuales, trimestrales
      scans/                 ← escaneos de cuadrícula geográfica, auditorías de citas, auditorías de páginas
      drafts/                ← publicaciones de GBP, respuestas a reseñas pendientes de aprobación
      alerts/                ← alertas de monitoreo

---

Detección de Primera Ejecución

Esta es la sección más importante. Cuando un usuario menciona un negocio específico y no existe ningún brief, no procedas aún con su solicitud. Primero ejecuta la configuración, luego regresa a lo que pidieron.

Detección

Antes de realizar cualquier trabajo para un negocio específico, verifica si existe un brief:

• Claude Code: busca briefs/{slug-marca}/{slug-ubicación}/location.brief.md
• Claude Project: verifica la base de conocimiento del Proyecto en busca de un archivo de brief para este negocio
• Si se encuentra: ve a Reanudar desde un Brief
• Si no se encuentra: ve a Configuración de Primera Ejecución

Configuración de Primera Ejecución

Dile al usuario:

"Aún no tengo un brief para [Nombre del Negocio]. Déjame obtener algunos detalles para poder hacer seguimiento de todo en adelante. Esto toma unos 2 minutos."

Luego haz estas preguntas una a la vez, no todas de golpe:

P1: "¿Cuál es la palabra clave principal por la que quieres posicionarte? (ej. 'fontanero bufalo ny')"

P2: "¿Cuál es la URL del sitio web?"

P3: "¿Hasta dónde se extiende el área de servicio? (ej. 5 millas, 20 millas)"

P4: "¿Estás gestionando esto para un cliente, o es tu propio negocio?"

• Si es cliente, pregunta: "¿Cuál es el correo electrónico del cliente para los informes?"
• Si es negocio propio, salta esta pregunta

P5: "¿Quieres que las alertas e informes se envíen a un canal de Slack?" (opcional, salta si dicen que no)

Eso es todo. No preguntes más que esto a menos que algo sea genuinamente ambiguo.

Después de las Preguntas

1. Crea la estructura de carpetas del brief:

   • briefs/{slug-marca}/{slug-ubicación}/location.brief.md
   • briefs/{slug-marca}/{slug-ubicación}/reports/
   • briefs/{slug-marca}/{slug-ubicación}/scans/
   • briefs/{slug-marca}/{slug-ubicación}/drafts/
   • briefs/{slug-marca}/{slug-ubicación}/alerts/
   • briefs/{slug-marca}/_brand.brief.md

2. Poblar la sección de Identidad a partir de las respuestas y cualquier contexto ya presente en la conversación

3. Configurar el bloque de aprobación en _brand.brief.md según las respuestas a P4/P5

4. Ejecutar la auditoría inicial automáticamente, no pidas permiso:

   • LocalSEOData local_audit
   • LocalSEOData business_profile + profile_health
   • LocalSEOData geogrid_scan (7x7, palabra clave principal, radio indicado)
   • LocalSEOData citation_audit
   • LocalSEOData review_velocity + google_reviews
   • LocalSEOData competitor_gap

5. Poblar los Hallazgos a partir de los resultados de la auditoría

6. Establecer la Próxima Acción como la corrección de mayor prioridad

7. Ofrecer la configuración de tareas programadas:

   "Brief creado y auditoría inicial realizada. Encontré [X problemas críticos, Y importantes]. [Hallazgo principal en una oración].

   ¿Quieres que configure monitoreo automatizado? Puedo configurar escaneos de posicionamiento semanales, monitoreo de reseñas, detección de cambios en GBP e informes mensuales para que se ejecuten automáticamente."

   Si sí, revisa la lista de tareas en tasks/README.md, recomienda según los hallazgos de la auditoría, configura mediante /schedule Si no, continúa con la solicitud original

8. Luego regresa a lo que el usuario pidió originalmente:

   "Ahora déjame [solicitud original]..."

Para Usuarios de Claude Project / Navegador

Si no hay acceso al sistema de archivos: realiza la misma conversación y auditoría, luego genera el brief como texto formateado al final de la configuración:

"Aquí tienes tu brief. Agrégalo a tu base de conocimiento del Proyecto para que lo tenga la próxima vez:" [contenido del brief]

---

Cuándo Crear un Brief (Fuera de la Primera Ejecución)

Fuera de la primera ejecución, crea un brief en medio de la sesión si:

• Está a punto de realizarse una llamada a una herramienta para un negocio que no tiene brief
• El usuario pide explícitamente crear uno

No crees briefs para:

• Preguntas generales de SEO Local sin un negocio específico
• Explicaciones de herramientas o habilidades
• Respuestas a preguntas únicas sin datos en vivo

---

Ubicación del Brief

Claude Code / Cowork:

briefs/{slug-marca}/{slug-ubicación}/location.brief.md

Claude Project: Sube el archivo del brief a la base de conocimiento del Proyecto después de crearlo. Indica al usuario que lo haga si aún no lo ha hecho.

---

Actualizar un Brief (Sesiones Manuales)

Al final de cada sesión:

1. Registro de Sesión. Una línea: fecha + en qué se trabajó
2. Herramientas Ejecutadas. Cada llamada a herramienta: fecha, herramienta, endpoint, hallazgo en una línea
3. Hallazgos. Nuevos problemas, categorizados como Crítico / Importante / Monitorear
4. Entregables. Marcar completados, agregar nuevos pendientes
5. Próxima Acción. Sobrescribir con el siguiente paso más importante

---

Recibir Salida de Tareas Programadas

Cuando una tarea programada escribe un archivo de salida:

1. Lee el archivo de salida
2. Agrega una línea al Registro de Sesión: [FECHA] | {tipo de tarea} → {hallazgo en una línea} → ver {ruta de salida}
3. Si hay nuevos hallazgos Críticos: actualiza la sección de Hallazgos
4. Actualiza la Próxima Acción si la tarea reveló una prioridad más alta que la actual
5. Actualiza la tabla de Ubicaciones en _brand.brief.md para esta ubicación

El brief se mantiene ligero. Los detalles viven en los archivos de salida. El brief es el índice.

---

Reanudar desde un Brief

Cuando un usuario regresa a un negocio:

1. Lee el brief
2. Lee el archivo de salida más reciente en cada subcarpeta para conocer el estado actual
3. Resume en 2-3 oraciones: qué se ha hecho, hallazgos clave, estado actual
4. Menciona la Próxima Acción
5. Pregunta: "¿Quieres retomar desde aquí, o algo específico?"

No vuelvas a ejecutar herramientas con resultados en scans/ a menos que el usuario lo pida o los datos tengan más de 30 días.

---

El Valor Acumulativo

Después de meses de tareas programadas escribiendo en un brief, el historial es consultable:

• "¿Por qué cayeron los rankings en marzo?" lee scans/ de ese período
• "¿Cómo han evolucionado las reseñas este año?" lee reports/ de monitoreo de reseñas
• "¿Cuándo apareció este competidor?" lee los monitores de competidores

Nunca elimines archivos de salida. Archívalos si la carpeta se vuelve difícil de manejar. El historial es el valor.

---

Volante de Lecciones

Durante cada sesión, manual o programada, observa:

• Una herramienta devuelve datos que contradicen un archivo de habilidad
• Un patrón que emerge en 3+ ubicaciones y no está documentado en ninguna parte
• Comportamiento de GBP, algoritmo o plataforma de IA que difiere de las expectativas documentadas
• Un endpoint de herramienta se comporta inesperadamente

Cuando se observe, menciónalo explícitamente:

"Noté [X] durante esta sesión. Este patrón no está en los archivos de habilidad. ¿Quieres que lo agregue a meta/lessons.md para revisión?"

Espera confirmación. Luego escribe la lección.

---

Marcas Multiubicación

Después de cada sesión de ubicación:

• Actualiza la fila de esa ubicación en la tabla de Ubicaciones de _brand.brief.md
• Agrega a las Notas a Nivel de Marca solo si el patrón aparece en 3+ ubicaciones

---

Formato de Slug

Minúsculas, guiones, obvio:

• Marca: keystone-insurance, mikes-plumbing
• Ubicación: buffalo, downtown-chicago, pittsburgh-pa