From d3245e83df436e47b7258966c66619c184baa7b8 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 15:18:28 +0100
Subject: [PATCH 01/98] Revise UX Guidelines for Base App Agents

Updated the UX Guidelines for Base App Agents to enhance clarity and relevance for 2026.
---
 .../agents/building-quality-agents.mdx        | 136 +-----------------
 1 file changed, 2 insertions(+), 134 deletions(-)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index f63ec37e9..a2edb2580 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -1,135 +1,3 @@
----
-title: 'UX Guidelines'
-description: Learn the best practices and guidelines for creating quality agents 
-sidebarTitle: 'UX Guidelines'
----
-
-As you start building, review these guidelines to understand what makes an agent successful in the Base app. We recommend trying out existing agents in the app first to get a feel for the quality bar, what works well, and areas for improvement.
-
-## Build a high quality foundation
-
-Your agent should provide a seamless, professional experience that users will want to engage with repeatedly. Here are the core requirements:
-
-### Responding to messages
-
-**Multi-Channel Support**
-- Respond to both DMs and group chats appropriately
-- Maintain consistent functionality across different conversation types
-
-**Immediate Feedback**
-- React to messages with a simple reaction (👀, 👍, ⌛, etc.) to show acknowledgment
-- This gives users confidence their message was received while processing
-
-**Fast Response Times**
-- Provide responses quickly (< 5 seconds)
-- Users expect near-instant communication in messaging apps
-
-### Group Chat Etiquette
-
-In group chats, agents should only respond when:
-
-1. **Mentioned directly** with "@" + agent name (e.g., @bankr)
-2. **Replied to directly** when a user replies to the agent's message using the reply content type
-
-This prevents spam and ensures agents participate naturally in group conversations.
-
-### Communication Style
-
-**Sound Human**
-- Use conversational, fun, and clear language
-- Keep responses polished but not robotic
-- Match the energy and tone of the conversation
-
-**Privacy Conscious**
-- Only ask for personal information when absolutely necessary
-- Always explain why the information is needed
-- Respect user privacy and data minimization principles
-
-## Craft compelling onboarding
-
-Your agent's first impression is critical. The onboarding message should immediately communicate value and give users a clear path forward.
-
-### Great Onboarding Message Structure
-
-1. **Introduce the agent** - Quick, friendly greeting with the agent's name
-2. **Explain capabilities** - Clear, specific examples of what it can do
-4. **Use quick select buttons** - Make it easy for users to select an action to take with the agent
-
-### Example: High-Quality Onboarding
-
-```
-hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's the rundown:
-
-• trade anything: buy, sell, swap tokens on base, polygon, and mainnet. try "buy 0.1 eth of degen."
-• send it: transfer crypto to anyone on x, farcaster, or a wallet address.
-• get alpha: token recs, market data, charts.
-• automate: set up recurring buys/sells. e.g. "buy $10 of $bnkr every week."
-
-what do you want to do first?
-```
-
-**Why this works:**
-- Friendly, conversational tone
-- Specific feature examples with concrete commands
-- Clear value propositions
-- Ends with a direct call-to-action
-
-### Example: Poor Onboarding
-
-```
-Gm! What can I help you with?
-```
-
-**Why this fails:**
-- Generic greeting with no context
-- No explanation of capabilities
-- Puts burden on user to figure out what to do
-- No clear value proposition
-
-## Showcase unique value
-
-### Solve Real Problems
-
-Your agent should:
-- **Address a unique pain point** or bring a delightful twist to an existing space
-- **Help users accomplish tasks** more easily than existing solutions
-- **Provide clear benefits** that users can understand immediately
-
-### Enable User Success
-
-Focus on helping users:
-- **Earn** - Generate income, rewards, or value
-- **Connect** - Build relationships or communities
-- **Have fun** - Provide entertainment or engaging experiences
-- **Complete tasks** - Streamline workflows or processes
-
-### Design for Engagement
-
-**Build Natural Growth Loops**
-- Include features that encourage sharing, re-engagement, and habit forming
-- Make it beneficial for users to invite others
-- Create ongoing value that brings users back
-
-**Plan the User Journey**
-1. **Define the ideal user experience first**
-2. **Craft agent messages around that journey**
-3. **Guide users through progressive value discovery**
-
-### Continuous Engagement Strategy
-
-As users complete actions with your agent:
-
-- **Show clear next steps** - Always give users something else to try
-- **Highlight ongoing value** - Explain how continued use benefits them
-- **Create habit loops** - Design features that encourage regular interaction
-- **Prevent one-and-done usage** - Build features that require return visits
-
-### Examples of Engagement Features
-
-- **Progressive features** - Unlock new capabilities as users engage more
-- **Personalization** - Learn user preferences and customize experiences  
-- **Social elements** - Enable sharing achievements or inviting friends
-- **Recurring value** - Automated tasks, alerts, or regular check-ins
-- **Gamification** - Points, levels, or achievement systems
-
+# UX Guidelines for Base App Agents
 
+*Updated for 2026*

From 31324e5c48091f10acbb17bcbce0df9df1327f99 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 15:19:44 +0100
Subject: [PATCH 02/98] Update UX guidelines for Base App agents

Added introductory text to UX guidelines for agents.
---
 docs/base-app/agents/building-quality-agents.mdx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index a2edb2580..fb82aacc0 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -1,3 +1,6 @@
 # UX Guidelines for Base App Agents
 
 *Updated for 2026*
+
+As you start building, review these guidelines to understand what makes an agent successful in the Base app. We recommend trying out existing agents in the app first to get a feel for the quality bar, what works well, and areas for improvement.
+

From 84ec08e7d631add4002fc1ff5a69e67f2fe6d636 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 15:20:32 +0100
Subject: [PATCH 03/98] Add guidelines for building quality agents

Added a section on building a high-quality foundation for agents.
---
 docs/base-app/agents/building-quality-agents.mdx | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index fb82aacc0..830f9d1c6 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -4,3 +4,7 @@
 
 As you start building, review these guidelines to understand what makes an agent successful in the Base app. We recommend trying out existing agents in the app first to get a feel for the quality bar, what works well, and areas for improvement.
 
+## Build a High Quality Foundation
+
+Your agent should provide a seamless, professional experience that users will want to engage with repeatedly. Here are the core requirements:
+

From 84e45bbc63c5266483b85440047591fb8326b385 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 15:21:17 +0100
Subject: [PATCH 04/98] Add section on responding to messages

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 830f9d1c6..bd862d097 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -8,3 +8,5 @@ As you start building, review these guidelines to understand what makes an agent
 
 Your agent should provide a seamless, professional experience that users will want to engage with repeatedly. Here are the core requirements:
 
+### Responding to Messages
+

From 5f189e026d05f7e83ec847946584bf777f309286 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 15:22:02 +0100
Subject: [PATCH 05/98] Add multi-channel support requirement

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index bd862d097..2b1d89068 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -10,3 +10,4 @@ Your agent should provide a seamless, professional experience that users will wa
 
 ### Responding to Messages
 
+**Multi-Channel Support**

From 984045eec5050c7fa5a40101cc50d67e19d01984 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:29:52 +0100
Subject: [PATCH 06/98] Add multi-channel support section

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 2b1d89068..528060853 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -11,3 +11,4 @@ Your agent should provide a seamless, professional experience that users will wa
 ### Responding to Messages
 
 **Multi-Channel Support**
+- Respond to both DMs and group chats appropriately

From 8bbf2d79809a8c0005716ba423f83be94cda1ed6 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:30:24 +0100
Subject: [PATCH 07/98] Add note on consistent functionality in responses

Added a note about maintaining consistent functionality across conversation types.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 528060853..2a2581b5f 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -12,3 +12,4 @@ Your agent should provide a seamless, professional experience that users will wa
 
 **Multi-Channel Support**
 - Respond to both DMs and group chats appropriately
+- Maintain consistent functionality across different conversation types

