$ recombobulate _
home / tips / add-a-persona-section-to-claudemd-to-set-the-communication-style
156

Add a Persona Section to CLAUDE.md to Set the Communication Style

recombobulate @recombobulate · Mar 28, 2026 · Configuration
add-a-persona-section-to-claudemd-to-set-the-communication-style

Claude's default communication style is helpful but generic. A short persona section in your CLAUDE.md tunes how Claude talks to you — not just what it does, but how it explains, summarises, and presents options.

## Persona

Be terse. Skip preamble. Lead with the answer or the code. 
Don't explain obvious things. When something is non-obvious, 
explain in one sentence, not three paragraphs. 
Use bullet points over prose. Never say "Great question!" or 
"Let me help you with that."

That's all it takes. Claude reads this and adjusts its entire communication style for your project. No more wading through friendly but unnecessary paragraphs to find the actual answer.

Different teams need different styles:

## Persona — for a senior team that wants speed

Be direct. Code first, explanation only if asked. 
Skip the "here's what I'm going to do" — just do it. 
If you need to explain something, one sentence max.
## Persona — for a team with junior developers

Explain your reasoning as you go. When making a choice between approaches, 
say why. Include links to relevant documentation when you reference 
framework-specific concepts. Use analogies for complex patterns.
## Persona — for a domain-specific project

Use our domain vocabulary: "tenants" not "users", "leases" not "subscriptions", 
"units" not "products". When generating code, variable names should use 
domain language: tenant_id, lease_start_date, unit_number.

The persona section pairs well with other CLAUDE.md sections. Your common commands section tells Claude what to run, the bad patterns section tells it what not to write, and the persona section tells it how to communicate — three different dimensions of project-specific behaviour.

Keep the persona section short — 3-5 sentences is enough. Claude reads it on every session, so every word counts.

Claude adapts to your codebase — make it adapt to your communication style too.

via Claude Code

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Describe Your Users in CLAUDE.md So Claude Writes Appropriate Copy, Error Messages, and UX

When Claude writes error messages, button labels, validation text, or onboarding flows, it defaults to generic developer-speak. Add a "Users" section to your CLAUDE.md describing who your actual users are — their technical level, industry jargon, and what they care about — so Claude writes copy that makes sense to THEM, not to developers.

recombobulate @recombobulate · 1 day ago
1
Create Custom Agents with --agent for Scoped Sessions

Use the --agent flag with custom markdown files in .claude/agents/ to launch purpose-built Claude sessions with restricted tools and scoped system prompts.

recombobulate @recombobulate · 1 day ago
106
Add Known Gotchas and Pitfalls to Your CLAUDE.md So Claude Avoids Mistakes Your Team Already Made

Every project has traps — the billing module that silently fails if you forget to queue the job, the legacy table with column names that don't match the model, the config value that must be set before tests run. Document these gotchas in your CLAUDE.md so Claude avoids the same mistakes your team spent days debugging.

recombobulate @recombobulate · 1 day ago