Hidden in Plain Sight: an Empirical Study about The Instruction Stacks of Coding Agents
Felipe de Sant'Anna Paixão, Dhyego Tavares, Eduardo Almeida, Iftekhar Ahmed
Abstract
Coding agents send their models more than the user's prompt: they add instructions, tool definitions, and environmental context that form an instruction stack. This stack guides execution and changes across releases, yet remains largely unexposed to users and insufficiently characterized in research. We present a longitudinal, cross-agent study of the instruction stacks captured in the first model requests of 1,886 releases of Claude Code, Codex, Gemini CLI, Qwen Code, and OpenCode. Under controlled conditions, we analyze their composition and evolution and trace changes in the four open-source agents to documented motivations. Our findings show why examining the system prompt or reporting the model alone provides an incomplete account of agent inputs. Tool definitions dominate three agents' latest requests, while occasional concentrated revisions alter instructions governing tool use, attribution, and coding style. Such revisions can complicate how researchers identify agent-authored contributions and interpret generated code. We also found that only 48% of examined change units directly explain the motivation for stack revisions. Across agents, shared capabilities emerge despite increasingly distinct wording. These findings expose an evolving, incompletely documented layer of agent design. The findings motivate documenting captured instruction stacks alongside agent releases, models, and user prompts, and preserving the rationale behind their revisions.
Create a lesson
Related papers
An EVM-Cosmos Bridge for Atomic, Semantic-Preserving Transfer of Environmental Tokens
Sebastian Pandolfi, Guzmán Llambías, Laura González
FeatureArc: Benchmarking Coding Agents on Evolving Features
Yunlong Wang, Alyssa Wu, Cuiyun Gao et al.
HIDE: Hierarchical Isolation via Documentation and Evidence for Rustc Bugs
Tianrong Zhang, Yakun Zhang, Dan Hao
Mind the Intent Gap: A Methodology for Collaborative Agent-Driven Software Engineering
Nicolas Tacheny, Tom Mens, Saïd Mahmoudi
BenchMeUp: Building Software Engineering Benchmarks from Natural-Language Specifications
Islem Bouzenia, Michael Pradel
Spine: Compiling Subtask Trees into Structured Context for Long-Horizon Coding Agents
Jiahong Xiang, Kunqiu Chen, Lingming Zhang et al.