Shayan Raisclaude-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
@pathimports that Claude sees every session - Rules - Modular topic-specific instructions in
.claude/rules/*.mdwith 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
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.
