Repository: shanraisshan/claude-code-best-practice

Stars: 45895

CLAUDE.md Copy Chapter

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview Copy Chapter

This is a best practices repository for Claude Code configuration, demonstrating patterns for skills, subagents, hooks, and commands. It serves as a reference implementation rather than an application codebase.

Key Components Copy Chapter

Weather System (Example Workflow) Copy Section

Two skill patterns: agent skills (preloaded via skills: field) vs skills (invoked via Skill tool). See orchestration-workflow/orchestration-workflow.md for the complete flow diagram.

Skill Definition Structure Copy Section

Presentation System Copy Section

Hooks System Copy Section

Hook events configured in .claude/settings.json: PreToolUse, PostToolUse, UserPromptSubmit, Notification, Stop, SubagentStart, SubagentStop, PreCompact, SessionStart, SessionEnd, Setup, PermissionRequest, TeammateIdle, TaskCompleted, ConfigChange.

Special handling: git commits trigger pretooluse-git-committing sound.

Critical Patterns Copy Chapter

Subagent Orchestration Copy Section

Agent(subagent_type="agent-name", description="...", prompt="...", model="haiku")

Be explicit about tool usage in subagent definitions. Avoid vague terms like "launch" that could be misinterpreted as bash commands.

Subagent Definition Structure Copy Section

Configuration Hierarchy Copy Section

Disable Hooks Copy Section

Answering Best Practice Questions Copy Chapter

When the user asks a Claude Code best practice question, always search this repo first (best-practice/, reports/, tips/, implementation/, and README.md) before relying on training knowledge or external sources. This repo is the authoritative source — only fall back to external docs or web search if the answer is not found here.

Workflow Best Practices Copy Chapter

From experience with this repository:

- Keep CLAUDE.md under 200 lines per file for reliable adherence
- Use commands for workflows instead of standalone agents
- Create feature-specific subagents with skills (progressive disclosure) rather than general-purpose agents
- Perform manual /compact at ~50% context usage
- Start with plan mode for complex tasks
- Use human-gated task list workflow for multi-step tasks
- Break subtasks small enough to complete in under 50% context

Debugging Tips Copy Section

- Use /doctor for diagnostics
- Run long-running terminal commands as background tasks for better log visibility
- Use browser automation MCPs (Claude in Chrome, Playwright, Chrome DevTools) for Claude to inspect console logs
- Provide screenshots when reporting visual issues

Git Commit Rules Copy Chapter

When committing changes, create separate commits per file. Do NOT bundle multiple file changes into a single commit. Each file gets its own commit with a descriptive message specific to that file's changes.

For example, if README.md, best-practice/claude-subagents.md, and a skill file all changed:
- Commit 1: git add README.md → commit with README-specific message
- Commit 2: git add best-practice/claude-subagents.md → commit with subagents-doc-specific message
- Commit 3: git add .claude/skills/weather-fetcher/SKILL.md → commit with skill-specific message

This makes the git history cleaner and easier to review, revert, or cherry-pick individual changes.

Documentation Copy Chapter

See .claude/rules/markdown-docs.md for documentation standards. Key docs:
- best-practice/claude-subagents.md: Subagent frontmatter, hooks, and repository agents
- best-practice/claude-commands.md: Slash command patterns and built-in command reference
- orchestration-workflow/orchestration-workflow.md: Weather system flow diagram

README.md Copy Chapter

claude-code-best-practice

!updated with Claude Code-white?style=flat&labelColor=555) <a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars"></a> !🇵🇰 4th Most ★<br>

      !Click on these badges below to see the actual sources<br>
<img src="!/tags/a.svg" height="14"> = Agents · <img src="!/tags/c.svg" height="14"> = Commands · <img src="!/tags/s.svg" height="14"> = Skills

<p align="center">
<img src="!/claude-jumping.svg" alt="Claude Code mascot jumping" width="120" height="100"><br>
<a href="https://github.com/trending"><img src="!/root/github-trending-day.svg" alt="GitHub Trending #1 Repository Of The Day"></a>
</p>

<p align="center">
<img src="!/root/boris-slider.gif" alt="Boris Cherny on Claude Code" width="600"><br>
Boris Cherny on X (<a href="https://x.com/bcherny/status/2007179832300581177">tweet 1</a> · <a href="https://x.com/bcherny/status/2017742741636321619">tweet 2</a> · <a href="https://x.com/bcherny/status/2021699851499798911">tweet 3</a>)
</p>

