update example workflows

Author: ethanpalm

ai/agent.mdx

@@ -19,7 +19,9 @@ Use the agent to:
 
 To get started, add the agent to your Slack workspace and mention it with `@mintlify` in a channel.
 
-## Add Agent to your Slack workspace
+## Configure the agent
+
+### Add Agent to your Slack workspace
 
 <Note>
   If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the TODO: (confirm app name) MintlifyWriter app before you add it.
@@ -32,6 +34,10 @@ TODO: confirm steps
   - Send a direct message to it.
   - Mention it with `@mintlify` in a channel.
 
+### Give the agent access to your repositories
+
+TODO: once workflow is finalized
+
 ## Embed the agent via API
 TODO: this whole section once the API is finalized
 See the API reference for more info.
@@ -51,25 +57,25 @@ Use broad prompts for general content maintenance like fixing typos, updating re
 The agent assists with many different documentation tasks. These workflows show some of the ways you can integrate the agent into your documentation process. Try an approach that fits how your team currently works and adapt it to your specific needs.
 
 ### Iterate on a prompt in a Slack thread
-You can 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.
+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 in your local environment or the web editor
-You can also query 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.
+### Begin with the agent then take over
+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
-When you merge a feature PR, mention the agent with the PR link to automatically update relevant documentation. For example: `@mintlify This PR adds a new authentication method. Update the API docs to include the new auth flow: [PR link]`.
+When you merge a feature pull request, prompt the agent with a link to the pull request to automatically update relevant documentation. For example: `@mintlify This PR adds a new authentication method. Update the docs to include the new auth flow: [PR link]`.
 
 ### Generate release notes from commit history
-Mention the agent with a specific PR or a time period to generate release notes or changelog updates based on the commit history. For example: `@mintlify Generate release notes for this PR: [PR link]`.
+Prompt the agent with a specific pull request or a time period to generate release notes or changelog updates based on the commit history. For example: `@mintlify Generate release notes for this PR: [PR link]` or `@mintlify Generate release notes for the last month`.
 
 ### Generate code examples
-Generate code examples for features or endpoints. For example: `@mintlify Generate a code example to make the authentication method easier to understand`.
-
-TODO: could be more specific about when/why this helps users
+Prompt the agent to generate code examples for features throughout your docs or on specific pages. For example: `@mintlify Generate a code example to make the authentication method easier to understand`.
 
-1. Add a workflow about reviewing existing content for accuracy: @mintlify Review the API rate limiting section - we changed limits last month
+### Review existing content
+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`.
 
-2. Consider adding troubleshooting prompts: @mintlify Users are getting confused by step 3 in the setup guide. Make it clearer
+### 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`.
 
 ### 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.