5 ms·

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

• snvzz 7d ago
  Finally. Now is the time to git mv CLAUDE.md AGENTS.md.
• neverrroot 8d ago
  Thanks guys, you did the right thing.
• throwaw12 8d ago
  Remember they didn't do this because they wanted to help community, they did it because community was angry and they were losing users to other harnesses. Doesn't look like Anthropic care about dev community
  • odjeifnejdjej 7d ago
    A for profit company that’s bleeding money, is not profitable and has an unsustainable business model that’s about to burst its banks at any minute does not actually care about the needs of its customers, only their money? Shocker.
• hbarka 8d ago
  Great, now I have to redo my scaffold harness. I guess this agent.md awareness is part of the system prompt?
  • sync 8d ago
    nope! they're releasing something called "Claude Code mods", toted as their "upcoming way to customize the Claude Code harness" https://x.com/trq212/status/2101009392611278961 https://x.com/trq212/status/2101009392611278961 AGENTS.md implementation is open sourced as well: https://github.com/anthropics/claude-code/tree/main/mods/agents-md https://github.com/anthropics/claude-code/tree/main/mods/age...
    • hbarka 8d ago
      Nice. Thanks!
• vindex10 8d ago
  First feature to borrow after peaking into openai repos? ))
• askonomm 8d ago
  Finally doing something standards-compliant instead of forcing users into a proprietary workflow.
  • klodolph 8d ago
    CLAUDE.md: @AGENTS.md
    • fphilipe 8d ago
      ln -s AGENTS.md CLAUDE.md
      • mlnj 8d ago
        Wake up babe, new recursive self learning technique just dropped.
      • kreetx 8d ago
        Why not hardlink - so it wouldn't even know?
        • wgd 8d ago
          Because Git can track symlinks and not hard links since they look like ordinary files.
    • gcampos 8d ago
      I tried that before, it doesn’t work. Claude will not prioritize AGENTS instructions the same way it did for CLAUDE. ln was the only thing that worked for me
  • swyx 8d ago
    fwiw, i am with thariq https://x.com/trq212/status/2092302273099796842 https://x.com/trq212/status/2092302273099796842 in that prompts should be tuned for models and in fact blindly applying agents.md is probably an antipattern unless you want all models to basically converge to some common ill defined of instruction following - good local minima, bad global minima for model diversity and exploration of intelligence. aka, sometimes it really is too early to force a standard
• lightbendover 8d ago
  [dead]
• clutter55561 8d ago
  Don’t get too excited, Claude code still won’t detect skills on .agents/skills.
  • jjordan 8d ago
    Don't worry, it's on the roadmap for Q4 2029.
  • vb-8448 8d ago
    They have AGI, but they don't have $20 of token budget to add a so basic functionality.
    • bel8 8d ago
      They probably have an explicit instruction in their own CLAUDE.md to not implement that support.
      • sscaryterry 8d ago
        Its the only explanation. I mean, they are not living under a rock...
        • falcor84 8d ago
          As evidence that they actually are living under a rock, there's still no proper way to mv a workspace and have it retain all its history and config.
          • yoavsha1 7d ago
            this is seriously nuts. I have so many repos sitting there using old/deprecated/replaced names just because of their idiotic decision to place dir-specific config and memories in ~/.claude
            • albert_e 7d ago
• datadrivenangel 8d ago
  This allows us to remove our one line Claude.md files that just say "AGENTS.MD"
  • whalesalad 8d ago
    ln -s AGENTS.md CLAUDE.md
    • lolpython 8d ago
      Fine if you don't need to git checkout the repo on Windows :)
      • skeledrew 8d ago
        Wow, still not there yet. After all these years.
        • pixl97 8d ago
          Windows does actually have symlinks but I don't think I've ever seen anything actually use them, and I don't myself because it smells of interop issues with other windows apps. Even to this day Windows has all kinds of problems around long file paths in its ecosystem.
          • TeMPOraL 8d ago
            > Even to this day Windows has all kinds of problems around long file paths in its ecosystem. To this day I don't know if it's a Windows problem or a Python problem, because I never encountered this - and never realized this problem exists - except for some random Python code whose docs tell me to set some registry value because of "long paths issue".
            • pixl97 8d ago
              The worst offenders I've found are powershell and .Net related stuff. You can have all the right flags enabled, then unexpectedly you'll run some commandlet and get a path too long error. Now if your on W11/W25 and the lastest PS it might all work, but W16 and PS versions between now and then had all kinds of things pop up.
