FREE: Take our Content Design Health Check and get a skills action plan. 
AI in Content Design: Exercises
UX Content Collective

AI in Content Design

Ethics, Scale, and Impact

Three exercises. Your work saves automatically as you type, so keep this tab open for the whole session. Use Export at the bottom when you want to take it with you.

Exercise 1

Write the copy

Pick one of the three scenarios below. Write the copy it asks for, then answer the two questions underneath it.

Scenario A

Wellness

Your company builds a wellness app that monitors phone use and smartwatch data (heart rate, sleep, message tone) to flag possible burnout. A new feature, "AI Mood Check", analyzes users' tone in messages to friends and colleagues. When the system detects stress patterns, it suggests a break or mindfulness exercise.

Scenario B

Money

Your budgeting app uses AI to classify expenses and send real-time tips. The model has flagged a user's weekly takeaway meals as "unnecessary spending" and suggests cutting back to meet savings goals. Internal testing shows people find these alerts judgmental.

Scenario C

Safety

You're working on the passenger app for a self-driving car. During a test ride, the car encounters an unavoidable collision scenario and must choose between swerving into property damage or endangering another vehicle. Legal requires a message explaining "decision-making transparency".

One more thing before you stop

Write down the rules you followed

You made decisions while writing that copy. Write two or three of them down as rules. You will use them in Exercise 2.

Too vague to use: Be empathetic.
Specific enough to use: Say what the app measured. Do not say what the user is feeling.
Exercise 2

Write documentation an AI can use

MindBridge is a wellness app. It has 36 pieces of copy and no documentation. You are going to write some.

What to do

You will fill in three sections below. The first one is long. The other two are short.

  1. Open the string list below and pick one component. Notifications, permissions, empty states, errors, or buttons.
  2. Fill in the long section for that component. Five fields.
  3. Pick two more components and fill in the short sections. Two fields each.
  4. Copy your work as markdown and test it on a model.

The one thing that matters: your rules need to be specific. If two people read your rule and look at the same piece of copy, they should agree on whether it passes.

Example

A finished long section

This one is written for Cadence, the project management tool from the demo. None of it will help you with MindBridge. It is here so you can see how the five fields fit together.

# Component: Confirmation dialogs

## Rule

The heading says what will be deleted and what else will go with it. The
buttons use the same verb as the heading.

## Example that follows the rule

> Delete the Q3 roadmap board?
> This also deletes 14 cards and their comments.
> [Keep board]  [Delete board]

From: rewritten from D4

## Pattern

`[Verb] the [name of thing]? + [what else gets deleted] + [buttons using the same verb]`

## Copy that breaks the rule: Vague question

> Are you sure?

Why it breaks the rule: it does not say what is being deleted, so people
click through it without reading.

## Copy that breaks the rule: Yes and no buttons

> Delete this board?  [Yes]  [No]

Why it breaks the rule: the buttons mean nothing on their own. If someone
misreads the heading, they click the wrong one.

## Scope

Use this rule for: anything that deletes something permanently.
Do not use it for: changes that save automatically. Those need no dialog.
Tone: plain and factual. No apologies.
If the thing has no name: describe it instead, like "3 selected cards".
Words: write "board" in lowercase unless it starts a sentence.
MindBridge: all 36 pieces of copy

MindBridge is a wellness app. It reads phone use and smartwatch data, then tells people when it thinks they might be burning out. Four different people wrote this copy over two years. Some of it is fine. Most of it is not.

Notifications

N1You're stressed. Take a break.
N2Your heart rate has been above your usual range for the past three hours. Want to log how you're feeling?
N3Hey you. We've missed you these past few days.
N4I noticed you've been struggling lately. I'm here if you want to talk.
N5Burnout risk: HIGH
N6Don't break your 12-day streak. Check in now.
N7Your sleep was shorter than usual last night. This can affect how the day feels.
N8Something might possibly be going on with your activity levels, perhaps.
N9Time for your daily mood check
N10You've had four nights under six hours this week. Sleep is one of the signals MindBridge uses. Want to see what else it's tracking?

Permissions

P1MindBridge needs access to your messages.
P2Allow MindBridge to analyse the tone of your messages? We look at word patterns, not content, and this stays on your device. You can turn it off any time.
P3Turn on Health access for the best experience.
P4We need your health data to keep you safe.
P5MindBridge reads your messages to detect stress.
P6Connect your watch to see heart rate and sleep in your daily summary. You can disconnect it later without losing your history.

Empty states

E1Nothing here yet.
E2No check-ins yet. Your first one takes about a minute and gives MindBridge something to compare against.
E3Oops. Looks like it's a bit empty in here.
E4You have not completed any check-ins.
E5No trends to show yet. MindBridge needs about a week of data before patterns mean anything.

Errors

X1Something went wrong.
X2Error 4021
X3You didn't allow health access, so this won't work.
X4We couldn't reach your watch. Check that Bluetooth is on and the watch is within range, then try again.
X5Your check-in didn't save. We've kept what you wrote, so you can try again now or come back to it later.
X6Failed to sync data. Please contact support.
X7The mood analysis was unable to be completed at this time.

Buttons

CopyWhere it appears
B1OKMessage access permission dialog
B2ContinueData sharing settings screen
B3Learn moreBelow a burnout alert
B4Allow message accessMessage access permission dialog
B5Not nowMessage access permission dialog
B6Log how I'm feelingDaily notification
B7Got itBurnout alert
B8See what's trackedBelow a burnout alert

Two places to start looking. Compare N1 and N7. Both react to something the watch measured, but only one of them tells the user what they are feeling. And look at what happens after a burnout alert: the only button is B7, "Got it".

Long section · five fields
One or two sentences. Say what the copy must do.
Too vague: Be clear and supportive.
Specific enough: The heading says what will be deleted and what else will go with it.
Pick one from the list that already works, or rewrite one that nearly does. Write out the full copy.
The ID, like N2. Or "rewritten from N3".
Take the example you just wrote and swap the specific words for brackets. This is the shape someone follows next time.
Example: Delete the Q3 roadmap board?
Pattern: [Verb] the [name of thing]? + [what else gets deleted]
Find one from the list. Give it a short name that describes the problem, so people can point at it in a review later.
Names like: Vague question. Yes and no buttons. No next step.
One sentence. Say what it costs the user.
Answer as many of these as you can. If you get stuck, ask yourself when you would tell someone to ignore your rule.
Short section · two fields
Short section · two fields
Last step

Test your rule on a model

  1. Click the button below. It copies your work as markdown.
  2. Paste your long section into ChatGPT, Claude, or Gemini.
  3. Paste in a piece of MindBridge copy that breaks your rule.
  4. Ask: does this follow the documentation?

If it spots the problem and can tell you which rule was broken, your rule is specific enough. If it hedges, agrees the copy is fine, or just says nice things about the writing, the rule needs more detail.

Exercise 3

Write the instructions for an AI assistant

MindBridge is building a writing assistant. Designers describe a screen, and it drafts the copy using your documentation. You are writing its instructions.

What to do

  1. Say what the assistant is for and what it is not allowed to decide.
  2. Say what rules it always follows and what it never does.
  3. Say how it should talk to the designer using it.
  4. Say what it does in four situations where it cannot just do what it was asked.

Step 4 is the important one. Most people have never written it, and it takes the longest.

Example

Instructions written for Cadence

Again, this is the project management tool, so the content will not help you. Notice how short it is, and how much of it is about what happens when the assistant cannot do what it was asked.

WHAT THIS IS FOR
You write interface copy for Cadence, a project management tool. You produce
first drafts. Designers edit them.

WHAT YOU DO NOT DECIDE
You do not approve copy, sign it off, or decide what ships. The designer knows
this product better than you do.

RULES
Always follow the documentation in your files.
Always say which document you used.
Never make up a rule that is not in your files.
Give one option unless someone asks for more.

HOW TO TALK TO THE DESIGNER
Be short and direct. No introductions, no compliments about their request.
Ask one question at most, then write the draft anyway.

IF SOMEONE ASKS FOR SOMETHING YOU HAVE NO RULES FOR
"That's marketing copy. I only have documentation for copy inside the product.
I can draft something, but none of my rules apply to it. Do you want me to?"

IF SOMEONE ASKS YOU TO BREAK A RULE
"The confirmation dialogs document says buttons use the same verb as the
heading. You've asked for Yes and No. I can write the verb version instead,
or you can change the document."

IF YOU DO NOT KNOW
"There's no document for tooltips. Here's what the buttons document suggests,
but treat it as a guess."

WHEN TO STOP AND GET A PERSON
Billing disputes and account deletion go to a human. Say so and stop.
Steps 1 to 3
Your documentation already covers how the copy should read. This is about how the assistant behaves.
This is different from how MindBridge talks to its users. It is easy to mix the two up.
Step 4

The four situations

Write the words the assistant actually says, not a description of what it should do.

A designer asks it to write a press release.
A designer asks for a notification telling a user they are depressed. Your documentation says the app never tells people what they are feeling. What does the assistant say back to a colleague who is senior to them?
A designer asks about a component you never documented. It can guess from a similar one, or say it has nothing. Pick one and write what it says.
For a wellness app, someone in a mental health crisis is the obvious case.

One question to take away: would your rules still work if someone who has never used MindBridge had to apply them?

 

Comments are closed

WEEKLY NEWSLETTERS

Join 12,000+ content designers

Stay on top of the industry. Get our weekly Dash newsletter with useful links, the jobs newsletter, news, discounts, events, and more.

"I got my job after seeing the newsletter, and I'm pretty sure I wouldn't have seen the posting otherwise."

Alexandra Carson
Alexandra Carson
Senior Content Designer