Golden Briefing Schema

El Golden Briefing es el contrato versionado entre el Strategist y el resto del workflow. Todos los agentes downstream lo leen. Solo el Strategist lo escribe (y solo tras aprobación en el gate humano).

Se produce un Golden Briefing por stream. El plan comercial mensual tiene 2 streams (Growth-Value combinado y Dispositivos), por lo que se producen 2 Golden Briefings independientes. Dentro del stream Growth-Value, Growth y Value son sub-corrientes con corrientes de demanda distintas.

Principios

1. JSON-parseable, no prosa. Un humano puede leerlo, pero un agente lo consume sin ambiguedad.
2. Versionado. Cada cambio es una nueva versión con diff y rationale.
3. Trazable. Cada campo referencia su evidencia en el documento original (rango de página, parrafo o cita).
4. Permisivo con gaps. Los campos pueden estar vacios o marcados como pending con razon. La rúbrica detecta y la pregunta va al formulario.

Schema completo (v2)

brief:
  # Identidad
  id: "uuid-v4"
  version: 1                                # int, incremental
  previous_version: null                    # int de versión anterior o null
  case_id: "string"                         # ej. "growth-value-agosto-26"
  stream: "growth-value|dispositivos"        # obligatorio
  client: "string"                          # ej. "Movistar"
  periodo: "string"                         # ej. "Julio 2026"
  created_by: "agente-a"
  created_at: "ISO8601"

  # Documento(s) fuente
  source_documents:
    - filename: "string"
      format: "pptx|xlsx|docx|pdf|md|email"
      rol: "fuente|indice|contexto"          # fuente = documento del área; indice = resumen derivado; contexto = flashes e informes
      fecha_documento: "string|null"         # la que declara el propio documento (portada, cabecera), no la del archivo
      version: "string|null"                 # si el documento la declara
      pages_referenced: "string"            # ej. "1-12" o "todo"
      citas_como_fuente: 0                   # cuántas afirmaciones del brief lo citan como fuente
      hash: "sha256:..."

  # Control de cobertura: cada línea de trabajo declarada por el área tiene territorio
  cobertura_plan:
    lineas_declaradas:
      - bloque: "growth|value|dispositivos"
        linea: "string"                      # ej. "Prioridad 5" o "colectivo X con calendario de BTL propio"
        fuente: "string"                     # documento y página
        territorio: "string|null"            # territorio que la cubre
        integrada_en: "string|null"          # si no tiene territorio propio, en cuál se integra
        motivo_integracion: "string|null"
    resumen: "string"                        # ej. "14 de 14 líneas de trabajo con territorio"

  # ── Bloque 1: Lectura estratégica ──

  foco:
    statement: "string (1-2 frases: la lectura clave del mes para este stream)"
    evidence: "string"
    status: "claro|confuso|ausente"

  lectura_ejecutiva:
    puntos:                                 # 5-7 puntos estrategicos ordenados por importancia
      - texto: "string"
        procedencia: { nivel: "string", fuente: "string", validacion: "string" }
    evidence: "string"
    status: "claro|confuso|ausente"

  arquitectura_mes:                         # sustituye a mensaje_paraguas (v3.0)
    - movimiento: "string (un verbo de negocio, derivado del briefing de ESTE mes)"
      territorios: ["string"]
      racional: "string (1 frase)"
  # PROHIBIDO: mensaje_paraguas, claim_mes, idea_unica o cualquier campo que contenga
  # una promesa verbal unica para todo el stream. Eliminado en v3.0.

  cobertura_informes:                       # informes semanales de Publicidad del mes anterior
    semanas_esperadas: 4
    semanas_disponibles: 0
    semanas_faltantes: ["YYYY-MM-DD"]
    nivel_confianza: "alto|medio|bajo"      # 4/4 alto, 2-3/4 medio, 0-1/4 bajo
    procedencia: { nivel: "insight_estrategia", fuente: "string", validacion: "confirmado" }

  rendimiento_periodo_anterior:             # extraido de los informes semanales. Vacio si no hay informes.
    # Es el canal por el que el dato de rendimiento llega a B y C. Sin esto, el detalle
    # por creatividad muere en el Strategist y los agentes aguas abajo no pueden usarlo.
    por_creatividad:
      - creatividad: "string"               # codigo de la pieza tal como aparece en el informe
        campana: "string"
        territorio_asociado: "string|null"   # territorio de MAIA al que corresponde, si se puede mapear
        lectura_informe: "string"            # el juicio del informe, citado literal
        metrica_principal:                   # la que mejor sostiene una decision sobre esta pieza
          metrica: "CTR|leads|CPL|VTR|clics|interaccion"
          valor: "string"
          variacion_vs_s1: "string|null"
        metricas_secundarias:                # el resto de metricas de respuesta de la misma pieza
          - metrica: "CTR|leads|CPL|VTR|clics|interaccion"
            valor: "string"
            variacion_vs_s1: "string|null"
        semana: "YYYY-MM-DD"
        procedencia: { nivel: "insight_estrategia", fuente: "string", validacion: "confirmado" }
    por_campana:
      - campana: "string"
        reparto_soportes: "string"          # ej. "Exterior 80%, Digital 15%, Radio 5%"
        traccion_trafico: "string"          # que fuente tracciona el trafico y cuanto
        semana: "YYYY-MM-DD"
        procedencia: { nivel: "insight_estrategia", fuente: "string", validacion: "confirmado" }
    contexto_negocio:                       # ventas y similares. NO sirven para juzgar creatividades.
      - campana: "string"
        dato: "string"
        salvedad: "string"                  # lo que el propio informe advierte sobre la lectura
        semana: "YYYY-MM-DD"
        procedencia: { nivel: "insight_estrategia", fuente: "string", validacion: "confirmado" }

  flags_dato_a_validar:                     # discrepancias dentro del propio original
    - concepto: "string"
      valor_usado: "string"
      valor_alternativo: "string"
      fuente_usada: "string"
      fuente_alternativa: "string"
      accion_sugerida: "string"

  decisiones_pendientes:
    - pregunta: "string"
      depende_de: "string"                  # quien decide (área, comunicación, director, etc.)
      bloqueante: true|false
      criterion_id: 0                       # vinculado a la rúbrica
    - ...

  # ── Bloque 2: Corrientes de demanda ──

  corrientes_demanda:                       # 2-4 corrientes por stream
    - nombre: "string"                      # ej. "Ventana de futbol", "Demanda estacional de verano"
      tipo: "ventana_temporal|estacional|lanzamiento|alianza|captación|retención"
      territorios:                          # territorios que pertenecen a esta corriente
        - nombre: "string"
          descripcion: "string (1 frase: rol estratégico)"
          detalle: "string (contexto operativo)"
      fecha_clave: "string|null"            # ej. "Desde el 15 de julio"
      validacion: "string|null"             # items pendientes de validar
      procedencia: { nivel: "plan_area|insight_estrategia|propuesta", fuente: "string", validacion: "confirmado|a_validar|no_confirmado" }
    - ...

  # ── Bloque 3: Jerarquia de territorios ──

  jerarquia_territorios:
    - territorio: "string"
      prioridad: "alta|media|apoyo|condicional"
      tipo_badge: "compra|consideración|contextual|desarrollo|upsell|estacional|viaje|hogar|captación|consumo|retención|value"
      justificacion: "string"
      condicion: "string|null"              # solo si prioridad = condicional
      procedencia: { nivel: "plan_area|insight_estrategia|propuesta", fuente: "string", validacion: "confirmado|a_validar|no_confirmado" }
    - ...

  # ── Bloque 4: Audiencia y mecánica ──

  audiencia_mecanica:
    segmentos:
      - nombre: "string"                    # ej. "No cliente, solo móvil"
        descripcion: "string"
        volumen_estimado: "string|null"
        procedencia: { nivel: "string", fuente: "string", validacion: "string" }
    modelo_segmentacion: "string"           # ej. "Modelo geolocalización (2a residencia)"
    mecanica_principal: "string"            # mecánica de activación

  # ── Bloque 5: Rol de canales ──

  rol_canales:
    - canal: "string"                       # ej. "CRM / Email", "Digital", "BTL", "M+", "Tienda", "TV", "Exterior"
      mision: "string"                      # para que sirve este canal en este stream (no solo presencia)
      notas: "string|null"                  # restricciones o aclaraciones
      procedencia: { nivel: "plan_area|insight_estrategia|propuesta", fuente: "string", validacion: "confirmado|a_validar|no_confirmado" }
    - ...

  # ── Bloque 6: Recomendación de publicidad ──

  recomendacion_publicidad:
    # Sin idea unica del mes ni claim. La coherencia del periodo vive en arquitectura_mes.
    reglas_del_mes:                         # que no puede faltar, que no puede aparecer
      - texto: "string"                     # referida a un producto, canal o timing concreto
        procedencia: { nivel: "plan_area|insight_estrategia|propuesta", fuente: "string", validacion: "confirmado|a_validar|no_confirmado" }
    condiciones_legales: "string|null"
    status: "claro|confuso|ausente"

  # ── Bloque 7: Primer paso ──

  primer_paso: "string"                     # acción concreta recomendada como siguiente paso

  # ── Campos heredados (mantenidos para trazabilidad) ──

  fechas:
    inicio: "YYYY-MM-DD | null"
    fin: "YYYY-MM-DD | null"
    hitos:
      - fecha: "YYYY-MM-DD"
        descripcion: "string"
        procedencia: { nivel: "string", fuente: "string", validacion: "string" }
    evidence: "string"
    status: "claro|confuso|ausente"

  riesgos:
    - descripción: "string"
      severidad: "alta|media|baja"
      mitigacion_sugerida: "string"
    - ...

  restricciones_mandatorios:
    - tipo: "marca|operativo|legal"
      descripcion: "string"
      procedencia: { nivel: "plan_area|insight_estrategia|propuesta", fuente: "string", validacion: "confirmado|a_validar|no_confirmado" }
      # El campo `origen` queda sustituido por `procedencia.fuente` (v3.0).
    - ...

  # Evaluación contra la rúbrica
  rubric_evaluation:
    - criterion_id: "C01"
      criterion_name: "Estrategia antes que catálogo"
      status: "cubierto|parcial|ausente"
      points: 2                             # max del criterio (2 para C01-C07, 1 para C08-C14)
      score: 2                              # points x factor (cubierto=1.0, parcial=0.5, ausente=0)
      evidence: "string"
      question_for_area: "string | null"
    - ... (uno por cada uno de los 14 criterios, total max 21 pts)

  # Estado del Brief
  approval:
    status: "draft|pending|approved|superseded"
    approved_by: "human:<email>"
    approved_at: "ISO8601"
    notes: "string"

  # Outputs vinculados (rellenado por el Strategist)
  linked_outputs:
    estrategia_one_pager: "path/al/estrategia_<stream>_v<N>.html"
    formulario_area: "path/al/formulario_area_<stream>_v<N>.docx"

  # Change log (para versiones > 1)
  change_log:
    - versión: 2
      timestamp: "ISO8601"
      changes:
        - field: "jerarquia_territorios[0].prioridad"
          from: "media"
          to: "alta"
          rationale: "Respuesta del área: dispositivo flagship se confirma como prioridad máxima"
          source: "formulario_response_2026-07-03.md"

Mapeo con el schema v1 (migración)

Campo v1	Campo v2	Notas
objetivo_comunicación	foco + lectura_ejecutiva	El objetivo se descompone en foco (1 frase) y lectura ejecutiva (puntos estrategicos)
contexto_negocio	Absorbido en lectura_ejecutiva.puntos	El contexto de negocio se integra como puntos de la lectura
públicos	audiencia_mecanica.segmentos	Estructura más rica con modelo de segmentación
productos_prioritarios	corrientes_demanda[].territorios	Los productos se organizan dentro de territorios y corrientes
mensaje_principal	arquitectura_mes	La coherencia del mes son 3-4 movimientos estrategicos, no una promesa verbal unica
accion_esperada	primer_paso	Más concreto y accionable
canales_posibles	rol_canales	Cada canal tiene mision específica, no solo presencia
criterios_exito	Absorbido en corrientes_demanda[].validación + riesgos	Los criterios se vinculan a las corrientes
(nuevo)	stream	Obligatorio: identifica a que stream pertenece el brief
(nuevo)	período	Mes y ano del plan
(nuevo)	corrientes_demanda	Estructura central nueva: agrupa territorios por tipo de oportunidad
(nuevo)	jerarquia_territorios	Priorización explicita de territorios con badge tipificado
(nuevo)	arquitectura_mes	3-4 movimientos estrategicos que ordenan el mes. Sustituye a mensaje_paraguas
(nuevo)	flags_dato_a_validar	Discrepancias detectadas dentro del propio plan comercial
(nuevo)	recomendacion_publicidad	Reglas del mes para publicidad. Sin idea única ni claim: la coherencia del mes vive en arquitectura_mes

