Give coding agents a 2,000-token project map first

On 2026-11-01 09:01, DEV Community's AI column published a piece by an author under the title "老仓库先给 Agent 一份 2000 Token 项目地图" (Give the agent a 2000-token project map first). The advice: before giving a coding agent its first task, spend a few commands generating a project map of roughly 2000 tokens that hands over the directory structure and the location of the tests directory, so the agent does not have to work those things out itself.

The article walks through a scenario. You open a ten-year-old PHP app, start a coding agent, and type "add a refund endpoint". The agent does what it was built to do: it lists the root folder, reads composer.json, greps for Controller, opens three files that turn out to be dead, finds a second tests/ folder nobody runs, and only then gets to the actual work. The point is that a session spent rediscovering the repository on every new conversation is wasted context window on dead files and unrun tests.

The same author wrote Decoupled PHP — Clean and Hexagonal Architecture for Applications That Outlive the Framework and Thinking in Go, a 2-book series pairing Complete Guide to Go Programming with Hexagonal Architecture in Go. His project Hermes IDE is pitched as an IDE for developers who ship with Claude Code and other AI coding tools, and his site is xgabriel.com.

The source material here is a single post, so the record so far contains only this proposal and its worked example; there is no follow-up, adoption data, or counterargument to report. What is documented is the technique and the reasoning behind it, nothing beyond that.