DocumentationClaude Code
Build Your Project Voice Guide
Define your team's coding voice, standards, and what you reject — so AI matches your style, not generic defaults
Prompt
Interview me to build a voice and standards guide for this project. Ask me one question at a time. Cover:
1. **Code style identity** — What does "clean code" look like to us? Paste a snippet you're proud of and one that makes you cringe.
2. **PR review tone** — Are we terse or thorough in reviews? Show me a real review comment you've written.
3. **Commit message style** — Conventional commits? Imperative mood? Show me 3 recent commits you liked.
4. **What we reject** — What patterns, naming conventions, or shortcuts are never acceptable? Be specific.
5. **Error handling philosophy** — Do we fail loud or recover silently? Where's the line?
6. **Comment policy** — When do we comment? What comments annoy you?
Rules for this interview:
- Push back if my answers are vague. Ask for examples.
- If I say "clean" or "readable" — ask me what that means concretely.
- 80% of this guide should document what we reject, not what we prefer.
- Output a structured Markdown section I can drop into CLAUDE.md.