claude-code-best-practice README

The project's README from github.com/shanraisshan/claude-code-best-practice. As one markdown file: README.md.

claude-code-best-practice

from vibe coding to agentic engineering - practice makes claude perfect

updated with Claude Code GitHub Stars

Best Practice Implemented Orchestration Workflow Claude Boris Community Click on these badges below to see the actual sources
= Agents · = Commands · = Skills

Claude Code mascot jumping
GitHub Trending #1 Repository Of The Day

Supported by:  Disrupt.com — Ventures Reimagined  ClaudeKit — Production-ready skills and workflows

Boris Cherny on Claude Code
Boris Cherny on X (tweet 1 · tweet 2 · tweet 3)

[!TIP] Visit the How to Use section to take full advantage of this repo.

🧠 CONCEPTS

Feature Location Description
Subagents .claude/agents/<name>.md Best Practice Implemented
Commands .claude/commands/<name>.md Best Practice Implemented
Skills .claude/skills/<name>/SKILL.md Best Practice Implemented Official Skills · Skills for Mono-repos
Workflows .claude/commands/weather-orchestrator.md Orchestration Workflow
Hooks .claude/hooks/ Best Practice Implemented Guide
MCP Servers .claude/settings.json, .mcp.json Best Practice Implemented
Plugins distributable packages Marketplaces · Create Marketplaces
Settings .claude/settings.json Best Practice Implemented Permissions · Model Config · Output Styles · Sandboxing · Keybindings · Auto Mode Config
Status Line .claude/settings.json Best Practice Implemented
Memory CLAUDE.md, .claude/rules/, ~/.claude/rules/, ~/.claude/projects/<project>/memory/ Best Practice Implemented Auto Memory · Auto Memory Deep-dive · Rules
Checkpointing automatic (file-edit tracking)
Sessions --resume, --continue, /resume, /branch
Context Window /compact, /clear, /context
CLI Startup Flags claude [flags] Best Practice Interactive Mode · Env Vars
AI Terms Best Practice
Best Practices Prompt Engineering · Extend Claude Code
Prompt Library

🔥 Hot

Feature Location Description
Ultrareview beta /code-review ultra, claude ultrareview [target] Tasks tracking
Devcontainers .devcontainer/
Channels beta --channels, plugin-based Reference
No Flicker Mode beta /tui fullscreen, CLAUDE_CODE_NO_FLICKER=1 Best Practice
Auto Mode --permission-mode auto, Shift+Tab Best Practice Blog
Power-ups /powerup Best Practice
Fast Mode beta /fast, "fastMode": true
Advisor beta /advisor, advisorModel, --advisor Blog
Computer Use beta computer-use MCP server Desktop
Agent SDK npm / pip package Quickstart · Examples
Ralph Wiggum Loop plugin Best Practice Implemented
Chrome --chrome, extension Best Practice
Claude Code Web beta claude.ai/code Routines
Artifacts /share, Artifact tool
Slack @Claude in Slack
Code Review beta GitHub App (managed) Best Practice Blog Local /code-review
GitHub Actions .github/workflows/ GitLab CI/CD
Remote Control /remote-control, /rc Best Practice Headless Mode
Deep Links claude-cli://open?repo=…&q=…
Dynamic Workflows /workflows, ultracode keyword, /effort ultracode, .claude/workflows/ Deep Research
Agent Teams beta built-in (env var) Best Practice Implemented
Agent View beta claude agents, --bg, /bg
Cross-Session Messaging SendMessage, ListAgents, /list-agents
Scheduled Tasks /loop, /schedule, cron tools Best Practice Implemented Desktop scheduled tasks · Announcement
Routines beta claude.ai/code/routines, /schedule Desktop Tasks
Tasks /tasks, ~/.claude/tasks/ Best Practice Ultrareview tracking
Goal /goal <condition>, /goal clear Implemented
Voice Dictation /voice Best Practice
Bundled Skills /code-review, /batch Best Practice
Git Worktrees --worktree/-w, .worktreeinclude, EnterWorktree/ExitWorktree, isolation: "worktree", WorktreeCreate/WorktreeRemove hooks Best Practice

