Boris Mode
CLI tool that audits your Claude Code setup and tells you exactly how to improve.
Open source · npm package · AI-powered analysis
Are you getting the most out of Claude Code? Boris Mode scans your project, compares it against best practices from Boris Cherny (creator of Claude Code) and Anthropic’s official documentation, and tells you exactly how to improve.
npx boris-modeWhat It Checks
Static Analysis
- CLAUDE.md Health — Existence, size, recency, contributor count
- Workflow Automation — Slash commands configured, essential commands present
- Verification Loops — Test framework setup, verification instructions
- Hooks & Safety — PostToolUse formatting, safety hooks, permissions
- Git Integration — gh CLI or GitHub MCP configured
- MCP Servers — Context7, Playwright, and other MCPs configured
AI-Powered Deep Analysis
Boris Mode uses Claude itself to analyze the quality of your setup:
- CLAUDE.md quality — Are your instructions specific and actionable, or vague boilerplate?
- Command quality — Are your slash commands clear and complete?
- Hooks safety — Any security concerns with your permissions?
- Prompting habits — Are you writing effective prompts? (opt-in)
Features
Actionable Reports — Every finding includes what’s missing, why it matters (with quotes from Boris Cherny), and exact copy-paste fixes.
Auto-Apply Mode — Run npx boris-mode --apply to generate a prompt that Claude Code can use to implement all recommendations automatically.
Prompting Analysis — Opt-in analysis of your Claude Code session history to evaluate prompt length, plan mode usage, and anti-patterns.
CI-Friendly — JSON output, non-interactive mode, and configurable timeouts for automation.
Scoring
| Score | Tier | Description |
|---|---|---|
| 0-6 | Beginner | Using Claude Code as a chat interface |
| 7-11 | Intermediate | Building workflows, room to grow |
| 12-16 | Advanced | Strong setup, minor optimizations available |
| 17-20 | Expert | Boris-level setup |
Based On
- Boris Cherny — Creator of Claude Code and his published setup
- Anthropic Docs — Claude Code Best Practices
- Official Documentation — code.claude.com
“Probably the most important thing to get great results out of Claude Code — give Claude a way to verify its work. If Claude has that feedback loop, it will 2-3x the quality of the final result.” — Boris Cherny