Validación

Antes de publicar un Golden Briefing, valida:

1. id, versión, case_id, stream, client, período estan presentes.
2. stream es uno de: growth-value, dispositivos.
3. Cada uno de los 14 criterios tiene una entrada en rubric_evaluation (criterion_id C01 a C14).
4. foco.statement no esta vacio si foco.status es "claro".
5. lectura_ejecutiva.puntos tiene entre 5 y 7 entradas.
6. arquitectura_mes tiene entre 3 y 4 movimientos, cada uno con al menos un territorio asignado. Todos los territorios del stream estan asignados a algun movimiento. No existe ningun campo con una promesa verbal unica para todo el stream. 6b. Toda afirmacion con valor informativo del brief tiene bloque procedencia con nivel (plan_area|insight_estrategia|propuesta), fuente concreta y validacion (confirmado|a_validar|no_confirmado). Definicion completa en la seccion 7 de contexto-sistema-maia. 6c. Toda cifra marcada validacion: "a_validar" tiene su entrada correspondiente en flags_dato_a_validar, y viceversa. Los dos conteos coinciden. 6d. cobertura_informes esta presente siempre, incluso con cero informes disponibles, y lleva su bloque procedencia. Los agentes aguas abajo lo usan para decidir si pueden apoyar una decision en datos de rendimiento. 6e. Si cobertura_informes.semanas_disponibles es mayor que cero, rendimiento_periodo_anterior no puede estar vacio: el Strategist leyo los informes y debe volcar lo que extrajo. Si es cero, rendimiento_periodo_anterior es un objeto con las tres listas vacias. 6f. Toda entrada de rendimiento_periodo_anterior.por_creatividad[] usa metricas de RESPUESTA, y solo estas seis: CTR, leads, CPL, VTR, clics, interaccion. Impactos, impresiones, frecuencia y sesiones no entran ahi: van en por_campana. Las ventas van en contexto_negocio con su salvedad. 6g. Cada entrada de por_creatividad[] tiene exactamente una metrica_principal, que es la que el Maia Copywriter copiara en evidencia_rendimiento. El resto van en metricas_secundarias. Orden de preferencia para elegir la principal: la que el propio informe destaca en su lectura, luego leads, CPL, CTR, VTR, y por ultimo clics o interaccion.
7. corrientes_demanda tiene al menos 2 entradas, cada una con al menos 1 territorio.
8. jerarquia_territorios tiene al menos 1 entrada con prioridad "alta".
9. rol_canales tiene al menos 2 entradas con mision no vacia.
10. Si decisiones_pendientes tiene entradas bloqueante: true, el approval.status no puede ser approved sin nota explicita del humano.
11. source_documents tiene al menos 1 entrada, y al menos una con rol: fuente.
12. Si versión > 1, previous_version apunta a un Brief valido y hay entrada en change_log.
13. linked_outputs.estrategia_one_pager y linked_outputs.formulario_area apuntan a archivos existentes.
14. Todas las evidence referencian el documento fuente de forma trazable.
15. Ninguna afirmación de nivel plan_area tiene como fuente un documento de rol: indice con validacion: confirmado. Si solo está en el índice, es a_validar.
16. cobertura_plan.lineas_declaradas: toda entrada tiene territorio o integrada_en. Una línea sin ninguno de los dos invalida el brief.

Mantenimiento

Cambios al schema requieren:

• Incrementar version del SKILL.
• Actualizar el prompt del Maia Strategist (agentes/01-strategist.md) con el set de campos nuevos.
• Actualizar todos los Briefs existentes con migración o marcarlos legacy.