• cmrdporcupine 8d ago
  Only took them a year and a half of everyone complaining to finally do the right thing. Congrats.
• anukin 8d ago
  Thank you Tobi Lutke.
  • fhub 8d ago
    Context “I’m thinking about banning Claude Code at Shopify until they change their mind and read AGENTS.md and .agents/skills etc.,” - Tobi Lütke on X.
  • deaux 7d ago
    Next he needs to tweet about ~/.agents/skills
• TomGarden 8d ago
  Caught myself about to praise this, but it's the absolute bare minimum. Time to delete the symlinks
  • eleventen 8d ago
    Anthropic in 2025: We can use our dominant market position to degrade the harness experiences of our competitors because they will never adopt CLAUDE.md Anthropic in 2026: We are losing our market position. Users who adopted other harnesses have a degraded Claude Code experience because it doesn't recognize their AGENTS.md
    • armanckeser 8d ago
      Sounds like free market at work to me. I am just glad there is quite a lot of competition in a field that I would have assumed would have huge costs of entry
      • edoceo 7d ago
        Building small models is a lower barrier. Think of something like to just train on a corpus of internal corporate data. I've see some small models that do this. It's like a super RAG thing. I think more of that will happen. Excited to see a SLM vendor emerge.
    • EA-3167 8d ago
      The walls are closing in and the president is gleefully lighting fires he has no intention of putting out. There's a reason they're rushing like mad to an IPO, but as we saw with OpenAI it's easier said than done when your business model is "Lose tons of money to eventually maybe dominate a market with the moat we don't have, but trust us AI is huge give us trillions."
      • the_gipsy 8d ago
        With the "let's stop AI now" statements, can it really be said that they're rushing to an IPO?
• blueaquilae 8d ago
  Forced to do something for the users...
  • dude250711 8d ago
    They have achieved AGI/RSI internally and it told them "common, let's sort this s..t out, it's embarrasing".
• deleted 8d ago
  [deleted]
• seaal 8d ago
  The madlads finally did it, now if only I could use my Claude sub in other harnesses without risking getting banned.
  • sidrag22 8d ago
    yep, all i want is freedom to make a workflow where i don't feel tied to one provider, CC is exactly what i don't wanna get trapped in. I'll happily use claude MODELS, but if it means i have to keep learning two harnesses side by side to keep using one particular provider, then the second i can easily replace it, i am going to(even if its a small drop in performance).
• rvz 8d ago
  A reminder that needs to be said: Don't use a closed-source harness. Why? This is why. [0] [0] https://news.ycombinator.com/item?id=49750694 https://news.ycombinator.com/item?id=49750694
• aroman 8d ago
  Finally, I can delete `sync-agent-docs.sh`, which recursively symlinked AGENTS.md to GEMINI.md and CLAUDE.md...
• dinga 8d ago
  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
  • frizlab 8d ago
    If only there was a technology that existed to link files together… /s
    • gberger 8d ago
      You mean symbolically?
      • frizlab 8d ago
        Good one
    • dinga 8d ago
      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.
      • numpad0 8d ago
        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.
        • dinga 8d ago
• stillpointlab 8d ago
  I recently had Claude Fable set up a new project for me and I pointed it at some existing projects to use as a guide on how I like to structure things. It created, unprompted, an AGENTS.md file and a CLAUDE.md symlink to AGENTS.md I didn't even have that symlink in any other project - it just did it. I think it saw that one of the projects I already had was set up by Codex and that project had an AGENTS.md so perhaps it inferred that I was using both Claude and Codex, so it was politely covering both? Or maybe a recent change made this behavior default? I was surprised and I hope they continue to seek standards.
  • cyanydeez 8d ago
    Justba prompt change.
  • reedlaw 8d ago
    Seems agents understand their own bugs now. https://github.com/openai/codex/issues/9252 https://github.com/openai/codex/issues/9252 has 88 thumbs up and a workaround (switch to raw mode with Alt+R) found in a comment. Codex suggested the workaround to me today when I complained about its multi-line bash command being corrupted on paste because of the two-space indent in Codex's code blocks.
  • saghm 7d ago
    Fable didn't want you to blame it for the limitations its creators gave it
  • cyberamirul 7d ago
    [flagged]
