Formal Architecture Descriptors as Navigation Primitives for AI Coding Agents
On the map: LLM agents and tool use → Software engineering coding agents
Abstract (arXiv)
AI coding agents spend a substantial fraction of their tool calls on undirected codebase exploration. We investigate whether providing agents with formal architecture descriptors can reduce this navigational overhead. We present three complementary studies. First, a controlled experiment (24 code localization tasks x 4 conditions, Claude Sonnet 4.6, temperature=0) demonstrates that architecture context reduces navigation steps by 33-44% (Wilcoxon p=0.009, Cohen's d=0.92), with no significant format difference detected across S-expression, JSON, YAML, and Markdown. Second, an artifact-vs-process experiment (15 tasks x 3 conditions) demonstrates that an automatically generated descriptor achieves 100% accuracy versus 80% blind (p=0.002, d=1.04), proving direct navigational value independent of developer self-clarification. Third, an observational field study across 7,012 Claude Code sessions shows 52% reduction in agent behavioral variance. A writer-side experiment (96 generation runs, 96 error injections) reveals critical failure mode differences: JSON fails atomically, YAML silently corrupts 50% of errors, S-expressions detect all structural completeness errors. We propose intent.lisp, an S-expression architecture descriptor, and open-source the Forge toolkit.
Key facts. No citing papers in the map yet (data through 7 Oct 2026). Placed in Software engineering coding agents, one of 16 directions in LLM agents and tool use. Builds on 8 of its 18 references that are in the map. First posted on arXiv 11 Apr 2026.
Builds on
8 of 18 references.
Closest ancestors · 6
Same direction, newest first
- 2026Architecture Without Architects: How AI Coding Agents Shape Software Architecture5 Apr
- 2026Effective Strategies for Asynchronous Software Engineering Agents23 Mar
- 2026Codified Context: Infrastructure for AI Agents in a Complex Codebase24 Feb
- 2025CodeCRDT: Observation-Driven Coordination for Multi-Agent LLM Code Generation18 Oct
- 2024SWE-agent: Agent-Computer Interfaces Enable Automated Software Engineering6 May
- 2023ChatDev: Communicative Agents for Software Development16 Jul
Other references · 2
Built on by
Not cited yet.
Similar, not cited
Close in wording, no citation either way
- 2026CodeCompass: Navigating the Navigation Paradox in Agentic Code Intelligence
- 2026Theory of Code Space: Do Code Agents Understand Software Architecture?
- 2026Inside the Scaffold: A Source-Code Taxonomy of Coding Agent Architectures
- 2026Understanding the Architecture of Coding Agents: An Exploratory Study Using a Research Prototype
- 2025Decoding the Configuration of AI Coding Agents: Insights from Claude Code Projects
- 2025Agent READMEs: An Empirical Study of Context Files for Agentic Coding
- 2026The Devil Is in the Interface: Evaluating How Tool Architecture Shapes Coding Agent Behavior
- 2026Beyond Resolution Rates: Behavioral Drivers of Coding Agent Success and Failure