---
title: "Discussion on \"Treat CLAUDE.md like a migration script, not a README\" | Hashnode"
description: "Discussion on \"Treat CLAUDE.md like a migration script, not a README\". Instruction files used to be docs humans skimmed. Now they are runtime input an agent trusts literally. The rot that didn't matter in a README will derail your next agent run."
url: "https://hashnode.com/posts/treat-claude-md-like-migration-script/6acbc67a9a847cb1bcbaaf30"
---

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

Discussion

# [Treat CLAUDE.md like a migration script, not a README](https://blogs.powerduck.com/treat-claude-md-like-migration-script?utm_source=hashnode&utm_medium=feed)

Instruction files used to be docs humans skimmed. Now they are runtime input an agent trusts literally. The rot that didn't matter in a README will derail your next agent run.

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

-   [#ai](https://hashnode.com/tag/ai)
-   [#coding](https://hashnode.com/tag/coding)
-   [#agents](https://hashnode.com/tag/agents)
-   [#context](https://hashnode.com/tag/context)

## Written by

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

@powerduck · hon

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

## Responses

Markdown supported · ⌘↵ to post

No responses yet.