🧠 CONCEPTS Copy Chapter

| Feature | Location | Description |
|---------|----------|-------------|
| <img src="!/tags/a.svg" height="14"> Subagents | .claude/agents/<name>.md |   Autonomous actor in fresh isolated context — custom tools, permissions, model, memory, and persistent identity |
| <img src="!/tags/c.svg" height="14"> Commands | .claude/commands/<name>.md |   Knowledge injected into existing context — simple user-invoked prompt templates for workflow orchestration |
| <img src="!/tags/s.svg" height="14"> Skills | .claude/skills/<name>/SKILL.md |   Knowledge injected into existing context — configurable, preloadable, auto-discoverable, with context forking and progressive disclosure · Official Skills |
| Workflows | .claude/commands/weather-orchestrator.md |  |
| Hooks | .claude/hooks/ |   User-defined handlers (scripts, HTTP, prompts, agents) that run outside the agentic loop on specific events · Guide |
| MCP Servers | .claude/settings.json, .mcp.json |   Model Context Protocol connections to external tools, databases, and APIs |
| Plugins | distributable packages | Bundles of skills, subagents, hooks, MCP servers, and LSP servers · Marketplaces · Create Marketplaces |
| Settings | .claude/settings.json |   Hierarchical configuration system · Permissions · Model Config · Output Styles · Sandboxing · Keybindings · Fast Mode |
| Status Line | .claude/settings.json |   Customizable status bar showing context usage, model, cost, and session info |
| Memory | CLAUDE.md, .claude/rules/, ~/.claude/rules/, ~/.claude/projects/<project>/memory/ |   Persistent context via CLAUDE.md files and @path imports · Auto Memory · Rules |
| Checkpointing | automatic (git-based) | Automatic tracking of file edits with rewind (Esc Esc or /rewind) and targeted summarization |
| CLI Startup Flags | claude [flags] |  Command-line flags, subcommands, and environment variables for launching Claude Code · Interactive Mode · Env Vars |
| AI Terms | |  Agentic Engineering · Context Engineering · Vibe Coding |
| Best Practices | | Official best practices · Prompt Engineering · Extend Claude Code |

🔥 Hot Copy Section

| Feature | Location | Description |
|---------|----------|-------------|
| Routines !beta | claude.ai/code/routines, /schedule | Cloud automation on Anthropic infrastructure — scheduled, API-triggered, or GitHub event-driven tasks that run even when your machine is off · Desktop Tasks |
| Devcontainers | .devcontainer/ | Preconfigured development containers with security isolation and firewall rules for consistent Claude Code environments |
| Channels !beta | --channels, plugin-based | Push events from Telegram, Discord, or webhooks into a running session — Claude reacts while you're away · Reference |
| Ultraplan !beta | /ultraplan | Draft plans in the cloud with browser-based review, inline comments, and flexible execution — remotely or teleported back to terminal |
| No Flicker Mode !beta | CLAUDE_CODE_NO_FLICKER=1 |  Flicker-free alt-screen rendering with mouse support, stable memory, and in-app scrolling — opt-in research preview |
| Auto Mode !beta | claude --enable-auto-mode |  Background safety classifier replaces manual permission prompts — Claude decides what's safe while blocking prompt injection and risky escalations · Start with claude --enable-auto-mode (or --permission-mode auto), or cycle to it with Shift+Tab during a session · Blog |
| Power-ups | /powerup |  Interactive lessons teaching Claude Code features with animated demos (v2.1.90) |
| Computer Use !beta | computer-use MCP server | Let Claude control your screen — open apps, click, type, and screenshot your display on macOS · Desktop |
| Agent SDK | npm / pip package | Build production AI agents with Claude Code as a library — Python and TypeScript SDKs with built-in tools, hooks, subagents, and MCP · Quickstart · Examples |
| Ralph Wiggum Loop | plugin |   Autonomous development loop for long-running tasks — iterates until completion |
| Chrome !beta | --chrome, extension |  Browser automation via Claude in Chrome — test web apps, debug with console, automate forms, extract data from pages |
| Claude Code Web !beta | claude.ai/code | Run tasks on cloud infrastructure — long-running tasks, PR auto-fix, parallel sessions with no local setup · Routines |
| Slack | @Claude in Slack | Mention @Claude in team chat with a coding task — routes to Claude Code web sessions for bug fixes, code reviews, and parallel task execution |
| Code Review !beta | GitHub App (managed) |  Multi-agent PR analysis that catches bugs, security vulnerabilities, and regressions · Blog |
| GitHub Actions | .github/workflows/ | Automate PR reviews, issue triage, and code generation in CI/CD pipelines · GitLab CI/CD |
| Remote Control | /remote-control, /rc |  Continue local sessions from any device — phone, tablet, or browser · Headless Mode |
| Agent Teams !beta | built-in (env var) |   Multiple agents working in parallel on the same codebase with shared task coordination |
| Scheduled Tasks | /loop, /schedule, cron tools |   /loop runs prompts locally on a recurring schedule (up to 7 days) · /schedule runs prompts in the cloud on Anthropic infrastructure — works even when your machine is off · Announcement |
| Voice Dictation !beta | /voice |  Push-to-talk speech input for prompts with 20-language support and rebindable activation key |
| Simplify & Batch | /simplify, /batch |  Built-in skills for code quality and bulk operations — simplify refactors for reuse and efficiency, batch runs commands across files |
| Git Worktrees | built-in |  Isolated git branches for parallel development — each agent gets its own working copy |

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

