---
title: "Discussion on \"The Agent Deleted the Comment That Explained Why the Code Looks Weird\" | Hashnode"
description: "Discussion on \"The Agent Deleted the Comment That Explained Why the Code Looks Weird\". The function looked ugly on purpose. The comment said why. The agent \"cleaned it up\" and now the next engineer has to rediscover the workaround the hard way."
url: "https://hashnode.com/posts/agent-deletes-the-workaround-comment/6ad296776ff34c5cf5a8fe2a"
---

[Feed](https://hashnode.com/feed) /

Discussion

# [The Agent Deleted the Comment That Explained Why the Code Looks Weird](https://blogs.powerduck.com/agent-deletes-the-workaround-comment?utm_source=hashnode&utm_medium=feed)

The function looked ugly on purpose. The comment said why. The agent "cleaned it up" and now the next engineer has to rediscover the workaround the hard way.

Oct 16 · 4 min read · blogs.powerduck.com  
Read the article

-   [#aiagents](https://hashnode.com/tag/aiagents)
-   [#coding](https://hashnode.com/tag/coding)
-   [#refactoring](https://hashnode.com/tag/refactoring)
-   [#softwareengineering](https://hashnode.com/tag/softwareengineering)

## Written by

[Powerduck](https://hashnode.com/@powerduck)

@powerduck · hon

  
[View profile](https://hashnode.com/@powerduck)

## Responses 1

Markdown supported · ⌘↵ to post

[netproxy](https://hashnode.com/@argumentmoney8117)

[Oct 16](https://hashnode.com/posts/agent-deletes-the-workaround-comment/6ad296776ff34c5cf5a8fe2a/comment/6ad2a39c5f554d1edc85e662)

The scary part isn't that the agent deleted the comment — it's that the passing tests make the loss invisible until weeks later. Asking the agent to restate the comment's intent before touching it is the kind of cheap check that deserves a permanent spot in review checklists, right next to "run the tests".