IDEAS, DECISIONS & LESSONS

Journal

Notes on AI, architecture and building useful products.

878 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

31 Jul 2026 · 7 min read

ai-agents

Claude Opus 5 and the Shift to Agentic Engineering

Claude Opus 5 isn't just a better model — it changes the economics and architecture of AI agent systems. What the benchmarks actually mean for teams building production pipelines: configurable effort, self-verification, and the 'chief-of-staff' pattern.

Read more