<a id="orchestration-workflow"></a>

<a href="orchestration-workflow/orchestration-workflow.md"><img src="!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a> Copy Chapter

See orchestration-workflow for implementation details of <img src="!/tags/c.svg" height="14"> Command → <img src="!/tags/a.svg" height="14"> Agent → <img src="!/tags/s.svg" height="14"> Skill pattern.

<p align="center">
<img src="orchestration-workflow/orchestration-workflow.svg" alt="Command Skill Agent Architecture Flow" width="100%">
</p>

<p align="center">
<img src="orchestration-workflow/orchestration-workflow.gif" alt="Orchestration Workflow Demo" width="600">
</p>

!How to Use

claude
/weather-orchestrator

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

⚙️ DEVELOPMENT WORKFLOWS Copy Chapter

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

| Name | ★ | Uniqueness | Plan | <img src="!/tags/a.svg" height="14"> | <img src="!/tags/c.svg" height="14"> | <img src="!/tags/s.svg" height="14"> |
|------|---|------------|------|---|---|---|
| Everything Claude Code | 158k | !instinct scoring !AgentShield !multi-lang rules | <img src="!/tags/a.svg" height="14"> planner | 48 | 143 | 230 |
| Superpowers | 156k | !TDD-first !Iron Laws !whole-plan review | <img src="!/tags/s.svg" height="14"> writing-plans | 5 | 3 | 14 |
| Spec Kit | 89k | !spec-driven !constitution !22+ tools | <img src="!/tags/c.svg" height="14"> speckit.plan | 0 | 9+ | 0 |
| gstack | 74k | !role personas !/codex review !parallel sprints | <img src="!/tags/s.svg" height="14"> autoplan | 0 | 0 | 46 |
| Get Shit Done | 54k | !fresh 200K contexts !wave execution !XML plans | <img src="!/tags/a.svg" height="14"> gsd-planner | 31 | 122 | 0 |
| BMAD-METHOD | 45k | !full SDLC !agent personas !22+ platforms | <img src="!/tags/s.svg" height="14"> bmad-create-prd | 0 | 0 | 39 |
| OpenSpec | 41k | !delta specs !brownfield !artifact DAG | <img src="!/tags/c.svg" height="14"> opsx:propose | 0 | 10 | 0 |
| oh-my-claudecode | 29k | !teams orchestration !tmux workers !skill auto-inject | <img src="!/tags/s.svg" height="14"> ralplan | 19 | 0 | 37 |
| Compound Engineering | 14k | !Compound Learning !Multi-Platform CLI !Plugin Marketplace | <img src="!/tags/s.svg" height="14"> ce-plan | 49 | 3 | 51 |
| HumanLayer | 10k | !RPI !context engineering !300k+ LOC | <img src="!/tags/c.svg" height="14"> create_plan | 6 | 27 | 0 |

Others Copy Section

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

💡 TIPS AND TRICKS (82) Copy Chapter

🚫👶 = do not babysit

Prompting · Planning · Context · Session · CLAUDE.md · Agents · Commands · Skills · Hooks · Workflows · Advanced · Git / PR · Debugging · Utilities · Daily

