skip to content

Agent prompts

Every prompt file Gantry ships, which stage of a run gets which, and where a copy of one has to go to displace it.

The prompts

Bundled agent prompts — 23 rows exported from config/agent-prompts

prompt kind handed to
preamble not a stage instruction no bundled pattern hands it to a stage
write-milestones stage instruction
role plan stage plan
write-sprints stage instruction
role plan stage plan
execute stage instruction
role build stage execute
review stage instruction
role review stage review
troubleshoot stage instruction
role build stage troubleshoot
write-milestone-gate stage instruction
role plan stage gate-build
write-environment stage instruction
role plan stage environment-build
review-plan-change stage instruction
role review stage review
write-gap-plan stage instruction
role plan stage replan
write-gate not a stage instruction no bundled pattern hands it to a stage
write-goal-check stage instruction
role plan stage gate-build
write-map-roster stage instruction
role plan stage plan
write-project-gate stage instruction
role plan stage gate-build

The decoration prompts

Reader-facing one-shots, each run on a cheap model with no worker preamble, led by the reader-preamble primer prepended to the rest of them.

prompt kind handed to
reader-preamble not a stage instruction no bundled pattern hands it to a stage
write-about stage instruction
role util stage support
summarize-gate not a stage instruction no bundled pattern hands it to a stage
summarize-review not a stage instruction no bundled pattern hands it to a stage
stop-summary not a stage instruction no bundled pattern hands it to a stage
commit not a stage instruction no bundled pattern hands it to a stage

How to change what an agent is told

Prompt registry tiers — 4 rows exported from src/engine/config.rs

tier where a copy goes what it is
run
consulted 1st
.gantry/<plan>/prompts/<id>.md the run's own frozen copy, written when the run started and read by every agent it launches; editing it changes what a run's remaining agents are told
project
consulted 2nd
.gantry/<plan>/<id>.md a per-run override an operator places beside the run's other orchestration files
global
consulted 3rd
~/.config/gantry/agent-prompts/<id>.md the materialized global mirror; it overrides the built-in once its bytes differ from the built-in's
built-in
consulted 4th
config/agent-prompts/<id>.md the default compiled into the binary
Extra and pattern-specific prompts
prompt kind handed to
adjudicate-merge stage instruction
role build stage resolve
resolve-merge stage instruction
role build stage resolve

READMEconfig/agent-prompts/README.md, documentation of the prompt tree rather than a prompt handed to an agent.