Cut your AGENTS.md down

x.com24 saved

  • post
  • Saved

Written by AI

TLDR
PostHog's Jina Yoon argues AGENTS.md needs subtraction not addition, and gives 3 methods: doctor checks, testable evals, and direct agent feedback.

postThe source

PostHog@posthog

Your AGENTS.md is holding you back

Media saved

Highlights

  • Boris Cherny, the creator of Claude Code, recommended deleting your CLAUDE.md every six months to stay on the bleeding edge.

  • Our agents therefore had wrong instructions for 21 hours. During that time, one engineer’s PR got stuck for 10 hours; another lost 45 minutes investigating the cause before updating the instructions.

    Cost of a stale AGENTS.md line

  • it suggested turning off 3 unused plugins and 3 skills across our website repo and estimated saving an average of 6K tokens per session.

  • For each line, if you can’t name the failure it prevents, delete it.

Excerpt

Context engineering used to focus on adding information that base models lacked: But then the models kept getting better. Now, the same context your agents couldn’t function without can make them perform worse.

From x.com