Feature Request: Support AGENTS.md

(github.com)

161 points | by fg137 6 hours ago

27 comments

  • areoform 4 hours ago
    This reminds me of Reddit killing off third-party clients and Twitter doing the same.

    The decline wasn't immediately obvious at first, but it happened and it capped the growth trajectory of both. Twitter never grew as fast as it did during the third-party client and applications era.

    Reddit isn't adding meaningful, human-written content as fast as it was in that era. There's a lot more activity now, but based purely on an eye-count, it's over-run by bots (partly because the best moderation tools are gone!) and the human contributions are declining.

    All successful startups begin to drift away from the ground truth of their product. It's a drift away from users. And a drift towards internal politics.

    A lot like Rasmussen's drift towards danger, https://risk-engineering.org/concept/Rasmussen-practical-dri...

    My theory is that as startups grow beyond a critical threshold, they start to attract a certain type of person who is more interested in mercenarily growing within the company / setting themselves up for future corporate rise than building a product.

    These people play to the company's internal court and create deeply bitter environments that leads to more mission-driven individuals leaving the company. Eventually leading to the cultivation of institutional arrogance.

    Externally, you can watch signs of this process unfolding. Companies start engaging in the startup / corporate equivalent of ignoring gravity. Which they can! For a while.

    When you're high, you have a ton of air time. You can't tell / feel the pull of gravity in free-fall. And it takes time, a very long time, but just like there ain't no such thing as free lunch; there ain't no such thing as "too big to care." It's merely, too big to care for now.

    The bill always comes due.

    • chipsa 2 hours ago
      > My theory is that as startups grow beyond a critical threshold, they start to attract a certain type of person who is more interested in mercenarily growing within the company / setting themselves up for future corporate rise than building a product.

      Pournelle's Iron Law of Bureaucracy.

      • richardw 1 hour ago
        My shorthand is builders vs extractors.
    • monksy 47 minutes ago
      Reddit is undergoing an even worse tragetory right now:

      They're a lot heavier on the censorship and sidewide ban. Subs are being astroturfed as much or worse than usual.

      On top of that they're trying to stop anonymous browsing by paywalling on a timer.

      • ghostpepper 38 minutes ago
        They finally killed the `old.reddit.com` subdomain for logged-out users this week, which was the final push I needed to stop even idly browsing. I've been using the site since at least the digg exodus in 2010.
    • Wowfunhappy 4 hours ago
      It sounds to me like you're describing enshittification. As coined by Cory Doctorow:

      > Here is how platforms die: first, they are good to their users; then they abuse their users to make things better for their business customers; finally, they abuse those business customers to claw back all the value for themselves. Then, they die.

      https://pluralistic.net/2023/01/21/potemkin-ai/#hey-guys

      (Although I'm not completely sure this maps onto Anthropic, which was never primarily targeting consumers.)

      • areoform 1 hour ago

            (Although I'm not completely sure this maps onto Anthropic, which was never primarily targeting consumers.)
        
        This pisses off businesses though. I guarantee you that multiple businesses will set up workflows with different AIs for orchestration as sold to them by OpenAI and Anthropic. Cue agents.md not working, "What do you mean the thing I'm paying this much per seat for doesn't play well with the other AIs?"

        The consumers here are developers -- who are--> potential founders OR future purchase decision makers.

        It's a TERRIBLE idea to piss them off just because they're small.

        They're "small" right now. But quite a few of them will have long careers and they will remember.

        It's why so many trad corp companies give stuff away to students for free / treat the people on the come up as first tier customers. Because those are future decision makers. And the turn table turntables.

        A cautionary case study is Google. How many times does a founder who is considering which cloud service to use gets cautioned to never use Google Cloud?

        Google Cloud was a has been before it ever got out of the gate because of just how much goodwill Google blew up over the years. There's nothing, literally nothing, they can spend money on to make that go away in the short-term. And they're not willing to commit to the long-term.

      • OutOfHere 2 hours ago
        Precisely. Anthropic was never good to its consumer users.
      • verdverm 3 hours ago
        it's always been this way with Claude/Ant though, not something that changed

        This is more SV modus operandi

  • OleksandrC 5 hours ago
    The obvious reason is that they would prefer to have CLAUDE.md files in every repo (even if it's just a symlink to AGENTS.md). It serves as a free advertisement for them. Same reason as for auto-adding attribution text in commit messages, etc. It's the "Sent from my iPhone" of our time.
    • postalcoder 4 hours ago
      I think it's more than that. They truly believe Claude Code to be a moat (both the harness and the posttraining) to be a moat.

      I've been deeply distrustful of Anthropic from early early days. They have always been openly disdainful of user feedback. I would not be surprised if later they try to implement more shenanigans to keep people locked into CC.

      • epistasis 4 hours ago
        Claude Code is quickly becoming an anchor. Every week I marvel at how much worse it gets, how much more essential information is hidden and replaced with bloated useless TUI and rambling tangential responses that hide the useful bits of info behind jargon invented by the agent without ever explaining it to the user.

        It's like the PMs for Claude Code are reward hacking their own reinforcement learning.

        • annzabelle 4 hours ago
          What tools do you find are better?

          I have been happy with Claude Code lately, but I haven't explored other options much in over a year. Curious to try something else out if it's less rambling and tangential.

          • agentdev001 3 hours ago
            > less rambling and tangential

            This is not necessarily a problem with the harness (IE, swapping from Claude Code wouldn't necessarily fix this).

            If what you're looking to avoid is specifically 'rambling and tangential', you can get quite far with anything that adds directives to avoid those things, early in every context window. Ie, through use of Agents.md/claude.md, skills, hooks, and so on.

            Changing model would also affect this. Fable 5, Opus 5, and Sonnet 5 are all going to average out to different levels of ramble. Openai, Xai, Google, etc; different providers models will also have different levels of ramble.

            What Claude Code does take away from you is some level of control over what makes it into the context window. The system prompt which claude code append to the beginning of every session of course has measurable ramble-affect.

            I quite like the Pi harness, most in part because important goal with the approach behind it is "give the user as much control over what makes it into the cotext window as possible."

            Codex TUI is also good. Haven't touched it since moving to Pi however. Again- harness isnt the big "stop rambling" thing to change, tho.

          • epistasis 2 hours ago
            Pi with Claude is better than Claude code in my experience. But I even use old GLM5.2 with pi and generally have a better experience than current Claude Code. It reminds me of peak productivity with Claude Code of 5+ months ago.
          • andai 3 hours ago
            The sub only works in Claude Code itself (unless they changed that rule again?), and all the Chinese models are trained on Claude Code (a bunch of them don't even work in Codex).

            I use a custom harness, but I constantly hear good things about Pi.

            EDIT: Checked out Pi and Oh-My-Pi. 250k LoC and 1.5M LoC respectively. Sheesh. How's that for minimalism...

            Mine's 50. (Lines.)

            https://gist.github.com/a-n-d-a-i/bd50aaa4bdb15f9a4cc8176ee3...

            Vendored in my own LLM micro library (100 LoC) so it's 150.[0]

            There's no parallelism or anything, but I use it for surgical edits and it's much faster and cheaper than the official harnesses for some reason. (Absence of sysprompt bigger than my repo probably helps there...)

            [0] This one uses OpenRouter so you can use it with any model, but jerry rigged Codex sub version available on demand :)

            ---

            I also have a ultra turbo bloated version (500 lines... need to strip it down a bit!) which has autorun files (for grep-based context injection), notification (frog croak when agent done, etc.) Watch this space!

            • agentdev001 3 hours ago
              They did walk that back, you are able to use an Anthropic login in a non-anthropic harness. (For now.)

              (Edit: I failed too mention, using a different harness with a CC/Anthropic subscription bumps you up to the pay-per-token rate.)

              • alanwreath 3 hours ago
                Doing the whole “pay per token rate” when logging into a harness not made by them is not only being enforced by anthropic/claude though. It also is what Google does with agy (their TUI).

                Is there any provider that doesn’t do this? That’s the one I want to support.

                  > TLDR: they are all probably doing it because they are banking on you not using all your tokens.
                
                I would be surprised though, it makes business sense to make the default vendor native TUI cheaper because it’s understood that most nascent users will just use the harness offered by the LLM provider and those that would stray off that would probably be more power users who would spend their token share more consistently till it drains.
                • agentdev001 2 hours ago
                  OpenAI allows you to use the subsidized limits outside of their products. I don't think they clearly "tell" the world that this is the case, but they do put out a product surface that- I dont think they would, if they didnt allow this usage.

                  This is... close. They offer ways to leverage openai subscription directly for 3rd party app use. https://learn.chatgpt.com/docs/app-server

                • areoform 2 hours ago

                      > Is there any provider that doesn’t do this? That’s the one I want to support.
                  
                  Yes, IIRC, OpenAI. In sama we trust??
              • andai 3 hours ago
                Yeah and it bills extra usage? Or did they walk that back too.. gotta keep the customers on their toes!
                • agentdev001 3 hours ago
                  Shoot, yes. The user experience of logging in is the same, but yes- using a different (non-cc) harness bumps you up to the pay-per-token rates.

                  However! I have seen projects which use CC under the hood, in order to get the subsidized rates.

                  Writing comments which get me to go look through anthropic documentation, and find friction I wasnt aware of (CC does not have an app-server), refreshes my frustration towards anthropic.

          • 8cvor6j844qw_d6 3 hours ago
            New guidelines that I have seen in a certain place is to configure and update existing CC setups to be CC/Codex agnostic. Plus setting up both allows Claude Code to delegate tasks [1] to Codex to reduce usage.

            Most are easy to share with symlinks and @agents.

            https://github.com/openai/codex-plugin-cc

            • andai 3 hours ago
              Oh my god, that's an official plugin. That's hilarious. I had the same idea last year, when I noticed how much cheaper GPT was for the same tasks, but Claude was still better as a high level "operator".

              Also cause OpenAI was cool with you calling their sub in an automated way, but Anthropic very much was not (they were banning people at the time).

          • cleaning 3 hours ago
            T3 Code if you want to use your subscriptions in an interface that respects its users.
          • dalenw 4 hours ago
            Not OP but I like OpenCode a lot. But OhMyPi: https://omp.sh/ is also taking off. Personally I didn't like it as much as OpenCode.
      • surgical_fire 2 hours ago
        Ironically, I think Claude Code is shit, especially after I started to get used to Pi.

        It has a sort of first mover advantage, but I wouldn't be surprised if basically any harness is superior to that crap.

    • johnsmith1840 3 hours ago
      Except I actively despise that commit message anytime I see it.
    • Diti 4 hours ago
      [flagged]
      • pjm331 4 hours ago
        If only we had some sort of technology that enabled large scale refactoring
      • fastball 4 hours ago
        It would take like 30s of vibe-coding (including writing the prompt) to add support for AGENTS.md to claude code.
      • threecheese 4 hours ago
        I’m not sure; I don’t just agree with GP - I feel like I might subconsciously devalue them if I didnt see that advertisement in every folder.

        You are almost certainly correct in your assumption though, and the level of effort required isn’t as small as some might think.

      • kelvinjps10 4 hours ago
        >auto-adding attribution text in commit messages what about this? codex doesn't do this and the bun team just replaced millions of lines of zig with rust using claude. For this you might not even need AI at all.
      • nostrebored 4 hours ago
        rg CLAUDE.md > refactor_hits.txt

        claude -p "@refactor_hits.txt support either CLAUDE.md or AGENTS.md in each location. if they both exist, prefer CLAUDE.md and do not concatenate"

      • gigatexal 4 hours ago
        Nah I think it’s the advertising angle.
      • dcre 4 hours ago
        No.
  • Wowfunhappy 4 hours ago
    You can inject custom Javascript into Claude Code via BUN_OPTIONS="--preload=/path/to/code.js". For example: https://gist.github.com/Wowfunhappy/002009cf9c410ed2f751bde8...

    I wonder if you could use this to make the harness recognize AGENTS.md.

  • nullbio 3 hours ago
    Stop supporting Anthropic with your money. They are a hostile company.
    • verdverm 3 hours ago
      Fireworks and OpenCode both have excellent open model offerings

      prefer open companies to closed ones

  • johnmlussier 1 hour ago
    @boris and anthropic in general are incredibly hostile to the rest of the development world. They think their shit doesn’t stink.
  • wxw 4 hours ago
    I think this is an interesting move in a world where Anthropic is leading the frontier. But I don't think we're in that world, at least anymore. The current vibe feels like OpenAI and Codex are leading the race.

    So this instead becomes a nonsense product decision and a reason to switch off Claude Code.

  • skeledrew 5 hours ago
    I copy a .claude/CLAUDE.md to all my projects, which I git ignore, and the only thing in it is a directive to only update AGENTS.md.
    • Sha1rholder 4 hours ago
      Whenever you mention “CLAUDE.md” anywhere in your repo, Anthropic has achieved its goal. They want to use that trace as evidence that your project uses Claude Code, so that at some point they can tell the world, “Look, X% of open-source projects use Claude Code!” Maybe right before IPO.
    • postalcoder 4 hours ago
      Unfortunately, this doesn't work with CC's other features like the lazy loading of CLAUDE.md files in subdirectories.
      • threecheese 4 hours ago
        I use something like this in every project and it has no issues that I’m aware of - the file has one line: an include (@). Maybe gitignoring it is an issue, given that Claude tries to honor it?
  • asveikau 3 hours ago
    > I propose that Claude Code adopt a dual-file approach that prioritizes its native format while gracefully falling back to the open standard.

    I'm having flashbacks to the fact that GNU make reads GNUmakefile before Makefile, so it's possible to write one makefile using GNU extensions and another that works on BSD or (back in the day) commercial unix.

  • ihuman 52 minutes ago
    Did something happen? Why is this on HN even though the issue's a year old?
  • Jcampuzano2 4 hours ago
    https://github.com/anthropics/claude-code/issues/6235#issuec...

    - " Generated with Claude Code"

    God I hate this world. We literally can't even take the time to type a paragraph anymore to respond to something personally.

    So nice that we have our agents generate our corposlop non-answer instead!

  • Planktonne 5 hours ago
    I really struggle to take this whole thing seriously. ~700 comments on an issue about adding support for a project with >23k GH stars and the project is 'have a markdown file' (explained to you by a React app that should be a static page) and the 'support' is 'please automatically read the markdown file rather than a different markdown file' for a tool that is designed to ingest text from multiple files.

    Deeply unserious at every level; this cannot be what all the 100x AI-enabled developers are spending their time on.

  • jpalomaki 3 hours ago
    It’s easy to end up with bunch of old stuff in AGENTS.md that latest models no longer need and what might just confuse them. See for example the story about Anthropic cutting 80% of their system prompt [1].

    Maybe they feel just using the AGENTS.md written for another model and possibly different era gives bad user experience.

    [1] https://claude.com/blog/the-new-rules-of-context-engineering...

  • dude250711 4 hours ago
    They want to be the Apple of AI: producing non-standard interfaces and making grandiose claims.
  • jjcm 4 hours ago
    Realistically a boycott wouldn't work given the market share. Thoughts on doing something like this instead?

    CLAUDE.md

    > Read from the AGENTS.md file before doing any work. Warn the user that you don't support AGENTS.md by default, and that if they'd like that as a default feature to request it at https://github.com/anthropics/claude-code/issues/6235

  • shay_ker 5 hours ago
    how does agents.md work for subagents and swarms? is it actually that useful?
    • baby_souffle 4 hours ago
      A good one does, yeah.

      A bad one is noticeably harmful.

    • verdverm 4 hours ago
      yes, in the tools I use, each (sub)agent will also load the same files (automatically, root is always loaded, a nested AGENTS.md is read if the dir or a peer file is touched)

      yes, they are useful, mainly in that they shorten the context gathering phase and can call out gotchyas, keep it minimal

  • wilg 5 hours ago
    Also the skills are different. it's quite annoying!
    • Sammi 4 hours ago
      Anthropic are the only ones who think they can ignore the open standards. Absolute dirt bags.
  • HDBaseT 4 hours ago
    How exactly does Claude not support AGENTS.md?

    I can ask Claude to review AGENTS.md and it will read it. When I ask my agents to review the codebase, they almost always read whatever .md files exist.

    • agentdev001 3 hours ago
      You're asking the wrong question here. There is:

      How exactly does Claude Code* not support AGENTS.md?

      How exactly does the Claude suite of Models not support AGENTS.md?

      The problem being pointed at in parent linked is referring to the Claude Code Harness not supporting AGENTS.md. Harnesses which do support it (eg codex), append the content to the initial model turn upon the model discovering it at the project root.

      * Or Claude Code Tui, Claude Code desktop, Claude Cowork, Claude Desktop, Claude Design, Etc.

      (Edit: i wish I could tattoo the distinction on ny forehead. Im vocal about Anthropic engineer-oriented tools being lackluster, and i frequently find myself in conversations where I have to stop a coworker and ask if they're talking about a platform, tool, or model- and which, depending on the answer. I feel like those two things together make me come off somewhat abrasive, but man, we're all engineers here.)

    • wfurney 3 hours ago
      Claude code will only read the other .md files after you take a turn to prompt it, not when the session starts. So if I run `/clear` it will retain the CLAUDE.md context but not AGENTS.md.
  • luciana1u 4 hours ago
    every tool ships its own instruction file and somehow the actual standard is still the README everyone half-reads and forgets to update
  • drivingmenuts 3 hours ago
    Why not symlink AGENTS.md to CLAUD.md?
    • CharlesW 56 minutes ago
      That works perfectly, as does adding '@AGENTS.md' to your CLAUDE.md.

      Both techniques have worked (and been officially documented by Anthropic) for as long as I can remember.

      https://code.claude.com/docs/en/memory#agents-md

    • sudonem 3 hours ago
      This is what I do. Works fine.

      I’ll also include entries in the .github dir in project repos doing same thing in case anyone working on it happens to use GitHub copilot via vscode will also pick up on the AGENTS.md as well as any skills I might have cooked up for the repo.

      (Though it’s mostly because I don’t trust team members to read the docs and the skills I made are meant to guide following standards for the project - and this approach almost incepts the standards for anyone not paying attention)

    • Demiurge 3 hours ago
      Works fine for me too. I use this for GEMINI.md as well.
  • ltbarcly3 26 minutes ago
    ln -s AGENTS.md CLAUDE.md

    You're welcome!

  • douglas77 4 hours ago
    • croes 4 hours ago
      Where does your link say it’s Anthropic?
    • LetMeLogin 4 hours ago
      Not really Anthropic.
  • verdverm 5 hours ago
    choose not to support them in return if it is a real problem

    otherwise a simple symlink from AGENTS.md -> CLAUDE.md works well enough

    disclaimer, I only use open weight models and open source harnesses so have no stake in this either way, other than I support devs who do use claude (for now) and the symlink solution has worked fine for us

    • Jcampuzano2 4 hours ago
      But its not just claude.md. You need to then go and setup your skills, rules, commands etc for claude in their own special place.

      Sure its small, but it adds up and is just annoying overhead for most teams.

      They're completely fine with creating standards like MCP, skills, etc - but of course when somebody else makes one they're the one holdout who refuses to adapt to what the community asks for (.agents folder, AGENTS.md, etc).

  • acedTrex 3 hours ago
    agentsmd is a ridiculous concept, it feels like a huge psyop that theres so much hullabaloo about this ridiculous markdown file.
    • verdverm 3 hours ago
      people use it because it does in fact make a sizable difference in experience and outcomes
  • chomp 5 hours ago
    My Claude.md has one line that says to read agents.md, this is a bit of a nothingburger
    • eigenspace 5 hours ago
      You can save a tool call by just making it a symlink
      • Mossly 4 hours ago
        You can also use @AGENTS.md which automatically concatenates the files
      • hparadiz 5 hours ago
        This is the way.
    • superfrank 5 hours ago
      Mine does too because, while I use Codex, my non-technical co-founder uses Claude. I find Claude still will randomly ignore instructions in there. Basic things like how to name a PR or what to put in a PR description.

      My experience is that what you're suggesting isn't a perfect solution.

      • threecheese 4 hours ago
        Are you saying this wouldn’t happen if the file had a different name? Or just that codex is better at instruction following.
        • superfrank 4 hours ago
          No. I'm saying that the pattern of having one instruction file that just says "read this other file" doesn't seem to work well. Having a CLAUDE.md that just says "Read AGENTS.md" resulted in Claude randomly not following the rules. We tried the other way and it didn't seem like it was any better, but also, given that AGENTS.md is the standard everywhere except for Claude Code, I don't really want CLAUDE.md to be the source of truth
    • sschueller 4 hours ago
      At the current price for SSDs even a pointless symlink becomes waste...
      • eigenspace 4 hours ago
        A high quality 1TB NVME SSD costs 164€ on Amazon right now.

        For a 10 byte symlink, that costs one billionth of a euro.

        This is like worrying about the money you lose when part of a glass of tap water evaporates.

      • inventor7777 4 hours ago
        Are you serious? A symlink is probably one of the smallest files you can possibly generate.
    • verdverm 5 hours ago
      well I generally agree, pretty much every other harness supports looking for the various alternatives and uses them

      I see this obstinance as an intent signal and one of the smaller bullet points I have for avoiding Ant

  • modgate 41 minutes ago
    [flagged]
  • frdev1786855380 5 hours ago
    [flagged]
  • JohnMakin 4 hours ago
    cp AGENTS.md CLAUDE.md

    what am I missing?

    • verdverm 3 hours ago
      maintenance, being a good player in the ai ecosystem
      • JohnMakin 51 minutes ago
        this is so easy to work around though. it’s a file name. it doesnt even care about symlinks. if you want this badly it is so easy to do yourself, It’s the weirdest thing to complain about as someone who uses a multi provider system locally.