34 comments

log in to comment.

  • @fullsquare@awful.systems · 28 Sep 2026

    Agents md file doesn’t actually do anything except using more tokens arxiv.org/pdf/2602.11988

    • @brian@programming.dev · 28 Sep 2026

      I feel like you either didn’t read your article or didn’t read the post article

      • @RumRunningDevil@lemmy.zip · 29 Sep 2026

        [deleted]

        • @brian@programming.dev · 30 Sep 2026

          your research paper:

          llm generated agent.md files are harmful. handwritten ones on average don’t have an effect on ability to complete a task

          thread article:

          agents keep signing off on commits wrong. we added it to the agents.md and now they don’t

          benchmarks notoriously don’t measure the likelihood that the results would be merged by maintainers, just that they passed a test

          the old style “repo map” agents.md files that every tool used to create is no longer useful, but of course things that would otherwise be repeated prompts are still good. I cut the ones at work down from hundreds of lines each to tens. without those last few lines the amount of iteration I do - both with agent and when reviewing PRs - goes up significantly

        • @Feathercrown@lemmy.world · 29 Sep 2026

          Agents.md doesn’t exist to make sure generated code functions, it’s there to make sure it’s written well.

          • @RumRunningDevil@lemmy.zip · 29 Sep 2026

            [deleted]

            • @hirihit640@sh.itjust.works · 30 Sep 2026 · edited

              If that’s the case; why use the agent to edit the code in the first place?

              Agents for generation, humans for review

            • @Feathercrown@lemmy.world · 30 Sep 2026 · edited

              “Writing code well” includes several relavant things:

              • Security implications
              • Stability and edge case handling
              • Performance
              • Quality of output (ie. for UI/UX)
              • Readability (Agents need to read to make changes too! Violating DRY/SOLID/etc. could still cause issues!)

              As far as I’m aware you do currently still need a human to ensure stuff like this is followed. People use agents because they don’t care about the above, or because they can get close enough and intervene to fix any issues that appear.