💅

Author: ethanpalm

ai/agent.mdx

@@ -59,7 +59,7 @@ The agent assists with many different documentation tasks. These workflows show
 ### Iterate on a prompt in a Slack thread
 Prompt the agent, then continue to mention it with `@mintlify` in the same thread to refine and iterate on the pull request that it creates. For example: `@mintlify Our quickstart page needs a new section on inviting collaborators` then `@mintlify The new section should be called "Inviting collaborators"` and any other iterations.
 
-### Begin with the agent then take over
+### Start with the agent, finish manually
 Prompt the agent to begin a project, then check out the branch it creates and finish the task in your local environment or the web editor. The agent can help you get started, then you can take over to complete the task. For example: `@mintlify Update the quickstart page to include information about inviting collaborators` and then checkout the branch to make any additional changes using your preferred method.
 
 ### Update docs when merging feature changes
@@ -75,7 +75,7 @@ Prompt the agent to generate code examples for features throughout your docs or
 Prompt the agent to review existing content for technical accuracy, style, grammar, or other issues. For example: `@mintlify Review the API rate limiting section. We changed limits last month`.
 
 ### Respond to user feedback
-Prompt the agent with feedback from your users to make focused updates to your docs. For example: `@mintlify Users are getting confused by step 3 in the setup guide. Make it more clear`.
+Prompt the agent with feedback from your users to make focused updates to your docs. For example: `@mintlify Users are getting confused by step 3 in the setup guide. What might be making it unclear?`.
 
 ### Automate with the API
 Integrate the agent into your existing automation tools to automatically update documentation when code changes occur, trigger content reviews, or sync documentation updates across multiple repositories.