Released my global AGENTS.md / CLAUDE.md for more reliable coding agent work, especially with open-weight models, plus WRITING.md rules for less sloppy AI text

Reddit r/LocalLLaMA / 4/24/2026

💬 OpinionIdeas & Deep AnalysisTools & Practical UsageModels & Research

Key Points

  • The author released a global AGENTS.md / CLAUDE.md instruction file aimed at making coding agents work more reliably by requiring evidence before code and using smaller, scoped changes.
  • They report common agent failures—such as entering a repo before understanding it, modifying adjacent code unintentionally, and claiming tasks are complete without real verification—and describe how their rules address these issues.
  • The instruction set emphasizes verification and encourages parallel work or subagents rather than attempting everything sequentially in one pass.
  • Alongside this, they also published WRITING.md with rules to reduce “AI slop” in LLM-assisted writing by removing filler, fake specificity, overly polished generic phrasing, and repetitive structural patterns.
  • The releases are public for others to use as-is, adapt, or debate via issues, and the author is seeking feedback on what holds up across different setups, especially with open-weight models.

I use coding agents a lot, and write with LLMs enough that the same issues kept showing up. Agents would jump into code before they understood the repo, touch adjacent code I did not ask for, and say something was done without really verifying it. And text is a separate big problem, as you all know: too polished, too generic, too much AI slop even when the actual point was fine.

So I started writing down the rules I wished the agents followed, then tightened them whenever I saw the same failure happen again. Eventually that turned into two small repos I use myself:

  • AGENTS.md / CLAUDE.md is my global instruction file for coding agents. It pushes evidence before code, small scoped changes, real verification, and better use of parallel work/subagents instead of doing everything one step at a time.
  • WRITING.md is my ruleset for cleaning up LLM-assisted writing. It is mostly about cutting the stuff that makes text feel pasted from a chatbot: filler, fake specificity, over-neat structure, repeated cadence, and other AI slop patterns.

Both are public now. Use them as-is, borrow parts, disagree with the rules, or open an issue if something works differently in your setup. They solved some of the problems for me, and I'm curious what holds up for other people.

submitted by /u/Anbeeld
[link] [comments]