---
title: Working with AI assistants
product: Advanced Framework Pro
version: 2.0
engine: Unreal Engine 5.8
updated: 2026-11-01
canonical: https://docs.human-codeable.com/guides/ai-assistants.html
---

# Working with AI assistants

From version 2.0 the plugin ships a pack for AI assistants: a guide that gives an assistant the framework's mental model and rules, the full documentation as Markdown, and pseudo-code of every framework Blueprint. With it, Claude Code, Cursor, Codex, Copilot and similar tools build on the framework correctly instead of guessing at component names and patterns.

## What ships

Everything is in the plugin's `Docs/AI/` folder:

- **`AGENTS.md`** - the guide. Short on purpose: the three-sided interaction model, the rules that keep changes working, and how to look things up. Assistants read it before touching a project.
- **`Reference/`** - this documentation as Markdown, one page per module, plus `assets.md` and `assets.json` listing every asset and what it is for.
- **`Codex/`** - pseudo-code of every Blueprint, enum, struct and data asset, one file per asset, mirroring the content folders. An assistant can read how a shipped example does something without opening the editor.
- **`VERSION`** - the plugin version the files describe.

## Setup in two minutes

1. **Tools > Advanced Framework Pro > Setup...**, page **AI assistants**.
2. **Guide pointer files**: writes `AGENTS.md` and `CLAUDE.md` into your project root, pointing at the guide. That is all most assistants need; they read these files when they start in the project.
3. Optional, for assistants that talk to the editor: tick **Start the MCP server with the editor**. The window enables the engine's Model Context Protocol and toolset plugins and starts the server on port 8000. The plugin registers the `AFProGuideTools` toolset, so an assistant connected to the editor can read the guide and the reference even when the plugin is installed in the engine rather than the project.

## What an assistant can then do

- Answer "how do I" questions from the reference rather than from memory.
- Read the pseudo-code of an example before copying its arrangement of components.
- With the editor connected: list and search the AI docs (`get_guide`, `list_ai_docs`, `read_ai_doc`, `search_ai_docs`).
- With [Codeable AI Editor Tools](../ai-editor-tools/index.html) installed as well: export your own project as text, add nodes and parent calls, lay out graphs, create structs and levels, place sockets and import meshes.

## Without the plugin

The guide is public at [docs.human-codeable.com/ai/AGENTS.md](https://docs.human-codeable.com/ai/AGENTS.md), and the reference is this site: [llms.txt](https://docs.human-codeable.com/llms.txt) lists every page, and each page is available as Markdown at the same address with a `.md` extension. Point an assistant at both when evaluating the framework.

Tip

Keep `AGENTS.md` as the single place for project rules. The pointer section the Setup window writes is marked, so your own notes above or below it are kept when the plugin updates the section.