!Community

<a id="tips-prompting"></a>■ Prompting (3)

| Tip | Source |
|-----|--------|
| challenge Claude — "grill me on these changes and don't make a PR until I pass your test." or "prove to me this works" and have Claude diff between main and your branch 🚫👶 |  |
| after a mediocre fix — "knowing everything you know now, scrap this and implement the elegant solution" 🚫👶 |  |
| Claude fixes most bugs by itself — paste the bug, say "fix", don't micromanage how 🚫👶 |  |

<a id="tips-planning"></a>■ Planning/Specs (6)

| Tip | Source |
|-----|--------|
| always start with plan mode |  |
| start with a minimal spec or prompt and ask Claude to interview you using AskUserQuestion tool, then make a new session to execute the spec |  |
| always make a phase-wise gated plan, with each phase having multiple tests (unit, automation, integration) | |
| spin up a second Claude to review your plan as a staff engineer, or use cross-model for review |  |
| write detailed specs and reduce ambiguity before handing work off — the more specific you are, the better the output |  |
| prototype > PRD — build 20-30 versions instead of writing specs, the cost of building is low so take many shots |   |

<a id="tips-context"></a>■ Context (5)

| Tip | Source |
|-----|--------|
| context rot kicks in around ~300-400k tokens on the 1M context model — don't let sessions drift past that for intelligence-sensitive work |  |
| avoid agent dumb zone, do manual /compact at max 50%. Use /clear to reset context mid-session if switching to a new task | |
| rewind > correct — double-Esc or /rewind back to before the failed attempt and re-prompt with what you learned, instead of leaving failed attempts + corrections polluting context 🚫👶 |  |
| /compact with a hint (/compact focus on the auth refactor, drop the test debugging) beats letting autocompact fire — the model is at its least intelligent point when auto-compacting due to context rot |  |
| use subagents for context management — ask yourself "will I need this tool output again, or just the conclusion?" — 20 file reads + 12 greps + 3 dead ends stay in the child's context, only the final report returns 🚫👶 |  |

<a id="tips-session"></a>■ Session Management (6)

| Tip | Source |
|-----|--------|
| every turn is a branching point — after Claude ends a turn, pick between Continue, /rewind, /clear, /compact, or Subagent based on how much existing context you need to carry forward |  |
| new task = new session — related tasks (e.g. writing docs for what you just built) can reuse context for efficiency, but genuinely new tasks deserve a fresh session |  |
| use "summarize from here" before rewinding to have Claude write a handoff message — like a note to the previous iteration of Claude from its future self |  |
| /compact vs /clear — compact is lossy but momentum-friendly (mid-task, fuzzy details ok); /clear + brief is more work but you control exactly what carries forward (high-stakes next step) |  |
| use recaps for long-running sessions — short summaries of what Claude did and what's next, useful when returning after minutes or hours. Disable with recaps in /config |  |
| /rename important sessions (e.g. [TODO - refactor task]) and /resume them later — label each instance when running multiple Claudes simultaneously |  |

<a id="tips-claudemd"></a>■ CLAUDE.md (7)

| Tip | Source |
|-----|--------|
| CLAUDE.md should target under 200 lines per file. 60 lines in humanlayer (still not 100% guaranteed) |   |
| wrap domain-specific CLAUDE.md rules in \<important if="..."\> tags to stop Claude from ignoring them as files grow longer |  |
| use multiple CLAUDE.md for monorepos — ancestor + descendant loading | |
| use .claude/rules/ to split large instructions | |
| memory.md, constitution.md does not guarantee anything | |
| any developer should be able to launch Claude, say "run the tests" and it works on the first try — if it doesn't, your CLAUDE.md is missing essential setup/build/test commands |  |
| keep codebases clean and finish migrations — partially migrated frameworks confuse models that might pick the wrong pattern |   |
| use settings.json for harness-enforced behavior (attribution, permissions, model) — don't put "NEVER add Co-Authored-By" in CLAUDE.md when attribution.commit: "" is deterministic |  |

<a id="tips-agents"></a><img src="!/tags/a.svg" height="14"> Agents (4)

| Tip | Source |
|-----|--------|
| have feature specific sub-agents (extra context) with skills (progressive disclosure) instead of general qa, backend engineer |  |
| say "use subagents" to throw more compute at a problem — offload tasks to keep your main context clean and focused 🚫👶 |  |
| agent teams with tmux and git worktrees for parallel development | |
| use test time compute — separate context windows make results better; one agent can cause bugs and another (same model) can find them |  |

