---
title: "Discussion on \"Why Your CLAUDE.md Keeps Growing \" | Hashnode"
description: "Discussion on \"Why Your CLAUDE.md Keeps Growing \". Imagine you are packing a suitcase for a long road trip with friends. On your first stop, it rains unexpectedly, so you pack an umbrella. On the second stop, you encounter mosquitoes, so you pack bug"
url: "https://hashnode.com/posts/why-your-claude-md-keeps-growing/6a95a4a5d7d493dbea95740d"
---

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

Discussion

# [Why Your CLAUDE.md Keeps Growing](https://blog.nidhin.dev/why-your-claude-md-keeps-growing?utm_source=hashnode&utm_medium=feed)

Imagine you are packing a suitcase for a long road trip with friends. On your first stop, it rains unexpectedly, so you pack an umbrella. On the second stop, you encounter mosquitoes, so you pack bug

Aug 31 · 4 min read · blog.nidhin.dev  
Read the article

-   [#claude](https://hashnode.com/tag/claude)
-   [#markdown](https://hashnode.com/tag/markdown)
-   [#claudemd](https://hashnode.com/tag/claudemd)
-   [#agentsmd](https://hashnode.com/tag/agentsmd)
-   [#ai](https://hashnode.com/tag/ai)

## Written by

[nidhinkumar](https://hashnode.com/@nidhinkumar)

@nidhinkumar · Coimbatore, Tamilnadu, India

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

Software Engineer

## Responses 2

Markdown supported · ⌘↵ to post

[Rulestack](https://hashnode.com/@rulestack)

[Sep 2](https://hashnode.com/posts/why-your-claude-md-keeps-growing/6a95a4a5d7d493dbea95740d/comment/6a976bf050dfae667d183708)

We got the deletion half moving by putting a hard size cap on the file: a commit-gate test fails any commit that pushes it past a fixed byte budget, so nothing lands until something moves out. The why still gets written down - each rule change adds a changelog entry with the date and the instruction behind it, and the file itself carries only current rules, so a policy change deletes the contradicting old text instead of layering on top of it. What I don't know is whether notes survive contact with a real file over months - have you kept them current on one of yours?

[Raunak Singh](https://hashnode.com/@raunakbuilds)

[Sep 2](https://hashnode.com/posts/why-your-claude-md-keeps-growing/6a95a4a5d7d493dbea95740d/comment/6a97d1565c4ae3ca8cb89215)

The suitcase metaphor captures the failure mode well. I have found that splitting stable project rules from temporary task context matters as much as trimming the file: otherwise every correction becomes permanent policy even when it was only relevant to one incident.
