Assistant: update Posit Assistant guidance

_positron-assistant-deprecated.qmd

@@ -0,0 +1,5 @@
+::: {.callout-warning}
+## Positron Assistant is being deprecated
+
+This page covers Positron Assistant, the old chat experience being superseded by [Posit Assistant](https://pos.it/assistant). It will be removed in a future release, so we recommend using Posit Assistant instead. See the [Posit Assistant documentation](https://pos.it/assistant-docs) to get set up.
+:::

assistant-chat-agents.qmd

@@ -3,8 +3,12 @@ title: "Chat Agents"
 description: "Customize AI behavior with chat agents in Positron Assistant. Choose from Ask, Edit, Agent, and Plan modes or create custom agents for specific tasks."
 ---
 
-::: {.callout-note}
-Chat agents were previously called chat modes.
+{{< include _positron-assistant-deprecated.qmd >}}
+
+::: {.callout-tip}
+## Migrating to Posit Assistant?
+
+Posit Assistant manages tool use and agent behavior through permissions. See [Permissions](https://posit-dev.github.io/assistant/docs/features/permissions/) in the Posit Assistant documentation.
 :::
 
 Chat agents tailor Assistant's behavior for specific tasks by providing unique instructions and tools. Select the agent selector dropdown at the bottom of the chat pane to switch between agents.

assistant-chat-commands-participants.qmd

@@ -3,6 +3,14 @@ title: "Commands & Participants"
 description: "Speed up your workflow with slash commands and chat participants in Positron Assistant. Access quick actions and specialized AI help without long prompts."
 ---
 
+{{< include _positron-assistant-deprecated.qmd >}}
+
+::: {.callout-tip}
+## Migrating to Posit Assistant?
+
+Posit Assistant has its own set of slash commands. See [Commands](https://posit-dev.github.io/assistant/docs/features/commands/) in the Posit Assistant documentation.
+:::
+
 ## Slash commands
 
 Slash commands provide quick access to common tasks without writing long prompts.

assistant-chat-context.qmd

@@ -3,6 +3,14 @@ title: "Context"
 description: "Give Positron Assistant context from your data, plots, Console activity, and files. Learn how to attach relevant context for smarter AI assistance."
 ---
 
+{{< include _positron-assistant-deprecated.qmd >}}
+
+::: {.callout-tip}
+## Migrating to Posit Assistant?
+
+Posit Assistant handles context in its own way. See [Context management](https://posit-dev.github.io/assistant/docs/features/context-management/) in the Posit Assistant documentation.
+:::
+
 Positron Assistant goes beyond reading your code files; it accesses your loaded data, plots, and Console activity by calling tools and executing code in your R or Python interpreter session or running commands in the Terminal.
 
 This access allows Assistant to provide more relevant coding guidance based on:

assistant-chat-instructions.qmd

@@ -3,12 +3,18 @@ title: "Custom Instructions"
 description: "Tailor Positron Assistant to your project with custom instructions. Set up workspace-specific AI behavior and coding preferences automatically."
 ---
 
-::: {.callout-note}
-Custom instructions do not apply to code completions.
+{{< include _positron-assistant-deprecated.qmd >}}
+
+::: {.callout-tip}
+## Migrating to Posit Assistant?
+
+Posit Assistant includes a built-in skill, `/import-instructions`, that migrates Positron, Copilot, Claude Code, and VS Code instruction files into Posit Assistant skills. Run it to bring the instructions described on this page over to Posit Assistant.
 :::
 
 Positron Assistant supports both **automatic workspace instructions** and **custom instructions files** to tailor AI behavior to your project's needs.
 
+Custom instructions do not apply to code completions.
+
 ## Automatic workspace instructions
 
 Add project-wide custom instructions by creating one or more of these files in your workspace root directory:

assistant-chat.qmd

@@ -3,11 +3,17 @@ title: "Chat"
 description: "Use Positron Assistant's chat pane for AI-powered coding help, inline assistance in editors and terminals, and quick Console error fixes."
 ---
 
+{{< include _positron-assistant-deprecated.qmd >}}
+
+::: {.callout-tip}
+## Migrating to Posit Assistant?
+
+See [Chat features](https://posit-dev.github.io/assistant/docs/features/chat-features/) in the Posit Assistant documentation.
+:::
+
 Positron Assistant provides multiple ways to interact with AI assistance across your workspace. Whether you use the dedicated chat pane, inline chat within your Editor or Terminal, or quick Console actions for errors, Assistant integrates seamlessly with your development environment.
 
-::: {.callout-important}
 To use Positron Assistant features, you'll need to first configure a language model provider. See the [Getting Started](assistant-getting-started.qmd) guide for more details.
-:::
 
 ## Chat pane