Files of Prompt design
wondelai/
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:
- Critical: Requires immediate action (security alerts, time-sensitive deadlines)
- Important: Meaningful event that benefits from quick response (teammate mention, task completion)
- Informational: Nice to know but not urgent (weekly digest, milestone reached)
- 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
- Identify the anchor through user research (what do users already do reliably?)
- Pair the new behavior with the anchor (proximity in time and context)
- Prompt at the anchor moment (notification, email, or in-app cue)
- Shrink the new behavior to its Starter Step
- 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 | |
| 3 | 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. |
| 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 | |
| 59 | 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. |
| 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 | |
| 87 | Every 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 | |
| 116 | Not all prompts are equal. Design a hierarchy: |
| 117 | |
| 118 | **Critical:** Requires immediate action (security alerts, time-sensitive deadlines) |
| 119 | **Important:** Meaningful event that benefits from quick response (teammate mention, task completion) |
| 120 | **Informational:** Nice to know but not urgent (weekly digest, milestone reached) |
| 121 | **Ambient:** Background awareness (badge count update, status change) |
| 122 | |
| 123 | Match 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 | |
| 136 | Anchor 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 | |
| 140 | A 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 | |
| 158 | **Identify** the anchor through user research (what do users already do reliably?) |
| 159 | **Pair** the new behavior with the anchor (proximity in time and context) |
| 160 | **Prompt** at the anchor moment (notification, email, or in-app cue) |
| 161 | **Shrink** the new behavior to its Starter Step |
| 162 | **Celebrate** after completion (feedback, progress, positive emotion) |
| 163 | |
| 164 | |
| 165 | |
| 166 | ## Prompt Design Patterns |
| 167 | |
| 168 | ### Progressive Prompt Reduction |
| 169 | |
| 170 | As 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 | |
| 181 | Every prompt should deliver more value than it costs in attention: |
| 182 | |
| 183 | |
| 184 | Prompt Value = (Relevance × Urgency × Actionability) / Frequency |
| 185 | |
| 186 | |
| 187 | If 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 | |
| 191 | Test 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 | |
| 201 | Measure: Open rate, action completion rate, and long-term retention (not just clicks). |
| 202 |
Discussion
Browse more free Claude skills.