Re: [Buildroot] [PATCH v3 1/1] docs: add agent guidance

On Fri, Sep 11, 2026 at 11:02 PM Peter Korsgaard [off-list ref] wrote:

quoted

quoted

quoted

quoted

quoted

"Fiona" == Fiona Klute via buildroot [off-list ref] writes:

 > Am 10.09.26 um 03:58 schrieb Matthew Weber:
 >> Document Buildroot structure, documentation, build and validation
 >> workflows, mailing-list submission, Patchwork usage, and AI-assisted
 >> contribution requirements.
 >> This file provides shared guidance for AI agents that recognize
 >> AGENTS.md. Claude Code projects can load it by importing @AGENTS.md
 >> from a root CLAUDE.md file.

 > I am strictly against merging this, or any other "AGENTS.md". Doing so
 > would imply we (Buildroot/maintainers, which includes me) encourage
 > LLM-generated patches. That is not acceptable to me.

I also have my reservations.

I do not use LLMs for development myself. What is actually the concrete
added value of such a file in the context of Buildroot?

AGENTS.md for LLM is like a README.md for developers. It provides the
common info
about the project, its structure, how to build and test, the DOs and
DONTs. The main goodies:

* Standardized Context Injection: Centralizes project rules, directory
layouts, and coding standards
  so developers don't waste context space pasting repetitive instructions.

* Inference Acceleration via KV Caching: Because AGENTS.md remains
static across sessions,
  local LLM backends (e.g., llama.cpp) cache its prefix tokens,
significantly reducing
  TTFT (Time To First Token) for subsequent queries.

* Higher Output Quality on Small Models: Smaller local models (7B–14B)
require clear, concise
  boundary constraints to stick to project patterns. AGENTS.md acts as
an automated system guardrail.

* Token Optimization: Encourages writing short, dense, high-signal
rules rather than loose,
  conversational prompt setups, preserving precious VRAM and context
space for code files.

For more details, see the official project site: https://agents.md/

Yegor

--
Bye, Peter Korsgaard
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot

_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot