Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gump.build/docs/llms.txt

Use this file to discover all available pages before exploring further.

State Variables

Complete list of all variables available in prompt templates.

Spec variable

VariableAvailableDescription
{spec}AlwaysFull content of the spec file

Step output variables

Available after the referenced step has executed. No steps. prefix.
VariableDescription
{<step>.output}Main output: diff (code), tasks JSON (split), bool (validate)
{<step>.diff}Git diff (code steps)
{<step>.agent}Agent that actually executed (reflects escalation)
{<step>.session_id}Agent session ID
{<step>.status}pass, fail, or fatal
{<step>.attempt}Final attempt number
{<step>.cost}Estimated cost in USD
{<step>.duration}Duration in milliseconds
{<step>.turns}Number of cognitive turns
{<step>.tokens_in}Input tokens consumed
{<step>.tokens_out}Output tokens produced
{<step>.gate.<name>}Bool result of a specific gate
{<step>.gate.<name>.comments}Validator comments
{<step>.gate.<name>.error}Stderr from a deterministic gate

Task variables (each block)

VariableDescription
{task.name}Task name from the split JSON
{task.description}Task description
{task.files}Task blast radius

Retry variables

VariableDescription
{error}Gate stderr (truncated to 2000 chars)
{diff}Failed attempt diff (truncated to 3000 chars)
{attempt}Current attempt number
{gate.<name>}Bool result of a gate
{gate.<name>.comments}Validator comments
{gate.<name>.error}Gate stderr
{prev.output}Output from previous retry iteration
{prev.gate.<name>.comments}Previous iteration validator comments

Sub-workflow variables

VariableDescription
{<step>.state.<key>}Value from a sub-workflow’s state

Scope resolution

Strict: step local → each scope → workflow scope. Ambiguity = dry-run error.

Template escaping

SyntaxResult
{variable}Resolved from the state
{{Literal {
}}Literal }
Empty variables on a line alone → line removed.