Prompt design skill

Prompts are the most overlooked element in behavior design.

by wondelai·MIT license·★ 2,235 Stars on the repo·GitHub ↗

Use now

Files of Prompt design

wondelai/main1 file
prompt-design.md
Show the full text202 lines

Prompt Design

Prompts are the most overlooked element in behavior design. Without a prompt, behavior doesn't happen — no matter how motivated or able the user is.

Three Prompt Types

1. Person Prompts (Internal)

What they are: Thoughts or reminders that come from within the user. "I should check my metrics." "Time to update the project."

How they form: Through repeated association between a context and a behavior. After enough repetitions, the user thinks of the behavior automatically in that context.

Product implications:

  • You cannot directly create Person Prompts
  • You create them indirectly by pairing external prompts with consistent contexts
  • Person Prompts are the goal — they mean the habit is formed
  • When users act without any external prompt, Person Prompts are driving behavior

Measurement: Track organic sessions (sessions without a preceding notification or email). Rising organic sessions = Person Prompts forming.


2. Context Prompts (Environmental)

What they are: Cues in the user's environment that trigger behavior. A badge on an app icon. A browser tab that's always open. A physical location associated with a task.

How they work: The environment reminds the user to act. The cue doesn't come from the product's notification system — it comes from the user's existing context.

Product implications:

  • Design for environmental persistence (widgets, browser tabs, badges, status bar items)
  • Integrate into existing workflows (Slack integrations, email digests, calendar events)
  • Physical environment matters: desktop apps have different context cues than mobile

Design strategies:

  • App badges and notification counts (persistent visual cue)
  • Browser start page or new tab integration
  • Widget on phone home screen
  • Calendar integrations (event = context cue)
  • Slack/Teams bot messages in existing channels

3. Action Prompts (Designed)

What they are: Prompts deliberately designed and sent by the product. Push notifications, emails, in-app tooltips, CTAs, banners, and modals.

How they work: The product actively tells the user to do something at a specific moment.

Product implications:

  • You have full control over timing, content, and frequency
  • But Action Prompts are expensive — each one uses up attention capital
  • Prompt fatigue is real: too many Action Prompts degrades all future prompts
  • Action Prompts should feel like helpful reminders, not interruptions

Prompt Timing

The most important principle: Prompts only work above the Action Line. Sending a prompt to someone who lacks motivation or ability is not engagement — it's spam.

When to Prompt
Timing Strategy How It Works Example
Event-based Prompt triggered by a real event "Your report is ready" (report was generated)
Anchor-based Prompt tied to user's existing routine "After your morning standup, check your dashboard"
State-based Prompt triggered by user's product state "You have 3 unread comments" (content waiting)
Completion-based Prompt after user finishes a related action "You just finished a meeting — want to log action items?"
Threshold-based Prompt when a metric crosses a threshold "Your project hit 80% completion"
When NOT to Prompt
Anti-Pattern Why It Fails Better Approach
Time-based schedule "Every Monday at 9am" regardless of context Event-based: prompt when there's something to act on
Re-engagement spam "We miss you!" every 3 days Wait for a meaningful event, then send one message
Feature promotion "Have you tried our new analytics?" Prompt when user encounters the problem analytics solves
Vanity metrics "You've been viewed 12 times this week!" Only prompt for actionable information
Guilt-based "Your team is waiting" when they're not Only use social prompts when genuinely true

Notification Design

The PASS Framework for Notifications

Every notification should pass four tests:

P — Personal: Is this relevant to this specific user?

  • Bad: "Check out our new features"
  • Good: "Your project 'Q2 Launch' has 3 new comments"

A — Actionable: Can the user act on this right now?

  • Bad: "Your subscription renews in 30 days"
  • Good: "Sarah shared a file with you — tap to view"

S — Specific: Does it tell the user exactly what happened?

  • Bad: "You have new activity"
  • Good: "2 tasks were completed in your Sprint 4 board"