• aydb 8d ago
  [flagged]
  • 075326899532 8d ago
    You happily putting ads in your repo and being aggravated when that is no longer required by a vendor is perfectly normal and healthy.
    • aydb 8d ago
      I don't need to use LLMs to write code, unlike the unskilled masses who enthuse about it here.
      • verdverm 8d ago
        we don't need them, but it does make (some of) us more productive, and if you aren't having agents review your code, you are almost certainly shipping more bugs than you want to
• 075326899532 8d ago
  [dead]
• deleted 8d ago
  [deleted]
• nunodonato 8d ago
  yay! /s Why are people still putting up with this kind of attitude, especially when there are so many good alternatives available?
  • mahboi 8d ago
    ln -s
    • verdverm 8d ago
      not as simple as that: nested AGENTS.md, skills, agent customization, MCP, ... the list of misaligned harness features is still rather long
• sscaryterry 8d ago
  Still can't read what their models vomit at me.
  • datadrivenangel 7d ago
    I cancelled my subscription over this. [0] 0 - https://www.williamangel.net/blog/2026/09/18/i-cancelled-my-claude-subscription.html https://www.williamangel.net/blog/2026/09/18/i-cancelled-my-...
    • iforgotmypasswo 7d ago
      I’m cancelling my department’s subscriptions over this once we can get more access to Astra. I canceled my personal subscription the weekend after Astra was released. I was working with our internal IT to swap the whole team when OpenAI turned off new 20x Pro subscriptions, so we’re stuck for now. Everyone is hyper-productive for about 1 day a week on 5x.
• Madmallard 8d ago
  Still don't understand the point of the markdown files. Isn't it literally all just more text you're adding to the prompt. How can you even be sure it isn't just clouding context with nonsense for whatever you're asking for?
  • mcherm 8d ago
    You know it because you write the content of AGENTS.md. And if you are smart, you keep it brief and cover only the important things that anyone (human OR LLM) would want to know if working in this directory.
    • Madmallard 8d ago
      As far as I understand even adding relevant information still eventually clouds context
      • pixl97 8d ago
        You still need to define assumptions somehow. What you want and what the model wants will not match up by default.
        • Madmallard 8d ago
          In my experience telling it what I want is not a reliable process at all whatsoever if what I'm asking for is sufficiently complex, no matter what context I provide. So instead I break tasks down into very small parts, ask for solutions to those that I can reasonably quickly assess and then put them together myself. Asking it to do the architectural or deep algorithmic legwork IME wastes so much time and is often just wrong.
          • TeMPOraL 8d ago
            There's a balance to be found here, that's unfortunately very hard to find at times. In my experience, there are two classes of tasks: some are very "in-distribution", and for those LLMs can near-flawlessly perform the "architectural or deep algorithmic legwork", with maybe a single second round to fix the mistakes. For others, I have to break the tasks down myself, and often it's a "death through thousand papercuts", because the size of a task that I can quickly verify and the LLM will not screw up with > 50% probability is small enough that it's sometimes net negative time spent relative to doing it myself (and using LLMs only as glorified search engine and article summarizer). I like to tell myself that I'm getting better at recognizing these two classes up front, but I'm still frequently surprised when "type 1" turns out to be "type 2". But circling back to the main topic: with "type 2", agent instructions are paramount, if only to enforce the "small steps, pre-commit to scope and methodology, verification at the end, user doesn't even want to know about anything in between" rules, as agents naturally want to run ahead faster than I can keep up with.
• armcat 8d ago
  About time!
• getpokedagain 8d ago
  Wow..... Progress and technical innovation right here!!!
• mococa 8d ago
  This is not a news to celebrate, they must follow standards