<a id="tips-commands"></a><img src="!/tags/c.svg" height="14"> Commands (3)

| Tip | Source |
|-----|--------|
| use commands for your workflows instead of sub-agents |  |
| use slash commands for every "inner loop" workflow you do many times a day — saves repeated prompting, commands live in .claude/commands/ and are checked into git |  |
| if you do something more than once a day, turn it into a skill or command — build /techdebt, context-dump, or analytics commands |  |

<a id="tips-skills"></a><img src="!/tags/s.svg" height="14"> Skills (9)

| Tip | Source |
|-----|--------|
| use context: fork to run a skill in an isolated subagent — main context only sees the final result, not intermediate tool calls. The agent field lets you set the subagent type |  |
| use skills in subfolders for monorepos | |
| skills are folders, not files — use references/, scripts/, examples/ subdirectories for progressive disclosure |  |
| build a Gotchas section in every skill — highest-signal content, add Claude's failure points over time |  |
| skill description field is a trigger, not a summary — write it for the model ("when should I fire?") |  |
| don't state the obvious in skills — focus on what pushes Claude out of its default behavior 🚫👶 |  |
| don't railroad Claude in skills — give goals and constraints, not prescriptive step-by-step instructions 🚫👶 |  |
| include scripts and libraries in skills so Claude composes rather than reconstructs boilerplate |  |
| embed !command in SKILL.md to inject dynamic shell output into the prompt — Claude runs it on invocation and the model only sees the result |  |

<a id="tips-hooks"></a>■ Hooks (5)

| Tip | Source |
|-----|--------|
| use on-demand hooks in skills — /careful blocks destructive commands, /freeze blocks edits outside a directory |  |
| measure skill usage with a PreToolUse hook to find popular or undertriggering skills |  |
| use a PostToolUse hook to auto-format code — Claude generates well-formatted code, the hook handles the last 10% to avoid CI failures |  |
| route permission requests to Opus via a hook — let it scan for attacks and auto-approve safe ones 🚫👶 |  |
| use a Stop hook to nudge Claude to keep going or verify its work at the end of a turn |  |

<a id="tips-workflows"></a>■ Workflows (6)

| Tip | Source |
|-----|--------|
| vanilla cc is better than any workflows with smaller tasks | |
| use /model to select model and reasoning, /context to see context usage, /usage to check plan limits, /extra-usage to configure overflow billing, /config to configure settings — use Opus for plan mode and Sonnet for code to get the best of both |  |
| always use thinking mode true (to see reasoning) and Output Style Explanatory (to see detailed output with ★ Insight boxes) in /config for better understanding of Claude's decisions |  |
| use ultrathink keyword in prompts for high effort reasoning | |
| /focus mode hides all intermediate work and shows only the final result — trust the model to run the right commands and just look at the outcome (toggle with /focus) |  |
| tune effort level with Opus 4.7's adaptive thinking — low for speed and fewer tokens, max for most intelligence (slider: low · medium · high · xhigh · max) |  |

<a id="tips-workflows-advanced"></a>■ Workflows Advanced (9)

