Skip to content

AGENTS.md causes instruction overload and context rot #9704

Closed

Description

@kairosci

Summary

AGENTS.md has grown into a long, repetitive set of project rules, examples, and workflows. Its absolute instructions often apply only to particular changes, so agents spend context on irrelevant guidance, over-test, or lose track of the user's actual task. This creates context rot and makes agent work less reliable.

Details

Keep the project requirements, but make them concise, non-duplicative, and clear about when each rule applies. PR #9703 proposes a rewrite. This issue was drafted with Codex (GPT-6) from the user's diagnosis.

Activity

  1. kairosci commented on Nov 4, 2026

    @kairosci
    Author
  2. fanninpm commented on Nov 4, 2026

    @fanninpm
    Contributor

    Please provide specific examples of how AGENTS.md can be simplified while still producing the same results.

  3. kairosci commented on Nov 4, 2026

    @kairosci
    Author

    @fanninpm PR #9703 proposes a rewrite

  4. youknowone commented on Nov 12, 2026

    @youknowone
    Member

    Thank you for pointing this out

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

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions