# Code review comments are the rules you forgot to write down

DevFeed: [Code review comments are the rules you forgot to write down](<https://devfeed.tech/articles/code-review-comments-are-the-rules-you-forgot-to-write-down-25590.md>)

Original publisher: [Read original article](<https://www.marcogomiero.com/posts/2026/code-review-agents-update/>)

Author: Marco Gomiero

Published: 2026-07-27T00:00:00Z

Content type: article

Language: en

Sources: [Posts on Marco Gomiero](<https://devfeed.tech/sources/posts-on-marco-gomiero.md>)

Topics: [Code review](<https://devfeed.tech/topics/code-review.md>), [Pull Request](<https://devfeed.tech/topics/pull-request.md>), [Loop Engineering](<https://devfeed.tech/topics/loop-engineering.md>), [context](<https://devfeed.tech/topics/context.md>), [Markdown](<https://devfeed.tech/topics/markdown.md>)

Tags: [agent](<https://devfeed.tech/tags/agent.md>), [ai-agents](<https://devfeed.tech/tags/ai-agents.md>), [also](<https://devfeed.tech/tags/also.md>), [code-review](<https://devfeed.tech/tags/code-review.md>), [maintenance](<https://devfeed.tech/tags/maintenance.md>), [markdown](<https://devfeed.tech/tags/markdown.md>), [workflow](<https://devfeed.tech/tags/workflow.md>)

## AI overview

The article describes a workflow for using AI agents to inspect recent pull-request review comments, identify recurring violations of project conventions, and propose updates to instruction files such as AGENTS.md. It presents code-review feedback as evidence of undocumented project rules and discusses using scripts to retrieve review comments.

## Source excerpt

If you work with AI agents, you have an instruction file (and if you don't, you should!) usually called AGENTS.md (with CLAUDE.md symlinked to it, because standards are hard to follow). This Markdown file is automatically added to the AI context, and it should contain all the guidelines for the project and everything that the agent should be aware of. For example, how to build the project, styling, conventions, and anything else that should be known to achieve the best possible result.