by awattar
💻 Best practices and examples for using Claude Code - Anthropic’s terminal-native AI - for writing, editing, and refactoring code with deep project awareness, prompt design, and safe automation.
# Add to your Claude Code skills
git clone https://github.com/awattar/claude-code-best-practicesA practical guide to using Claude Code, Anthropic’s agentic coding assistant, effectively in real-world development workflows. This repo distills best practices, patterns, and examples for integrating Claude Code into your terminal-based coding environment.
Claude Code is a command-line tool that gives you direct access to Claude’s reasoning and coding capabilities. It’s designed for agentic coding - where Claude autonomously explores, edits, and explains code across your project. Think of it as a collaborative AI pair programmer that understands your repo structure, coding conventions, and workflows.
CLAUDE.md to preload project contextClaude Code is optimized for agentic coding - AI that acts with autonomy and awareness:
No comments yet. Be the first to share your thoughts!
This repository includes a collection of custom slash commands designed to streamline development workflows with Claude Code. Use /help-commands to get detailed information about all available commands.
/custom-init
Automatically generates comprehensive CLAUDE.md files for any project by analyzing project structure, technology stack, and development patterns.
/help-commands
Provides comprehensive help documentation for all available custom commands, including usage examples and best practices.
/commit
Creates well-formatted conventional commits following best practices with automatic staging, diff analysis, and atomic commit recommendations. Uses standardized commit templates from .gitmessage and .github/COMMIT_CONVENTION.md.
/issue
End-to-end GitHub issue resolution following GitHub Flow with automated planning, branch creation, and incremental implementation. Integrates with GitHub PR templates from .github/pull_request_template.md.
/reviewpr
Comprehensive pull request review process with CI/CD checks, code quality analysis, and structured feedback via GitHub CLI.
/testThis repository includes a collection of 9 specialized AI agents that provide domain-specific expertise across all development workflows. These agents work automatically with commands to deliver expert-level capabilities in architecture, development, and quality assurance.
general-purpose
Complex multi-step analysis, file searching, and task coordination across any development workflow.
general-solution-architect
Architecture analysis, technology stack decisions, scalability planning, and distributed systems design.
general-technical-writer
Documentation creation, API documentation, formatting, and technical content organization.
general-fullstack-developer
End-to-end feature implementation spanning database, API, and frontend layers with seamless integration.
general-backend-developer
API development, database design, server-side logic, and backend performance optimization.
general-frontend-developer
UI/UX implementation, component patterns, browser automation, and modern JavaScript frameworks.
general-qa
Testing strategies, test automation, comprehensive validation, and quality assurance methodologies.
general-code-quality-debugger
Code review, systematic debugging, refactoring guidance, and technical debt reduction.
general-technical-project-lead
Security assessments, strategic technical decisions, performance optimization, and architectural leadership.
Agent Integration: These specialized agents work seamlessly with all custom commands, automatically providing domain expertise when needed. Commands like /issue, /reviewpr, and /test leverage multiple agents to deliver comprehensive, expert-level results.
Models OverviewBest Practices for Agentic CodingCommon WorkflowsRun Parallel Claude Code Sessions with Git WorktreesManage Claude's MemoryHooksSub-agentsClaude Code Subagents Collection by davepoonGitHub ActionsMy Claude Code Workflow and Personal Tips by paraditePuppeteer Local MCP Server
_"A Model Context Protocol server