Skip to content

AGENTS.md is past the typical agent context budget (51.8k chars on main) #139

Description

@banozz0

AGENTS.md on main is currently 51,792 chars. Most coding-agent tooling caps auto-loaded instruction files around 40k chars and silently truncates the remainder — so the tail of this file likely never reaches the agent for anyone working in this repo. Rules end up applied by position in the file rather than by importance.

Largest sections today:

chars section
6.0k ### CDXC comments: why the code exists, and what the user decided
6.0k ### Repository Search Routing
4.8k ### Repository layout (restructured 2026-08-22)
4.6k ### Changing zmx: the wire generation and the wire-cycle pass
2.9k ### Ghostex Help must stay true to the product

Suggestion: keep AGENTS.md as the short, always-loaded rulebook and move the deep-reference sections into docs/agents/*.md with a one-line pointer each. Extracting just the top three brings the file to ~35k. The zmx / CDXC / search-routing material reads as reference-on-demand rather than something every agent needs every turn.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions