{"id":45189831,"url":"https://github.com/shanraisshan/claude-code-best-practice","last_synced_at":"2026-02-28T02:01:01.891Z","repository":{"id":321796513,"uuid":"1087192965","full_name":"shanraisshan/claude-code-best-practice","owner":"shanraisshan","description":"practice made claude perfect","archived":false,"fork":false,"pushed_at":"2026-02-12T18:07:50.000Z","size":3182,"stargazers_count":2446,"open_issues_count":0,"forks_count":163,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-02-12T21:29:21.531Z","etag":null,"topics":["claude-ai","claude-code"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shanraisshan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-31T14:15:28.000Z","updated_at":"2026-02-12T21:19:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/shanraisshan/claude-code-best-practice","commit_stats":null,"previous_names":["shanraisshan/claude-code-best-practice"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/shanraisshan/claude-code-best-practice","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanraisshan%2Fclaude-code-best-practice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanraisshan%2Fclaude-code-best-practice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanraisshan%2Fclaude-code-best-practice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanraisshan%2Fclaude-code-best-practice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shanraisshan","download_url":"https://codeload.github.com/shanraisshan/claude-code-best-practice/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shanraisshan%2Fclaude-code-best-practice/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29922702,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-ai","claude-code"],"created_at":"2026-02-20T12:00:23.664Z","updated_at":"2026-02-28T02:01:01.876Z","avatar_url":"https://github.com/shanraisshan.png","language":"HTML","funding_links":[],"categories":["HTML","A01_文本生成_文本对话","Configuration \u0026 Rules","语言资源库","Acknowledgements","📋 Development Methodologies","Productivity Tools","Skills","Repos","🤖 AI \u0026 Machine Learning","Extensions, Skills \u0026 Rules","AI Agent Frameworks \u0026 SDKs","Comprehensive Frameworks"],"sub_categories":["大语言对话模型及数据","books","Adversarial Code Review via Codex CLI","Configuration \u0026 Templates","Community Skills","Methodologies \u0026 Spec-Driven Workflows","Multi-Agent Collaboration Systems"],"readme":"# claude-code-best-practice\npractice makes claude perfect\n\n![Last Updated](https://img.shields.io/badge/Last_Updated-Feb_26%2C_2026_10%3A45_AM_PKT-white?style=flat\u0026labelColor=555) \u003ca href=\"https://github.com/shanraisshan/claude-code-best-practice/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=social\" alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"!/claude-jumping.svg\" alt=\"Claude Code mascot jumping\" width=\"120\" height=\"100\"\u003e\n\u003c/p\u003e\n\n\u003ctable align=\"center\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"!/boris-cherny.png\" alt=\"Claude Code Creator\" width=\"100%\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"!/boris-cherny-2.png\" alt=\"Claude Code Creator\" width=\"100%\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\n## CONCEPTS\n\n\u003e **Note:** Custom slash commands have been merged into skills. Files in `.claude/commands/` still work, but skills (`.claude/skills/`) are recommended as they support additional features like supporting files, invocation control, and subagent execution.\n\n- **[Skills](https://code.claude.com/docs/en/skills)** - Reusable knowledge, workflows, and slash commands that Claude can load on-demand or you invoke with `/skill-name`\n- **[Agents](https://code.claude.com/docs/en/sub-agents)** - Custom agents in `.claude/agents/` with their own name, color, tools, permissions, and model — usable as default main agent (`\"agent\"` in settings.json) or as isolated subagents via the Task tool\n- **[Memory](https://code.claude.com/docs/en/memory)** - Persistent context via CLAUDE.md files and `@path` imports that Claude sees every session\n- **[Rules](https://code.claude.com/docs/en/memory#modular-rules-with-clauderules)** - Modular topic-specific instructions in `.claude/rules/*.md` with optional path-scoping via frontmatter\n- **[Hooks](https://code.claude.com/docs/en/hooks)** - Deterministic scripts that run outside the agentic loop on specific events\n- **[MCP Servers](https://code.claude.com/docs/en/mcp)** - Model Context Protocol connections to external tools, databases, and APIs\n- **[Plugins](https://code.claude.com/docs/en/plugins)** - Distributable packages that bundle skills, subagents, hooks, and MCP servers\n- **[Marketplaces](https://code.claude.com/docs/en/discover-plugins)** - Host and discover plugin collections\n- **[Sandboxing](https://code.claude.com/docs/en/sandboxing)** - File and network isolation runtime that improves safety while reducing permission prompts\n- **[Output Styles](https://code.claude.com/docs/en/output-styles)** - Configurable response tone and format — Explanatory, Learning, or Custom\n- **[Settings](https://code.claude.com/docs/en/settings)** - Hierarchical configuration system for Claude Code behavior (37 settings, 84 env vars)\n- **[Permissions](https://code.claude.com/docs/en/iam)** - Fine-grained access control for tools and operations with wildcard syntax\n\n**Extension Overview:** See [Extend Claude Code](https://code.claude.com/docs/en/features-overview) for when to use each feature and how they layer together.\n\n## 💎 HIDDEN GEMS\n\n\u003e Reports that are frequently updated as Claude Code evolves.\n\n| Report | Description |\n|--------|-------------|\n| [Claude Code Commands Reference](reports/claude-commands.md) | Complete reference of all slash commands, keyboard shortcuts, and input modes |\n| [Claude Code Settings Reference](reports/claude-settings.md) | Comprehensive guide to all `settings.json` configuration options |\n| [Agents Frontmatter Reference](reports/claude-agents-frontmatter.md) | Complete reference of all agent (`.claude/agents/`) frontmatter fields |\n| [Commands Frontmatter Reference](reports/claude-commands-frontmatter.md) | Complete reference of all command (`.claude/commands/`) frontmatter fields |\n| [Skills Frontmatter Reference](reports/claude-skills-frontmatter.md) | Complete reference of all skill (`.claude/skills/`) frontmatter fields |\n\n## MY EXPERIENCE\n\n■ **Workflows**\n- Claude.md should not exceed 150+ lines. (still not 100% guaranteed)\n- use commands for your workflows instead of agents\n- have feature specific subagents (extra context) with skills (progressive disclosure) instead of general qa, backend engineer.\n- /memory, /rules, constitution.md does not guarantee anything\n- do manual /compact at max 50%\n- always start with plan mode\n- subtasks should be so small that it can be completed in less than 50% context\n- vanilla cc is better than any workflows with smaller tasks\n- commit often, as soon as task is completed, commit.\n\n■ **Utilities**\n- iTerm terminal instead of IDE (crash issue) \n- Wispr Flow for voice prompting (10x productivity)\n- claude-code-voice-hooks for claude feedback\n- status line for context awareness and fast compacting\n- git worktrees for parallel development\n- /permissions with wildcard syntax (`Bash(npm run *)`, `Edit(/docs/**)`) instead of dangerously-skip-permissions\n- /sandbox to reduce permission prompts with file and network isolation\n- output styles: use Explanatory when learning a new codebase, Learning for coaching\n- /keybindings to remap any key, settings live reload\n\n■ **Debugging** \n- /doctor\n- always ask claude to run the terminal (you want to see logs of) as a background task for better debugging\n- use mcp (claude in chrome, playwright, chrome dev tool) to let claude see chrome console logs on its own\n- provide screenshots of the issue\n\n## TIPS FROM BORIS CHERNY (CREATOR OF CLAUDE CODE)\n- [Feb 2026 - 12 Tips](reports/claude-boris-tips-feb-26.md) ([Reddit thread](https://www.reddit.com/r/ClaudeAI/comments/1r2m8ma/12_claude_code_tips_from_creator_of_claude_code/))\n\n## CONTEXT ENGINEERING\n- [Humanlayer - Writing a good Claude.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md)\n- [Claude.md for larger monorepos - Boris Cherny on X](https://github.com/shanraisshan/claude-code-best-practice/blob/main/reports/claude-md-for-larger-mono-repos.md)\n\n## WORKFLOWS\n- [RPI](workflow/rpi/rpi-workflow.md)\n- [Boris Feb26 workflow](https://x.com/bcherny/status/2017742741636321619)\n- [Ralph plugin with sandbox](https://www.youtube.com/watch?v=eAtvoGlpeRU)\n- [Human Layer RPI - Research Plan Implement](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents/blob/main/ace-fca.md)\n- [AgentOs - 2026 its overkill (Brian Casel)](https://www.youtube.com/watch?v=0hdFJA-ho3c)\n- [Github Speckit](https://github.com/github/spec-kit)\n- [GSD - Get Shit Done](https://github.com/glittercowboy/get-shit-done)\n- [OpenSpec OPSX](https://github.com/Fission-AI/OpenSpec/blob/main/docs/opsx.md)\n- [Superpower](https://github.com/obra/superpowers)\n- [Andrej Karpathy Workflow](https://github.com/forrestchang/andrej-karpathy-skills)\n- [Creator of Clawd Bot Workflow](https://www.youtube.com/watch?v=8lF7HmQ_RgY)\n\n\n\n\n\n## CLAUDE CODE FEATURES INSPIRATION\n\n- [Claude Code Tasks - inspired by beats](https://www.reddit.com/r/ClaudeAI/comments/1qkjznp/anthropic_replaced_claude_codes_old_todos_with/) [Inspiration](https://github.com/steveyegge/beads)\n- [Ralph Plugin](https://x.com/GeoffreyHuntley/status/2015031262692753449)\n\n## COMMAND + SKILL + SUBAGENT ARCHITECTURE\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"!/command-skill-agent-flow.svg\" alt=\"Command Skill Agent Architecture Flow\" width=\"600\"\u003e\n\u003c/p\u003e\n\n| Component | Role | Example |\n|-----------|------|---------|\n| **Command** | Entry point, user interaction | `/weather-orchestrator` |\n| **Agent** | Orchestrates workflow with preloaded skills | `weather` agent |\n| **Skills** | Domain knowledge injected at startup | `weather-fetcher`, `weather-transformer` |\n\n**When to use:** Multi-step workflows • Domain-specific knowledge injection • Sequential tasks • Reusable components\n\n**Why it works:** Progressive disclosure • Single execution context • Clean separation • Reusability\n\nSee [weather-orchestration-architecture](weather-orchestration/weather-orchestration-architecture.md) for implementation details.\n\n## AI TERMS\n\n| | | | | |\n|---|---|---|---|---|\n| Agentic Engineering | AI Slop | Context Bloat | Context Engineering | Context Rot |\n| Dumb Zone | Hallucination | Scaffolding | Orchestration | Vibe Coding |\n\n[**See Complete List →**](https://github.com/shanraisshan/claude-code-codex-cursor-gemini/blob/main/reports/ai-terms.md)\n\n## CLI STARTUP FLAGS\n\n| | | | | |\n|---|---|---|---|---|\n| `--dangerously-skip-permissions` | `--model` | `--print` | `--resume` | `--continue` |\n| `--system-prompt` | `--verbose` | `--debug` | `--init` | `--max-turns` |\n\n[**See Complete List →**](reports/claude-cli-startup-flags.md)\n\n## CLAUDE COMMANDS\n\n| | | | | |\n|---|---|---|---|---|\n| `/compact` | `/context` | `/model` | `/plan` | `/config` |\n| `/clear` | `/cost` | `/memory` | `/doctor` | `/rewind` |\n\n[**See Complete List →**](reports/claude-commands.md)\n\n\n## CLAUDE SETTINGS\n\n| | |\n|---|---|\n| [**Claude Settings**](reports/claude-settings.md) | [**Global vs Project Settings**](reports/claude-global-vs-project-settings.md) |\n\n\n## MCP SERVERS FOR DAILY USE\n\n\u003e *\"Went overboard with 15 MCP servers thinking more = better. Ended up using only 4 daily.\"* — [r/mcp](https://reddit.com/r/mcp/comments/1mj0fxs/) (682 upvotes)\n\n| MCP Server | What It Does | Resources |\n|------------|-------------|-----------|\n| [**Context7**](https://github.com/upstash/context7) | Fetches up-to-date library docs into context. Prevents hallucinated APIs from outdated training data | [Reddit: \"by far the best MCP for coding\"](https://reddit.com/r/mcp/comments/1qarjqm/) · [npm](https://www.npmjs.com/package/@upstash/context7-mcp) |\n| [**Playwright**](https://github.com/microsoft/playwright-mcp) | Browser automation — implement, test, and verify UI features autonomously. Screenshots, navigation, form testing | [Reddit: essential for frontend](https://reddit.com/r/mcp/comments/1m59pk0/) · [Docs](https://playwright.dev/) |\n| [**Claude in Chrome**](https://github.com/nicobailon/claude-code-in-chrome-mcp) | Connects Claude to your real Chrome browser — inspect console, network, DOM. Debug what users actually see | [Reddit: \"game changer\" for debugging](https://reddit.com/r/mcp/comments/1qarjqm/5_mcps_that_have_genuinely_made_me_10x_faster/nza0i7t/) · [Comparison Report](reports/claude-in-chrome-v-chrome-devtools-mcp.md) |\n| [**DeepWiki**](https://github.com/devanshusemwal/deepwiki-mcp) | Fetches structured wiki-style documentation for any GitHub repo — architecture, API surface, relationships | [Reddit: \"put it behind a gateway with Context7\"](https://reddit.com/r/mcp/comments/1qarjqm/) |\n| [**Excalidraw**](https://github.com/antonpk1/excalidraw-mcp-app) | Generate architecture diagrams, flowcharts, and system designs as hand-drawn Excalidraw sketches from prompts | [GitHub](https://github.com/antonpk1/excalidraw-mcp-app) |\n\nResearch (Context7/DeepWiki) -\u003e Debug (Playwright/Chrome) -\u003e Document (Excalidraw)\n\n## REPORTS\n\n| Report | Description |\n|--------|-------------|\n| [Agent SDK vs CLI System Prompts](reports/claude-agent-sdk-vs-cli-system-prompts.md) | Why Claude CLI and Agent SDK outputs may differ—system prompt architecture and determinism |\n| [Browser Automation MCP Comparison](reports/claude-in-chrome-v-chrome-devtools-mcp.md) | Comparison of Playwright, Chrome DevTools, and Claude in Chrome for automated testing |\n| [Claude Code CLI Startup Flags](reports/claude-cli-startup-flags.md) | Complete reference of all CLI flags, subcommands, and environment variables |\n| [CLAUDE.md Loading in Monorepos](reports/claude-md-for-larger-mono-repos.md) | Understanding ancestor vs descendant loading behavior for CLAUDE.md files |\n| [Global vs Project Settings](reports/claude-global-vs-project-settings.md) | Which features are global-only (`~/.claude/`) vs dual-scope, including Tasks and Agent Teams |\n| [Skills Discovery in Monorepos](reports/claude-skills-for-larger-mono-repos.md) | How skills are discovered and loaded in large monorepo projects |\n| [Agent Memory Frontmatter](reports/claude-agent-memory.md) | Persistent memory scopes (`user`, `project`, `local`) for subagents — enabling agents to learn across sessions |\n| [Boris Cherny's 12 Customization Tips](reports/claude-boris-tips-feb-26.md) | 12 ways to customize Claude Code — from terminal config to plugins, agents, hooks, and output styles |\n| [Advanced Tool Use Patterns](reports/claude-advanced-tool-use.md) | Programmatic Tool Calling (PTC), Tool Search, and Tool Use Examples |\n| [Usage, Rate Limits \u0026 Extra Usage](reports/claude-usage-and-rate-limits.md) | Usage commands (`/usage`, `/extra-usage`, `/cost`), rate limits, and pay-as-you-go overflow billing |\n| [Claude Code Commands Reference](reports/claude-commands.md) | Complete reference of all slash commands, keyboard shortcuts, and input modes |\n| [Claude Code Settings Reference](reports/claude-settings.md) | Comprehensive guide to all `settings.json` configuration options |\n| [Agents Frontmatter Reference](reports/claude-agents-frontmatter.md) | Complete reference of all agent (`.claude/agents/`) frontmatter fields |\n| [Commands Frontmatter Reference](reports/claude-commands-frontmatter.md) | Complete reference of all command (`.claude/commands/`) frontmatter fields |\n| [Skills Frontmatter Reference](reports/claude-skills-frontmatter.md) | Complete reference of all skill (`.claude/skills/`) frontmatter fields |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshanraisshan%2Fclaude-code-best-practice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshanraisshan%2Fclaude-code-best-practice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshanraisshan%2Fclaude-code-best-practice/lists"}