Specification

revenue design system

MESSAGE.md is a dynamic messaging specification for agents built to keep AI-generated content consistent, relevant, and uniquely yours - without breaking the token bank.

Check the spec
MESSAGE.md
---
company:Acme, Inc.
version:1.0
maintained-by:Product Marketing
---
## Attributes
// Market framing to set the right altitude
## Facts
// Quick company reference
...
Elements

the messaging house

codified positioning and messaging that defines the brand, the audience, and the portfolio - with the proof to back it up

Assets
define the shape

Structured documents for what every asset type looks like for you, with the conventions to design and produce.

Collections
hold the details

Granular profiles loaded on demand for specific personas, products, competitors, segments, and more.

Pillars
tell the story

Foundational messaging documents — the company, narrative, market, audience, and portfolio, with the proof to back it all up.

MESSAGE.md
sets the altitude

Company facts, glossary of terms, brand guardrails, and scenario dimensions. Agents load this first, always-on.

Runtime

the messaging room

the right message, at the right time, for the right reasons

Compelling event
analyst-report · competitor-news · customer-win · market-event
Market moment
category-disruption · regulatory-shift · consolidation
Strategic shape
new-product · strategic-event · brand-campaign · thought-leadership
Content lens
Awareness · Acquisition · Activation · Adoption · Advocacy · Amplification
Load

MESSAGE.md loads first — attributes, glossary, guardrails, and the scenario vocabulary. Always on.

Infer

The agent reads the task and combines the four dimensions into the scenario at hand.

Assemble

Only the pillars, collections, and assets whose Load When conditions match get pulled in.

The result is tightly scoped context assembled per task — not the entire messaging house in every prompt. Message optimized, token optimized.

Runtime — alt

the messaging room

the right message, at the right time, for the right reasons

the messaging house
Profile
Pitch
Personas
Position
Products
Portfolio
Categories
People
Competitors
Segments
Proof
Stories
runtime assemblyby scenario
the messaging room
categories/zero-trust.mdthe market frame to align to
products/access-manager.mdthe one product in scope
segments/financial-services.mdthe industry slice in play
personas/ciso.mdthe named buyer role
stories/regional-bank.mdthe customer proof that matches

The result is tightly scoped context assembled per task — not the entire messaging house in every prompt. Message optimized, token optimized.

Factory

the content factory

one scenario in, a full set of on-message assets out

step 01
Determine Scenario

Infer dimensions from user/agent input.

step 02
Build Room

Load the relevant messaging context.

step 03
Run Builder

Work through guided session to lock POV.

step 04
Write Plan

Determine key messages and asset selections.

step 05
Generate Assets

Subagents spawn to write from the plan.

step 06
Handoff to Production

Plug into templates or pass to design tools.

Design principles

why it holds up

pluggable architecture

Drop MESSAGE.md and the messaging/ directory into any repository. Your AGENTS.md or CLAUDE.md teaches the agent how to read and use it.

runtime messaging

Assembly is driven by the scenario, so the agent delivers the right message at the right time for the right reasons.

progressive loading

Tight, per-task context assembly avoids confusion, hallucination, and bloat.

asset definitions

LLMs already know how to write. What they need is structured output and company-specific rules for better content and downstream production.

update-ready

Market moves, competitive shifts, and new innovations land as reviewable file changes — the house stays maintainable by agents.

build your own AI content factory

start with MESSAGE.md