You misunderstand AGENTS.md: how coding tools read project instructions

dotey · x · 2026-09-24

A breakdown of AI coding tools' project instruction files: Claude Code defaults to CLAUDE.md while Codex and many others read AGENTS.md, forcing multi-tool users to maintain duplicates. Using Jobs's "process mistaken for magic" insight, the author argues AGENTS.md has become ritualized, and notes Claude Code's fallback: it checks AGENTS.md when CLAUDE.md is absent.

Original post →

More from coding & agent

coding & agent channel →