> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# get_improvement_guide

Returns the Ada Entity Improvement Guide — a static reference describing Ada entity types (articles, coaching, playbooks, actions, custom instructions, company description) and best practices for making improvement suggestions.

Call this before proposing changes with [`edit_agent_behavior`](/mcp/tools/edit-agent-behavior) or [`edit_agent_config`](/mcp/tools/edit-agent-config) so the assistant chooses the right entity type and follows Ada's recommended improvement workflow.

## Example prompts

* "What types of Ada entities can I use to improve my Agent?"
* "Before we make changes, pull up the improvement guide."
* "What's the recommended way to fix a knowledge gap vs. a behavior issue?"

## Parameters

This tool takes no parameters.

## Response

Returns markdown covering:

* **Entity types** — when to use articles, coaching, playbooks, actions, custom instructions, and company description.
* **Making good improvements** — recommended workflow, guidelines, and example suggestion formats.
* **Search-first guidance** — use [`search_knowledge`](/mcp/tools/search-knowledge) and [`search_coaching`](/mcp/tools/search-coaching) before creating duplicates.

> **Tip**
>
> The guide recommends prioritizing knowledge articles and playbooks over coaching when addressing root causes. Coaching is best for targeted behavior guidance, not as a substitute for missing knowledge or unstructured workflows.