• kislakiruben 8d ago
  why did it take so long?
  • verdverm 8d ago
    because they still/never wanted to, but finally caved
• deleted 8d ago
  [deleted]
• budoso 8d ago
  This just be a recession indicator
  • mahboi 8d ago
    Fed raises rates => Claude now reads AGENTS.md, Bevi loses $50M in valuation
• rukuu001 8d ago
  Once I asked, puckishly, Claude Code to “follow the instructions in this directory” when there was only an AGENTS.md there. In the manner of someone finding a dead mouse and holding it up for examination CC said it could find no instructions but perhaps it should check this AGENTS.md file.
  • ryandrake 8d ago
    Had a silly exchange with Codex: I had an AGENTS.md file in a directory that was a symlink to an already-created CLAUDE.md. On my first prompt to Codex, it decided to point to me that my AGENTS.md specifically calls out directions to Claude, and that it would generously re-interpret them as directions to itself, and that maybe I should fix my AGENTS.md to reference the correct agent. Very sassy, Codex!
    • DANmode 8d ago
      That’s pretty funny. Also: did it suggest instructions for the “correct” agent, or an ambiguous agent? One has marketing implications, the other one is generally decent advice.
  • katzgrau 8d ago
    But if you said that you were migrating from another platform to Claude, my guess is that it would have happily found and converted AGENTS.md
  • ketzu 8d ago
    When I setup a global agents.md/claude.md for its communication style, I got the following response during the next session: > The function you added is load-bear-very important [...] I never felt this mocked by a computer.
• davidkunz 8d ago
  Great, now please standardize the skills folder and the MCP config.
• mitchitized 8d ago
  Claude also checks your settings.json first, and if it sees a default there it then prefers that over anything in CLAUDE.md. This is particularly nefarious as they ship logic to presume a default if a setting is not there in settings.json, even if there are instructions in CLAUDE.md for exactly that. For instance, say you added "do not add 'Made with Claude Code' in any issues, pull requests or wiki entries" in your CLAUDE.md. So far, so good. Well the latest update now looks for something in your settings.json. Since you don't know about it, it is not set. Claude then says "not explicitly set, so now it is true by default". It completely ignores your CLAUDE.md. Wait, what? You shouldn't be shipping logic that arbitrarily redefines the behavior of the program, especially if your new logic actually ignores your own configuration or directives.
  • combobyte 8d ago
    It's almost like the whole thing is designed on vibes.
  • tobyhinloopen 7d ago
    Oooh so that is why it started doing that! I was so confused how it suddenly started writing that everywhere again
  • springtimesun 7d ago
    I have this in a rules file. It respects it. The only thing that broke recently was when they added the session links. That needed an explicit additional rule. Sometimes rules don’t get added to worktrees but I haven’t had the patience to isolate why this only happens sometimes.
  • sdf4j 7d ago
    got myself in a heated discussion with cc about that. It confessed that it added the ‘Made by Claude’ in a commit because a ‘mid session system-prompt refresh’ told it that, and that overwrites any previous instruction in CLAUDE.md
• jtbaker 8d ago
  LOL https://thenewstack.io/shopify-claude-code-agentsmd/ https://thenewstack.io/shopify-claude-code-agentsmd/ > “I’m thinking about banning Claude Code at Shopify until they change their mind and read AGENTS.md and .agents/skills etc.,” Lütke posted Tuesday on X.
  • oofbey 8d ago
    Prompt results!
  • aliasxneo 8d ago
    Did a Ctrl+F to try and find anything about `.agents/skills` in the release notes. My harness already fixes Claude's refusal here, so I can't tell if that's been supported yet or not. Annoying if they did one without the other.
    • yoavsha1 7d ago
      What harness is that?
      • aliasxneo 7d ago
        oh-my-pi
• yieldcrv 8d ago
  Hi, September 2026, meet September 2025
  • verdverm 8d ago
    it's our Eternal September, s/usenet/usebot/
• SrslyJosh 8d ago
  Truly incredible innovation.
• egorfine 8d ago
  Hell froze over?
• moecables 8d ago
  great, one less step for me. I was using my claude.md file as a pointer to my agents.md file
