Golden Briefing Schema

Defines a versioned, JSON-parseable briefing schema for multi-agent marketing campaign workflows.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/Superreal-io/maia-campaign-skills --skill golden-briefing-schema-superreal-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Golden Briefing Schema
Source: https://github.com/Superreal-io/maia-campaign-skills/tree/main/golden-briefing-schema
Command: npx skills add https://github.com/Superreal-io/maia-campaign-skills --skill golden-briefing-schema-superreal-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Marketing campaign workflows with multiple AI agents break down when the strategic brief is ambiguous prose. This Skill defines a canonical, versioned, JSON-parseable contract (the Golden Briefing) that the Strategist agent produces and downstream agents consume as ground truth, eliminating ambiguity and lost context between agents. ## Core Features & Use Cases - Canonical Schema Definition: Specifies every field of the Golden Briefing, from strategic focus and demand currents to territory hierarchy, channel roles, and prior-period performance data. - Traceability and Provenance: Requires every informative claim to carry a procedencia block (level, source, validation status) and evidence references to source documents. - Validation Checklist: Ships 14+ validation rules covering rubric evaluation, performance metrics, coverage of weekly reports, and approval gating before publication. - Use Case: A Strategist agent reads a client's monthly commercial plan (PPTX/XLSX), produces one Golden Briefing per stream (growth-value and dispositivos), and downstream copywriting and media agents consume it without re-interpreting the source documents. ## Quick Start Use the Golden Briefing Schema to validate this draft briefing JSON for the growth-value stream and list every rule it violates.

Frequently Asked Questions about Golden Briefing Schema

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a marketing brief for multi-agent AI workflows?▼

Use a versioned, JSON-parseable schema like the Golden Briefing, where each field carries provenance metadata (level, source, validation status). This lets downstream agents consume the brief programmatically without re-reading source documents.

What is a Golden Briefing in campaign planning?▼

A Golden Briefing is a versioned contract produced by the Strategist agent and consumed by downstream agents as ground truth. One brief is produced per stream (growth-value or dispositivos), and only the Strategist writes it after human gate approval.

How do I validate a strategic briefing before publishing it?▼

Run the schema's validation checklist: required identity fields, 5-7 executive reading points, 3-4 monthly architecture movements, at least 2 demand currents, rubric entries for all 14 criteria, and traceable evidence for every claim.

Can the schema handle missing or unconfirmed data?▼

Yes. Fields can be empty or marked pending with a reason, figures flagged a_validar must appear in flags_dato_a_validar, and blocking open decisions prevent approval status without an explicit human note.

How does performance data from previous campaigns reach downstream agents?▼

Through the rendimiento_periodo_anterior block, which the Strategist fills from weekly reports. It separates per-creativity response metrics (CTR, leads, CPL, VTR, clicks, interaction) from per-campaign delivery data and business context.

What are the limitations of this briefing schema?▼

It is a documentation-only schema with no executable validation scripts, so enforcement depends on the agent following the checklist. It is also tailored to a specific two-stream monthly planning workflow and requires migration when the schema version changes.