docs: deprecate self-improvement in favor of AI writeback

docs.json

@@ -154,7 +154,6 @@
                   "guides/ai-agents/evaluations",
                   "guides/ai-agents/data-access",
                   "guides/ai-agents/best-practices",
-                  "guides/ai-agents/self-improvement",
                   "guides/ai-agents/ai-writeback",
                   "guides/ai-agents/mcp-servers",
                   "guides/ai-agents/autopilot"

guides/ai-agents.mdx

@@ -43,8 +43,8 @@ This guide covers everything you need to know about AI agents in Lightdash:
   <Card title="Verified answers" icon="check-circle" horizontal href="/guides/ai-agents/verified-answers">
 
   </Card>
-  <Card title="Self-improvement (Beta)" icon="sparkles" horizontal href="/guides/ai-agents/self-improvement">
-    
+  <Card title="AI writeback (Beta)" icon="sparkles" horizontal href="/guides/ai-agents/ai-writeback">
+
   </Card>
 </CardGroup>
 
@@ -67,4 +67,4 @@ This guide covers everything you need to know about AI agents in Lightdash:
 - **Multiple agents** - Create specialized agents for different teams or use cases
 - **Evaluations** - Create test suites to validate your agent’s answers and prevent regressions.
 - **Conversations** - Monitor all agent interactions in one place, review feedback, and build evaluation sets directly from real threads.
-- **Self-improvement (Beta)**- Agents can propose changes to your semantic layer
+- **AI writeback (Beta)** - Ask an agent to edit your dbt project in chat and open a pull request with the changes

guides/ai-agents/ai-writeback.mdx

@@ -28,7 +28,6 @@ For other kinds of changes, the agent will pick a different tool:
 | --- | --- |
 | Ask a question about data | Query and discovery tools |
 | Edit an existing chart or dashboard in Lightdash | `editContent` |
-| Propose an in-app change to a metric or dimension for review | `proposeChange` (see [Self-improvement](/guides/ai-agents/self-improvement)) |
 | Change the underlying dbt repository | `proposeWriteback` |
 
 ## Prerequisites
@@ -94,4 +93,3 @@ When the pull request is ready, the agent posts the URL in the thread. Open it,
 ## Related
 
 - [dbt write-back](/guides/developer/dbt-write-back) — write back individual custom metrics, dimensions, and SQL Runner queries from the Lightdash UI.
-- [Self-improvement](/guides/ai-agents/self-improvement) — let agents propose in-app changes to the semantic layer through reviewable changesets instead of pull requests.

guides/ai-agents/getting-started.mdx

@@ -174,8 +174,8 @@ models:
 
 3. For more technical users who want to configure tagging rules in more detail - including how tags interact with permissions and schema visibility - see the [Data access control section.](/guides/ai-agents/data-access#limiting-access-to-specific-explores-and-fields)
 
-### Enable Self-Improvement (optional, Beta)
-Allow your agent to propose changes to your semantic layer, including updating descriptions and creating new metrics. Changes are tracked in changesets for review. Read more on [self-improvement (beta)](/guides/ai-agents/self-improvement) feature.
+### Enable AI writeback (optional, Beta)
+Allow your agent to edit your dbt project from chat — renaming metrics, adding dimensions, or updating descriptions — and open a pull request with the changes for review. Read more on the [AI writeback (beta)](/guides/ai-agents/ai-writeback) feature.
 
 ## Setting up multiple agents