Assembly order
Sections are appended in this order. Anything conditional is skipped entirely rather than rendered empty.
Section 9 is the branch that gives each situation its character. A skill is
active, so its instructions are rendered; or a knowledge search has run this
turn, so the compact answer-from-knowledge section replaces them; or no skill is
active, so the routing catalogue is rendered instead.
The override keys in the table replace their section’s built-in default text.
Leaving one unset keeps the default.
knowledge_answering.instructions is
its own paragraph after the lifecycle search bullet. The built-in instruction
in that bullet stays. While a skill is active, that skill’s
knowledge_answering.instructions replaces the agent text. The compact
answer-from-knowledge section does not repeat it. See
agent.yml.
The acknowledgement section renders only on the first LLM iteration of a turn.
The agent produces its acknowledgement once, on that first call, so later
iterations of the same turn omit the section (and its examples) rather than
re-sending guidance the agent has already acted on. The ack reminder
is gated the same way.
The built-in instruction asks for an acknowledgement that stays true whatever
the tool returns: one that does not predict the result, promise the task, or
call a change done, because the tool may fail, find nothing, or need the user’s
confirmation. When you set
neither fillers.instructions nor fillers.examples, the section also includes
built-in examples. Setting fillers.examples replaces them, and setting
fillers.instructions removes them.
The current turn section renders on every main LLM call, including when you set
The current turn section renders on every main LLM call.
It tells the model that its messages after the user’s
latest message, such as an acknowledgement, were already delivered, and asks it
to continue from them in the reply after the tools instead of repeating or
contradicting them.
The lifecycle section does not offer hangup() to the model. To end a
conversation, a skill must explicitly execute an ordered-block execute_tool: hangup
step, usually after an authored goodbye response.
Situations
Pending tool confirmation can sit on top of any of these five.
Sections that carry runtime data
Some sections are pure framing and some are filled from live conversation state. The templates only supply the framing. Everything below comes from your compiled skills and the current tracker:- Skill instructions and step text, from
skill.md - Project memory (
### Project Memory) and skill memory (### Memory:) entry names and current values - Routing catalogue entries, from each skill’s
description - Paused work, from the stack. See below
- The confirmation question, from
utter_for_confirmation
project.* field is set, section 8 renders under
### Project Memory (routing and active skill). Each line is
project.<entry>: value. Unset fields are omitted; if none are set, the
heading is omitted. pii: true shows [set]. The section tells the model
those facts stay set for the session. Skill working state stays under
### Memory: on the active-skill prompt only.
Paused work covers three cases, each listed with the id the model needs to
return to it:
The first two resume on their own when the work they are waiting on completes.
An interrupted task resumes only if the customer wants it to, which is why the
prompt lists them: the model needs the ids to make that offer. See
Skills & Routing.
This is why two agents running the same engine version see prompts that look
very different. The framing is identical, the content is yours.
The separate LLM calls
Not every model call uses only the main system prompt. Separate calls use smaller prompts, and some main calls receive additional injected messages:
The rephrase calls are given no tools at all, which is what makes them safe for
verbatim wording: the model can only return text.
See also
- Prompt templates: the full text of each assembled prompt
agent.yml:persona,rules,fillers, andknowledge_answering- Execution Loop: where prompt building sits in the turn
- Tools: the built-in framework tools the prompt describes