Recently, a repository named claude-code-best-practice has skyrocketed to 32,000 stars on GitHub.
It systematically organizes various usage tips and workflows for Claude Code, covering everything from beginner to advanced levels.
It has topped the GitHub Trending daily charts and sparked significant discussion across various communities.
Even Boris Cherny, the creator of Claude Code, has cited this project multiple times on X (formerly Twitter).
The project specifically includes 15 usage tips shared by Boris himself.
01. What Exactly Does This Project Do?
claude-code-best-practice is a systematic guide to using Claude Code.
The author is shanraisshan, a name you'll often see if you frequent the technology sections of Reddit.
The slogan of this open-source project is: "Practice makes perfect Claude."
It breaks down all of Claude Code's core capabilities.
Agents, Commands, Skills, Hooks, MCP Server, Subagents—every module comes with ready-to-use templates.
Currently, it includes over 86 practical tips.
This isn't just a translation of official documentation; rather, it represents experience summarized by the author and the community after encountering real-world pitfalls.
Open Source Address: https://github.com/shanraisshan/claude-code-best-practice02. Core Highlights
After reviewing it, I believe the most impressive aspects of this repository are as follows:
① Keeping Pace with the Latest Beta Features
Beyond its systematic knowledge architecture, the project features a "Hot Features" table that tracks the latest dynamic updates to Claude Code in real-time:
- Ultraplan: Cloud-based planning, allowing you to review and adjust execution plans directly in the browser.
- Claude Code Web: Cloud infrastructure for running long-duration tasks.
- Auto Mode: A backend safety classifier that replaces manual permission confirmations.
- Computer Use: macOS screen control capabilities.
- Code Review: Multi-Agent Pull Request reviews.
- And more.
There is also an interesting feature called No-Flicker Mode, activated by setting CLAUDE_CODE_NO_FLICKER=1.
This new full-screen renderer enables clicking within the input box to position the cursor precisely.
It allows users to click on folded tool results to expand or collapse the full output.
Furthermore, clicking on URLs or file paths directly opens the link or file.
② Comparison of 10+ Development Workflows
This repository doesn't just introduce its own content; it also horizontally compares mainstream Claude Code development workflows available on GitHub.
Each workflow is annotated with its Star count, number of components, and a "uniqueness" tag, making it easy to see their respective focuses at a glance:
- Everything Claude Code (137k Stars): Takes an all-encompassing approach with 38 commands, 75 Agents, and 156 Skills. Its highlights include instinct scoring and the AgentShield protection mechanism, making it suitable for teams wanting a complete, out-of-the-box solution.
- Superpowers (135k Stars): Built on the core philosophy of Test-Driven Development (TDD) first. It enforces a set of "Iron Laws" to constrain code quality and includes a "whole-plan review" mechanism, ideal for projects with high code quality requirements.
- Spec Kit (85k Stars): Follows a specification-document-driven approach, writing specs before letting the AI execute. It integrates 22+ tools and is suitable for teams with standardized processes.
- gstack (64k Stars): Features a role-playing mode, assigning different personas to different Agents and supporting parallel sprints. Ideal for scenarios requiring multi-task parallelism.
- Get Shit Done (48k Stars): Uses a fresh 200K context window every time, executing XML plans in batches via "waves." Suitable for developers pursuing speed who don't want to be burdened by historical context.
- BMAD-METHOD (44k Stars): Covers the complete software development lifecycle, supports 22+ platforms, and is suitable for large projects requiring management from PRD to deployment.
In summary: choose Superpowers for quality, Get Shit Done for efficiency, Everything Claude Code for an all-in-one suite, and Spec Kit for process-driven development.
Simply pick the one that matches your development style.
Each workflow is labeled with its Star count and core features to help you quickly select the most suitable one for your needs.
In essence, it serves as a buyer's guide for Claude Code workflows.
③ A Wealth of Curated Tips
It contains numerous highly popular tips, articles, and video tutorials.
If you consume all the content in this project, you will be among the most proficient users of Claude Code.
03. How to Use It
The repository itself is structured as a complete Claude Code project.
Under the .claude/ directory, you will find ready-made configuration files for agents, commands, and skills. You can simply clone it and copy the parts you need into your own project.
There is no need to write configurations from scratch; it's ready to run out of the box.
Step 1: Clone the repository:
git clone https://github.com/shanraisshan/claude-code-best-practice.gitStep 2: Browse it like a course.
It is recommended to start with the project's README to first understand the differences between core concepts like Agents, Commands, and Skills.
The project also includes a tutorial/day0 introductory guide, suitable for beginners.
Step 3: Pick the configurations you need.
Look at the template files under the .claude/ directory and copy the agents, skills, and hooks that suit your project.
Step 4: Choose a development workflow.
Based on the workflow comparison table in the project, select the one that best matches your development habits and configure accordingly.
The core philosophy is: do not accept everything wholesale; take only what you need.
The value of this repository lies not in teaching you a specific function of Claude Code, but in helping you establish a systematic methodology for using Claude Code.
From concept understanding to configuration templates, from workflow selection to tracking the latest features, it basically covers every issue you might encounter while using Claude Code.
If you are currently using Claude Code, or planning to start, this repository is worth saving.
Especially for those who feel Claude Code isn't delivering results, the problem might not be the tool, but rather the way you are opening it.