From 1edd46eb8452fa1c8e7e99a1e64a9ed7f1af0195 Mon Sep 17 00:00:00 2001 From: Tommaso Casaburi Date: Fri, 5 Jun 2026 18:40:37 +0700 Subject: [PATCH] docs: clarify large artifact context tooling --- AGENTS.md | 1 + public/llms-full.txt | 1 + 2 files changed, 2 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 9022e1d6..df9d7b14 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -44,6 +44,7 @@ Compiled context: - `docs/agent-playbooks/**`, `docs/agent-runs/**`, `docs/agent-playbooks/known-surprises.md`, and tracked `llms.txt` / `llms-full.txt` files when present. Agents may use compiled context to navigate quickly, but must verify against source files before making behavioral claims or edits. External code graph, RAG, MCP, or wiki tools are optional local accelerators unless the developer explicitly asks to make one part of the committed workflow. +For very large non-source artifacts such as CI logs, debug traces, generated JSON, or massive tool output, contributors may optionally use `chopratejas/headroom` or a similar local compression tool as a navigation aid, but agents must verify conclusions against the original uncompressed artifact before editing code or making final claims. When CodeGraph MCP tools are available and `.codegraph/` exists, prefer them for initial symbol lookup, caller/callee tracing, and impact analysis before broad `rg` or file-reading sweeps; still verify important claims against source files before editing or reporting conclusions. ## Task Router (Read First) diff --git a/public/llms-full.txt b/public/llms-full.txt index 490420aa..b59b4fc9 100644 --- a/public/llms-full.txt +++ b/public/llms-full.txt @@ -215,6 +215,7 @@ Compiled context: - `docs/agent-playbooks/**`, `docs/agent-runs/**`, `docs/agent-playbooks/known-surprises.md`, and tracked `llms.txt` / `llms-full.txt` files when present. Agents may use compiled context to navigate quickly, but must verify against source files before making behavioral claims or edits. External code graph, RAG, MCP, or wiki tools are optional local accelerators unless the developer explicitly asks to make one part of the committed workflow. +For very large non-source artifacts such as CI logs, debug traces, generated JSON, or massive tool output, contributors may optionally use `chopratejas/headroom` or a similar local compression tool as a navigation aid, but agents must verify conclusions against the original uncompressed artifact before editing code or making final claims. When CodeGraph MCP tools are available and `.codegraph/` exists, prefer them for initial symbol lookup, caller/callee tracing, and impact analysis before broad `rg` or file-reading sweeps; still verify important claims against source files before editing or reporting conclusions. ## Task Router (Read First)