section divider

Orchestration Workflow

See orchestration-workflow for implementation details of Command → Agent → Skill pattern.

Command Skill Agent Architecture Flow

Orchestration Workflow Demo

How to Use

claude
/weather-orchestrator

section divider

⚙️ DEVELOPMENT WORKFLOWS

All major workflows converge on the same architectural pattern: Research → Plan → Execute → Review → Ship

Name ★ Workflow
Superpowers 284k brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → test-driven-development → executing-plans → verification-before-completion → requesting-code-review → receiving-code-review → finishing-a-development-branch 0 0 14
Matt Pocock Skills 258k grill-with-docs → to-spec → to-tickets → implement → tdd → code-review → improve-codebase-architecture 0 0 37
Everything Claude Code 255k ecc:plan → tdd-workflow → implement → code-review → build-fix → security-scan → e2e-testing → test-coverage → save-session 68 94 286
Spec Kit 134k /speckit.constitution → /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement → /speckit.converge 0 10 0
gstack 132k /office-hours → /plan-ceo-review → /plan-eng-review → /plan-design-review → /design-shotgun → /design-html → /review → /qa → /ship → /retro 0 0 58
agent-skills 89k /spec → /plan → /build → /test → <img src="https://img.shields.io/badge/%2Freview-ddf4ff"

claude-code-best-practice (shanraisshan/claude-code-best-practice)

Searching Database…

这是什么?这是一个精选的参考资料和知识库,记录 Claude Code 的功能与最佳实践,涵盖代理、命令、技能、工作流、钩子、MCP 服务器等内容,并以相互链接的表格形式组织,而不是一篇单独的教程。
这是要安装的工具,还是只是一份参考指南?这是一个参考仓库,并不是可以安装的软件:其中有一张大表,列出 Claude Code 的各种概念(子代理、命令、技能、钩子、MCP 服务器、插件),并附有文档、博客以及相关技能市场的链接。
我到底该怎么用这个仓库?打开 README,依次查看 CONCEPTS 和 DEVELOPMENT WORKFLOWS 两张表。每一行都链接到对应的 Claude Code 功能或外部文档。然后把 .claude/agents/*.md、.claude/commands/*.md 或 .claude/skills/*/SKILL.md 这类写法复制到你自己的项目中。
要用上这个仓库,我需要先安装 Claude Code 本身吗?需要。这里记录的所有内容(代理、命令、技能、钩子、设置)都是 Anthropic 的 Claude Code 命令行工具(CLI)的功能,所以要应用其中任何一项,都得先安装 Claude Code。
这是 Anthropic 官方的资源吗?不是。它更像是一份独立整理的速查表,而不是 Anthropic 官方文档。因此,标记为「热门」的条目(如 Auto Mode、Agent Teams、Scheduled Tasks)可能较新,并且会随着 Claude Code 的演进而快速变化。
仓库中提到的 Research to Ship 模式是什么?这是作者所说的一种通用架构模式,所有主要的 Claude Code 工作流最终都会汇聚到这种模式上。它把“命令 → 代理 → 技能”这条链路串联起来,该链路在编排工作流部分中有所介绍。
它指向了哪些第三方技能合集?它列出了按星标排名的社区技能和插件合集,例如 Superpowers、Matt Pocock Skills、Everything Claude Code、Spec Kit、gstack 和 agent-skills,并附有各自的代理、命令和技能数量。
顶部提到的 Boris Cherny 是谁?他在 README 顶部通过一个 X 个人主页链接被提及,是与 Claude Code 相关的知名人物。仓库在进入功能表格之前,先以这段说明开场。
列表中什么样的功能才算「热门」?「热门」表格收录了较新或正在流行的 Claude Code 功能,例如 Ultrareview、Auto Mode、Fast Mode、Agent Teams 和 Scheduled Tasks,每一项都附有对应的触发命令或参数。
Size
74.8 MB
Stars
67.7K
Updated
CommitOct 17
Age
11mo
Commits · 90 Days