claude-code-best-practice

your best ai assistant with the best practice

CONCEPTS

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.

Skills - Reusable knowledge, workflows, and slash commands that Claude can load on-demand or you invoke with /skill-name
Subagents - Isolated execution contexts that run their own loops and return summarized results
Memory - Persistent context via CLAUDE.md files and @path imports that Claude sees every session
Rules - Modular topic-specific instructions in .claude/rules/*.md with optional path-scoping via frontmatter
Hooks - Deterministic scripts that run outside the agentic loop on specific events
MCP Servers - Model Context Protocol connections to external tools, databases, and APIs
Plugins - Distributable packages that bundle skills, subagents, hooks, and MCP servers
Marketplaces - Host and discover plugin collections
Settings - Hierarchical configuration system for Claude Code behavior
Permissions - Fine-grained access control for tools and operations

Extension Overview: See Extend Claude Code for when to use each feature and how they layer together.

LESSON LEARNED

Context Engineering

Humanlayer - Writing a good Claude.Md

Debugging

always ask claude to run the terminal (you want to see logs of) as a background task for better debugging
use claude in chrome to let claude see chrome console logs on its own

Workflows

LIBRARIES

KEYWORDS

[btw] start prompt with btw to let the current task executing in background
[claude --dangerously-skip-permissions] "defaultMode": "bypassPermissions"
deprecated* [ultrathink] Triggers extended thinking with up to ~32K thinking tokens for a single request.

DOCS

docs/AGENTS.md - Agent Orchestration Best Practices

Learn how to properly orchestrate multiple agents, avoid common pitfalls when sub-agents aren't invoking, and implement sequential workflows using the Task tool.

docs/PROMPTS.md - Invocation Patterns Reference

Quick reference tables showing how to invoke agents and commands from different contexts (CLI, other agents, other commands).

docs/WEATHER.md - Weather System Flow Documentation

Complete system architecture and flow diagram for the weather data fetching and transformation workflow, demonstrating real-world agent and command orchestration.

IDE

Cursor vs. Windsurf vs. VS Code

Claude Code Replaced Cursor for Me… Here’s Why

3.8 KiB Raw Blame History Unescape Escape