This repository provides a lean, token-efficient .claude/ configuration for Claude Code, optimized for daily development tasks like bug fixing, feature additions, and code reviews. It targets developers seeking to enhance Claude's utility for routine workflows by minimizing token consumption and improving response relevance, offering a practical alternative to heavier plugin-based solutions.

How It Works

The project structures Claude Code configurations—including settings, rules, skills, and agents—within a .claude/ directory. It leverages modular rules for code quality and project-specific guidelines, skills (slash commands) for automating common development tasks like debugging, shipping, and refactoring, and specialized agents for focused reviews (code, security, performance, documentation). The core /setupdotclaude command automates the customization of these configurations by scanning the project's tech stack, ensuring a tailored and efficient setup.

Quick Start & Requirements

1. Clone the repository: git clone https://github.com/poshan0126/dotclaude.git /tmp/dotclaude
2. Copy configuration files into your project's .claude/ directory.
3. Run /setupdotclaude within your Claude Code session to customize configurations based on your codebase.
4. Restart Claude Code if it was already open.

• Prerequisites: jq must be installed for hooks to function correctly.
• Links: dotclaude GitHub Repository

Highlighted Details

• The /setupdotclaude command automates codebase scanning (tech stack, linters, formatters) and configuration customization, confirming changes before application.
• Specialized agents like @code-reviewer, @security-reviewer, and @performance-reviewer provide targeted analysis for specific code changes or tasks.
• Includes essential hooks such as format-on-save (auto-detecting formatters like Prettier, Black, Ruff), scan-secrets, block-dangerous-commands, and protect-files.
• Designed for token efficiency, focusing on daily development needs rather than large-scale project scaffolding.

Maintenance & Community

The README mentions leveraging "Community best practices from hundreds of Claude Code power users" but does not provide specific links to community channels, active maintainers, or sponsorship details.

Licensing & Compatibility

The project is released under the MIT License, permitting broad use, modification, and distribution, including for commercial purposes.

Limitations & Caveats

Skills and agents are loaded at session start, necessitating a restart of Claude Code after initial setup or configuration changes. The jq utility is a hard requirement for hook functionality. While /setupdotclaude automates much of the setup, manual adjustments to rules, skills, or agents may be required for highly specific project needs.