Skip to content

docs(agents): compress AGENTS.md for frontier context tax - #68

Merged
gildesmarais merged 1 commit into
mainfrom
docs/agents-md-compress
Oct 20, 2026
Merged

gildesmarais merged 1 commit into
mainfrom
docs/agents-md-compress

Conversation

@gildesmarais

Copy link
Copy Markdown
Member

What changed

  • Rewrote AGENTS.md: 185→84 lines, 15049→7512 bytes (−50%).
  • Dropped the ASCII project layout tree and duplicated isolation/runtime + wire-field lists (owners: app/schemas/, openapi.yaml).
  • Added core rules: reduce LOCs, time matters, modern Python 3.12+, no backward compatibility, no shims.
  • Kept layer imports, WorkLease ownership, prewarm/env knobs, contract invariants, SSRF, smoke/check gates.

Why

Agent context tax: instructions that do not change decisions still consume attention on every load. AGENTS.md is always-applied for this repo.

Risk

  • low — docs-only; contracts/paths/commands preserved in meaning. Agents may miss a removed redundant path hint and need the code tree once.

Review map: whole PR is small — start at AGENTS.md.

Validation

  • make check (lint, test, typecheck, openapi-verify) — pass
  • Metrics: before 15049 bytes / 185 lines → after 7512 bytes / 84 lines

Cut ~50% bytes/lines by removing the layout tree, duplicated isolation/runtime
and wire-field lists, while keeping fail-closed contracts and adding reduce-LOCs /
modern-Python / no-shim rules.
@gildesmarais
gildesmarais enabled auto-merge (squash) October 20, 2026 20:04
@gildesmarais
gildesmarais merged commit c22cdf4 into main Oct 20, 2026
13 checks passed
@gildesmarais
gildesmarais deleted the docs/agents-md-compress branch October 20, 2026 20:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant