Annotated Guidelines

What changes when AI agents read your brand guidelines

An AI agent follows your guide literally and cannot ask what you meant. Which parts of a typical guide it can use, which parts it misses, and what to add.

Not much changes. The rules that help a new designer also help an AI agent, that is, an AI tool that does tasks for you. But a designer asks when a rule is vague, and an agent fills the gap with its own default. So the six things that make a rule easy to follow are more important for agents. Also, some habits of PDF guides stop working.

The advice from Anthropic for instructions to its Claude models is the same advice that a brand team gives about a new employee:

Think of Claude as a brilliant but new employee who lacks context on your norms and workflows. The more precisely you explain what you want, the better the result.

The quote is from the prompting best practices from Anthropic, checked 2026-11-11. The same page says that an explanation of why a behavior is important “can give Claude more information about your goals and help it deliver more targeted responses”. For this reason, a rule needs its reason.

What an agent can use as it is

  • Rules in text: color values, font names, sizes, and words to use and avoid. The agent can use these directly.
  • Examples in text: a sentence in the brand voice next to a sentence that misses. The agent can copy the pattern.
  • Reasons: people and agents apply a rule with a reason to cases that the rule does not list.

What it misses

  • Rules that exist only in pictures. A page with six crossed-out pictures of logo mistakes and no words teaches a person quickly. It teaches an agent much less. Write each mistake as a sentence under its picture.
  • Values inside images. If a color swatch shows the hex code only in the image, the agent possibly does not get the code. Put the code in the text.
  • Vague words. “Friendly”, “modern”, and “premium” mean different things to different readers, and an agent uses its own meaning. Add what the word means for this brand, and what it does not mean.
  • Pictures of files. A logo in a PDF is a picture. If an agent has only the picture, the agent will draw the logo again. Give the agent the SVG file.
  • Old copies. A PDF that someone saved into an AI tool last year still looks current to the agent. A date on every page lets a person see the age of a copy. One current version that every tool reads is better. Sharing shows how to do that.

What to add for agents

  1. Say which rules are hard rules and which rules are preferences.
  2. Give every value as text, in every format that people need.
  3. Put a written example next to every rule about words.
  4. Link the real files from the rule that uses them.
  5. Put a date and a version on the guide, and say what changed.
  6. Add a short Using AI part. Say which tools people can use, what AI can make, and who checks the work.

You do not need a different guide for agents. A guide that works for a new agency on its first day also works for an agent.