brief.md · v0.1.0
brief.md — open spec for portable brand context.
A markdown document carrying an operator’s voice rules, credentials, identity, and available assets. Hosted at the operator’s domain. Consumed by AI assistants, journalist-side workflows, PR products, and any tool that needs to know “who is this brand and how do they sound.”
What it is
A YAML-frontmatter markdown document with five canonical sections: identity, credentials, voice-rules, public-links, submission-assets. Operators publish it at their own domain (typically /.well-known/brief.md or /brief.md). Tools fetch it to learn voice, verify credentials, or compose structured pitches.
Why it exists
Brand context is currently locked inside proprietary PR / outreach tools — voice settings, asset libraries, founder credentials. Cancel the subscription and the settings disappear with it. brief.md inverts that: the operator owns the document, the format is open, any compliant tool can consume it.
Stewardship
The spec is open. The brief.md trademark is held by The Integrity Framework. Implementing tools may use the trademark under license; the license requires spec compliance, verified by passing the @theintegrityframework/brief-core test suite.
Endpoints under this spec home
/specs/brief-md/v0.1.0/spec.md— full spec document,text/markdown/specs/brief-md/v0.1.0/schema.json— JSON Schema for the document structure,application/schema+json
Reference implementation
@theintegrityframework/brief-core is the canonical parser + validator. Other implementations are encouraged.
Versioning
Briefs declare spec_versionin their frontmatter. Consumers may refuse to parse versions they don’t recognize, or fall back to best-effort. The spec follows semver — breaking changes bump major; additive changes bump minor.