retejs · Ni55aN · Jul 7, 2026
diff --git a/content/en/docs/02.getting-started.md b/content/en/docs/02.getting-started.md
@@ -29,13 +29,13 @@ If TypeScript is your preferred choice, make sure you have TypeScript version 4.
 
 ## AI Assistance {#ai-assistance}
 
-Get intelligent, context-aware help in your AI-powered IDE. Use your IDE's agent or command execution feature (available in Cursor, GitHub Copilot Chat, Windsurf, and similar tools) and simply ask your AI assistant:
+Get intelligent help in your AI-powered IDE when working with Rete.js. Use your IDE's agent or command execution feature (available in Cursor, GitHub Copilot Chat, and similar tools) and simply ask your AI assistant:
 
 ```prompt
-Run npx rete-kit ai for [your intention]
+Run npx rete-kit@latest ai
 ```
 
-Replace `[your intention]` with your actual goal, such as "learning Rete.js", "creating a new app", or "adding to my existing project". The AI agent will automatically determine the right options based on your intent. This generates IDE-specific instructions that help AI assistants understand Rete.js patterns and provide relevant guidance.
+Run it once per project — this starts a short agent-driven setup for Rete.js AI guidance. Ask anything afterward about learning, building, or extending Rete.js.
 
 For more details, see the [AI Assistance](/docs/development/ai-assistance) documentation.
 

diff --git a/content/en/docs/20.development/1.index.md b/content/en/docs/20.development/1.index.md
@@ -21,7 +21,7 @@ Check out the [Rete Kit](/docs/development/rete-kit) article for details.
 
 ## AI Assistance {#ai-assistance}
 
-Enhance your Rete.js development workflow with AI-powered coding assistants. Get context-aware help for learning, creating applications, or developing plugins.
+Enhance your Rete.js development workflow with AI-powered coding assistants. Get AI help for learning, creating applications, or developing plugins.
 
 Check out the [AI Assistance](/docs/development/ai-assistance) article for details.
 

diff --git a/content/en/docs/20.development/3.rete-kit.md b/content/en/docs/20.development/3.rete-kit.md
@@ -26,7 +26,7 @@ It offers the following features:
 - **Plugin creating**: use this feature to create a basic plugin structure instantly, without the need for setting up a build system, linter, or test runner
 - **Application creation**: choose the framework to build your application, specify the version and desired features and get a ready-to-use application to jumpstart your development process
 - **Batch build**: select copies of repositories containing the source code of the plugins being developed and this tool will start building them in a watch mode, as well as synchronizing their dependencies
-- **AI assistance**: generate context-aware instructions for AI-powered code editors to get intelligent help when learning or developing with Rete.js. See the [AI Assistance](/docs/development/ai-assistance/rete-kit-ai) documentation for details
+- **AI assistance**: set up Rete.js AI guidance for AI-powered code editors. See the [AI Assistance](/docs/development/ai-assistance/rete-kit-ai) documentation for details
 
 ## Install {#install-rete-kit}
 
@@ -103,17 +103,17 @@ Please note that to use the hot reload feature to its fullest, you will need to
 
 ## AI assistance {#ai-assistance-rete-kit}
 
-Generate context-aware instructions for AI-powered code editors (Cursor, GitHub Copilot, Windsurf, etc.) to get intelligent help when learning or developing with Rete.js. Use your IDE's agent or command execution feature and simply ask your AI assistant:
+Set up Rete.js AI guidance for AI-powered code editors (Cursor, GitHub Copilot, and others). Use your IDE's agent or command execution feature and simply ask your AI assistant:
 
 ```prompt
-Run npx rete-kit ai for [your intention]
+Run npx rete-kit@latest ai
 ```
 
-Replace `[your intention]` with your actual goal, such as "learning Rete.js", "creating a new app", or "adding to my existing project". The AI agent will automatically determine the right options based on your intent.
+Run it once per project — this starts an agent-driven setup; your assistant finishes install and cleanup. Different tasks (learning, scaffolding, integration, plugins) are handled afterward in chat, not via separate command runs.
 
 See the [AI Assistance](/docs/development/ai-assistance/rete-kit-ai) documentation for complete details.
 
 ## Related Documentation {#related-documentation}
 
-- [AI Assistance](/docs/development/ai-assistance) - Generate context-aware instructions for AI-powered code editors
+- [AI Assistance](/docs/development/ai-assistance) - Set up Rete.js AI guidance for AI-powered code editors
 - [Rete CLI](/docs/development/rete-cli) - Build tool for plugin development
diff --git a/content/en/docs/20.development/4.ai-assistance/1.index.md b/content/en/docs/20.development/4.ai-assistance/1.index.md
@@ -9,28 +9,28 @@ Enhance your Rete.js development workflow with AI-powered coding assistants. Thi
 
 ## Quick Start {#quick-start}
 
