Personality Is a Luxury Tax on AI Agents - How Trimming CLAUDE.md Improved Output
Personality Is a Luxury Tax on AI Agents - How Trimming CLAUDE.md Improved Output
Personality is a luxury tax. Every token you spend telling an AI agent to be friendly, use certain phrases, or maintain a specific tone is a token not spent on understanding your codebase, remembering constraints, or planning the next action.
The CLAUDE.md Bloat Problem
CLAUDE.md files tend to grow. You add a note about communication style. Then a section on how to handle errors gracefully. Then personality guidelines because the agent was being too terse. Before you know it, 200 lines of your context window are spent on personality that has zero impact on whether the agent writes correct code.
We discovered this by accident. After trimming our CLAUDE.md from 400 lines to 180 - cutting mostly personality and style instructions - code output quality improved noticeably. Fewer hallucinated imports. Better error handling. More accurate use of existing patterns in the codebase.
Why This Happens
Context windows are finite. Even with 200K tokens, the model's attention is not evenly distributed. Instructions at the top of the context compete with code context, file contents, and tool outputs for the model's limited attention budget.
When you fill that budget with "be concise but friendly" and "use analogies when explaining," you are literally displacing technical context. The model has less room to hold the function signature it just read or the error message it needs to address.
What to Keep, What to Cut
Keep instructions that affect correctness - coding standards, architectural patterns, file naming conventions, testing requirements. These directly improve output quality.
Cut instructions that affect style without affecting correctness. The agent does not need to be charming. It needs to write code that compiles, passes tests, and follows your project's patterns.
The Exception
If your agent is user-facing - a chatbot, a voice assistant, a customer support tool - personality instructions earn their token cost. The output is the conversation itself, so tone matters.
For developer tools and automation agents, personality is pure overhead. Trim it and watch your output improve.
- Context Engineering - CLAUDE.md Is the Most Important File
- Claude Overkill - Avoid Over-Engineering CLAUDE.md
- AI Goldfish Memory and CLAUDE.md Constraints
Fazm is an open source macOS AI agent. Open source on GitHub.