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.