Shayan Raisclaude-code-best-practice
your best ai assistant with the best practice
CONCEPTS
- Agents - Specialized subprocesses that autonomously handle complex, multi-step tasks
- Commands - Custom slash commands to extend Claude Code with reusable prompts
- Memory - Persistent context that Claude remembers across conversations
- Hooks - Shell commands that execute in response to events like tool calls
- Skills - Installable capabilities that add specialized functionality to Claude Code
- Settings - Hierarchical configuration system for Claude Code behavior
- MCP Servers - Model Context Protocol for connecting to external tools, databases, and APIs
- Plugins - Extensible packages that bundle commands, agents, skills, hooks, and MCP servers
- Rules - Modular topic-specific instructions in
.claude/rules/*.md - Output Styles - Custom system prompt modifications for different use cases
- Permissions - Fine-grained access control for tools and operations
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.
