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…

What is this?A curated reference and knowledge base documenting Claude Code's features and best practices, covering agents, commands, skills, workflows, hooks, MCP servers, and more, organized as linked tables rather than a single tutorial.
Is this a tool I install, or just a reference guide?It is a reference repository, not installable software: a big table of Claude Code concepts (Subagents, Commands, Skills, Hooks, MCP Servers, Plugins) with links to docs, blogs and related skill marketplaces.
How do I actually use this repo?Open the README and work through the CONCEPTS and DEVELOPMENT WORKFLOWS tables; each row links to the relevant Claude Code feature or external doc, and you copy patterns like .claude/agents/*.md, .claude/commands/*.md, or .claude/skills/*/SKILL.md into your own project.
Do I need Claude Code itself to make use of this?Yes, everything documented here (agents, commands, skills, hooks, settings) is a feature of Anthropic's Claude Code CLI, so you need Claude Code installed to apply any of it.
Is this an official Anthropic resource?No, it reads as an independently curated cheat sheet rather than official Anthropic documentation, so 'Hot' entries like Auto Mode, Agent Teams, or Scheduled Tasks may be newer or change quickly as Claude Code evolves.
What is the Research to Ship pattern mentioned in the repo?It is the common architectural pattern the author says all major Claude Code workflows converge on, tying together the Command to Agent to Skill chain described in the orchestration-workflow section.
Which third-party skill collections does it point to?It lists star-ranked community skill and plugin collections such as Superpowers, Matt Pocock Skills, Everything Claude Code, Spec Kit, gstack, and agent-skills, along with counts of their agents, commands, and skills.
Who is Boris Cherny, mentioned at the top?He is referenced via a linked X profile near the top of the README as a notable figure tied to Claude Code, with the repo opening on that callout before diving into the feature tables.
What counts as a 'Hot' feature in the list?The Hot table highlights newer or trending Claude Code capabilities like Ultrareview, Auto Mode, Fast Mode, Agent Teams, and Scheduled Tasks, each paired with its trigger command or flag.
Size
74.8 MB
Stars
67.7K
Updated
CommitOct 17
Age
11mo
Commits · 90 Days