-The fastest way to get AI assistance for Rete.js development is to use your AI-powered IDE's agent or command execution feature (available in Cursor, GitHub Copilot Chat, Windsurf, and similar tools). Simply ask your AI assistant:
+The fastest way to get AI assistance for Rete.js development is to use your AI-powered IDE's agent or command execution feature (available in Cursor, GitHub Copilot Chat, and similar tools). Simply ask your AI assistant:
 
 ```prompt
-Run npx rete-kit ai for [your intention]
+Run npx rete-kit@latest ai
 ```
 
-Replace `[your intention]` with your actual goal, such as "learning Rete.js", "creating a new app", or "adding to my existing project". The AI agent will automatically determine the right tool and context options based on your description. This generates context-aware instructions for your IDE's AI assistant.
+Run it once per project — this kicks off a short agent-driven setup (staging, install, cleanup). After that, describe what you need in plain language (learning, new app, integration, plugin work, and more).
 
-For manual usage or more details, see the [Rete Kit AI](/docs/development/ai-assistance/rete-kit-ai) documentation.
+For complete documentation, see [Rete Kit AI](/docs/development/ai-assistance/rete-kit-ai).
 
 ## Available Options {#available-options}
 
 ### Rete Kit AI {#rete-kit-ai}
 
-**Best for:** Automated, context-aware IDE integration
+**Best for:** Automated IDE setup with Rete.js-aware AI assistance
 
-The `npx rete-kit ai` command (or `rete-kit ai` if installed globally) generates IDE-specific instruction files that provide contextually appropriate help based on your current situation:
+The `npx rete-kit@latest ai` command (or `rete-kit ai` if installed globally) starts setup — your IDE agent stages, installs, and finalizes project instructions, task guides, and specialized agents. Later, when you ask for help, it adapts by task — for example:
 
-- **Learning Rete.js** → `onboard` context
-- **Creating new apps** → `boot` context  
-- **Working with existing code** → `dev` context
-- **Plugin development** → `plugin` context
+- **Learning Rete.js** → onboarding guidance
+- **Creating new apps** → app scaffolding guidance
+- **Working with existing code** → integration and customization guidance
+- **Plugin development** → plugin development guidance
 
 Check out the [Rete Kit AI](/docs/development/ai-assistance/rete-kit-ai) guide for complete documentation.
 
@@ -47,7 +47,7 @@ See the [LLMs.txt](/docs/development/ai-assistance/llms) guide for integration e
 
 ## Which Should I Use? {#which-should-i-use}
 
-- **Use Rete Kit AI** if you want automated setup with context-aware instructions for your IDE
+- **Use Rete Kit AI** if you want automated Rete.js AI setup in your IDE
 - **Use LLMs.txt** if you prefer manual integration or need to reference documentation in AI conversations
 
 Both approaches can be used together for comprehensive AI assistance.

diff --git a/content/en/docs/20.development/4.ai-assistance/2.llms.md b/content/en/docs/20.development/4.ai-assistance/2.llms.md
@@ -33,18 +33,18 @@ These endpoints are continuously updated to reflect the latest in node editor de
 You can integrate Rete.js documentation with any AI coding assistant by providing the LLMs.txt URLs as context. This gives the AI comprehensive knowledge about node editor development patterns and best practices.
 
 ::alert{type="info"}
-[Rete Kit AI](/docs/development/ai-assistance/rete-kit-ai) automates this integration process by generating IDE-specific instruction files that reference LLMs.txt. If you're using Cursor, GitHub Copilot, Windsurf, or similar tools, consider using `npx rete-kit ai` for context-aware, automated setup.
+[Rete Kit AI](/docs/development/ai-assistance/rete-kit-ai) automates this integration by installing project instructions and Rete.js guidance that reference LLMs.txt. If you're using Cursor, GitHub Copilot, or similar tools, consider `npx rete-kit@latest ai` for automated setup.
 ::
 
 ### Automated Setup with Rete Kit AI {#automated-setup-with-rete-kit-ai}
 
-For automated IDE integration, use Rete Kit AI which generates context-aware instructions that reference LLMs.txt:
+For automated IDE integration, ask your IDE's agent:
 
-```bash
-npx rete-kit ai --tool cursor --context onboard
+```prompt
+Run npx rete-kit@latest ai
 ```
 
-This creates IDE-specific instruction files that automatically include references to LLMs.txt endpoints. See the [Rete Kit AI](/docs/development/ai-assistance/rete-kit-ai) documentation for details.
+This starts an agent-driven setup that installs project instructions and Rete.js guidance (including LLMs.txt references). See the [Rete Kit AI](/docs/development/ai-assistance/rete-kit-ai) documentation for details.
 
 ### Manual Integration {#manual-integration}