IDEAS, DECISIONS & LESSONS

Journal

Notes on AI, architecture and building useful products.

45 articles

02 Aug 2026 · 6 min read

ai-agents

Why Your AGENTS.md Is Making Your AI Worse — And How to Fix It

An ETH Zurich study tested AGENTS.md files across hundreds of real-world GitHub issues and found that LLM-generated context files reduce task success rates by 3%, increase costs by 20%, and add nearly 4 extra reasoning steps per task. Here's what actually works — and why less structured context is usually better.

Read more