S — Short: Can the user get the point in under 3 seconds?

  • Bad: "We wanted to let you know that there have been some updates to the project that you've been following, and several team members have added their contributions"
  • Good: "3 updates in Project Alpha"
Notification Frequency Guidelines
User Segment Frequency Rationale
New users (Week 1) 1-2 per day max Build value without overwhelming
Active users Based on events, not schedule They're engaged; prompt around real activity
Fading users 1-2 per week max High value, low volume to re-engage
Churned users 1 per month max Only prompt for highly relevant events
Notification Hierarchy

Not all prompts are equal. Design a hierarchy:

  1. Critical: Requires immediate action (security alerts, time-sensitive deadlines)
  2. Important: Meaningful event that benefits from quick response (teammate mention, task completion)
  3. Informational: Nice to know but not urgent (weekly digest, milestone reached)
  4. Ambient: Background awareness (badge count update, status change)

Match the notification channel to the hierarchy level:

Level Channel Interruption Level
Critical Push notification + banner Full interruption
Important Push notification Standard interruption
Informational In-app + email digest Low interruption
Ambient Badge count, in-app indicator No interruption

Anchor Moments

Anchor moments are the key to forming habits. They are existing routines that serve as reliable triggers for new behaviors.

What Makes a Good Anchor

A good anchor moment is:

  • Reliable: It happens consistently (daily, weekly)
  • Recognizable: The user clearly knows when it happens
  • Relevant: It's contextually related to the new behavior
  • Already habitual: It doesn't require motivation — it's automatic
Common Anchor Moments for Products
Anchor Moment New Behavior Recipe
Opening laptop in the morning Check dashboard "After I open my laptop, I will glance at my dashboard"
Finishing a meeting Log action items "After I leave a meeting, I will add one task"
Morning coffee Review daily plan "After I pour my coffee, I will check my priorities"
End of workday Update project status "After I close my IDE, I will update one status"
Weekly team standup Review team metrics "After our standup, I will check the team scoreboard"
Designing for Anchor Moments
  1. Identify the anchor through user research (what do users already do reliably?)
  2. Pair the new behavior with the anchor (proximity in time and context)
  3. Prompt at the anchor moment (notification, email, or in-app cue)
  4. Shrink the new behavior to its Starter Step
  5. Celebrate after completion (feedback, progress, positive emotion)

Prompt Design Patterns

Progressive Prompt Reduction

As habits form, reduce external prompts:

Week Prompt Strategy Goal
1-2 Daily action prompts Establish the behavior
3-4 Reduce to every other day Test if habit is forming
5-8 Weekly summary only Shift to context/person prompts
9+ No external prompts Habit formed (monitor organic sessions)
The Prompt-Value Ratio

Every prompt should deliver more value than it costs in attention:

Prompt Value = (Relevance × Urgency × Actionability) / Frequency

If frequency goes up, each prompt must be more relevant, more urgent, or more actionable to maintain the same value ratio.

Prompt A/B Testing

Test prompts on these dimensions:

Dimension A B
Timing Morning send Anchor-moment send
Content Generic ("Check your dashboard") Specific ("2 tasks due today")
Channel Push notification In-app banner
Frequency Daily Event-based
Tone Informational ("Your report is ready") Social ("Sarah commented on your project")

Measure: Open rate, action completion rate, and long-term retention (not just clicks).

