> ## Documentation Index
> Fetch the complete documentation index at: https://unity.farlocus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge

> What each of the four knowledge types is for, the tree badges, and how to read the overview stats

The Knowledge page manages the Agent's project knowledge base. Everything in it is a Markdown document, grouped into four types by purpose, and all of it participates in retrieval and injection. The Agent relies on this content to understand the project background, so you do not have to explain it again in every session.

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/overview/page-tour/knowledge-types.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=326337ae9abcdcf94c389d70502d618a" alt="img" width="2021" height="1325" data-path="images/overview/page-tour/knowledge-types.png" />

## The four types

* **Design (project docs)**: records design requirements and the factual baseline, so the Agent knows what you want. The AI can propose updates summarized from your sessions (approval required), and later tasks treat the content as the requirements basis.
* **Memory (long-term)**: experiential notes the AI maintains automatically, so sessions stop starting from zero. Three preset modules by default: `Project Understanding`, `Mistake Notebook`, and `User Preferences`.
* **Skill (workflow)**: high-frequency workflows written down as documents, so the same kind of task needs no fresh briefing every time. Triggered with a / command or recalled automatically.
* **Reference (external)**: a read-only library for material from outside the project, for when the Agent needs sources the project itself does not contain. Imports local folders, the official Unity documentation, and Feishu docs.

Maintenance of the first two types is covered in [Design and Memory](/en/knowledge/memory-and-design), the last two in [Skill and Reference](/en/knowledge/skills-and-references).

## Tree and badges

The tree on the left organizes documents by type; right-click to create, rename, move, or delete. Badges on each entry mark document state, and `Badge Legend` at the top of the tree lists them all:

* **`AUTO`**: the document is maintained automatically by the AI.
* **`LX` / `SM`**: full-text or semantic retrieval is enabled for this directory. See [Retrieval and indexing](/en/knowledge/retrieval).
* **`EXT`**: content imported from an external source (local folder, Feishu, Unity docs, and so on), read-only.
* **`/cmd`**: a Skill document that can be triggered in chat with a / command.
* **Plugin badge**: content provided by a plugin; it cannot be renamed, moved, or deleted. See [Plugins and views](/en/extensions/plugins-and-views).
* **Skill package badge**: content provided by a Skill package, read-only.

## Overview stats

Selecting a knowledge type shows that type's overview cards on the right:

* **`Search Index`**: both retrieval channels, full-text and semantic, in one card. The full-text side shows coverage and the `Fresh` / `Stale` / `Pending` states; the semantic side shows coverage and index health. Use it to confirm the Agent can actually retrieve these documents.
* **`Knowledge Freshness`**: the share of indexed documents that are fresh, need a refresh, or have unknown status. Documents needing a refresh return to fresh after the next indexing pass.
* **`Context Load`**: estimates always-on context pressure (about 1 token per CJK character, 4 characters per token otherwise), split into Knowledge Overview, Memory, Auto Skill, and Retrieval Corpus. Use it to judge the token cost the knowledge system adds to every request.

The first two cards answer whether content can be found; the third answers what it costs. More knowledge documents are not automatically better: always-on injection consumes the context window directly, while retrieval coverage is close to free. Keeping the injected total small and leaving most content to retrieval is the basic principle of knowledge base maintenance. The levels are described in [Injection modes](/en/knowledge/injection).