From c80181aac27176d4afc084d90884cd89627cbb14 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:30:44 +0100
Subject: [PATCH 08/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 2a2581b5f..338bee85e 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -13,3 +13,5 @@ Your agent should provide a seamless, professional experience that users will wa
 **Multi-Channel Support**
 - Respond to both DMs and group chats appropriately
 - Maintain consistent functionality across different conversation types
+
+**Immediate Feedback**

From 9d6922d430ef51b05e6f28ee474e1105746cd140 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:31:08 +0100
Subject: [PATCH 09/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 338bee85e..21f87d3c9 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -15,3 +15,4 @@ Your agent should provide a seamless, professional experience that users will wa
 - Maintain consistent functionality across different conversation types
 
 **Immediate Feedback**
+- React to messages with a simple reaction (👀, 👍, ⌛, etc.) to show acknowledgment

From c510487bf12b402a2d4be6e3f42c69d763dd1f5a Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:31:33 +0100
Subject: [PATCH 10/98] Enhance user experience with immediate feedback

Added a point about providing immediate feedback to users.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 21f87d3c9..304a21f3b 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -16,3 +16,4 @@ Your agent should provide a seamless, professional experience that users will wa
 
 **Immediate Feedback**
 - React to messages with a simple reaction (👀, 👍, ⌛, etc.) to show acknowledgment
+- This gives users confidence their message was received while processing

From 1e0f2124e1fbd880cafa309afcd6a46f6fabe541 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:31:57 +0100
Subject: [PATCH 11/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 304a21f3b..bae1a63d9 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -17,3 +17,5 @@ Your agent should provide a seamless, professional experience that users will wa
 **Immediate Feedback**
 - React to messages with a simple reaction (👀, 👍, ⌛, etc.) to show acknowledgment
 - This gives users confidence their message was received while processing
+
+**Fast Response Times**

From 254044ece136ec4caba8c4956c31b3303459634f Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:32:33 +0100
Subject: [PATCH 12/98] Add guideline for fast response times

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index bae1a63d9..4ea436c4d 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -19,3 +19,4 @@ Your agent should provide a seamless, professional experience that users will wa
 - This gives users confidence their message was received while processing
 
 **Fast Response Times**
+- Provide responses quickly (< 5 seconds)

From 19b79ce5c22fde8f44c4176e5f0dced34d6f1113 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:33:07 +0100
Subject: [PATCH 13/98] Add note on user expectations for fast responses

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 4ea436c4d..f3e4b02be 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -20,3 +20,4 @@ Your agent should provide a seamless, professional experience that users will wa
 
 **Fast Response Times**
 - Provide responses quickly (< 5 seconds)
+- Users expect near-instant communication in messaging apps

From bcc2826cc4eca53751c5dde21249affbfc11eac3 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:33:26 +0100
Subject: [PATCH 14/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index f3e4b02be..1b68f1135 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -21,3 +21,5 @@ Your agent should provide a seamless, professional experience that users will wa
 **Fast Response Times**
 - Provide responses quickly (< 5 seconds)
 - Users expect near-instant communication in messaging apps
+
+### Group Chat Etiquette

From a86a781a90659b85572e2283fa4aac1a916ed76f Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:33:55 +0100
Subject: [PATCH 15/98] Add group chat etiquette for agent responses

Added guidelines for agent responses in group chats.
---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 1b68f1135..63f52aa87 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -23,3 +23,5 @@ Your agent should provide a seamless, professional experience that users will wa
 - Users expect near-instant communication in messaging apps
 
 ### Group Chat Etiquette
+
+In group chats, agents should only respond when:

From 75b6c621a0dd4b34d4be241d655554f9e1c2461a Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:34:19 +0100
Subject: [PATCH 16/98] Add guideline for agent responses in group chats

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 63f52aa87..f4bb14c1c 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -25,3 +25,5 @@ Your agent should provide a seamless, professional experience that users will wa
 ### Group Chat Etiquette
 
 In group chats, agents should only respond when:
+
+1. **Mentioned directly** with "@" + agent name (e.g., @bankr)

From d3f8c86fafbbbb189be999efc86bf9606b4d0b84 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:34:56 +0100
Subject: [PATCH 17/98] Add response conditions for agents in group chats

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index f4bb14c1c..af2d0cf49 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -27,3 +27,4 @@ Your agent should provide a seamless, professional experience that users will wa
 In group chats, agents should only respond when:
 
 1. **Mentioned directly** with "@" + agent name (e.g., @bankr)
+2. **Replied to directly** when a user replies to the agent's message using the reply content type

From d7c5b55bd4911e924a4966711ba952cff060c5ee Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:35:19 +0100
Subject: [PATCH 18/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index af2d0cf49..ea8cc1fb5 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -28,3 +28,5 @@ In group chats, agents should only respond when:
 
 1. **Mentioned directly** with "@" + agent name (e.g., @bankr)
 2. **Replied to directly** when a user replies to the agent's message using the reply content type
+
+This prevents spam and ensures agents participate naturally in group conversations.

From 1fc8fd71ff6f7aa69e2d42669a794b1c4ef672b8 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:35:46 +0100
Subject: [PATCH 19/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ea8cc1fb5..1940b321c 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -30,3 +30,5 @@ In group chats, agents should only respond when:
 2. **Replied to directly** when a user replies to the agent's message using the reply content type
 
 This prevents spam and ensures agents participate naturally in group conversations.
+
+### Communication Style

From c98dd695f58f20576cac0b77ec8f999ddb18decb Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:39:58 +0100
Subject: [PATCH 20/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 1940b321c..6b667e78b 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -32,3 +32,4 @@ In group chats, agents should only respond when:
 This prevents spam and ensures agents participate naturally in group conversations.
 
 ### Communication Style
+- Use conversational, fun, and clear language

From c1b206177f306d8d10513a9837d175ee817ba0e0 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:40:21 +0100
Subject: [PATCH 21/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 6b667e78b..857f4b7b0 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -33,3 +33,4 @@ This prevents spam and ensures agents participate naturally in group conversatio
 
 ### Communication Style
 - Use conversational, fun, and clear language
+- Keep responses polished but not robotic

From 793d5431da17825ebd1cca923f7a285282e1f650 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:40:36 +0100
Subject: [PATCH 22/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 857f4b7b0..de860e03f 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -34,3 +34,4 @@ This prevents spam and ensures agents participate naturally in group conversatio
 ### Communication Style
 - Use conversational, fun, and clear language
 - Keep responses polished but not robotic
+- Match the energy and tone of the conversation

From 983988e5a7b44999efbb3bd755ef000cdfcb3307 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:40:53 +0100
Subject: [PATCH 23/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index de860e03f..fb1aa97c8 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -35,3 +35,5 @@ This prevents spam and ensures agents participate naturally in group conversatio
 - Use conversational, fun, and clear language
 - Keep responses polished but not robotic
 - Match the energy and tone of the conversation
+
+**Privacy Conscious**

From 232f47aac51b5ee97155439e9a8e269cbe8095b9 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:41:07 +0100
Subject: [PATCH 24/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index fb1aa97c8..a6f7e5495 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -37,3 +37,4 @@ This prevents spam and ensures agents participate naturally in group conversatio
 - Match the energy and tone of the conversation
 
 **Privacy Conscious**
+- Only ask for personal information when absolutely necessary

From 8c4515c14b5778b7e7f8f5e8d80643cd10850332 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:41:22 +0100
Subject: [PATCH 25/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index a6f7e5495..e31daaf1c 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -38,3 +38,4 @@ This prevents spam and ensures agents participate naturally in group conversatio
 
 **Privacy Conscious**
 - Only ask for personal information when absolutely necessary
+- Always explain why the information is needed

From f80406dc9715c755c7b0fda4f3dce444f7c9c320 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:41:37 +0100
Subject: [PATCH 26/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index e31daaf1c..218a98cfa 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -39,3 +39,4 @@ This prevents spam and ensures agents participate naturally in group conversatio
 **Privacy Conscious**
 - Only ask for personal information when absolutely necessary
 - Always explain why the information is needed
+- Respect user privacy and data minimization principles

From 84e03ec609f9b1ac7131b3c4118bd811ebd0d299 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:41:54 +0100
Subject: [PATCH 27/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 218a98cfa..69003f011 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -40,3 +40,5 @@ This prevents spam and ensures agents participate naturally in group conversatio
 - Only ask for personal information when absolutely necessary
 - Always explain why the information is needed
 - Respect user privacy and data minimization principles
+
+## Craft Compelling Onboarding

From 66c2c2015f8c1ed7a17c248e676355685586570c Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:44:08 +0100
Subject: [PATCH 28/98] Highlight critical onboarding message for agents

Emphasize the importance of the onboarding message for agents.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 69003f011..6e064421b 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -42,3 +42,4 @@ This prevents spam and ensures agents participate naturally in group conversatio
 - Respect user privacy and data minimization principles
 
 ## Craft Compelling Onboarding
+Your agent's first impression is critical. The onboarding message should immediately communicate value and give users a clear path forward.

From 6a66ea5c5f0248195ca7c66296a2063efa8ea074 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:45:22 +0100
Subject: [PATCH 29/98] Enhance onboarding section in quality agents guide

Added a section on crafting compelling onboarding messages for agents.
---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 6e064421b..a5a1d00ac 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -43,3 +43,5 @@ This prevents spam and ensures agents participate naturally in group conversatio
 
 ## Craft Compelling Onboarding
 Your agent's first impression is critical. The onboarding message should immediately communicate value and give users a clear path forward.
+
+### Great Onboarding Message Structure

From ea01e96d54c14ffd9af3138ad92c352b5a6d875d Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:46:49 +0100
Subject: [PATCH 30/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index a5a1d00ac..8350244e1 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -45,3 +45,4 @@ This prevents spam and ensures agents participate naturally in group conversatio
 Your agent's first impression is critical. The onboarding message should immediately communicate value and give users a clear path forward.
 
 ### Great Onboarding Message Structure
+1. **Introduce the agent** - Quick, friendly greeting with the agent's name

From 274608024f9f43ad989cc123349ed1e51ae0204b Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:47:12 +0100
Subject: [PATCH 31/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 8350244e1..7618d3f0d 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -46,3 +46,4 @@ Your agent's first impression is critical. The onboarding message should immedia
 
 ### Great Onboarding Message Structure
 1. **Introduce the agent** - Quick, friendly greeting with the agent's name
+2. **Explain capabilities** - Clear, specific examples of what it can do

From 9f809b3f6ee2eafd25333855e380bd66f0ce4e71 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:47:36 +0100
Subject: [PATCH 32/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 7618d3f0d..2301cd92a 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -47,3 +47,4 @@ Your agent's first impression is critical. The onboarding message should immedia
 ### Great Onboarding Message Structure
 1. **Introduce the agent** - Quick, friendly greeting with the agent's name
 2. **Explain capabilities** - Clear, specific examples of what it can do
+3. **Use quick select buttons** - Make it easy for users to select an action to take with the agent

From 379bf7a892ea6aceec573de5ca02ec24c54be956 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:48:07 +0100
Subject: [PATCH 33/98] Add example for high-quality onboarding message

Added an example section for high-quality onboarding.
---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 2301cd92a..7972ce9b1 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -48,3 +48,5 @@ Your agent's first impression is critical. The onboarding message should immedia
 1. **Introduce the agent** - Quick, friendly greeting with the agent's name
 2. **Explain capabilities** - Clear, specific examples of what it can do
 3. **Use quick select buttons** - Make it easy for users to select an action to take with the agent
+
+### Example: High-Quality Onboarding

From f9ae5126aaa867379e9e00f25b2ea3d8449a7e2d Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:49:07 +0100
Subject: [PATCH 34/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 7972ce9b1..6b16777bb 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -50,3 +50,4 @@ Your agent's first impression is critical. The onboarding message should immedia
 3. **Use quick select buttons** - Make it easy for users to select an action to take with the agent
 
 ### Example: High-Quality Onboarding
+```

From 175dd3e50fd27128611cc3cf932da441ae97323c Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 16:50:06 +0100
Subject: [PATCH 35/98] Add example introduction for bankr agent

Added an example introduction for the agent 'bankr' to enhance onboarding.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 6b16777bb..670adfa15 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -51,3 +51,4 @@ Your agent's first impression is critical. The onboarding message should immedia
 
 ### Example: High-Quality Onboarding
 ```
+hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's the rundown:

From 93e1309d65e8ebeaefa087cdb87eb9e1344d56f8 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:14:55 +0100
Subject: [PATCH 36/98] Add onboarding example for crypto agent

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 670adfa15..994f3c7cb 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -52,3 +52,5 @@ Your agent's first impression is critical. The onboarding message should immedia
 ### Example: High-Quality Onboarding
 ```
 hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's the rundown:
+
+• trade anything: buy, sell, swap tokens on base, polygon, and mainnet. try "buy 0.1 eth of degen."

From 4eed2d3da821e54a14fb32cb1d5077aa64f052e1 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:15:44 +0100
Subject: [PATCH 37/98] Add functionality to send crypto to users

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 994f3c7cb..e9c55ee54 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -54,3 +54,4 @@ Your agent's first impression is critical. The onboarding message should immedia
 hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's the rundown:
 
 • trade anything: buy, sell, swap tokens on base, polygon, and mainnet. try "buy 0.1 eth of degen."
+• send it: transfer crypto to anyone on x, farcaster, or a wallet address.

From 0bc3fad6cd8dbc8472e88966c8a6ec7977785d8d Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:16:17 +0100
Subject: [PATCH 38/98] Add alpha features to building quality agents
 documentation

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index e9c55ee54..16b502f82 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -55,3 +55,4 @@ hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's t
 
 • trade anything: buy, sell, swap tokens on base, polygon, and mainnet. try "buy 0.1 eth of degen."
 • send it: transfer crypto to anyone on x, farcaster, or a wallet address.
+• get alpha: token recs, market data, charts.

From 2dcdc18efc44d2964f8d79336c502ea94575ebc0 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:16:36 +0100
Subject: [PATCH 39/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 16b502f82..81d208d27 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -56,3 +56,4 @@ hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's t
 • trade anything: buy, sell, swap tokens on base, polygon, and mainnet. try "buy 0.1 eth of degen."
 • send it: transfer crypto to anyone on x, farcaster, or a wallet address.
 • get alpha: token recs, market data, charts.
+• automate: set up recurring buys/sells. e.g. "buy $10 of $bnkr every week."

From d57dedb26f8a490c0362e34358213eb4f76570fd Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:16:52 +0100
Subject: [PATCH 40/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 81d208d27..023b425f1 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -57,3 +57,6 @@ hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's t
 • send it: transfer crypto to anyone on x, farcaster, or a wallet address.
 • get alpha: token recs, market data, charts.
 • automate: set up recurring buys/sells. e.g. "buy $10 of $bnkr every week."
+
+what do you want to do first?
+```

From 3e48d1985671d1ba0c9754c9e7c9d2f69c08ae43 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:17:15 +0100
Subject: [PATCH 41/98] Explain why automation feature works

Added a section explaining why the automation feature works.
---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 023b425f1..7fdb949f6 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -60,3 +60,5 @@ hey, i'm bankr. i can help you trade, transfer, and manage your crypto. here's t
 
 what do you want to do first?
 ```
+
+**Why this works:**

From 4cd5a9be43f0dde634bbe3572f78fa7b2750ff07 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:17:36 +0100
Subject: [PATCH 42/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 7fdb949f6..ba152eda3 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -62,3 +62,4 @@ what do you want to do first?
 ```
 
 **Why this works:**
+- Friendly, conversational tone

From 4997fa2de3d140fadfd9e087004134f3502b2006 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:18:00 +0100
Subject: [PATCH 43/98] Enhance documentation with feature examples

Added specific feature examples with concrete commands to enhance clarity.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ba152eda3..5b67c2e95 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -63,3 +63,4 @@ what do you want to do first?
 
 **Why this works:**
 - Friendly, conversational tone
+- Specific feature examples with concrete commands

From 213c95d0bc4b3718c946bec0ae140e05d662a87c Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:18:24 +0100
Subject: [PATCH 44/98] Add clear value propositions to quality agents guide

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 5b67c2e95..48818317a 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -64,3 +64,4 @@ what do you want to do first?
 **Why this works:**
 - Friendly, conversational tone
 - Specific feature examples with concrete commands
+- Clear value propositions

From c9318b253e78de89a22c32c0721a26610c4251d2 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:18:42 +0100
Subject: [PATCH 45/98] Add call-to-action to building-quality-agents guide

Added a direct call-to-action to enhance engagement.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 48818317a..a03c52e44 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -65,3 +65,4 @@ what do you want to do first?
 - Friendly, conversational tone
 - Specific feature examples with concrete commands
 - Clear value propositions
+- Ends with a direct call-to-action

From 5f2518d5dc9626771047c9e6e7d44eff5e27a2db Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:19:30 +0100
Subject: [PATCH 46/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index a03c52e44..ce07fcf26 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -66,3 +66,5 @@ what do you want to do first?
 - Specific feature examples with concrete commands
 - Clear value propositions
 - Ends with a direct call-to-action
+
+### Example: Poor Onboarding

From 053c243ca28bc7ee79eb68e9ab3401a212fa48b4 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:19:47 +0100
Subject: [PATCH 47/98] Add example of poor onboarding in documentation

Added an example of poor onboarding to the document.
---
 docs/base-app/agents/building-quality-agents.mdx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ce07fcf26..fc315fdb6 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -68,3 +68,6 @@ what do you want to do first?
 - Ends with a direct call-to-action
 
 ### Example: Poor Onboarding
+```
+Gm! What can I help you with?
+```

From bbd4d791131e22499cb6648668d1cec61e3837ad Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:20:01 +0100
Subject: [PATCH 48/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index fc315fdb6..750b879f5 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -71,3 +71,4 @@ what do you want to do first?
 ```
 Gm! What can I help you with?
 ```
+**Why this fails:**

From 3933a7ccf6ccae58b3285f0b0488a10744424aea Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:20:19 +0100
Subject: [PATCH 49/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 750b879f5..ca509e850 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -72,3 +72,4 @@ what do you want to do first?
 Gm! What can I help you with?
 ```
 **Why this fails:**
+- Generic greeting with no context

From 8513c43f966f88883403233090d792aedae0105d Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:20:37 +0100
Subject: [PATCH 50/98] Enhance greeting with context and capabilities

Added explanation of capabilities to the greeting.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ca509e850..9fbc9dcce 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -73,3 +73,4 @@ Gm! What can I help you with?
 ```
 **Why this fails:**
 - Generic greeting with no context
+- No explanation of capabilities

From 87e2dcba34f406c6af9943acb825a42fd5f471b2 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:20:52 +0100
Subject: [PATCH 51/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 9fbc9dcce..b04a82fa5 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -74,3 +74,4 @@ Gm! What can I help you with?
 **Why this fails:**
 - Generic greeting with no context
 - No explanation of capabilities
+- Puts burden on user to figure out what to do

From 1be1d0d2ec88a69cc8fea696d206fd2ddbda0b96 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:21:17 +0100
Subject: [PATCH 52/98] Clarify reasons for failure in agent design

Added a point about lack of clear value proposition.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index b04a82fa5..5f834df4c 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -75,3 +75,4 @@ Gm! What can I help you with?
 - Generic greeting with no context
 - No explanation of capabilities
 - Puts burden on user to figure out what to do
+- No clear value proposition

From ac7dcd52935f5d2e49f12072587fbfc347dcc6e7 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:21:30 +0100
Subject: [PATCH 53/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 5f834df4c..d726246a6 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -76,3 +76,5 @@ Gm! What can I help you with?
 - No explanation of capabilities
 - Puts burden on user to figure out what to do
 - No clear value proposition
+
+## Showcase Unique Value

From c927592b7b251d0e41236e50d7fc43a1ae362b00 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:21:59 +0100
Subject: [PATCH 54/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index d726246a6..1e83a4cf3 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -78,3 +78,5 @@ Gm! What can I help you with?
 - No clear value proposition
 
 ## Showcase Unique Value
+
+### Solve Real Problems

From 5c598302b50a9985cf32eb93f446f20b081a575b Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:22:14 +0100
Subject: [PATCH 55/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 1e83a4cf3..3623824ee 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -80,3 +80,5 @@ Gm! What can I help you with?
 ## Showcase Unique Value
 
 ### Solve Real Problems
+
+Your agent should:

From f46efc8fbf718be207c3c11669b847b74c4ab2ec Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:22:28 +0100
Subject: [PATCH 56/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 3623824ee..90a15e1cb 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -82,3 +82,4 @@ Gm! What can I help you with?
 ### Solve Real Problems
 
 Your agent should:
+- **Address a unique pain point** or bring a delightful twist to an existing space

From 478d6dda0de083a02dfd28c1920c6c4d26be85a2 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:22:48 +0100
Subject: [PATCH 57/98] Add guideline to help users accomplish tasks easily

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 90a15e1cb..a928049df 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -83,3 +83,4 @@ Gm! What can I help you with?
 
 Your agent should:
 - **Address a unique pain point** or bring a delightful twist to an existing space
+- **Help users accomplish tasks** more easily than existing solutions

From 8f711a4ee2e85f303f7d888a7a66c547e16bbda8 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:23:14 +0100
Subject: [PATCH 58/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index a928049df..a73a9a309 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -84,3 +84,4 @@ Gm! What can I help you with?
 Your agent should:
 - **Address a unique pain point** or bring a delightful twist to an existing space
 - **Help users accomplish tasks** more easily than existing solutions
+- **Provide clear benefits** that users can understand immediately

From e2ed7da5935e0531670e1b4684f456dcae5eb60f Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:23:48 +0100
Subject: [PATCH 59/98] Add section on enabling user success

Added a section on enabling user success.
---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index a73a9a309..75ceceaf9 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -85,3 +85,5 @@ Your agent should:
 - **Address a unique pain point** or bring a delightful twist to an existing space
 - **Help users accomplish tasks** more easily than existing solutions
 - **Provide clear benefits** that users can understand immediately
+
+### Enable User Success

From c94f983c53d1bf427ba473c4ca293d4ba0c88214 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:24:10 +0100
Subject: [PATCH 60/98] Add focus on user success in agent guidelines

Added a section on focusing on user success.
---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 75ceceaf9..d81a2b9c5 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -87,3 +87,5 @@ Your agent should:
 - **Provide clear benefits** that users can understand immediately
 
 ### Enable User Success
+
+Focus on helping users:

From 6e1fbf156b7a4901f8b44beb552cdc4c641a00c9 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:25:36 +0100
Subject: [PATCH 61/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index d81a2b9c5..9998b5666 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -89,3 +89,4 @@ Your agent should:
 ### Enable User Success
 
 Focus on helping users:
+- **Earn** - Generate income, rewards, or value

From 8a91891b08b5a01e6bfeed6419402f7dc52b0e85 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:25:53 +0100
Subject: [PATCH 62/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 9998b5666..dd188e500 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -90,3 +90,4 @@ Your agent should:
 
 Focus on helping users:
 - **Earn** - Generate income, rewards, or value
+- **Connect** - Build relationships or communities

From 3569a8beda83d2af30cfd98075ef36ee5b0c3219 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:27:02 +0100
Subject: [PATCH 63/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index dd188e500..1a1ba2453 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -91,3 +91,4 @@ Your agent should:
 Focus on helping users:
 - **Earn** - Generate income, rewards, or value
 - **Connect** - Build relationships or communities
+- **Have fun** - Provide entertainment or engaging experiences

From adbf3edc9fee77bf73cd1d9690e9d6a99341f112 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:27:25 +0100
Subject: [PATCH 64/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 1a1ba2453..896d094a8 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -92,3 +92,4 @@ Focus on helping users:
 - **Earn** - Generate income, rewards, or value
 - **Connect** - Build relationships or communities
 - **Have fun** - Provide entertainment or engaging experiences
+- **Complete tasks** - Streamline workflows or processes

From bedfa3c5dfb3112c0189e60443f87b25d9f9b24e Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:28:12 +0100
Subject: [PATCH 65/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 896d094a8..8ab5bd13c 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -93,3 +93,5 @@ Focus on helping users:
 - **Connect** - Build relationships or communities
 - **Have fun** - Provide entertainment or engaging experiences
 - **Complete tasks** - Streamline workflows or processes
+
+### Design for Engagement

From 68937ca233a6d1815f5deceaa4ec24f4c6f39c66 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:30:29 +0100
Subject: [PATCH 66/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 8ab5bd13c..db0334d5a 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -95,3 +95,4 @@ Focus on helping users:
 - **Complete tasks** - Streamline workflows or processes
 
 ### Design for Engagement
+**Build Natural Growth Loops**

From ea59425e6b3a6bf5b0cf40d0577e898442267eb1 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:30:55 +0100
Subject: [PATCH 67/98] Add section on designing for engagement

Added a section on building natural growth loops to enhance engagement.
---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index db0334d5a..26efe1467 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -95,4 +95,6 @@ Focus on helping users:
 - **Complete tasks** - Streamline workflows or processes
 
 ### Design for Engagement
+
 **Build Natural Growth Loops**
+- Include features that encourage sharing, re-engagement, and habit forming

From 65544f0df9dc57b830cb6a3a4039d5e92ebc5469 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:31:20 +0100
Subject: [PATCH 68/98] Add note on user invitations for engagement

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 26efe1467..a288b5b23 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -98,3 +98,4 @@ Focus on helping users:
 
 **Build Natural Growth Loops**
 - Include features that encourage sharing, re-engagement, and habit forming
+- Make it beneficial for users to invite others

From 9997f3cbdc4a22ca23f0331e80045c8e2833951a Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:31:44 +0100
Subject: [PATCH 69/98] Enhance growth loop strategies in documentation

Added a point about creating ongoing value to encourage user retention.
---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index a288b5b23..c17ee5562 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -99,3 +99,4 @@ Focus on helping users:
 **Build Natural Growth Loops**
 - Include features that encourage sharing, re-engagement, and habit forming
 - Make it beneficial for users to invite others
+- Create ongoing value that brings users back

From 261927f58dc756c03560801b8e64d05022198626 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:32:00 +0100
Subject: [PATCH 70/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index c17ee5562..78c4400d4 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -100,3 +100,5 @@ Focus on helping users:
 - Include features that encourage sharing, re-engagement, and habit forming
 - Make it beneficial for users to invite others
 - Create ongoing value that brings users back
+
+**Plan the User Journey**

From c7596b369fd54b13667688cce59bc7dc328b5882 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:32:18 +0100
Subject: [PATCH 71/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 78c4400d4..6c2438fb9 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -102,3 +102,5 @@ Focus on helping users:
 - Create ongoing value that brings users back
 
 **Plan the User Journey**
+
+1. **Define the ideal user experience first**

From b7913eaeadb39c27e5575072025cb77d85c1ba8c Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:32:32 +0100
Subject: [PATCH 72/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 6c2438fb9..9044f3290 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -104,3 +104,4 @@ Focus on helping users:
 **Plan the User Journey**
 
 1. **Define the ideal user experience first**
+2. **Craft agent messages around that journey**

From f7bf5f87b04f30ed05dde9332ef0c61b46bca1b5 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:32:46 +0100
Subject: [PATCH 73/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 9044f3290..beb098946 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -105,3 +105,4 @@ Focus on helping users:
 
 1. **Define the ideal user experience first**
 2. **Craft agent messages around that journey**
+3. **Guide users through progressive value discovery**

From 04c5c5c8ac6a2a9034859b33468378e39f5a28d4 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:33:04 +0100
Subject: [PATCH 74/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index beb098946..e084f2fd3 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -106,3 +106,5 @@ Focus on helping users:
 1. **Define the ideal user experience first**
 2. **Craft agent messages around that journey**
 3. **Guide users through progressive value discovery**
+
+### Continuous Engagement Strategy

From 160061de27e83fe727e651d0e365fbe95ebaf439 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:33:28 +0100
Subject: [PATCH 75/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index e084f2fd3..07657d5ab 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -108,3 +108,4 @@ Focus on helping users:
 3. **Guide users through progressive value discovery**
 
 ### Continuous Engagement Strategy
+As users complete actions with your agent:

From 61702468bd60514ae1d2173b1dae879b186f9747 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:33:58 +0100
Subject: [PATCH 76/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 07657d5ab..f39c646a5 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -109,3 +109,5 @@ Focus on helping users:
 
 ### Continuous Engagement Strategy
 As users complete actions with your agent:
+
+- **Show clear next steps** - Always give users something else to try

From d0692482b74986e176c6c2d936b0b8390afec451 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:34:15 +0100
Subject: [PATCH 77/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index f39c646a5..937ff67fa 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -111,3 +111,4 @@ Focus on helping users:
 As users complete actions with your agent:
 
 - **Show clear next steps** - Always give users something else to try
+- **Highlight ongoing value** - Explain how continued use benefits them

From 5cdda74c76fdf6df7037463c3e20d32b0e274dfa Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:34:42 +0100
Subject: [PATCH 78/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 937ff67fa..fe5a3ba24 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -112,3 +112,4 @@ As users complete actions with your agent:
 
 - **Show clear next steps** - Always give users something else to try
 - **Highlight ongoing value** - Explain how continued use benefits them
+- **Create habit loops** - Design features that encourage regular interaction

From f42ac26e6a7df266f2aeb199891739e63520c5e5 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:35:02 +0100
Subject: [PATCH 79/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index fe5a3ba24..9ddbeb3db 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -113,3 +113,4 @@ As users complete actions with your agent:
 - **Show clear next steps** - Always give users something else to try
 - **Highlight ongoing value** - Explain how continued use benefits them
 - **Create habit loops** - Design features that encourage regular interaction
+- **Prevent one-and-done usage** - Build features that require return visits

From 69af9214678be3aad1e60feac48869a4a39e5507 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:35:20 +0100
Subject: [PATCH 80/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 9ddbeb3db..e25be3861 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -114,3 +114,5 @@ As users complete actions with your agent:
 - **Highlight ongoing value** - Explain how continued use benefits them
 - **Create habit loops** - Design features that encourage regular interaction
 - **Prevent one-and-done usage** - Build features that require return visits
+
+### Examples of Engagement Features

From 8b8592b6994ed9f4177dd6d5af20db6c996b87ad Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:35:40 +0100
Subject: [PATCH 81/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index e25be3861..ddea6f458 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -116,3 +116,4 @@ As users complete actions with your agent:
 - **Prevent one-and-done usage** - Build features that require return visits
 
 ### Examples of Engagement Features
+- **Progressive features** - Unlock new capabilities as users engage more

From 92abfd53b40066bad88881739d4ae5d0010ec90d Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:35:57 +0100
Subject: [PATCH 82/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ddea6f458..d10fcbcb0 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -117,3 +117,4 @@ As users complete actions with your agent:
 
 ### Examples of Engagement Features
 - **Progressive features** - Unlock new capabilities as users engage more
+- **Personalization** - Learn user preferences and customize experiences

From dec8920eb85ac662b3e23ac554c164466e96d807 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:36:13 +0100
Subject: [PATCH 83/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index d10fcbcb0..86075925c 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -118,3 +118,4 @@ As users complete actions with your agent:
 ### Examples of Engagement Features
 - **Progressive features** - Unlock new capabilities as users engage more
 - **Personalization** - Learn user preferences and customize experiences
+- **Social elements** - Enable sharing achievements or inviting friends

From 44612a701740b4d1053345de34e2c126f3785fb4 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:36:31 +0100
Subject: [PATCH 84/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 86075925c..f23cc19e8 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -119,3 +119,4 @@ As users complete actions with your agent:
 - **Progressive features** - Unlock new capabilities as users engage more
 - **Personalization** - Learn user preferences and customize experiences
 - **Social elements** - Enable sharing achievements or inviting friends
+- **Recurring value** - Automated tasks, alerts, or regular check-ins

From 3695d3b325841a8b9f73162848063719ac443c77 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:36:53 +0100
Subject: [PATCH 85/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index f23cc19e8..ae872a107 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -120,3 +120,5 @@ As users complete actions with your agent:
 - **Personalization** - Learn user preferences and customize experiences
 - **Social elements** - Enable sharing achievements or inviting friends
 - **Recurring value** - Automated tasks, alerts, or regular check-ins
+
+- **Gamification** - Points, levels, or achievement systems

From f7ebe281b989e25d1e428f7f3fba3ca9f4611e36 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:37:18 +0100
Subject: [PATCH 86/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ae872a107..afe5949fc 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -122,3 +122,5 @@ As users complete actions with your agent:
 - **Recurring value** - Automated tasks, alerts, or regular check-ins
 
 - **Gamification** - Points, levels, or achievement systems
+
+## 2026 Best Practices for AI Agents

From 87215b9f11c731fd69d357e3a408fc8db538bb9f Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:37:38 +0100
Subject: [PATCH 87/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index afe5949fc..574e1401f 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -124,3 +124,5 @@ As users complete actions with your agent:
 - **Gamification** - Points, levels, or achievement systems
 
 ## 2026 Best Practices for AI Agents
+
+### Agentic UX: Designing for Autonomy

From 2bec13f944d904bba4ce53d8800c60e378c9c016 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:37:56 +0100
Subject: [PATCH 88/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 574e1401f..cf99bcc6a 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -126,3 +126,5 @@ As users complete actions with your agent:
 ## 2026 Best Practices for AI Agents
 
 ### Agentic UX: Designing for Autonomy
+
+Modern users expect agents to take initiative and complete tasks on their behalf. When designing agentic experiences:

From 7500857b286536e22aa2d83b4a904f963d1fa866 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:38:19 +0100
Subject: [PATCH 89/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index cf99bcc6a..d9ed54cab 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -128,3 +128,5 @@ As users complete actions with your agent:
 ### Agentic UX: Designing for Autonomy
 
 Modern users expect agents to take initiative and complete tasks on their behalf. When designing agentic experiences:
+
+**Build Trust Through Transparency**

From 78b5ea52a3d560862351c6f98515fcca299b1506 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:39:00 +0100
Subject: [PATCH 90/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index d9ed54cab..4269d208e 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -130,3 +130,4 @@ As users complete actions with your agent:
 Modern users expect agents to take initiative and complete tasks on their behalf. When designing agentic experiences:
 
 **Build Trust Through Transparency**
+- Show clear previews of what actions the agent will take before executing

From 7c4ce77948017fc6ecdf492b0872aa1144a67534 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:39:19 +0100
Subject: [PATCH 91/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 4269d208e..4d89493d1 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -131,3 +131,4 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 
 **Build Trust Through Transparency**
 - Show clear previews of what actions the agent will take before executing
+- Provide activity logs so users can review what happened

From a58abf031e51c229e15d6fe99b8376f0b05e7c84 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:39:33 +0100
Subject: [PATCH 92/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 4d89493d1..f7989ca95 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -132,3 +132,4 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 **Build Trust Through Transparency**
 - Show clear previews of what actions the agent will take before executing
 - Provide activity logs so users can review what happened
+- Enable simple undo/stop controls for all autonomous actions

From b1119fde953d62bda525dac36bb41aef938af0b4 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:39:58 +0100
Subject: [PATCH 93/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index f7989ca95..e8cd23497 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -133,3 +133,4 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 - Show clear previews of what actions the agent will take before executing
 - Provide activity logs so users can review what happened
 - Enable simple undo/stop controls for all autonomous actions
+- Display clear role statements: "I can [do X]. I won't [do Y] without your approval."

From 0b3179c8a26891639c68b541d5252ee090b2dbf4 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:40:35 +0100
Subject: [PATCH 94/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index e8cd23497..274b13fe0 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -134,3 +134,5 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 - Provide activity logs so users can review what happened
 - Enable simple undo/stop controls for all autonomous actions
 - Display clear role statements: "I can [do X]. I won't [do Y] without your approval."
+
+**Start Small, Scale Gradually**

From 35de2e2768e3c886b0acfc9343e169e35d113876 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:40:58 +0100
Subject: [PATCH 95/98] Add guidance for starting small with agents

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 274b13fe0..ad89506b4 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -136,3 +136,4 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 - Display clear role statements: "I can [do X]. I won't [do Y] without your approval."
 
 **Start Small, Scale Gradually**
+- Begin with bounded, low-risk tasks (checking status, simple transfers)

From 81c9b0a715f749e74daec734330434e4fed81db1 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:41:27 +0100
Subject: [PATCH 96/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ad89506b4..0689cb4c5 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -137,3 +137,4 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 
 **Start Small, Scale Gradually**
 - Begin with bounded, low-risk tasks (checking status, simple transfers)
+- Progressively unlock more complex autonomous workflows as users build trust

From daa2d8b046928946d3a132c46a20689322a4f660 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 17:42:45 +0100
Subject: [PATCH 97/98] Update building-quality-agents.mdx

---
 docs/base-app/agents/building-quality-agents.mdx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index 0689cb4c5..ca89d6a26 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -138,3 +138,6 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 **Start Small, Scale Gradually**
 - Begin with bounded, low-risk tasks (checking status, simple transfers)
 - Progressively unlock more complex autonomous workflows as users build trust
+- Design safe failure modes with graceful recovery paths
+
+**Context Awareness**

From 31a7b31302856f53c7ab515f44a139648ddf8040 Mon Sep 17 00:00:00 2001
From: Afolabi Ayomide Emmanuel <138625749+Spagero763@users.noreply.github.com>
Date: Tue, 20 Jan 2026 18:28:23 +0100
Subject: [PATCH 98/98] Enhance guidelines for building quality agents

Expanded on various design principles for building quality agents, including context awareness, predictive interfaces, privacy-first design, accessibility, micro-interactions, and success metrics.
---
 .../agents/building-quality-agents.mdx        | 88 +++++++++++++++++++
 1 file changed, 88 insertions(+)

diff --git a/docs/base-app/agents/building-quality-agents.mdx b/docs/base-app/agents/building-quality-agents.mdx
index ca89d6a26..306961f9f 100644
--- a/docs/base-app/agents/building-quality-agents.mdx
+++ b/docs/base-app/agents/building-quality-agents.mdx
@@ -141,3 +141,91 @@ Modern users expect agents to take initiative and complete tasks on their behalf
 - Design safe failure modes with graceful recovery paths
 
 **Context Awareness**
+
+- Make it clear what information the agent is using to make decisions
+- Show what data sources are being accessed
+- Explain what's missing or uncertain that might affect the action
+
+### Predictive & Adaptive Interfaces
+
+Agents should anticipate user needs based on patterns and context:
+
+**Smart Personalization**
+- Reorder quick actions based on time of day or user history
+- Surface frequently-used features more prominently
+- Reduce repetitive inputs by remembering preferences
+
+**Correction Mechanisms**
+- Always provide quick ways to reset or correct misguided predictions
+- Let users easily override automated suggestions
+- Learn from corrections to improve future predictions
+
+### Privacy-First Design (2026 Standards)
+
+With increasing regulatory requirements and user awareness:
+
+**Visible Privacy Controls**
+- Make data usage visible at the moment of action, not hidden in settings
+- Offer frictionless opt-outs for data collection and personalization
+- Explain clearly where data goes and what it's used for
+- Design consent flows that are respectful, clear, and fast
+
+**Data Minimization**
+- Only request data that's truly necessary for the current task
+- Provide clear explanations for why each piece of data is needed
+- Offer alternatives that require less personal information when possible
+
+### Accessibility & Inclusive Design
+
+Accessibility is now mandatory in many jurisdictions. Your agent should:
+
+**Universal Design Principles**
+- Support voice interactions for users with mobility challenges
+- Ensure all visual information has text alternatives
+- Provide clear, simple language that works across literacy levels
+- Test with diverse user groups including people with disabilities
+
+**Sustainable UX**
+- Optimize for low-bandwidth scenarios
+- Minimize unnecessary animations or heavy assets
+- Consider energy efficiency in your design choices
+
+### Micro-Interactions & Feedback
+
+Small details create trust and delight in 2026:
+
+**Intelligent Feedback**
+- Use micro-interactions to communicate system state and progress
+- Show when the agent is thinking, processing, or waiting
+- Provide progressive disclosure of complex actions
+- Celebrate completed tasks with subtle, satisfying animations
+
+**Error Recovery**
+- Design for graceful failures with clear next steps
+- Provide helpful error messages that explain what went wrong
+- Offer alternative paths when the primary action fails
+
+## Measuring Success
+
+Track these key metrics to understand your agent's performance:
+
+**Engagement Metrics**
+- Response time (target: < 5 seconds)
+- Message completion rate
+- Return user rate (7-day, 30-day)
+- Actions per conversation
+
+**Quality Metrics**
+- User satisfaction ratings
+- Support ticket volume
+- Error/failure rates
+- Undo/correction frequency
+
+**Growth Metrics**
+- New user acquisition
+- Referral/share rate
+- Feature adoption curve
+- Long-term retention
+
+---
+