1# Prompt Design
2 
3Prompts are the most overlooked element in behavior design. Without a prompt, behavior doesn't happen — no matter how motivated or able the user is.
4 
5## Three Prompt Types
6 
7### 1. Person Prompts (Internal)
8 
9**What they are:** Thoughts or reminders that come from within the user. "I should check my metrics." "Time to update the project."
10 
11**How they form:** Through repeated association between a context and a behavior. After enough repetitions, the user thinks of the behavior automatically in that context.
12 
13**Product implications:**
14- You cannot directly create Person Prompts
15- You create them indirectly by pairing external prompts with consistent contexts
16- Person Prompts are the goal — they mean the habit is formed
17- When users act without any external prompt, Person Prompts are driving behavior
18 
19**Measurement:** Track organic sessions (sessions without a preceding notification or email). Rising organic sessions = Person Prompts forming.
20 
21---
22 
23### 2. Context Prompts (Environmental)
24 
25**What they are:** Cues in the user's environment that trigger behavior. A badge on an app icon. A browser tab that's always open. A physical location associated with a task.
26 
27**How they work:** The environment reminds the user to act. The cue doesn't come from the product's notification system — it comes from the user's existing context.
28 
29**Product implications:**
30- Design for environmental persistence (widgets, browser tabs, badges, status bar items)
31- Integrate into existing workflows (Slack integrations, email digests, calendar events)
32- Physical environment matters: desktop apps have different context cues than mobile
33 
34**Design strategies:**
35- App badges and notification counts (persistent visual cue)
36- Browser start page or new tab integration
37- Widget on phone home screen
38- Calendar integrations (event = context cue)
39- Slack/Teams bot messages in existing channels
40 
41---
42 
43### 3. Action Prompts (Designed)
44 
45**What they are:** Prompts deliberately designed and sent by the product. Push notifications, emails, in-app tooltips, CTAs, banners, and modals.
46 
47**How they work:** The product actively tells the user to do something at a specific moment.
48 
49**Product implications:**
50- You have full control over timing, content, and frequency
51- But Action Prompts are expensive — each one uses up attention capital
52- Prompt fatigue is real: too many Action Prompts degrades all future prompts
53- Action Prompts should feel like helpful reminders, not interruptions
54 
55---
56 
57## Prompt Timing
58 
59The most important principle: **Prompts only work above the Action Line.** Sending a prompt to someone who lacks motivation or ability is not engagement — it's spam.
60 
61### When to Prompt
62 
63| Timing Strategy | How It Works | Example |
64|----------------|-------------|---------|
65| **Event-based** | Prompt triggered by a real event | "Your report is ready" (report was generated) |
66| **Anchor-based** | Prompt tied to user's existing routine | "After your morning standup, check your dashboard" |
67| **State-based** | Prompt triggered by user's product state | "You have 3 unread comments" (content waiting) |
68| **Completion-based** | Prompt after user finishes a related action | "You just finished a meeting — want to log action items?" |
69| **Threshold-based** | Prompt when a metric crosses a threshold | "Your project hit 80% completion" |
70 
71### When NOT to Prompt
72 
73| Anti-Pattern | Why It Fails | Better Approach |
74|-------------|-------------|-----------------|
75| **Time-based schedule** | "Every Monday at 9am" regardless of context | Event-based: prompt when there's something to act on |
76| **Re-engagement spam** | "We miss you!" every 3 days | Wait for a meaningful event, then send one message |
77| **Feature promotion** | "Have you tried our new analytics?" | Prompt when user encounters the problem analytics solves |
78| **Vanity metrics** | "You've been viewed 12 times this week!" | Only prompt for actionable information |
79| **Guilt-based** | "Your team is waiting" when they're not | Only use social prompts when genuinely true |
80 
81---
82 
83## Notification Design
84 
85### The PASS Framework for Notifications
86 
87Every notification should pass four tests:
88 
89**P — Personal:** Is this relevant to this specific user?
90- Bad: "Check out our new features"
91- Good: "Your project 'Q2 Launch' has 3 new comments"
92 
93**A — Actionable:** Can the user act on this right now?
94- Bad: "Your subscription renews in 30 days"
95- Good: "Sarah shared a file with you — tap to view"
96 
97**S — Specific:** Does it tell the user exactly what happened?
98- Bad: "You have new activity"
99- Good: "2 tasks were completed in your Sprint 4 board"
100 
101**S — Short:** Can the user get the point in under 3 seconds?
102- Bad: "We wanted to let you know that there have been some updates to the project that you've been following, and several team members have added their contributions"
103- Good: "3 updates in Project Alpha"
104 
105### Notification Frequency Guidelines
106 
107| User Segment | Frequency | Rationale |
108|-------------|-----------|-----------|
109| New users (Week 1) | 1-2 per day max | Build value without overwhelming |
110| Active users | Based on events, not schedule | They're engaged; prompt around real activity |
111| Fading users | 1-2 per week max | High value, low volume to re-engage |
112| Churned users | 1 per month max | Only prompt for highly relevant events |
113 
114### Notification Hierarchy
115 
116Not all prompts are equal. Design a hierarchy:
117 
1181. **Critical:** Requires immediate action (security alerts, time-sensitive deadlines)
1192. **Important:** Meaningful event that benefits from quick response (teammate mention, task completion)
1203. **Informational:** Nice to know but not urgent (weekly digest, milestone reached)
1214. **Ambient:** Background awareness (badge count update, status change)
122 
123Match the notification channel to the hierarchy level:
124 
125| Level | Channel | Interruption Level |
126|-------|---------|-------------------|
127| Critical | Push notification + banner | Full interruption |
128| Important | Push notification | Standard interruption |
129| Informational | In-app + email digest | Low interruption |
130| Ambient | Badge count, in-app indicator | No interruption |
131 
132---
133 
134## Anchor Moments
135 
136Anchor moments are the key to forming habits. They are existing routines that serve as reliable triggers for new behaviors.
137 
138### What Makes a Good Anchor
139 
140A good anchor moment is:
141- **Reliable:** It happens consistently (daily, weekly)
142- **Recognizable:** The user clearly knows when it happens
143- **Relevant:** It's contextually related to the new behavior
144- **Already habitual:** It doesn't require motivation — it's automatic
145 
146### Common Anchor Moments for Products
147 
148| Anchor Moment | New Behavior | Recipe |
149|---------------|-------------|--------|
150| Opening laptop in the morning | Check dashboard | "After I open my laptop, I will glance at my dashboard" |
151| Finishing a meeting | Log action items | "After I leave a meeting, I will add one task" |
152| Morning coffee | Review daily plan | "After I pour my coffee, I will check my priorities" |
153| End of workday | Update project status | "After I close my IDE, I will update one status" |
154| Weekly team standup | Review team metrics | "After our standup, I will check the team scoreboard" |
155 
156### Designing for Anchor Moments
157 
1581. **Identify** the anchor through user research (what do users already do reliably?)
1592. **Pair** the new behavior with the anchor (proximity in time and context)
1603. **Prompt** at the anchor moment (notification, email, or in-app cue)
1614. **Shrink** the new behavior to its Starter Step
1625. **Celebrate** after completion (feedback, progress, positive emotion)
163 
164---
165 
166## Prompt Design Patterns
167 
168### Progressive Prompt Reduction
169 
170As habits form, reduce external prompts:
171 
172| Week | Prompt Strategy | Goal |
173|------|----------------|------|
174| 1-2 | Daily action prompts | Establish the behavior |
175| 3-4 | Reduce to every other day | Test if habit is forming |
176| 5-8 | Weekly summary only | Shift to context/person prompts |
177| 9+ | No external prompts | Habit formed (monitor organic sessions) |
178 
179### The Prompt-Value Ratio
180 
181Every prompt should deliver more value than it costs in attention:
182 
183```
184Prompt Value = (Relevance × Urgency × Actionability) / Frequency
185```
186 
187If frequency goes up, each prompt must be more relevant, more urgent, or more actionable to maintain the same value ratio.
188 
189### Prompt A/B Testing
190 
191Test prompts on these dimensions:
192 
193| Dimension | A | B |
194|-----------|---|---|
195| **Timing** | Morning send | Anchor-moment send |
196| **Content** | Generic ("Check your dashboard") | Specific ("2 tasks due today") |
197| **Channel** | Push notification | In-app banner |
198| **Frequency** | Daily | Event-based |
199| **Tone** | Informational ("Your report is ready") | Social ("Sarah commented on your project") |
200 
201Measure: Open rate, action completion rate, and long-term retention (not just clicks).
202 

Discussion