skip to content

Agent prompts

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

The prompts

Bundled agent prompts — 30 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, replan
write-sprints stage instruction
role plan stage plan, replan
execute stage instruction
role build stage execute
review stage instruction
role review stage review
fix stage instruction
role build stage fix
troubleshoot stage instruction
role build, review stage troubleshoot
write-gate stage instruction
role plan stage gate-build
write-environment stage instruction
role plan stage environment-build
write-map-spec not a stage instruction no bundled pattern hands it to a stage
compose-cycle-plan not a stage instruction no bundled pattern hands it to a stage
gantry-agent not a stage instruction no bundled pattern hands it to a stage

The decoration prompts

Cosmetic one-shots, each run on a cheap model with no worker preamble.

prompt kind handed to
reader-preamble not a stage instruction no bundled pattern hands it to a stage
title-plan 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
summarize-replan 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; edit it to change what a run's remaining agents are told
project
consulted 2nd 		.gantry/<plan>/<id>.md a per-run override an operator drops 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
design/briefs/execute stage instruction
role build stage execute
design/briefs/review stage instruction
role review stage review
design/briefs/write-gate stage instruction
role plan stage gate-build
design/briefs/write-sprints stage instruction
role plan stage plan, replan
design/clean-slate stage instruction
role build stage execute
design/pages/execute stage instruction
role build stage execute
design/pages/review stage instruction
role review stage review
design/pages/write-gate stage instruction
role plan stage gate-build
design/pages/write-sprints stage instruction
role plan stage plan, replan

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