‹ BackHN Continuity

Thread

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

741 points · 285 comments · datadrivenangel

  1. dinga · · focus · HN ↗
    My claude.md:

    # CLAUDE.md

    This project uses `AGENTS.md` as its agent instruction file (kept provider-agnostic). Treat any `AGENTS.md` file exactly as you would a `CLAUDE.md` file — at the root level and in any subdirectory you are working in.

    @AGENTS.md

    1. frizlab · · focus · HN ↗
      If only there was a technology that existed to link files together… /s
      1. dinga · · focus · HN ↗
        The idea was to have it automatically detect nested AGENTS.md

        Does your tech do that?

        Anyway, the joke is on me I guess, because it might not work reliably.

        1. numpad0 · · focus · HN ↗
          On many filesystems, a lot of data about a file is not attached to the content of the file, but stored in a master filename and metadata table graph tree of some sort, and the address offset within that metadata used to retrieve the contents on disk can be a duplicate of another entry, without that situation instantly leading to a filesystem driver crash. Some filesystems officially support such duplicates as well as equivalents of HTTP 3xx, some you can just do as a matter of fact and fsck would have some words about it.

          Default filesystems for all Unix, Linux, WinNT, all do.

          1. dinga · · focus · HN ↗
            Yes. The thing is that creating a link will not do it recursively for all subdirectories. Even worse, in the subdirectories I didn't want to place a claude.md in the first place but just have agents.md.

            That was the idea.... For the toplevel it works because of the @AGENTS.md and this is also the part the link would solve.

            Thanks for all the great advice and explanations.

Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.