IDEAS, DECISIONS & LESSONS

Journal

Notes on AI, architecture and building useful products.

9 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

27 Jul 2026 · 8 min read

ai-agents

Why Software Factories Fail (and What Actually Works): A Tech Lead's Guide to the HumanLayer Series

Dex Horthy's two-part HumanLayer series lands on the same conclusion from opposite directions: 'lights-off' agentic factories that skip code review don't work, because RL training has no way to reward good architecture — only passing tests. The fix isn't less AI, it's front-loaded structure: research/plan/implement, frequent intentional compaction, and four review checkpoints before code gets written. Here's the synthesis and a rollout plan.

Read more

09 May 2026 · 15 min read

agentic-ai

The Evolution of AI Agentic Patterns: From Prompts to Production Systems

How the central question of building with AI has shifted three times in four years — from 'what should I say?' to 'what system should I build?' A deep dive into prompt engineering, context engineering, and harness engineering with architecture diagrams, decision frameworks, and production lessons for engineering leaders.

Read more