News for hackers. Stuff that matters.
Re:Cursor CLI by thehamkercat on Thursday August 07, 2025 @05:58PM (#44830894)
I wonder when all of them will adopt AGENT.md and stop using gemini.md/claude.md/crush.md/summary.md/qwen.md

https://agent.md [redirect -> https://ampcode.com/AGENT.md] https://agent-rules.org

Re:Cursor CLI by stillsut on Thursday August 07, 2025 @07:34PM (#44831699)
Yeah I suspect some of these providers will become Microsoft in the '90s type bully holdouts on implementing the emerging conventions. But ultimately with CLI interface you have workarounds to all the major providers read in your system guidelines. But in an IDE - e.g. like MS had with VisualStudio - you more lock-in potential for your config files.

Yesterday, I was writing about a way I found to pass the same guideline documents into Claude, Gemini, and Aider CLI-coders: https://github.com/sutt/agro/blob/master/docs/case-studies/a...

Re:Cursor CLI by rapind on Thursday August 07, 2025 @07:41PM (#44831758)
Isn't think just a symlink?
Re:Cursor CLI by mrits on Thursday August 07, 2025 @10:24PM (#44832757)
I'm at a point where I symlink differnet sets of docs to try to focus context so much I feel like maybe I need a git submodule with different branches of context I want. I left managing people to now manage AI
Re:Cursor CLI by neuronexmachina on Thursday August 07, 2025 @07:36PM (#44831721)
I really like the idea of standardizing on AGENT.md, although it's too bad it doesn't really work with the .cursor/rules/ approach of having several rules files that get included based on matching the descriptions or file globs in frontmatter. Then again, I'm not sure if any other agents support an approach like that, and in my experience Cursor isn't entirely predictable about which rules files it ends up including in the context.

I guess having links to supplementary rules files is an option, but I'm not sure which agents (if any) would work well with that.

Re:Cursor CLI by prmph on Thursday August 07, 2025 @06:49PM (#44831360)
Yep, that's a peeve of mine. I've resorted to using AGENT.md, and aliasing Claude, Gemini, etc to a command that calls them with an initial instruction to read that file. But of course they will forget after some time.

The whole agentic coding via CLI experience could be much improved by:

- Making it easy to see what command I last issued, without having to scroll up through reams of output hunting for context - Making it easy to spin up a proper sandbox to run sessions unattended - Etc.

Maybe for code generation, what we actually need is a code generator that is itself deterministic but uses AI, instead of AI that does code generation.

Re:Cursor CLI by thehamkercat on Thursday August 07, 2025 @07:01PM (#44831448)
I think most of them provide an option to change the default file, but it'll be really good if they all can switch to AGENT.md by default

Till then you can also use symlinks

there are issues opened in some repos for this

- Support "AGENT.md" spec + filename · Issue #4970 · google-gemini/gemini-cli

https://github.com/google-gemini/gemini-cli/issues/4970#issu...

Re:Cursor CLI by ximeng on Thursday August 07, 2025 @09:20PM (#44832366)
Re:Cursor CLI by troupo on Friday August 08, 2025 @03:24AM (#44834445)
And then they should standardize on usage rules (an idea in Elixir space: https://hexdocs.pm/usage_rules/readme.html )
Re:Cursor CLI by manmal on Friday August 08, 2025 @01:45AM (#44833838)
In case you haven’t seen this, you can just pipe contents into Claude. Eg

cat AGENT.md | claude

IIRC this saves some tokens.

Re:Cursor CLI by adastra22 on Friday August 08, 2025 @11:33AM (#44838247)
Why would it save tokens?
Re:Cursor CLI by taylorfinley on Friday August 08, 2025 @02:56PM (#44840407)
probably skips the step where you say "take a look at path/to/file" and the model converts that to a tool call
Re:Cursor CLI by codesnik on Friday August 08, 2025 @04:45AM (#44834874)
maybe symlinking will work
Re:Cursor CLI by js2 on Thursday August 07, 2025 @06:31PM (#44831210)
That's a more obvious (but less fun) name than what I've been using: ROBOTS.md with symlinks.
Re:Cursor CLI by thehamkercat on Thursday August 07, 2025 @06:38PM (#44831272)
https://ampcode.com/AGENT.md#migration

they also suggest using symlinks for now

Re:Cursor CLI by irrationalfab on Thursday August 07, 2025 @06:55PM (#44831405)
Thank you so much for this!
Re:Cursor CLI by ijidak on Thursday August 07, 2025 @07:05PM (#44831481)
Agree. It's all English. That's the whole point of these tools.

Why are we purposely creating CLI dialects?

Re:Cursor CLI by sneak on Thursday August 07, 2025 @06:44PM (#44831318)
When they stop getting desperate for differentiation by spamming their brand advertising in your repo against your will.

Claude Code likes to add "attribution" in commit messages, which is just pure spam.

Re:Cursor CLI by striking on Thursday August 07, 2025 @06:47PM (#44831350)
You can turn it off: https://docs.anthropic.com/en/docs/claude-code/settings#avai... `includeCoAuthoredBy: false`
Re:Cursor CLI by arcanemachiner on Friday August 08, 2025 @05:26AM (#44835099)
5 years from now: Subscribe to the Ultra plan for the ability to prevent the LLM from putting ads for Coca-Cola into your code comments!
Re:Cursor CLI by what on Friday August 08, 2025 @12:38AM (#44833459)
It’s not spam, it lets people know it was written by an LLM and maybe you should look closer at it.
Re:Cursor CLI by computerfriend on Friday August 08, 2025 @07:34AM (#44835836)
I've experimented a little with LLM agents (only Claude Code). I definitely don't want the agent to write the commit messages (they should be written by a human as they're for human consumption) so I manually added the co-author trailer. It's morally correct to provide attribution.
Re:Cursor CLI by CubicalBatch on Friday August 08, 2025 @04:22PM (#44841305)
I find LLM written commits are more often than not better than humans one
Re:Cursor CLI by sneak on Saturday August 09, 2025 @03:46PM (#44849502)
Code is also for human consumption.

SICP contains the famous quote: “Programs must be written for people to read, and only incidentally for machines to execute.”

Re:Cursor CLI by dgunay on Thursday August 07, 2025 @09:24PM (#44832391)
I just wish the AGENTS.md standard wasn't a single file. I have a lot of smaller context documents that aren't applicable to every task, so I like to throw them into a folder (.ai/ or .agents/) and then selectively cat them together or tell the agent to read them.
Re:Cursor CLI by esafak on Thursday August 07, 2025 @10:26PM (#44832775)
You can put them in subdirectories like CODEOWNERS files. https://ampcode.com/AGENT.md#multiple-agent-files
Re:Cursor CLI by what on Friday August 08, 2025 @12:36AM (#44833454)
>When multiple files exist, tools SHOULD merge the configurations with more specific files taking precedence over general ones.

How is the tool supposed to merge multiple md files?

Re:Cursor CLI by esafak on Friday August 08, 2025 @12:41AM (#44833477)
The same way it synthesizes anything else. We're talking about LLMs here; this is their bread and butter.
Re:Cursor CLI by yunohn on Friday August 08, 2025 @06:52AM (#44835555)
Most AI solutions make tracing the finally assembled prompt a bit difficult.

However, if you look through the source code or network requests, you’ll see that merging just means naive “concatenation”.

Re:Cursor CLI by troupo on Friday August 08, 2025 @03:25AM (#44834450)
Elixir has this idea with usage rules: https://hexdocs.pm/usage_rules/readme.html
Re:Cursor CLI by dotancohen on Friday August 08, 2025 @05:12AM (#44835018)
You could have a python script that generates the MD file on the fly, based on how you want to prompt the model. I think it's kind of funny, how deep we are getting with tools instructing tools instructing tools.
Re:Cursor CLI by bikeshaving on Thursday August 07, 2025 @09:28PM (#44832411)
Every time I’ve ever read a {CLAUDE|GEMINI|QWEN}.md I’ve thought all this information could just be in CONTRIBUTING.md instead.
Re:Cursor CLI by hahajk on Thursday August 07, 2025 @09:38PM (#44832474)
Yes! I want an option to always add README.md to the context; It would force me to have a useful, up to date document about how to build, run, and edit my projects.
Re:Cursor CLI by tyre on Thursday August 07, 2025 @11:38PM (#44833145)
You can include in your prompt for it to read the README!
Re:Cursor CLI by ______ on Friday August 08, 2025 @12:09AM (#44833312)
Ultimately if this stuff is actually intelligent it should be using the same sources of information that we intelligent beings use. Feels silly to have to have to jump through all these hoops to make it work today
Re:Cursor CLI by adastra22 on Friday August 08, 2025 @11:30AM (#44838214)
It’s a crapshoot of it actually does.
Re:Cursor CLI by eru on Friday August 08, 2025 @01:01AM (#44833603)
> It would force me to have a useful, up to date document about how to build, run, and edit my projects.

Not really: our AI agents are probably smart enough to even make sense of somewhat bad instructions.

Re:Cursor CLI by yunohn on Friday August 08, 2025 @02:15AM (#44834034)
They’re definitely not, Claude and all other agents frequently forget the build and test commands present in CLAUDE/etc.md for my various repos (even though most of them were were initialized by the AI).
Re:Cursor CLI by eru on Friday August 08, 2025 @03:12AM (#44834379)
Whether Claude and co understand is probably not a great proxy for whether your docs are good for humans.
Re:Cursor CLI by yunohn on Friday August 08, 2025 @07:35AM (#44835842)
Hmmm, in my experience if something like documentation confuses the current SOTA LLMs, then it will confuse the average developer for sure.
Re:Cursor CLI by eru on Sunday August 10, 2025 @03:12AM (#44853365)
I had the other direction in mind: you can put together some text that the average LLM will figure out, but that will be really annoying for your average developer.

Eg if you write your instructions in a mixture of base 64, traditional Chinese, morse code and Polish, the LLM will still figure it out.

Re:Cursor CLI by dotancohen on Friday August 08, 2025 @05:07AM (#44834978)
Not the case at all. AI agents will happily turn your bad ideas into code.
Re:Cursor CLI by eru on Friday August 08, 2025 @07:05AM (#44835629)
Non sequitur?

I am talking about LLMs figuring out how to build your project with some bad and incomplete instructions plus educated guessing.

Re:Cursor CLI by __MatrixMan__ on Friday August 08, 2025 @08:06AM (#44836051)
If I'm writing for a human contributor, I'm gonna have a pretty high bar for the quality of that writing.

An agent on the other hand, one who is in that sweet spot where they're no longer ignorant, and not yet confused... It's nice to have them dump their understanding to agent_primers/subsystem_foo.md for consumption by the next agent that touches that subsystem. I don't usually even read these until I suspect a problem in one. They're just nuggets of context transfer.

Re:Cursor CLI by stonecharioteer on Thursday August 07, 2025 @09:38PM (#44832482)
Symlinks $AGENT.md to AGENT.md in your repo.
Re:Cursor CLI by anp on Thursday August 07, 2025 @09:46PM (#44832539)
FWIW at least with Claude and Jules on a project I have a decent setup where I put all of the real content in an agents.md and then use “@agents.md” in CLAUDE.md. If all of the tools supported these kinds of context references in markdown it wouldn’t be that hard to have a single source of truth for memory files.
Re:Cursor CLI by yougotwill on Thursday August 07, 2025 @11:13PM (#44833008)
Same here each specific instruction file (vs code, cursor, etc.) just says read the AGENTS.md for instructions
Re:Cursor CLI by fastball on Thursday August 07, 2025 @10:04PM (#44832655)
That sounds nice and I have the same pain, but not sure AGENT.md is the right abstraction either. After all, these models are indeed different and will respond differently even given the same prompting. Not to mention that different wrappers around those models have different capabilities.

e.g. maybe for CURSOR.md you just want to provide context and best practices without any tool-calling context (because you've found it doesn't do a great job of tool-calling), while for CLAUDE.md (for use with Claude Code) you might want to specify tools that are available to it (because it does a great job with tool calling).

Probably best if you have an AGENT.md that applies to all, and then the tools can also ingest their particular flavor in addition, which (if anything is in conflict) would trump the baseline AGENT file.

Re:Cursor CLI by JamesSwift on Friday August 08, 2025 @09:48AM (#44836914)
Then lets do:

  AGENT.md
  AGENT.CLAUDE.md
They get applied AGENT first, then AGENT.CLAUDE. You are able to specify agent specific instructions in the AGENT.md:

  @agent-disable CLAUDE
  These instructions are not parsed by claude
  @agent-enable CLAUDE
Re:Cursor CLI by ako on Friday August 08, 2025 @01:09AM (#44833651)
I asked claude code for a guidelines file so it would collaborate with windsurf. This is what it proposed:

---

    This project uses shared planning documents for collaboration with Claude Code. Please:

    1. First read and understand these files:

       - PLAN.md - current project roadmap and objectives

       - ARCHITECTURE.md - technical decisions and system design

       - TODO.md - current tasks and their status

       - DECISIONS.md - decision history with rationale

       - COLLABORATION.md - handoff notes from other tools

    2. Before making any significant changes, check these documents for:

       - Existing architectural decisions

       - Current sprint priorities

       - Tasks already in progress

       - Previous context from Claude Code

    3. After completing work, update the relevant planning documents with:

       - Task completion status

       - New decisions made

       - Any changes to architecture or approach

       - Notes for future collaboration

    Always treat these files as the single source of truth for project state.
Re:Cursor CLI by novaleaf on Friday August 08, 2025 @01:26AM (#44833742)
problem is that claude doesn't actually read those or keep them in context unless you prompt it to. it has to be in CLAUDE.md or it'll quickly forget about the contents
Re:Cursor CLI by ako on Friday August 08, 2025 @01:51AM (#44833876)
I've added these instructions in CLAUDE.md and .windsurfrules, and yes sometimes you have to remind it, but overall it works quite well.
Re:Cursor CLI by MrGreenTea on Friday August 08, 2025 @02:04AM (#44833952)
Habe you though about adding a Session start hook that reads this file and adds it to the context?
Re:Cursor CLI by ako on Friday August 08, 2025 @02:44AM (#44834205)
Not yet, but that sounds like a good suggestion.
Re:Cursor CLI by radarsat1 on Friday August 08, 2025 @05:22AM (#44835082)
Sounds like a job for a symlink
Re:Cursor CLI by troupo on Friday August 08, 2025 @03:21AM (#44834428)
> it has to be in CLAUDE.md or it'll quickly forget about the contents

And then it will promptly forget about CLAUDE.md as well (happened to me on several occasions)

Re:Cursor CLI by adastra22 on Friday August 08, 2025 @11:29AM (#44838202)
CLAUDE.md is placed in front of the first input for your session, right after the system prompt. That’s all. It’s not given any more weight than the rest of the context, and idk what compacting the conversation does to it.
Re:Cursor CLI by ascorbic on Friday August 08, 2025 @06:59AM (#44835593)
You could create a CLAUDE.md that just contains:

  @AGENTS.md
Still messy, but at least it means it's using the same content
Re:Cursor CLI by Jenk on Friday August 08, 2025 @08:11AM (#44836088)
What about

    ln -s AGENTS.md CLAUDE.md # repeat for all

?
Re:Cursor CLI by seunosewa on Friday August 08, 2025 @09:35AM (#44836761)
Also great.
Re:Cursor CLI by zarzavat on Friday August 08, 2025 @01:49AM (#44833860)
Never. It's a marketing strategy. Some percentage of users will check these files into their repos, and some percentage of repo browsers will think "what is this X.md?" Given how much money people are spending on these things the value of having a unique filename must be enormous.
Re:Cursor CLI by drdaeman on Friday August 08, 2025 @02:47AM (#44834226)
It’s a marketing strategy that works here and now, but “never” is a very long time. What could be seen as pioneers claiming names today could be also seen as retrogressive stubbornness tomorrow and lose its marketing value.
Re:Cursor CLI by dotancohen on Friday August 08, 2025 @05:09AM (#44834996)
There's a reason we still call the file robots.txt by that name, and not web-scraping.txt or search-engines.txt.
Re:Cursor CLI by adobrawy on Friday August 08, 2025 @09:29AM (#44836704)
Yea, the reason is RFC9309.
Re:Cursor CLI by dotancohen on Friday August 08, 2025 @11:40AM (#44838329)
That's actually a good point, but we have RFCs superceding RFCs all the time. My favorite RFC, 8601, superseded I think half a dozen other RFCs.
Re:Cursor CLI by getflourish on Friday August 08, 2025 @02:09AM (#44833986)
Brand asset
Re:Cursor CLI by stpedgwdgfhgdd on Friday August 08, 2025 @03:08AM (#44834350)
The deeper problem are the custom commands, hooks and subagents. The time has come that you need to make a strategic choice. Once you have heavily invested into CC, it is not easy to turn to an alternative.

Side remark: CC is very expensive when using API billing (compared to e.g. GPT-5). Once a company adopts CC and all developers start to adapt to it at full scale, the bill will go out of the roof.

Re:Cursor CLI by asboans on Friday August 08, 2025 @06:52AM (#44835554)
Symlink?
Re:Cursor CLI by calmoo on Friday August 08, 2025 @07:11AM (#44835685)
The font on that RFC is aggressively squashed and aliased, why?
Re:Cursor CLI by ignoramous on Friday August 08, 2025 @09:20AM (#44836633)
Different file names is easy analytics (ex: 'how many OSS projects use gemini.md and claude.md' is a mere search query).
Re:Cursor CLI by leerob on Friday August 08, 2025 @10:53AM (#44837737)
(I work at Cursor) We plan to add support for AGENT.md!
Re:Cursor CLI by vmt-man on Friday August 08, 2025 @11:36AM (#44838277)
For example: i'm using Claude Code mostly + Gemini CLI. Gemini CLI is not such powerful as CC, also it won't work with some mcp's. So i have different *.md files.
Re:Cursor CLI by neuronexmachina on Friday August 08, 2025 @11:58AM (#44838533)
I haven't tried it yet myself, but I noticed their product page (https://cursor.com/cli) says:

> Set your own rules: Customize Cursor's work with rules, AGENTS.md, and MCP.

There's no mention of it in the docs, though. It's also interesting it's AGENTS.md on that page instead of AGENT.md, I wonder if that's a typo.

Re:Cursor CLI by enobrev on Friday August 08, 2025 @12:00PM (#44838555)
I think I'd be happier with a standard .agents directory and have all of these in there. I imagine each agent is going to need its own tweaks to get it to work just right with their system prompts, just as Claude already has it's project-specfic .claude directory for hooks and commands and whatnot.

I'd rather .agents/claude or something so we can get these files out of the root directory, which, at least for typescript projects, is already a confetti-like jumble of json files for every little "simple" tool that needs its own configuration file.

I get why package.json isn't enough. But would a .config directory standard really have hurt us so much?

Re:Cursor CLI by augusto-moura on Friday August 08, 2025 @01:00PM (#44839270)
Ideally (and in practice, so far) they shouldn't change that much. The agent instructions should be close to a human explanation, and they are pretty good at parsing instructions anyway. In my experience you can symlink the same file to all paths and they work as expected.