‹ BackHN Continuity

Thread

Claude Code now reads AGENTS.md if there is no Claude.md

741 points · 285 comments · datadrivenangel

  1. perganomoly · · focus · HN ↗
    The fact that it took this long to add such a basic feature is a disgrace. I’m not even remotely satisfied. Bailed on Claude ages ago. Rolling Codex, Gemini, and Qwen3.8 30B. The only way I’m going back to Anthropic is if they drop and Culture Series mind.
    1. chrisandchris · · focus · HN ↗
      We have a CLAUDE.md file whose only content is "please read .agents/agents.md"
      1. yjftsjthsd-h · · focus · HN ↗
        Wouldn't symlinking it be faster and use fewer tokens?
        1. ffsm8 · · focus · HN ↗
          I did that but not necessarily.

          When prompted to write to it, it will always try to write into the Claude.md and error out with that approach.. It eventually figures it out, but it's a ymmv situation I think

        2. tstrimple · · focus · HN ↗
          It also works more reliably. I've tested this quite a bit. Instructions in files referenced via CLAUDE.md are more likely to fall out of context or to be ignored. Raw project level CLAUDE.md instructions are the second most durable available as far as I know. I used to have a "well organized" hierarchy of rules and instructions. Collapsing all of that into CLAUDE.md + skills made things far more predictable and "as instructed".
      2. arceister · · focus · HN ↗
        it's been a standard practice on open source projects, right? CLAUDE.md only have one sentence "read ./AGENTS.md", lol.
      3. [deleted] · · focus · HN ↗

        [deleted]

      4. x______________ · · focus · HN ↗
        Maybe I'm not up to speed but i deleted claude.md while testing weird opus 5 behaviors, it came back saying nothing was used in claude.md but rather storing context in memories.md in some .claude/projectname/memories folder in my user profile....

        How is agents.md and different? Just a standard for other models? Is claude the lower standard now?

        1. pranabsarkar · · focus · HN ↗

          [dead]

      5. pampas · · focus · HN ↗
        Everyone does. But I think you're missing the point. It's effectively a billboard in the root of your repo.

        Sent from my iPhone.

Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.