claude-code-best-practice - An open-source systematic guide to using Claude Code

What is claude-code-best-practice

claude-code-best-practice is an open-source systematic guide to using Claude Code. The project advances from "vibe coding" to "agent engineering," collecting 86+ practical tips, covering core modules such as Agents, Commands, Skills, Hooks, and MCP, and comparing 10+ mainstream development workflows. The project has been cited multiple times by Claude Code creator Boris Cherny, and provides a complete learning path from beginner to advanced.

Main features of claude-code-best-practice

• Systematic knowledge base: Comprehensively breaks down the core modules of Claude Code (Subagents, Commands, Skills, Hooks, MCP Servers), providing a complete learning path from beginner to advanced.
• Hot feature tracking: Updates the Beta feature table in real time, covering the latest features such as Ultraplan, Auto Mode, Computer Use, and Agent Teams.
• Workflow comparison: Compares 10+ mainstream development workflows side by side (such as Everything Claude Code, Superpowers, Spec Kit, etc.), noting Star counts and applicable scenarios.
• Practical tips library: Collects 69+ community lessons learned, covering prompt engineering, context management, CLAUDE.md optimization, Git/PR management, and more.
• Resource aggregation: Organizes articles, tweets, and video tutorials from the official team (Boris, Thariq, etc.).

How to use claude-code-best-practice

• Go directly to the repository: Visit the GitHu repositoryhttps://github.com/shanraisshan/claude-code-best-practice。
• Core sections：
  • Hot: View configuration methods for the latest Beta features (Ultraplan, Auto Mode, Computer Use).
  • Workflows: Compare 10+ mainstream solutions (such as Superpowers, Spec Kit) and choose the workflow suitable for the team.
  • Tips: Consult 69 practical tips (prompt engineering, CLAUDE.md optimization, Git management, etc.).
• Project configuration (practice): Create in the root directory of the target code repository the .claude/ folder structure:

.claude/
├── commands/        # 常用命令（如 /refactor、/techdebt）
├── skills/          # 可复用技能（含 SKILL.md、scripts/、examples/）
├── agents/          # 专用子代理配置
├── hooks/           # 事件钩子（如提交前格式化）
└── settings.json    # 项目级配置（模型、权限、状态栏）

• • At the same time, create in the root directory the CLAUDE.md file, recording the project tech stack and development standards (keep it within 200 lines).
• Daily application
  • Getting started for beginners: Read the "Prompting" and "Workflows" sections in Tips to improve Claude Code usage habits.
  • Encapsulating high-frequency operations: Convert daily repetitive tasks (such as refactoring, code review) into Commands or Skills, and store them in the .claude/ corresponding directory.
  • Troubleshooting: When encountering specific scenarios (such as debugging, PR management), directly consult the corresponding Tips category.

Key information and usage requirements of claude-code-best-practice

• Author: shanraisshan (Shayan Rais), cited multiple times by Claude Code creator Boris Cherny
• Content: 86+ practical tips, covering the five core modules Agents, Commands, Skills, Hooks, and MCP
• Features: A comparison table of 10+ mainstream workflows, real-time tracking of Beta features (Ultraplan, Auto Mode, etc.), and 69 community lessons learned
• Prerequisites: Claude Code CLI tool installed
• Project configuration: Create in the code repository .claude/ Directories (including agents/, commands/, skills/, hooks/ subdirectories) and CLAUDE.md project rules files
• How to use: No installation required; browse the GitHub repository directly and consult as needed; or fork it and customize the workflow according to your own needs

Core advantages of claude-code-best-practice

• Comprehensive system: Systematically breaks down the five major modules—Agents, Commands, Skills, Hooks, and MCP—covering the full path from beginner to advanced, rather than a scattered pile of tips.

• Practice-oriented: Includes 86+ real community lessons learned from pitfalls (such as \"keep CLAUDE.md under 200 lines\", \"use Esc Esc to undo rather than correct\"), not a translation of official documentation.
• Leading timeliness: Tracks Beta features in real time (Ultraplan, Auto Mode, Computer Use, etc.) and provides configuration guides for the latest features.
• Workflow selection: Horizontally compares 10+ mainstream solutions (Everything Claude Code, Superpowers, etc.), annotates Star counts and applicable scenarios, and quickly matches team needs.

Project address of claude-code-best-practice

• GitHub repository：https://github.com/shanraisshan/claude-code-best-practice

Comparison of claude-code-best-practice with similar competitors

Application scenarios of claude-code-best-practice

• Personal efficiency improvement: Developers consult 69 hands-on tips to quickly master prompt engineering, context management, and debugging methods, and avoid common pitfalls.
• Team workflow selection: By comparing 10+ mainstream solutions (such as Superpowers, Spec Kit), choose the most suitable AI-assisted development model for the team.
• Rapid rollout of new features: Use the Hot Features table to instantly learn how to configure Beta features (such as Auto Mode, Computer Use) and get early access to new capabilities.
• Code quality control: Adopt the built-in Code Review workflow or a TDD-first approach, combined with Subagents to implement multi-agent PR review and vulnerability detection.
• Large-scale project management: Through the CLAUDE.md rules file and the Agent Teams feature, achieve parallel development and context isolation in Monorepo or multi-module projects.