Table of Contents
A brand context directory is a small set of plain-text or Markdown files that gives an AI writing tool consistent, reusable instructions. Instead of pasting an entire visual style guide into every prompt, you supply only the relevant voice, messaging, audience, visual, and example files for the task.
The directory does not guarantee on-brand output. It works best as a controlled reference set with clear rules, approved examples, and a human review process.
What belongs in a brand context directory?
Start with two files and add more only when they solve a recurring problem:
brand-context/ ├── 01-voice-and-style.md ├── 02-positioning-and-messaging.md ├── 03-audiences.md ├── 04-visual-direction.md └── 05-approved-examples.md
- Voice and style: how the brand sounds, including wording, sentence patterns, formatting, and prohibited habits.
- Positioning and messaging: what the organization does, who it serves, its proof points, and claims it must not make.
- Audiences: what each reader already knows, needs, fears, and expects from the content.
- Visual direction: written guidance for image briefs, presentations, diagrams, and generated-image prompts.
- Approved examples: short excerpts that demonstrate the rules in real content.
Keep factual source material—product specifications, legal text, pricing, research, and support procedures—separate from stylistic context. Facts change at a different rate and should have an owner and review date.
1. Define the job before writing files
List the outputs the directory must support: help articles, product pages, emails, social posts, sales proposals, or visual briefs. A useful context set for technical documentation differs from one for advertising.
For each output type, record:
- the intended audience and reading situation;
- the action the content should help the reader take;
- required and prohibited claims;
- the level of formality and technical detail;
- who approves the final output.
This prevents the directory from becoming a collection of attractive but unusable adjectives.
2. Build the voice and style file
Choose specific voice traits
Use four to six traits that imply an observable writing choice. “Professional” and “friendly” are too broad on their own. Define each trait in practical terms:
- Direct, not abrupt: state the answer early, then include the context needed to act safely.
- Confident, not absolute: make clear recommendations while acknowledging material uncertainty.
- Warm, not sentimental: recognize the reader's problem without exaggerated empathy.
- Technical, not opaque: use the correct term, then explain it when the audience may not know it.
Translate traits into rules
Rules should be easy to test during editing. For example:
Do:
- address the reader as “you” when giving instructions;
- use active voice for actions and ownership;
- put the main answer in the opening paragraph;
- use descriptive headings and short-to-medium paragraphs;
- give a concrete example after an abstract rule;
- state a limitation beside the claim it qualifies.
Do not:
- open with a rhetorical question or a generic statement about modern life;
- use superlatives such as “ultimate” or “revolutionary” without approved evidence;
- repeat the conclusion of every section;
- invent statistics, quotes, customer stories, or product capabilities;
- use exclamation marks in support or policy content;
- replace a precise noun with vague phrases such as “this powerful solution.”
Resolve contradictory rules. “Always use short sentences” and “explain nuanced tradeoffs” may conflict; say which goal takes priority.
Describe mechanics and rhythm
Specify the preferred spelling variant, capitalization, date and number formats, contraction policy, heading style, paragraph length, and treatment of acronyms. If reading level matters, name the audience behavior you want rather than relying only on a numerical score.
3. Write positioning and messaging as usable constraints
Start with a literal brand definition
Use one sentence that explains the offer and audience without tagline language:
We help early-stage B2B software founders build measurable marketing systems before they hire a full internal team.
Define three to five message pillars
Each pillar should contain a belief, the evidence allowed to support it, and a boundary. For example:
- Practicality: recommend steps a small team can execute; do not imply every company has an enterprise budget.
- Measurement: connect recommendations to an observable outcome; do not present an untested tactic as proven.
- Reader respect: assume relevant experience; explain necessary context without teaching unrelated basics.
Create a claims register
Add three lists:
- Approved claims: statements already verified by product, legal, or research owners.
- Claims requiring evidence: comparisons, performance results, security statements, and numbers that need a current source.
- Prohibited claims: guarantees, unsupported rankings, or language restricted by policy.
Include the source and review date for approved factual claims. The model should be told to flag a missing fact instead of filling it in.
4. Describe audiences by decisions, not stereotypes
Create one section for each audience that materially changes the output. Include:
- the question or decision that brought the reader to the content;
- what they probably know already;
- what they have tried and where they may be stuck;
- the terms they use and terms that need explanation;
- the evidence they trust;
- the consequence of getting the answer wrong;
- the format that helps them act: steps, comparison, checklist, example, or reference.
Avoid demographic details unless they genuinely change the content. “Operations manager comparing three vendors under a fixed budget” gives the model more useful direction than a fictional age, hobby, and personality type.
5. Turn visual identity into a written brief
AI tools and designers need more than color names. Record the functional role of each visual choice:
- Palette: exact color values, approved combinations, contrast requirements, and where accent colors may appear.
- Typography: approved fonts and fallbacks, hierarchy, weight, and the desired editorial or product feel.
- Photography: subject, setting, lighting, framing, realism, diversity, and what staged imagery to avoid.
- Illustration: line, shape, texture, perspective, icon treatment, and complexity.
- Layout: spacing, information density, alignment, corner treatment, and use of decoration.
Example:
Use deep navy
#1A2B4Afor primary text and warm ivory#F5F0E8for large backgrounds. Muted terracotta#C4613Ais an accent, not a full-page fill. Keep text/background combinations within the organization's accessibility standard. Photography should show realistic work in natural light; avoid staged handshakes, generic boardrooms, neon gradients, and decorative interface holograms.
A written file supports prompt generation, but final artwork still needs checks for color accuracy, accessibility, trademark use, licensing, and factual details.
6. Add approved examples with annotations
Three strong examples are more useful than dozens of mixed-quality samples. Keep excerpts short enough that the model can identify the pattern. For each one, include:
- content type and audience;
- the approved excerpt;
- two or three notes explaining why it fits;
- the approval date or campaign version;
- any element that should not be copied literally.
Add one or two negative examples when they demonstrate a common failure. Label them clearly as do not imitate and explain the correction.
7. Make every file easy for an AI tool to use
- Use descriptive headings and one rule per bullet.
- Put high-priority constraints near the top.
- Separate permanent rules from task-specific instructions.
- Avoid rules that depend on unseen visuals or institutional knowledge.
- State what to do when information is missing: ask, cite a source, insert a placeholder, or stop.
- Give examples, but tell the model not to copy names, numbers, or claims into unrelated work.
Plain text and Markdown are convenient because they are searchable, diffable, and easy to include selectively. A PDF can remain the human-facing brand guide, but do not assume a model will extract every chart, sidebar, and visual example correctly.
8. Use the directory in a repeatable prompt
A task prompt should name the relevant files and define the deliverable:
Use
01-voice-and-style.md, the “technical buyer” section of03-audiences.md, and the approved claims in02-positioning-and-messaging.md. Draft a 700-word product comparison for readers choosing between the Standard and Pro plans. Preserve uncertainty, do not invent specifications, and mark any missing source fact as[VERIFY]. After the draft, list the rules you applied and any conflicts you found.
Do not attach every file to every task. Extra context can dilute the relevant instructions and increase the chance of conflicting rules.
9. Test with a small evaluation set
Create five to ten representative tasks and an editing checklist. Test at least:
- an ordinary article or email;
- a request that tempts the model to exaggerate;
- a task with missing facts;
- two audience segments that require different depth;
- a visual brief that must respect prohibited styles.
Score outputs for voice, factual discipline, message accuracy, audience fit, structure, and prohibited-language violations. Compare the draft against both the rules and human-approved examples. Revise the context file when the same error appears repeatedly; do not add a new rule for a one-off preference.
10. Assign ownership and protect sensitive context
Add a short header to each file:
Owner: Brand team Version: 1.3 Last reviewed: 2026-07-15 Applies to: Website and lifecycle email Priority: High
Keep the directory in version control or another system with change history. Review it when positioning, product claims, legal requirements, or visual standards change.
Do not place secrets, unreleased financial data, personal customer information, confidential contracts, or private research into a context directory unless the chosen AI system and access controls are approved for that data. Brand consistency is not worth exposing sensitive information.
Reader Comments 0
Sign in with email or Google to join the discussion.