Document /security-review slash command in GitHub Copilot app (#62276)

Author: saritai

content/copilot/how-tos/github-copilot-app/agent-sessions.md

@@ -47,24 +47,18 @@ Hover over the {% octicon "info" aria-label="the info icon" %} icon in the model
 
 **Quick chats** in the sidebar opens a conversation mode without creating a dedicated branch or worktree. Use it for brainstorming, asking questions, or exploring ideas before starting a session. Your chat history is saved and listed by conversation name.
 
-## Using `/chronicle` with app sessions
+## Using `/security-review` in app sessions
 
-Because the {% data variables.copilot.github_copilot_app %} is built on {% data variables.copilot.copilot_cli %}, you can use {% data variables.copilot.copilot_cli_short %} session history features such as `/chronicle` to get insights from work you did in the app and in other {% data variables.copilot.copilot_cli_short %} sessions.
+> [!NOTE]
+> The `/security-review` slash command is currently in {% data variables.release-phases.public_preview %} and subject to change.
 
-For example, you can use `/chronicle standup` to summarize recent work. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/chronicle).
+You can run the `/security-review` slash command in an active agent session to review your current workstream changes for high-confidence vulnerabilities. The command returns prioritized findings with severity and confidence scores, plus suggested fixes you can apply and verify in the same session.
 
-## Using voice dictation
+1. Open an active session that has in-progress code changes.
+1. In the prompt box, type `/security-review` and press <kbd>Enter</kbd>.
+1. Review the findings, then update your code changes as needed.
 
-You can use voice dictation to speak prompts in a session instead of typing them.
-
-Before you can use voice dictation, you need to configure it in the app settings.
-
-1. Open the app settings, then select the **Voice dictation** tab.
-1. Choose a keyboard shortcut.
-1. Allow microphone access in your operating system settings.
-1. Download a local transcription model.
-
-After setup, use your shortcut to start and stop voice transcription. The app inserts transcribed text into the prompt box so you can review or edit it before sending.
+This lightweight, on-demand review complements {% data variables.product.github %} {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_dependabot %}, and {% data variables.product.prodname_secret_scanning %} by giving you an initial check on your local changes before opening a pull request.
 
 ## Using the rubber duck agent
 
@@ -82,6 +76,25 @@ You can also manually ask {% data variables.product.prodname_copilot_short %} to
 
 For more information on the rubber duck agent, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/rubber-duck).
 
+## Using `/chronicle` with app sessions
+
+Because the {% data variables.copilot.github_copilot_app %} is built on {% data variables.copilot.copilot_cli %}, you can use {% data variables.copilot.copilot_cli_short %} session history features such as `/chronicle` to get insights from work you did in the app and in other {% data variables.copilot.copilot_cli_short %} sessions.
+
+For example, you can use `/chronicle standup` to summarize recent work. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/chronicle).
+
+## Using voice dictation
+
+You can use voice dictation to speak prompts in a session instead of typing them.
+
+Before you can use voice dictation, you need to configure it in the app settings.
+
+1. Open the app settings, then select the **Voice dictation** tab.
+1. Choose a keyboard shortcut.
+1. Allow microphone access in your operating system settings.
+1. Download a local transcription model.
+
+After setup, use your shortcut to start and stop voice transcription. The app inserts transcribed text into the prompt box so you can review or edit it before sending.
+
 ## Keyboard shortcuts
 
 The {% data variables.copilot.github_copilot_app %} supports keyboard shortcuts to help you navigate sessions, switch between workspaces, and perform common actions. To see available shortcuts, open the app, go to **Help**, then **Keyboard Shortcuts**.