Three structured tracks through this repository, from first-time setup to advanced orchestration.
| ← Back to Claude Code Best Practice |  |
Get Claude Code running and understand the core concepts.
| Step | Document | What You Learn |
|---|---|---|
| 1 | Tutorial | Guided first-day walkthrough of Claude Code |
| 2 | Power-ups | Interactive lessons with animated demos for each feature |
| 3 | CLAUDE.md / Memory Guide | How to write effective CLAUDE.md files, rules, and memory hierarchy |
| 4 | Memory | Persistent context via CLAUDE.md — writing and loading in monorepos |
| 5 | Commands | Slash command patterns, built-in commands, and custom workflow templates |
| 6 | FAQ | Answers to the most common questions about Claude Code configuration |
Build your own agents, skills, and automation pipelines.
| Step | Document | What You Learn |
|---|---|---|
| 1 | Skills | SKILL.md structure, auto-discovery, preloading, and context forking |
| 2 | Subagents | Agent frontmatter, tools, permissions, model selection, and memory |
| 3 | Hooks | Event-driven scripts that run outside the agentic loop |
| 4 | Decision Tree | When to use Agent vs Command vs Skill — flowchart and scenario mapping |
| 5 | Orchestration Workflow | Command-to-Agent-to-Skill architecture (weather system example) |
| 6 | MCP Servers | Model Context Protocol connections to external tools and APIs |
| 7 | CLI Startup Flags | Command-line flags, subcommands, and environment variables |
Scale Claude Code across teams, diagnose issues, and study real-world patterns.
| Step | Document | What You Learn |
|---|---|---|
| 1 | Settings | Full configuration hierarchy, permissions, sandboxing, fast mode |
| 2 | Anti-Patterns | Common mistakes in architecture, configuration, skills, and operations |
| 3 | Troubleshooting | Diagnostic guide for installation, performance, hooks, MCP, and memory |
| 4 | Agent Teams | Multi-agent topologies and team coordination patterns |
| 5 | Cross-Model Workflow | Using different models for different pipeline stages |
| 6 | RPI Workflow | Research-Plan-Implement methodology and its evolution |
| 7 | Reports | Deep-dive analyses on specific topics (see list below) |
claude-code-best-practice-v2/
├── README.md # Main entry point — concepts table, tips, links
├── CLAUDE.md # Repository instructions for Claude Code
├── NAVIGATION.md # This file — learning tracks and directory map
│
├── best-practice/ # Best practice guides (one topic per file)
│ ├── claude-anti-patterns.md # Common mistakes and how to avoid them
│ ├── claude-cli-startup-flags.md # CLI flags, subcommands, env vars
│ ├── claude-commands.md # Slash command patterns and reference
│ ├── claude-decision-tree.md # Agent vs Command vs Skill flowchart
│ ├── claude-faq.md # Answers to Billion-Dollar Questions
│ ├── claude-hooks.md # Event-driven hook system
│ ├── claude-mcp.md # Model Context Protocol servers
│ ├── claude-memory.md # CLAUDE.md writing and loading
│ ├── claude-memory-guide.md # Comprehensive memory management guide
│ ├── claude-power-ups.md # Interactive feature lessons
│ ├── claude-settings.md # Configuration hierarchy and permissions
│ ├── claude-skills.md # Skill definition and auto-discovery
│ ├── claude-subagents.md # Subagent architecture and frontmatter
│ └── claude-troubleshooting.md # Diagnostic and debugging guide
│
├── implementation/ # Reference implementations
│ ├── claude-agent-teams-implementation.md
│ ├── claude-commands-implementation.md
│ ├── claude-hooks-implementation.md
│ ├── claude-mcp-implementation.md
│ ├── claude-scheduled-tasks-implementation.md
│ ├── claude-skills-implementation.md
│ └── claude-subagents-implementation.md
│
├── reports/ # Deep-dive analyses
│ ├── claude-advanced-tool-use.md
│ ├── claude-agent-command-skill.md
│ ├── claude-agent-memory.md
│ ├── claude-agent-sdk-vs-cli-system-prompts.md
│ ├── claude-global-vs-project-settings.md
│ ├── claude-in-chrome-v-chrome-devtools-mcp.md
│ ├── claude-skills-for-larger-mono-repos.md
│ ├── claude-usage-and-rate-limits.md
│ └── llm-day-to-day-degradation.md
│
├── tips/ # Boris Cherny and community tips
│ ├── claude-boris-10-tips-01-feb-26.md
│ ├── claude-boris-12-tips-12-feb-26.md
│ ├── claude-boris-13-tips-03-jan-26.md
│ ├── claude-boris-15-tips-30-mar-26.md
│ ├── claude-boris-2-tips-10-mar-26.md
│ ├── claude-boris-2-tips-25-mar-26.md
│ └── claude-thariq-tips-17-mar-26.md
│
├── videos/ # Interview transcripts with TL;DR summaries
│ ├── claude-boris-lennys-podcast-19-feb-26.md
│ ├── claude-boris-pragmatic-engineer-04-mar-26.md
│ ├── claude-boris-ryan-peterman-15-dec-25.md
│ ├── claude-boris-y-combinator-17-feb-26.md
│ ├── claude-cat-every-29-oct-25.md
│ └── claude-dex-mlops-community-24-mar-26.md
│
├── tutorial/ # Step-by-step tutorials
│ └── day0/ # Day 0 getting started guide
│
├── changelog/ # Documentation drift tracking
│ ├── README.md # Index of all changelog files
│ ├── best-practice/ # Per-topic changelogs and checklists
│ │ ├── claude-commands/
│ │ ├── claude-settings/
│ │ ├── claude-skills/
│ │ ├── claude-subagents/
│ │ └── concepts/
│ └── development-workflows/ # Community workflow repo tracking
│
├── orchestration-workflow/ # Weather system demo (Command → Agent → Skill)
│ ├── orchestration-workflow.md
│ ├── orchestration-workflow.svg
│ └── output.md
│
├── development-workflows/ # External methodology references
│ ├── cross-model-workflow/
│ └── rpi/
│
├── agent-teams/ # Multi-agent coordination patterns
│ ├── agent-teams-prompt.md
│ └── output/
│
├── presentation/ # Slide deck (managed by presentation-curator agent)
│
├── i18n/ # Translations (zh, ja, fr, ru, ar)
│
└── .claude/ # Claude Code configuration
├── agents/ # Subagent definitions
├── commands/ # Slash command templates
├── hooks/ # Hook scripts and config
├── rules/ # Glob-scoped rules
├── skills/ # Skill definitions (SKILL.md)
├── settings.json # Team-shared settings
└── settings.local.json # Personal settings (git-ignored)
- Agent SDK vs CLI | Browser Automation MCP | Global vs Project Settings | Skills in Monorepos | Agent Memory | Usage & Rate Limits | Advanced Tool Use | Agent vs Command vs Skill | LLM Degradation