claude-code-best-practice

from vibe coding to agentic engineering - practice makes claude perfect

= Agents · = Commands · = Skills

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

🧠 CONCEPTS

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

🔥 Hot

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

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

claude
/weather-orchestrator

⚙️ DEVELOPMENT WORKFLOWS

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

Note: yellow tags are sub-loops — steps that repeat inside a parent step (e.g. per task, per story, or until a verify condition passes).

Others

• RPI
• Ralph Wiggum Loop
• Andrej Karpathy (Founding Member, OpenAI) Workflow
• Peter Steinberger (Creator of OpenClaw) Workflow
• Boris Cherny (Creator of Claude Code) Workflow — 13 Tips · 10 Tips · 12 Tips · 2 Tips · 15 Tips · 6 Tips
• Thariq (Anthropic) Workflow — Skills · Session Management

🔀 CROSS-MODEL WORKFLOWS

Use Claude Code together with other models — Codex, Gemini, GPT, Kimi, DeepSeek, local — via three mechanisms:

• Plugin — another model's CLI runs inside Claude Code (slash commands like /codex:review)
• MCP — Claude Code calls another model as a tool through Model Context Protocol
• Router — Claude Code's API endpoint is swapped to a different provider

Methodology: Cross-Model (Claude Code + Codex) Workflow — manual two-terminal flow with Plan in Claude, QA-Review in Codex.

🧰 SKILL COLLECTIONS

Repos primarily known as curated libraries of SKILL.md files (distinct from full workflow methodologies above). Sorted by stars descending.

🤖 AGENT COLLECTIONS

Repos primarily known as curated libraries of subagent definitions (.claude/agents/*.md). Sorted by stars descending.

💡 TIPS AND TRICKS (83)

🚫👶 = do not babysit

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

■ 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 🚫👶

■ Planning/Specs (7)

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)
break PRDs into vertical slices (tracer bullets) that cross all layers (DB + service + UI) — AI defaults to horizontal phasing (DB phase, then API phase, then frontend phase) which delays end-to-end feedback until the last phase. From the Pragmatic Programmer 🚫👶
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	[](https://youtu.be/julb