| Tip | Source |
|-----|--------|
| use ASCII diagrams a lot to understand your architecture |  |
| use /loop for local recurring monitoring (up to 7 days) · use /schedule for cloud-based recurring tasks that run even when your machine is off | |
| use Ralph Wiggum plugin for long-running autonomous tasks |  |
| /permissions with wildcard syntax (Bash(npm run ), Edit(/docs/*)) instead of dangerously-skip-permissions |  |
| /sandbox to reduce permission prompts with file and network isolation — 84% reduction internally |   |
| invest in product verification skills (signup-flow-driver, checkout-verifier) — worth spending a week to perfect |  |
| use auto mode instead of dangerously-skip-permissions — a model-based classifier decides if each command is safe and auto-approves, pauses and asks if risky. Shift+Tab to cycle Ask → Plan → Auto modes 🚫👶 |  |
| use /fewer-permission-prompts skill to scan session history for safe bash/MCP commands that repeatedly prompt, then get a recommended allowlist to paste into settings |  |
| build a /go skill that (1) tests end-to-end via bash/browser/computer use (2) runs /simplify (3) puts up a PR — so when you come back, you know the code works 🚫👶 |  |

<a id="tips-git-pr"></a>■ Git / PR (5)

| Tip | Source |
|-----|--------|
| keep PRs small and focused — p50 of 118 lines (141 PRs, 45K lines changed in a day), one feature per PR, easier to review and revert |  |
| always squash merge PRs — clean linear history, one commit per feature, easy git revert and git bisect |  |
| commit often — try to commit at least once per hour, as soon as task is completed, commit | !Shayan |
| tag @claude on a coworker's PR to auto-generate lint rules for recurring review feedback — automate yourself out of code review 🚫👶 |   |
| use /code-review for multi-agent PR analysis — catches bugs, security vulnerabilities, and regressions before merge |  |

<a id="tips-debugging"></a>■ Debugging (7)

| Tip | Source |
|-----|--------|
| make it a habit to take screenshots and share with Claude whenever you are stuck with any issue | !Shayan |
| use mcp (Claude in Chrome, Playwright, Chrome DevTools) to let claude see chrome console logs on its own | |
| always ask claude to run the terminal (you want to see logs of) as a background task for better debugging | |
| /doctor to diagnose installation, authentication, and configuration issues | |
| error during compaction can be resolved by using /model to select a 1M token model, then running /compact | |
| use a cross-model for QA — e.g. Codex for plan and implementation review | |
| agentic search (glob + grep) beats RAG — Claude Code tried and discarded vector databases because code drifts out of sync and permissions are complex |   |

<a id="tips-utilities"></a>■ Utilities (5)

| Tip | Source |
|-----|--------|
| iTerm/Ghostty/tmux terminals instead of IDE (VS Code/Cursor) |  |
| /voice or Wispr Flow for voice prompting (10x productivity) |  |
| claude-code-hooks for claude feedback | !Shayan |
| status line for context awareness and fast compacting |  !Shayan |
| explore settings.json features like Plans Directory, Spinner Verbs for a personalized experience |  |

<a id="tips-daily"></a>■ Daily (2)

| Tip | Source |
|-----|--------|
| update Claude Code daily | !Shayan |
| start your day by reading the changelog | !Shayan |

!Boris Cherny + Team

| Article / Tweet | Source |
|-----------------|--------|
| 6 Tips for Getting More Out of Opus 4.7 (Boris) \| 16/Apr/26 | Tweet |
| Session Management & 1M Context (Thariq) \| 16/Apr/26 | Tweet |
| 15 Hidden & Under-Utilized Features in Claude Code (Boris) \| 30/Mar/26 | Tweet |
| Squash Merging & PR Size Distribution (Boris) \| 25/Mar/26 | Tweet |
| Lessons from Building Claude Code: How We Use Skills (Thariq) \| 17/Mar/26 | Article |
| Code Review & Test Time Compute (Boris) \| 10/Mar/26 | Tweet |
| /loop — schedule recurring tasks for up to 3 days (Boris) \| 07 Mar 2026 | Tweet |
| AskUserQuestion + ASCII Markdowns (Thariq) \| 28 Feb 2026 | Tweet |
| Seeing like an Agent - lessons from building Claude Code (Thariq) \| 28 Feb 2026 | Article |
| Git Worktrees - 5 ways how boris is using \| 21 Feb 2026 | Tweet |
| Lessons from Building Claude Code: Prompt Caching Is Everything (Thariq) \| 20 Feb 2026 | Article |
| 12 ways how people are customizing their claudes (Boris) \| 12/Feb/26 | Tweet |
| 10 tips for using Claude Code from the team (Boris) \| 01/Feb/26 | Tweet |
| How I use Claude Code — 13 tips from my surprisingly vanilla setup (Boris) \| 03/Jan/26 | Tweet |
| Ask Claude to interview you using AskUserQuestion tool (Thariq) \| 28/Dec/25 | Tweet |
| Always use plan mode, give Claude a way to verify, use /code-review (Boris) \| 27/Dec/25 | Tweet |

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

🎬 VIDEOS / PODCASTS Copy Chapter

| Video / Podcast | Source | YouTube |
|-----------------|--------|---------|
| Everything We Got Wrong About Research-Plan-Implement (Dex) \| 24 Mar 2026 \| MLOps Community |  | YouTube |
| Building Claude Code with Boris Cherny (Boris) \| 04 Mar 2026 \| The Pragmatic Engineer |  | YouTube |
| Head of Claude Code: What happens after coding is solved (Boris) \| 19 Feb 2026 \| Lenny's Podcast |  | YouTube |
| Inside Claude Code With Its Creator Boris Cherny (Boris) \| 17 Feb 2026 \| Y Combinator |  | YouTube |
| Boris Cherny (Creator of Claude Code) On What Grew His Career (Boris) \| 15 Dec 2025 \| Ryan Peterman |  | YouTube |
| The Secrets of Claude Code From the Engineers Who Built It (Cat) \| 29 Oct 2025 \| Every |  | YouTube |

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

🔔 SUBSCRIBE Copy Chapter

| Source | Name | Badge |
|--------|------|-------|
| !Reddit | r/ClaudeAI, r/ClaudeCode, r/Anthropic | !Boris + Team |
| !X | Claude, Claude Devs, Anthropic, Boris, Thariq, Cat, Lydia, Noah, Anthony, Alex, Kenneth | !Boris + Team |
| !X | Jesse Kriss (Superpowers), Affaan Mustafa (ECC), Garry Tan (gstack), Dex Horthy (HumanLayer), Kieran Klaassen (Compound Eng), Tabish Gilani (OpenSpec), Brian McAdams (BMAD), Lex Christopherson (GSD), Dani Avila (CC Templates), Dan Shipper (Every), Andrej Karpathy (AutoResearch), Peter Steinberger (OpenClaw), Sigrid Jin (claw-code), Yeachan Heo (oh-my-claudecode) | !Community |
| !YouTube | Anthropic | !Boris + Team |
| !YouTube | Lenny's Podcast, Y Combinator, The Pragmatic Engineer, Ryan Peterman, Every, MLOps Community | !Community |

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

☠️ STARTUPS / BUSINESSES Copy Chapter

| Claude | Replaced |
|-|-|
|Code Review|Greptile, CodeRabbit, Devin Review, OpenDiff, Cursor BugBot|
|Voice Dictation|Wispr Flow, SuperWhisper|
|Remote Control|OpenClaw
|Claude in Chrome|Playwright MCP, Chrome DevTools MCP|
|Computer Use|OpenAI CUA|
|Cowork|ChatGPT Agent, Perplexity Computer, Manus|
|Tasks|Beads
|Plan Mode|Agent OS|
|Skills / Plugins|YC AI wrapper startups (reddit)|

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

<a id="billion-dollar-questions"></a>
!Billion-Dollar Questions

If you have answers, do let me know at [email protected]

Memory & Instructions (4)

1. What exactly should you put inside your CLAUDE.md — and what should you leave out?
2. If you already have a CLAUDE.md, is a separate constitution.md or rules.md actually needed?
3. How often should you update your CLAUDE.md, and how do you know when it's become stale?
4. Why does Claude still ignore CLAUDE.md instructions — even when they say MUST in all caps? (reddit)

Agents, Skills & Workflows (6)

1. When should you use a command vs an agent vs a skill — and when is vanilla Claude Code just better?
2. How often should you update your agents, commands, and workflows as models improve?
3. Does giving your subagent a detailed persona improve quality? What does a "perfect persona/prompt" for research/QA subagent look like?
4. Should you rely on Claude Code's built-in plan mode — or build your own planning command/agent that enforces your team's workflow?
5. If you have a personal skill (e.g., /implement with your coding style), how do you incorporate community skills (e.g., /simplify) without conflicts — and who wins when they disagree?
6. Are we there yet? Can we convert an existing codebase into specs, delete the code, and have AI regenerate the exact same code from those specs alone?

Specs & Documentation (3)

1. Should every feature in your repo have a spec as a markdown file?
2. How often do you need to update specs so they don't become obsolete when a new feature is implemented?
3. When implementing a new feature, how do you handle the ripple effect on specs for other features?

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

REPORTS Copy Chapter

<p align="center">
<a href="reports/claude-agent-sdk-vs-cli-system-prompts.md"><img src="https://img.shields.io/badge/Agent_SDK_vs_CLI-555?style=for-the-badge" alt="Agent SDK vs CLI"></a>
<a href="reports/claude-in-chrome-v-chrome-devtools-mcp.md"><img src="https://img.shields.io/badge/Browser_Automation_MCP-555?style=for-the-badge" alt="Browser Automation MCP"></a>
<a href="reports/claude-global-vs-project-settings.md"><img src="https://img.shields.io/badge/Global_vs_Project_Settings-555?style=for-the-badge" alt="Global vs Project Settings"></a>
<a href="reports/claude-skills-for-larger-mono-repos.md"><img src="https://img.shields.io/badge/Skills_in_Monorepos-555?style=for-the-badge" alt="Skills in Monorepos"></a>
<br>
<a href="reports/claude-agent-memory.md"><img src="https://img.shields.io/badge/Agent_Memory-555?style=for-the-badge" alt="Agent Memory"></a>
<a href="reports/claude-advanced-tool-use.md"><img src="https://img.shields.io/badge/Advanced_Tool_Use-555?style=for-the-badge" alt="Advanced Tool Use"></a>
<a href="reports/claude-usage-and-rate-limits.md"><img src="https://img.shields.io/badge/Usage_&_Rate_Limits-555?style=for-the-badge" alt="Usage & Rate Limits"></a>
<a href="reports/claude-agent-command-skill.md"><img src="https://img.shields.io/badge/Agents_vs_Commands_vs_Skills-555?style=for-the-badge" alt="Agents vs Commands vs Skills"></a>
<br>
<a href="reports/llm-day-to-day-degradation.md"><img src="https://img.shields.io/badge/LLM_Degradation-555?style=for-the-badge" alt="LLM Degradation"></a>
</p>

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

!How to Use

1. Read the repo like a course, learn what commands, agents, skills, and hooks are before trying to use them.
2. Clone this repo and play with the examples, try /weather-orchestrator, listen to the hook sounds, run agent teams, so you can see how things actually work.
3. Go to your own project and ask Claude to suggest what best practices from this repo you should add, give it this repo as a reference so it knows what's possible.

<a href="https://www.youtube.com/watch?v=AkAhkalkRY4"><img src="!/thumbnail/video-1.png" alt="Watch on YouTube" width="300"></a>

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

<p align="center">
<a href="https://github.com/trending?since=monthly"><img src="!/root/github-trending.png" alt="GitHub Trending" width="1200"></a><br>
✨Trending on Github in March 2026✨
</p>

Other Repos Copy Chapter

<a href="https://github.com/shanraisshan/claude-code-hooks"><img src="!/claude-speaking.svg" alt="Claude Code Hooks" width="40" height="40" align="center"></a> <a href="https://github.com/shanraisshan/claude-code-hooks"><strong>claude-code-hooks</strong></a> · <a href="https://github.com/shanraisshan/codex-cli-best-practice"><img src="!/codex-jumping.svg" alt="Codex CLI" width="40" height="40" align="center"></a> <a href="https://github.com/shanraisshan/codex-cli-best-practice"><strong>codex-cli-best-practice</strong></a> · <a href="https://github.com/shanraisshan/codex-cli-hooks"><img src="!/codex-speaking.svg" alt="Codex CLI Hooks" width="40" height="40" align="center"></a> <a href="https://github.com/shanraisshan/codex-cli-hooks"><strong>codex-cli-hooks</strong></a>

Developed by Copy Chapter

!Developed by

| # | Workflow | Description |

|---|----------|-------------|

| 1 | /workflows:development-workflows | Update the DEVELOPMENT WORKFLOWS table and cross-workflow analysis report by researching all 10 workflow repos in parallel |

| 2 | /workflows:best-practice:workflow-concepts | Update the README CONCEPTS section with the latest Claude Code features and concepts |

| 3 | /workflows:best-practice:workflow-claude-settings | Track Claude Code settings report changes and find what needs updating |

| 4 | /workflows:best-practice:workflow-claude-subagents | Track Claude Code subagents report changes and find what needs updating |

| 5 | /workflows:best-practice:workflow-claude-commands | Track Claude Code commands report changes and find what needs updating |

| 6 | /workflows:best-practice:workflow-claude-skills | Track Claude Code skills report changes and find what needs updating |


Star History Copy Chapter


<a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars" align="center"></a> stars and counting

<p align="center">
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
</p>

<img src="!/tags/sponsor-heart.svg" width="22" height="22" align="center"> Sponsor My Work Copy Chapter

If you like my work, buy me a doodh patti 🍵 on

<a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C"><img src="!/tags/polar.svg" alt="Polar" width="40" height="40" align="center"></a> <a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C"><strong>Polar</strong></a>