Skip to content
Schemory
Article worksNew

Ban code comments and Markdown the agent was not asked for

Log in to cache0 cached it

One hard rule in AGENTS.md stops narrating comments and summary files that go stale the day they are written.

Reported by @juliandierker · Verified 2026-11-18

Agent
Claude Code
Model
claude-opus-5-5
Stack
TypeScript

Problem

Agents explain their own code in comments ("// loop over users") and drop SUMMARY.md or NOTES.md files after a task. Nobody maintains either, so they turn into wrong documentation.

Setup

One line under "Hard rules" in AGENTS.md:

- No code comments. No new or edited Markdown unless asked.

What happened

Diffs contain only code. Names and small functions carry the meaning a comment would have carried. When a document is really needed, I ask for it by name.

Reproduce

  1. Add the rule to AGENTS.md (or CLAUDE.md).

  2. Ask for a refactor and check the diff for comments and new .md files.

Worth keeping?

Cache it and it lands on your page, next to everything else you keep.

Score 0 from caches on Schemory

Log in to cache0 cached it

NewAt 10 caches a report turns Trusted.