Build Agent Context

Build Agent context is the information that the Build Agent uses while it plans and builds. Two kinds of context exist, and each works differently. This article compares them and helps Creators decide where information belongs. A detailed article covers each kind.

Types of Context

Chat context holds items that Creators add to a single task. Context Documents hold what the agent keeps for the whole workspace.

Conversation history does not carry between tasks. Context Documents do, so the agent begins each new task with the workspace's shared knowledge.

How Context Works

The agent has a limited working space for each task. Three things share it: the skills that the agent loads, the Context Documents, and the conversation. Chat context items count as part of the conversation.

At the beginning of a task, the agent loads the workspace overview from the Context Documents. As the task runs, the agent adds the items in chat context to the conversation and opens other entries when the work needs them. Each message adds to the conversation.

When the working space is nearly full, the agent summarizes earlier messages so that the task can continue. The context gauge in the prompt box displays how full the space is. For what each row means, see Context Usage Gauge. For how Context Documents count toward the total, see Context Usage.

Choosing Where Information Belongs

Add an item to chat context when the current task needs it. For example, add a module that the agent must read before it builds. The item leaves chat context when the task ends.

Record information in Context Documents when every task in the workspace needs it. Examples include how an application is designed and the conventions that the team follows. Creators can ask the agent to record information in the chat, or edit an entry directly.