claude-code-best-practice - A systematic guide to using the open-source Claude Code.

What is claude-code-best-practice?

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

The main functions of claude-code-best-practice

• Systematic knowledge baseA comprehensive breakdown of Claude Code's core modules (Subagents, Commands, Skills, Hooks, MCP Servers), providing a complete learning path from beginner to advanced.
• Popular Features Tracking: Real-time updates to the Beta feature list, covering the latest features such as Ultraplan, Auto Mode, Computer Use, and Agent Teams.
• Workflow ComparisonA horizontal comparison of 10+ mainstream development workflows (such as Everything Claude Code, Superpowers, Spec Kit, etc.) is conducted, with star ratings and applicable scenarios noted.
• Practical Skills LibraryIt includes 69+ community pitfall experiences, covering topics such as hint engineering, context management, CLAUDE.md optimization, Git/PR management, etc.
• Resource aggregation: Compile articles, tweets, and video tutorials from the official team (Boris, Thariq, etc.).

How to use claude-code-best-practice

• Direct to warehouseVisit the GitHu repository: https://github.com/shanraisshan/claude-code-best-practice.
• Core Sector:
  • Hot: View the configuration methods for the latest Beta features (Ultraplan, Auto Mode, Computer Use).
  • WorkflowsCompare 10+ mainstream solutions (such as Superpowers and Spec Kit) and choose the workflow that suits your team.
  • Tips: Review 69 practical tips (including project tips, CLAUDE.md optimization, Git management, etc.).
• Project Configuration (Practice)Create in the root directory of the target code repository .claude/ Folder structure:

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

• • Create the root directory at the same time. CLAUDE.md The document should record the project's technology stack and development specifications (within 200 lines).
• Everyday Applications
  • Beginner's GuideRead the "Prompting" and "Workflows" sections in the Tips to improve your Claude Code usage habits.
  • High-frequency operating packageConvert routine, repetitive tasks (such as refactoring and code review) into Commands or Skills and save them. .claude/ Corresponding directory.
  • TroubleshootingFor specific scenarios (such as debugging or PR management), directly refer to the corresponding Tips category.

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

• authorshanraisshan (Shayan Rais), cited multiple times by Boris Cherny, creator of the Claude Code.
• content86+ practical tips covering five core modules: Agents, Commands, Skills, Hooks, and MCP.
• feature: 10+ mainstream workflow comparison tables, real-time tracking of Beta features (Ultraplan, Auto Mode, etc.), and 69 community troubleshooting tips.
• PrerequisitesClaude Code CLI tool is installed.
• Project ConfigurationCreate in the code repository .claude/ The directory (including subdirectories agents/, commands/, skills/, and hooks/) and CLAUDE.md Project rules document
• How to useNo installation required; simply browse the GitHub repository as needed; or fork it and customize your workflow to your specific requirements.

The core advantages of claude-code-best-practice

• Complete systemThe system is broken down into five major modules: Agents, Commands, Skills, Hooks, and MCP, covering the entire path from beginner to advanced, rather than just a collection of scattered skills.

• Practical orientationIncludes 86+ real-world experiences from the community (such as "Controlling CLAUDE.md to within 200 lines" and "Use Esc to undo instead of correct"), and translations of unofficial documentation.
• Leading in timelinessReal-time tracking of Beta features (Ultraplan, Auto Mode, Computer Use, etc.) and provision of the latest feature configuration guides.
• Workflow Selection: Compare 10+ mainstream solutions (Everything Claude Code, Superpowers, etc.), mark the number of stars and applicable scenarios, and quickly match team needs.

claude-code-best-practice project address

• GitHub repositoryhttps://github.com/shanraisshan/claude-code-best-practice

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

Application scenarios of claude-code-best-practice

• Personal efficiency improvementDevelopers can consult 69 practical tips to quickly master tooltips, context management, and debugging methods, avoiding common pitfalls.
• Team workflow selectionBy comparing 10+ mainstream solutions (such as Superpowers and Spec Kit), we help teams select the most suitable AI-assisted development model.
• New features implemented quicklyUse the Hot Features table to instantly learn how to configure Beta features (such as Auto Mode and Computer Use) and be among the first to experience new capabilities.
• Code quality controlIt employs a built-in Code Review workflow or TDD-first approach, combined with Subagents, to achieve multi-agent PR review and vulnerability detection.
• Large-scale project managementEnables parallel development and context isolation in Monorepo or multi-module projects through the CLAUDE.md rule file and Agent Teams functionality.