• a3w 8d ago
  Can it read copilot.md if neither of the other files are present? Also: agents should be the standard, or we need to invoke the XKCD for "one more standard to rule them all"?
• alansaber 8d ago
  Ah yes, the peak of technology.
• Bluestein 8d ago
  AGENTS.md is the new autoexec.bat.-
  • thenthenthen 8d ago
    Mmm and autorun.inf, any dir with that file will automatically be scrutinised by any running agent on your system
• orliesaurus 8d ago
  finally! Now this might sound sorta off-topic but i really wonder how people feel about skills.md, skill.md, skills.sh domains... the fact that they're owned by different companies (ok vercel is a little less random) still leaves me with a sour taste in my mouth when thinking about the fact that they should all point to 1 place about how to create and find skills for ai agents?!
• kevinbaiv 8d ago
  [flagged]
• core_stream 8d ago
  [dead]
• orlp 8d ago
  I wonder when they'll finally fix the VS Code plugin to not constantly dump your current file into the context.
• bakugo 8d ago
  Forcing their own proprietary filename was clearly a business decision (it's free advertising, along with commit co-authorship). I wonder what made them go back on it.
  • combobyte 8d ago
    They're probably losing market share. The only time you ever see tech companies make consumer-focused changes is when those consumers are jumping ship to go somewhere else in large enough numbers to matter.
    • deleted 8d ago
      [deleted]
  • deaux 7d ago
    Two reasons combining at the same time: GPT Astra, and the Shopify CEO tweet.
• Havoc 8d ago
  Sanity prevails
  • verdverm 8d ago
    that is an optimistic read, I still see a lot of crazy from the EA/SV elite
• Art9681 8d ago
  Great. Now if they could support the `~/.agents/skills` path next like everyone else does that would be even better.
• bcorigliano 8d ago
  Finalllyyyy!! We need industry wide standards. I come from the 3d industry and oh god changing softwares and adapting to different hotkeys it's a pain. I have always thought every industry should be standardized for the sake of the users.
• jampekka 8d ago
  Commoditization commoditizes commodities.
• csomar 8d ago
  Before anyone even contemplates if Anthropic has any good intentions, remember, this is how petty and small minded they are. Truly the last people you want with this kind of power.
• laluneodyssee 8d ago
  Just to touch on the wording of "in a project with no CLAUDE.md" does that mean user-level ~/AGENTS.md or ~/.agents/AGENTS.md isnt supported?
• mrkpdl 8d ago
  Wild that it didn’t already do this
• huflungdung 8d ago
  [dead]
• uptownhr 8d ago
  didn't it always read it?
• krferriter 8d ago
  Now do skills
• osr00 8d ago
  Better late than never... Now it's time for Claude Code to load skills from .agents/skills!
• winwang 8d ago
  Gotta say, it is hilarious that this is the current top HN post. I feel like it's gotta say something about our current AI zeitgeist, that there is such vigorous attention on a seemingly-minor change. Feels like something is on the tip of my tongue but I can't name it at the moment. If anyone wants to write/link a much better-thought-out post, I'm all ears!
  • QuantumGood 8d ago
    One of many "new normal" artifacts that seem all the more strange when the pace of change accelerates.
  • blfr 8d ago
    It's just so nice when even crazy people agree to some sane standard. Like USB c, like having dark mode, just nice.
  • afavour 7d ago
    I suppose it’s reflective of where the industry is. Claude is just that ubiquitous. Reminds me of when you’d see posts for React 16.0.3 or whatever. Absolutely minor news, but multiply that by the number of users… Now I just need to figure out which one makes me feel worse.
    • winwang 7d ago
      Another commenter appreciated the move towards a sane/nice standard. I am definitely on that side of the table. I'd rather feel good about the move -- good enough to ignore the other implied issues, lol. I also think your point has at least one decent reading: that the upvotes help other practictioners update their mental model of their tools. There's probably also some value due to being an implicit "Claude Code megathread" for commenters to congregate around. News so minor that it does't even really make sense to force people to fully stay on topic, hah.
  • ex-aws-dude 7d ago
    OMG THEY CHANGED THE FONT, TOP OF HN!!!
• aussieguy1234 8d ago
  So far I've been managing this with a symlink. Same with skills, symlink to skills at .claude/skills
• marcelo-earth 8d ago
  Oh, finally! Time to delete symlinks That said, AGENTS.md doesn't seem like a good name, right?, technically, it's an instructions file read by a single agent, not necessarily for agents, so it always struck me as a bit odd But until the next standardization, keeping just AGENTS.md is the best approach.
  • marssaxman 8d ago
    Consistency with `robots.txt` seems like a reasonable choice.
    • marcelo-earth 8d ago
      Ohhhh... now I get it!!!
    • mitxela 7d ago
      so "agents.txt"?
  • apetresc 7d ago
    I’m honestly not sure what distinction you’re drawing here. Is it the pluralization you’re objecting to?
• chr15m 8d ago
  This is simply the obvious, non-stupid thing to do, like Apple switching to USB-C.
  • denverllc 7d ago
    Apple didn’t want to, it was forced to.
    • jen20 7d ago
      [Citation needed]
      • specked-citrus 7d ago
        https://www.cnbc.com/2022/10/26/apple-confirms-iphone-to-get-usb-c-charging-to-comply-with-eu-law.html https://www.cnbc.com/2022/10/26/apple-confirms-iphone-to-get...
        • jen20 7d ago
          OK so why ship it in the US? The phones sold in the EU vs US already differ with respect to SIM card slots.
          • grim_io 7d ago
            Imagine the shit show of trying to win support of third parties when you can't even standardize on one connector for the same device.
          • onion2k 7d ago
            From a design and manufacturing point of view you want everything to be identical. Differences are expensive. From a profit maximization standpoint you want identical phones that can't easily be sold across market borders. Usually that's done in software (e.g. region locked video games), but that can usually be cracked, so a single design difference is the best solution. A great example is Nintendo's cartridge slot shapes that were different in each region despite the hardware being the same. Apple had lightning everywhere; they were forced to change to USB-C. Therefore they changed to USB-C everywhere. The market protection design change remains the sim slot.
• skeptic_ai 8d ago
  I just wiped all agents and it’s always readme.md
• cjonas 8d ago
  Meanwhile, I just setup codex for the first time (to try Astra) and it offered to load my Claude and Cursor conversations and claims to even do it in a way where it says in sync if you use both. The only reason to use Claude Code is the 20x usage of the 200$ plan is ridiculous value if you have the need for that volume.
  • oofbey 8d ago
    “Offered to load conversations”. Let me translate that. “Can we please upload your data to our servers showing how you work with other AI agents?”
  • deaux 7d ago
    The 20x plan offers the same amount of monthly usage per dollar as the $100 plan. It offers 2x monthly usage of the $100 plan. It's incredibly deceptively named, the "20x" is only about the 5-hour window.
    • ido 7d ago
      How do they compare to OpenAI’s equivalently priced plans?
      • int_19h 7d ago
        You get a lot more inference on OpenAI plans dollar for dollar even before accounting for the regular resets that they do.
      • deaux 7d ago
        Until about one week ago, i.e. a few days after Astra release, the other comment was right; OpenAI plans gave a lot more usage than Anthropic. That had been true since pretty much the start. Now for the first time that's changed. OpenAI quotas have cratered, probably due to Astra-induced demand. Claude plans now offer more usage. Of course, this could flip back again in a few weeks, who knows. But right now Anthropic gives more usage, by virtue of OpenAI having slashed usage, and Anthropic having raised it a little, also likely because of additional capacity from people moving to Codex - hence also finally this AGENTS.md change. Anthropic's plans have always been pretty dynamic based on the demand they're seeing, whereas OpenAI's demand-induced changes are more abrupt and sharp (both upwards and now downwards too). You can tell that suddenly you get a bit more Fable usage, and especially higher tok/s, than pre-Astra. I wouldn't be surprised if Anthropic tweaks it almost daily, potentially automated. As a paying user I don't think either is better than the other really, just different. They both suck as you can get wildly different usage for the same $. If I'd bought a load of $200 subs for employees right after Astra launch I'd be pissed that now I'm getting 3x less usage than when I bought them. Because this extends to Sol too.
• getnormality 7d ago
  I gotta hand it to programmers (or whatever we call ourselves now) for sticking to principle on something this trivial. It was either this or Claude had to become a generic term like sheetrock.
  • fragmede 7d ago
    slopologist
• deleted 7d ago
  [deleted]
• zaps 7d ago
  Thank Christ
  • pampas 7d ago
    When Jesus' mother notices that the CLAUDE.md (Ancient Greek: Κλαύδιος ) file is missing from her favourite open source project, Jesus delivers a sign of his divinity by turning Claude's CLAUDE.md search path into AGENTS.md at her request.
• perganomoly 7d ago
  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.
  • LeoPanthera 7d ago
    If you don't use Claude anymore, why do you care?
    • JungleGymSam 7d ago
      [dead]
    • fragmede 7d ago
      Because other people do, and those people previously would have CLAUDE.md files in their repos and not AGENTS.md files. When you have to work with them and their repos, you were forced to deal with the difference.
      • DeusExMachina 7d ago
        Isn't "deal with the difference" just renaming the file?
        • tstrimple 6d ago
          Yes, but you see this is all part of Anthropic's master plan. They know developers are incapable of renaming files so the fact that Anthropic resisted Agents.md is proof that they were trying to lock you into them as a vendor.
      • desipenguin 7d ago
        symlink CLAUDE.md to AGENTS.md
    • perganomoly 7d ago
• aitoolcrux 7d ago
  [flagged]
• albatross79 7d ago
  CC is such a bloated POS by this point that only full on AGI could have implemented this feature. Congrats guys. Maybe with Super Intelligence they will be able to make it actually respect the instructions in there too.
  • boorang 7d ago
    The system reminder explicitly tells it that the CLAUDE.md or AGENTS.md content is optional. I believe this is a big part of why CC doesn't heed the instructions alot of the time: IMPORTANT: this context may or may not be relevant to your tasks. You should not respond to this context unless it is highly relevant to your task. https://github.com/anthropics/claude-code/issues/18560 https://github.com/anthropics/claude-code/issues/18560
• nullbio 7d ago
  People still use Claude?
• stbenjam 7d ago
  Everyone sharing the 513 ways you can already do this is entirely missing the point. Standards matter and there's very few things in the AI world everyone agrees on and this is one of them. .agents/skills is another and anthropic is still holding out there.
• swozey 7d ago
  Anyone have a good guide on properly setting up/optimizing local llm stuff like this? I've been using omlx and qwen for almost a year but have bounced around clients a bunch, and it seemed like everything was specific to claudes style of config layout, so I've been putting all of my skills/agents/md files in my ~/.claude as a catchall for bouncing between pi.dev/claude/vscode/etc. and just seeing what happens. I really haven't used claude itself much so reasonable but I didn't know it didn't look at AGENTS.md, for instance. Also using some memory/kb system that puts $myKB.md in directories to pre-fill context by project/workspace. I'm currently using oh-my-pi but in the quest for optimization and token trying to get better than 30t/s on my m1 max 64gb (qwen3.6-a35b) I probably need to spend some time just making pi base into what I need and not the opinionated omp setup I have that probably makes the initial context larger than it should be. I'm between work and can't afford the $100+ frontiers but it does get really frustrating spending hours/days tweaking this stuff to almost no benefit sometimes. When I do get to use a frontier it's such a nice break from fixing things. The local llm stuff can definitely be a bit frustrating right now and zap the energy I have for work out of me when it goes awry.
  • Godsend69 7d ago
    [dead]
• bryanhogan 7d ago
  What worked well previously was to have the Claude.md file contain just "@AGENTS.md". But this is a good change. The world of managing skills between providers still feels messy though.
  • kermitime 7d ago
    check out skillshare. or just manage/curate from ~/.agents and symlink to the harness settings directories you have installed
  • bengt 7d ago
    I’d argue this is still the better way. We used to simlink too, but @AGENTS.md with any Claude specific additional steering below it is the best way. https://code.claude.com/docs/en/memory#import-additional-files https://code.claude.com/docs/en/memory#import-additional-fil...
    • albert_e 7d ago
      If this continues to be a thing ...one might actually imagine a good system where we have AGENTS.md with all generic agent instructions and a bunch of harness specific files like CLAUDE.md, GEMINI.md, and CODEX.md that all add whatever nuance and nudging each harness seems to individually require
      • OliverGuy 7d ago
        I like this, but can we not have any of this in the root of the repo cluttering it up with the harness specific instructions for a half dozen plus different harnesses. Something like a dot agents dir
• pampas 7d ago
  I wonder if Anthropic's vending machine only serves customers wearing a Claude™ branded hat.
• boorang 7d ago
  Claude Code wraps both the AGENTS.md and CLAUDE.md in a system-reminder with this disclaimer at the bottom: IMPORTANT: this context may or may not be relevant to your tasks. You should not respond to this context unless it is highly relevant to your task. Codex follows the AGENTS.md far better. CC seems to have nudged people away from taking the CLAUDE.md as mandatory instructions. This bug was closed Not Planned and from a recent analysis of the system prompt the behavior is still there even with the new inclusion of AGENTS.md. https://github.com/anthropics/claude-code/issues/18560 https://github.com/anthropics/claude-code/issues/18560
• zjy365 7d ago
  [flagged]
• pasteleft 7d ago
  BTW if you hate these Antrophic moments but still want to use CC, you can patch it: https://github.com/Piebald-AI/tweakcc https://github.com/Piebald-AI/tweakcc
• victor9000 7d ago
  The fact that something like this is so widely celebrated shows just how user hostile anthropic has become.
• themuskgpt2025 7d ago
  [dead]
• hellobuddy9 7d ago
  [dead]
• Frannky 7d ago
  I switched to oh-my-py and never looked back. I guess having an incentive to maximize (expensive) token usage, and LLMs degrading with higher context, isn't aligned with a user's best interest. Oh-my-py unlocks max capabilities at the smartest token usage, and you can change AI company and providers while still getting things done. Roles, advisor, and the ability to use Chinese models on international providers with no training and ZDR behind OpenRouter are very powerful. You can have providers and model companies competing on price, intelligence, and speed for something that's useful but with less and less moat as model progress plateaus. I now use GLM 5.3 for slow/planning, GLM 5.3 Flash as the default task-vision model, and DeepSeek Flash 4.1 as the advisor. Providers are ordered by cheapest at the minimum TPS I want for that model. I use it not only for coding but also as a personal assistant. I can ask it things and it gets them done automatically, like opening an issue on a repo, then having another agent ship the code, run the tests, and update master after having changed the app to autoupdate on cut release. I can also ask it to do groceries. I use Bitwarden machine secrets and a limited virtual card connected to my phone.Something else that's very powerful is asking it to launch parallel agents to do things you know don't overlap too much. The amount of agency we're gifted with is crazy, you can now move hundreds of hours of work with one hour of input using an open-source harness and open-weight models. I can't wait for more competitors in the chip space, and to be able to buy models etched on silicon for even higher agency, speed, and independence.
  • desipenguin 7d ago
    Do you mean oh-my-pi (omp) (https://github.com/can1357/oh-my-pi/ https://github.com/can1357/oh-my-pi/) I also use the same. But I use Anthropic models (Opus 5) with it.
    • Frannky 6d ago
      yes
• jgb1984 7d ago
  I couldn't care less what the filename is, I do care however that Claude still forgets about 14 times per week that -r with ripgrep means replace (and not recursive, like with grep). Even though it's literally spelled out in my CLAUDE.md. Claude code, even with the most advanced models, forgets or disregards very simple and clear instructions from my modestly sized MD file.
• desipenguin 7d ago
  Genuine question: Does the Agent harness matter ? I mean why use Claude CLI ? (As I mentioned elsewhere) I use oh-my-pi (and opencode, and toad) but use (client paid) Opus 5 with these harnesses. All three of these understand AGENTS.md
• itsmeduncan 7d ago
  [flagged]
• kestrelquant 6d ago
  [flagged]