Schema v0.2 · Markdown · YAML · JSON · CSS

Context Catalog Schema v0.2

This is an early working schema for packaging brand, product, audience, and creative context for AI creative systems. Fields are grouped into five Records. Expect changes as we learn what's useful.

Brand & Product

What is factually true about the product, and how the brand sounds and looks.

product

01 / 12

The thing being marketed. Facts the brand will stand behind.

FieldDescriptionExample
nameProduct name as it appears in market.CoolGrip
categoryPlain-English category.Golf glove
materialsNotable materials or components.[synthetic leather, silicone]

voice

06 / 12

How the brand sounds in writing.

FieldDescriptionExample
attributesVoice descriptors.[calm, direct, non-jargon]
avoidWords or patterns to avoid.[hype, urgency, exclamation marks]

visual_rules

07 / 12

How the brand should look on screen.

FieldDescriptionExample
paletteApproved colors.[#0d0d0d, #f5f3ee]
typographyApproved typefaces.[Inter, JetBrains Mono]

Audience

Who the product is for, and when it becomes relevant in their life.

audience

02 / 12

Who the product is for, in plain language.

FieldDescriptionExample
primaryMain intended buyer.Weekend golfers aged 30–60
secondaryOther meaningful buyer groups.Gift buyers near holidays

moments

03 / 12

When the product becomes relevant in a person's life.

FieldDescriptionExample
triggersSituations that surface a need.Replacing a worn glove before a round

Claims & Proof

What the brand can say, and the evidence that stands behind it.

claims

04 / 12

Approved language the brand can use without legal or factual issues.

FieldDescriptionExample
approvedClaims cleared for use as-is.[All-weather grip, Machine-washable]
requires_substantiationClaims that need proof attached.Outlasts standard gloves by 2x

proof_points

05 / 12

Evidence that supports the claims — specs, tests, certifications.

FieldDescriptionExample
itemsShort statements with a source.Independent wet-grip test, 2025

Creative Guardrails

What AI creative systems may generate, and what is off-limits.

approved_scenes

08 / 12

Scene types AI creative tools can safely generate.

FieldDescriptionExample
itemsShort scene descriptions.Glove on a club grip outdoors

prohibited_scenes

09 / 12

Scene types or imagery the brand will not allow.

FieldDescriptionExample
itemsShort scene descriptions.Tour pros or sponsored athletes

Performance & Preferences

Working theories, what's already been learned, and how outputs should be shaped.

creative_hypotheses

10 / 12

Working theories about what creative will perform.

FieldDescriptionExample
itemsHypothesis statements to test.Real terrain footage outperforms studio shots

performance_learnings

11 / 12

What's already been learned from previous creative.

FieldDescriptionExample
itemsShort, sourced learnings.Short-form video CTR doubled vs. static, Q1 2026

output_preferences

12 / 12

Defaults the brand prefers when AI generates new creative.

FieldDescriptionExample
formatsPreferred output formats.[9:16 video, 1:1 image]
lengthPreferred copy length.Under 90 characters