An open API service indexing awesome lists of open source software.

https://github.com/alirezarezvani/claude-code-tresor

A world-class collection of Claude Code utilities: autonomous skills, expert agents, slash commands, and prompts that supercharge your development workflow
https://github.com/alirezarezvani/claude-code-tresor

agent-development-kit agentic-ai agentic-coding agentic-workflow agents anthropic-claude claude-code

Last synced: 3 days ago
JSON representation

A world-class collection of Claude Code utilities: autonomous skills, expert agents, slash commands, and prompts that supercharge your development workflow

Awesome Lists containing this project

README

          

# Claude Code Tresor ๐Ÿ†

> A world-class collection of Claude Code utilities: autonomous skills, expert agents, slash commands, and prompts that supercharge your development workflow.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/version-2.7.0-blue.svg)](https://github.com/alirezarezvani/claude-code-tresor)
[![Quality](https://img.shields.io/badge/quality-9.7%2F10-brightgreen.svg)](docs/VALIDATION-REPORT-CONTENT.md)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blue.svg)](https://claude.ai/code)
[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md)

## Also available on Smithery:
[![Run in Smithery](https://smithery.ai/badge/skills/alirezarezvani)](https://smithery.ai/skills?ns=alirezarezvani&utm_source=github&utm_medium=badge)

**Author**: Alireza Rezvani
**Created**: September 16, 2025
**Updated**: December 17, 2025 (v2.7.0 - Tresor Workflow Framework)
**Quality**: 9.7/10 (Exceptional)
**License**: MIT
**Repository**: https://github.com/alirezarezvani/claude-code-tresor

---

## ๐ŸŽ‰ What's New in v2.7.0

**Major Release** - 10 New Orchestration Commands + Tresor Workflow Framework!

- ๐Ÿš€ **10 Orchestration Commands** - Production-grade intelligent orchestration (12,682 lines of code)
- ๐Ÿ”’ **Security**: `/audit`, `/vulnerability-scan`, `/compliance-check`
- โšก **Performance**: `/profile`, `/benchmark`
- ๐Ÿ”ง **Operations**: `/deploy-validate`, `/health-check`, `/incident-response`
- ๐Ÿ“Š **Quality**: `/code-health`, `/debt-analysis`
- ๐Ÿค– **Intelligent Agent Selection** - Auto-selects from 141 agents based on tech stack
- ๐Ÿ”„ **Multi-Phase Orchestration** - 3-4 phases with parallel & sequential execution
- ๐Ÿ›ก๏ธ **Dependency Verification** - Ensures safe parallel agent execution
- ๐Ÿ”„ **Tresor Workflow Framework** - Meta-prompting, todo management, context handoff
- ๐Ÿ“ฆ **Consolidated Structure** - Unified agent directory in `/subagents/` (133 total agents)

---

### Previous: v2.6.0 - Quality Excellence

**Quality Excellence Release** - Achieved 9.7/10 exceptional quality rating!

- ๐ŸŽจ **Design Category Transformation** - Improved from 4.0 to 8.0/10 (+100% quality boost)
- ๐Ÿ“š **12 Enhanced Examples** - Added comprehensive usage examples to key agents
- ๐Ÿ“‹ **Improved Consistency** - Standard sections added to 9 specialized agents
- โœ… **Best Practices** - Added to config-safety-reviewer and security-auditor
- ๐Ÿค **Collaboration Guide** - Cross-team workflow documentation created
- ๐Ÿ“– **Streamlined Docs** - Consolidated 21 files into 3 guides + archive

**Backward Compatible** - No breaking changes from v2.5.0

### Previous Release: v2.5.0 (November 15, 2025)

**Agent Reorganization & Extension** - 141 agents organized by team and function!

- ๐Ÿ—๏ธ **New Structure** - `subagents/` directory with 10 color-coded team categories
- ๐Ÿ“ฆ **141 Total Agents** - 8 core + 133 subagents across all development domains
- ๐Ÿ”„ **Core Agent Renaming** - systems-architect, config-safety-reviewer, root-cause-analyzer
- ๐ŸŽจ **Color Coding System** - Visual team identification (10 team colors)
- ๐Ÿ“š **Comprehensive Documentation** - 450KB of guides, catalogs, and references

**BREAKING CHANGES** (v2.5.0 only):
- `@architect` โ†’ `@systems-architect`
- `@code-reviewer` โ†’ `@config-safety-reviewer`
- `@debugger` โ†’ `@root-cause-analyzer`

---

## ๐ŸŽฏ What is Claude Code Tresor?

Claude Code Tresor is the ultimate collection of **professional-grade utilities** for Claude Code users. Whether you're a solo developer or part of a team, this repository provides battle-tested tools that integrate seamlessly into your development workflow.

### ๐ŸŒŸ Why Choose Claude Code Tresor?

- **๐Ÿš€ Production-Ready**: All utilities are tested and used in real-world projects
- **๐Ÿ“š Comprehensive**: Covers the entire development lifecycle
- **๐Ÿ› ๏ธ Easy Installation**: One-command setup with automated updates
- **๐ŸŽจ Customizable**: Adapt templates to your specific needs and tech stack
- **๐Ÿ‘ฅ Team-Friendly**: Includes collaboration guidelines and standards
- **๐Ÿ“– Well-Documented**: Every component includes detailed examples and usage guides

> **๐Ÿ’ก Ecosystem Tip:** Looking for more? Check out the [Claude Code Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory) to build custom skills, or browse the [Claude Skills Library](https://github.com/alirezarezvani/claude-skills) for pre-built professional domain packages. See [Related Projects](#-related-projects--ecosystem) for details.
>
> **๐Ÿ“– [Complete Augmentation Guide](https://gist.github.com/alirezarezvani/a0f6e0a984d4a4adc4842bbe124c5935)** - Comprehensive guide with FAQs, use cases, and installation instructions
>
> ## ๐Ÿ“š Deep Dive

### Want to understand the architecture behind this 141-agent setup?
- [141 Claude Code Agents: The Setup That Actually Works](https://medium.com/@alirezarezvani/141-claude-code-agents-the-setup-that-actually-works-a-complete-guide-98c2c79bf867?sk=73d5be97f9bd81a18edbcc0394e44b95)

---

## โœจ What's Included

### ๐Ÿš€ Slash Commands (19 Total)

**Development Commands** (4):

| Command | Purpose | Example Usage |
|---------|---------|---------------|
| **`/scaffold`** | Generate project structures, components, and boilerplate | `/scaffold react-component UserProfile --hooks --tests` |
| **`/review`** | Automated code review with security and performance analysis | `/review --scope staged --checks security,performance` |
| **`/test-gen`** | Create comprehensive test suites automatically | `/test-gen --file utils.js --coverage 90` |
| **`/docs-gen`** | Generate documentation from code and comments | `/docs-gen api --format openapi` |

**Tresor Workflow Commands** (5):

| Command | Purpose | Example Usage |
|---------|---------|---------------|
| **`/prompt-create`** | Generate optimized prompts for complex tasks | `/prompt-create Build user authentication system` |
| **`/prompt-run`** | Execute generated prompts in sub-agents | `/prompt-run 001 --parallel` |
| **`/todo-add`** | Capture ideas mid-conversation | `/todo-add Fix performance issue in API` |
| **`/todo-check`** | Review and work on captured todos | `/todo-check` |
| **`/handoff-create`** | Generate context handoff document | `/handoff-create` |

**Orchestration Commands** (10) - **NEW in v2.7.0!**

๐Ÿ”’ Security Commands (3)

| Command | Purpose | Duration | Key Features |
|---------|---------|----------|--------------|
| **`/audit`** | Comprehensive security audit | 2-4 hours | OWASP Top 10, pentesting, infrastructure review, RCA |
| **`/vulnerability-scan`** | CVE & dependency scanning | 30-60 min | NVD correlation, SAST, exploit detection, auto-fix |
| **`/compliance-check`** | Regulatory compliance validation | 1-2 hours | GDPR, SOC2, HIPAA, PCI-DSS, ISO 27001, CCPA |

โšก Performance Commands (2)

| Command | Purpose | Duration | Key Features |
|---------|---------|----------|--------------|
| **`/profile`** | Performance profiling | 15min-2h | Bottleneck analysis, Core Web Vitals, query optimization |
| **`/benchmark`** | Load testing | 5-30 min | Scenario generation, stress testing, capacity planning |

๐Ÿ”ง Operations Commands (3)

| Command | Purpose | Duration | Key Features |
|---------|---------|----------|--------------|
| **`/deploy-validate`** | Pre-deployment validation | 10-20 min | Test suite, config safety, go/no-go decision |
| **`/health-check`** | System health verification | 5-15 min | Multi-layer checks, anomaly detection, alerting |
| **`/incident-response`** | Production incident coordination | 30min-2h | Emergency triage, RCA, blameless postmortem |

๐Ÿ“Š Quality Commands (2)

| Command | Purpose | Duration | Key Features |
|---------|---------|----------|--------------|
| **`/code-health`** | Codebase quality assessment | 20-40 min | Quality metrics, test coverage, maintainability scoring |
| **`/debt-analysis`** | Technical debt identification | 30-60 min | Debt quantification, ROI prioritization, refactoring roadmap |

### ๐Ÿค– Core Agents (8 Production-Ready)
Expert-level assistance for complex development tasks:

| Agent | Expertise | Best For |
|-------|-----------|----------|
| **`@config-safety-reviewer`** | Configuration safety, production reliability | Pool sizes, timeouts, connection limits, magic numbers |
| **`@test-engineer`** | Testing strategies, test creation, QA | Unit tests, integration tests, coverage analysis |
| **`@docs-writer`** | Technical documentation, user guides | API docs, README files, troubleshooting guides |
| **`@systems-architect`** | System design, technology evaluation | Architecture reviews, design decisions, scalability |
| **`@root-cause-analyzer`** | Comprehensive RCA, systematic debugging | Production incidents, complex bugs, performance issues |
| **`@security-auditor`** | Security assessment, OWASP compliance | Security audits, vulnerability analysis, compliance |
| **`@performance-tuner`** | Performance optimization, profiling | Performance issues, bottleneck analysis, optimization |
| **`@refactor-expert`** | Code refactoring, clean architecture | Technical debt, code modernization, SOLID principles |

### ๐ŸŒ Extended Subagents (133 Specialists)

**Total: 141 agents** (8 core + 133 subagents) organized in `subagents/` directory

Organized by team and function across 10 color-coded categories:

- **๐Ÿ”ต Engineering** (54) - Backend, frontend, mobile, DevOps, security, testing, 16 languages
- **๐Ÿ† Leadership** (14) - Finance, strategy, risk, compliance
- **๐ŸŒฑ Marketing** (11) - Content, social media, growth, SEO
- **๐Ÿ’œ Product** (9) - Product management, requirements, research, analytics
- **๐Ÿง  AI/Automation** (9) - AI/ML engineering, automation, prompt engineering
- **๐Ÿ’™ Account/CS** (8) - Account management, customer success, sales, support
- **๐ŸŽจ Design** (7) - UI/UX design, visual design, branding (9.7/10 quality โญ)
- **๐Ÿ”ถ Research** (7) - Market research, competitive intelligence, data research
- **๐ŸŒŠ Operations** (6) - Analytics, infrastructure, support

**Quality**: 9.7/10 (Exceptional - validated across all agents)

**See:** [Complete Agent Catalog](subagents/README.md) | [Agent Index](subagents/AGENT-INDEX.md) | [Technical Reference](docs/TECHNICAL-REFERENCE.md)

### โœจ Skills (8 Autonomous) - **NEW!**
Automatic background helpers that work while you code:

| Skill | What It Does | Triggers On |
|-------|--------------|-------------|
| **`code-reviewer`** | Real-time code quality checks | File edits, saves |
| **`test-generator`** | Suggests missing tests automatically | New functions, untested code |
| **`git-commit-helper`** | Generates commit messages from diff | `git diff --staged` |
| **`security-auditor`** | Detects vulnerabilities (SQL injection, XSS) | Auth code, API endpoints |
| **`secret-scanner`** | Blocks commits with exposed secrets | Pre-commit, API keys in code |
| **`dependency-auditor`** | Checks dependencies for CVEs | package.json changes |
| **`api-documenter`** | Auto-generates OpenAPI specs | API routes added |
| **`readme-updater`** | Keeps README current | Project changes, features |

**Skills vs Agents:** Skills work **automatically** in the background. Agents require **manual invocation** (`@agent`) for deep analysis.

**Learn more:** [Skills Guide](skills/README.md) ยท [Getting Started](GETTING-STARTED.md) ยท [Architecture](ARCHITECTURE.md)

### ๐Ÿ“ Curated Prompt Templates (20+)
Ready-to-use prompts for common development scenarios:

- **Frontend Development**: React, Vue, Angular, JavaScript/TypeScript
- **Backend Development**: APIs, databases, authentication, microservices
- **Debugging & Analysis**: Error analysis, performance troubleshooting
- **Best Practices**: Clean code, security, refactoring strategies

### ๐Ÿ“ Development Standards
Professional coding standards and style guides:

- **JavaScript/TypeScript** style guide with ESLint/Prettier configs
- **Git workflows** with conventional commits
- **Code review** checklists and PR templates
- **Team collaboration** guidelines

### ๐Ÿ’ก Real-World Examples
Complete workflow demonstrations:

- **React App Setup**: Full modern React application from scratch
- **API Development**: RESTful APIs with testing and documentation
- **Performance Optimization**: Systematic performance improvement
- **CI/CD Pipelines**: Automated testing and deployment

### ๐Ÿ† Quality Achievements

**v2.6.0 Quality Metrics**:
- **Overall Quality**: 9.7/10 (Exceptional - up from 7.1/10 in v2.5.0)
- **YAML Validation**: 100% (all 141 agents valid)
- **Content Quality**: 9.7/10 (comprehensive examples and best practices)
- **Organization**: 100% (perfect categorization and structure)
- **Cross-References**: 100% (all integrations validated)

**Validation**: All agents tested across 4 validation tiers - YAML, Content, Organization, Cross-References

---

## ๐Ÿ”— Related Projects & Ecosystem

Looking to extend your Claude Code capabilities further? Check out these companion repositories:

### ๐Ÿญ [Claude Code Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory)
**Build your own custom Skills and Agents at scale**

A comprehensive toolkit for generating production-ready Claude Skills and Agents without starting from scratch. Perfect when you need specialized capabilities beyond what's available in pre-built collections.

**Key Features:**
- **Skills Factory**: Generate multi-file skill packages with Python code, documentation, and examples
- **Agents Factory**: Create single-file specialist agents with enhanced YAML configuration
- **Smart Architecture**: Automatically determines when functional code is needed vs. prompt-only approaches
- **7 Reference Examples**: Financial analysis, AWS architecture, content research, Microsoft 365, and more
- **Enterprise Standards**: Type-annotated code, error handling, and composable design

**Best For:** Developers who need custom domain-specific capabilities, teams building proprietary workflows, or organizations requiring specialized AI tools tailored to their tech stack.

**Use Case:** "I need a skill that analyzes our company's specific Terraform patterns" โ†’ Use Skill Factory to generate it

### ๐Ÿ“š [Claude Skills Library](https://github.com/alirezarezvani/claude-skills)
**Production-ready skill packages for professional domains**

A curated collection of specialized skill packages combining best practices, analysis tools, and strategic frameworks for various professional roles. Deploy expert-level capabilities immediately.

**Available Collections:**
- **Marketing** (3 packages): Content strategy, demand generation, product marketing
- **C-Level Advisory** (2 packages): CEO and CTO strategic guidance
- **Product Team** (6 packages): Product management, UX research, design systems, agile delivery
- **Project Management** (6 packages): Jira, Confluence, Scrum, PMO, Atlassian integration
- **Engineering** (9 packages): Architecture, fullstack, QA, DevOps, security, code review
- **AI/ML/Data** (Coming soon): Data science and machine learning workflows

**Key Benefits:**
- **40%+ time savings** through domain-specific guidance
- **30%+ quality improvements** with built-in best practices
- **Python CLI utilities** for automated analysis and reporting
- **Ready-to-use templates** for immediate deployment

**Best For:** Teams needing enterprise-grade expertise packages, professionals seeking domain-specific guidance, or organizations standardizing workflows across multiple roles.

**Use Case:** "I need comprehensive product management workflows with templates and frameworks" โ†’ Use Claude Skills Library

---

### ๐Ÿ“– Complete Ecosystem Guide

**New to Claude Code augmentation?** Read the comprehensive guide with FAQs, installation instructions, and detailed use cases:

**[๐Ÿ“– Complete Augmentation Guide](https://gist.github.com/alirezarezvani/a0f6e0a984d4a4adc4842bbe124c5935)** (GitHub Gist)

This guide answers:
- What is Claude Code augmentation and why should I use it?
- How do Skills, Agents, Commands, and Hooks work?
- Which repository should I use for my needs?
- Step-by-step installation for all three repositories
- 20+ FAQs covering installation, usage, and troubleshooting
- 5+ detailed use cases with code examples

---

### ๐ŸŽฏ How These Projects Work Together

| Your Need | Use This Repository |
|-----------|-------------------|
| **Ready-to-use utilities** (scaffolding, code review, testing, docs) | **Claude Code Tresor** (this repo) |
| **Build custom skills** for your specific domain/tech stack | [**Skill Factory**](https://github.com/alirezarezvani/claude-code-skill-factory) |
| **Deploy pre-built expertise** for professional roles | [**Skills Library**](https://github.com/alirezarezvani/claude-skills) |

**Complete Workflow Example:**
1. **Start here** (Claude Code Tresor) โ†’ Install 8 skills + 8 agents + 4 commands for development workflows
2. **Browse Skills Library** โ†’ Add marketing, product, or engineering domain expertise packages
3. **Build custom with Skill Factory** โ†’ Generate proprietary skills for your company's unique needs

All three repositories are **MIT licensed** and maintained by Alireza Rezvani.

---

## ๐Ÿ“š Documentation

**[Complete Documentation โ†’](documentation/README.md)**

### Quick Links
- **[Installation Guide โ†’](documentation/guides/installation.md)** - Install in 5 minutes
- **[Getting Started โ†’](documentation/guides/getting-started.md)** - Your first workflow
- **[FAQ โ†’](documentation/reference/faq.md)** - Common questions answered
- **[Troubleshooting โ†’](documentation/guides/troubleshooting.md)** - Fix issues

### Full Documentation
- **[User Guides โ†’](documentation/guides/)** - Installation, configuration, troubleshooting, migration, contributing
- **[Technical Reference โ†’](documentation/reference/)** - Complete skills, agents, and commands documentation
- **[Workflows โ†’](documentation/workflows/)** - Git workflow, GitHub automation, agent-skill integration

---

## ๐Ÿš€ Quick Start

### Option 1: Automated Installation (Recommended)

```bash
# Clone the repository
git clone https://github.com/alirezarezvani/claude-code-tresor.git
cd claude-code-tresor

# Run the installation script (installs skills + agents + commands)
chmod +x scripts/install.sh
./scripts/install.sh
```

**What's installed:**
- โœ… **8 Skills** - Automatic background helpers
- โœ… **8 Agents** - Manual expert sub-agents
- โœ… **4 Commands** - Workflow automation

**First time?** See [GETTING-STARTED.md](GETTING-STARTED.md) for 5-minute quick start.

### Option 2: Manual Installation

```bash
# Copy skills to Claude Code directory
cp -r skills/* ~/.claude/skills/

# Copy commands to Claude Code directory
cp -r commands/* ~/.claude/commands/

# Copy agents to Claude Code directory
cp -r agents/* ~/.claude/agents/

# Copy resources for reference
cp -r prompts standards examples ~/claude-code-resources/
```

### Option 3: Selective Installation

```bash
# Install only autonomous skills (v2.0+)
./scripts/install.sh --skills-only

# Install only slash commands
./scripts/install.sh --commands-only

# Install only agents
./scripts/install.sh --agents-only

# Install only resources (prompts, standards, examples)
./scripts/install.sh --resources-only
```

---

## ๐Ÿ› ๏ธ Usage Examples

### ๐Ÿ—๏ธ Project Setup
```bash
# Create a complete React application
/scaffold react-app my-project --typescript --tailwind --tests

# Generate API endpoints with tests
/scaffold express-api user-service --auth --database --tests
```

### ๐Ÿ” Code Review
```bash
# Configuration safety review
@config-safety-reviewer Review database connection pool settings for:
- Pool size limits
- Timeout configurations
- Connection limit safety
- Magic numbers

# Security audit
@security-auditor Please review this component for:
- OWASP Top 10 vulnerabilities
- Authentication/authorization
- Input validation

# Automated PR review
/review --scope pr --checks security,performance,configuration
```

### ๐Ÿงช Testing
```bash
# Generate comprehensive tests
@test-engineer Create unit tests for this utility function with:
- Edge case coverage
- Error handling tests
- Performance benchmarks

# Automated test generation
/test-gen --file components/UserCard.tsx --framework jest
```

### ๐Ÿ“– Documentation
```bash
# Generate API documentation
/docs-gen api --format openapi --include-examples

# Create user guides
@docs-writer Create a user guide for this authentication system with:
- Setup instructions
- Usage examples
- Troubleshooting guide
```

---

## ๐Ÿ“ Repository Structure

```
claude-code-tresor/
โ”œโ”€โ”€ ๐Ÿ“– README.md # This file - complete overview
โ”œโ”€โ”€ โš–๏ธ LICENSE # MIT License
โ”œโ”€โ”€ ๐Ÿค CONTRIBUTING.md # Contribution guidelines
โ”œโ”€โ”€ ๐Ÿ“š GETTING-STARTED.md # 5-minute quick start guide
โ”œโ”€โ”€ ๐Ÿ—๏ธ ARCHITECTURE.md # 3-tier system explanation
โ”œโ”€โ”€ ๐Ÿ”„ MIGRATION-GUIDE.md # Upgrade guide for existing users
โ”œโ”€โ”€
โ”œโ”€โ”€ โœจ skills/ # 8 Autonomous Skills (NEW v2.0!)
โ”‚ โ”œโ”€โ”€ development/ # code-reviewer, test-generator, git-commit-helper
โ”‚ โ”œโ”€โ”€ security/ # security-auditor, secret-scanner, dependency-auditor
โ”‚ โ”œโ”€โ”€ documentation/ # api-documenter, readme-updater
โ”‚ โ”œโ”€โ”€ README.md # Skills guide
โ”‚ โ””โ”€โ”€ TEMPLATES.md # Custom skill templates
โ”œโ”€โ”€
โ”œโ”€โ”€ ๐Ÿค– agents/ # 8 Specialized Agents
โ”‚ โ”œโ”€โ”€ code-reviewer/ # Code quality expert
โ”‚ โ”œโ”€โ”€ test-engineer/ # Testing specialist
โ”‚ โ”œโ”€โ”€ docs-writer/ # Documentation expert
โ”‚ โ”œโ”€โ”€ architect/ # System design expert
โ”‚ โ”œโ”€โ”€ debugger/ # Debugging specialist
โ”‚ โ”œโ”€โ”€ security-auditor/ # Security expert
โ”‚ โ”œโ”€โ”€ performance-tuner/ # Performance optimization
โ”‚ โ””โ”€โ”€ refactor-expert/ # Code refactoring
โ”œโ”€โ”€
โ”œโ”€โ”€ โšก commands/ # 4 Slash Commands
โ”‚ โ”œโ”€โ”€ development/ # Project scaffolding and tools
โ”‚ โ”œโ”€โ”€ testing/ # Test generation and analysis
โ”‚ โ”œโ”€โ”€ documentation/ # Doc generation utilities
โ”‚ โ””โ”€โ”€ workflow/ # PR reviews and automation
โ”œโ”€โ”€
โ”œโ”€โ”€ ๐Ÿ“ prompts/ # Prompt Templates
โ”‚ โ”œโ”€โ”€ code-generation/ # Frontend & backend prompts
โ”‚ โ”œโ”€โ”€ debugging/ # Error analysis prompts
โ”‚ โ”œโ”€โ”€ architecture/ # System design prompts
โ”‚ โ””โ”€โ”€ best-practices/ # Code quality prompts
โ”œโ”€โ”€
โ”œโ”€โ”€ ๐Ÿ“ standards/ # Development Standards
โ”‚ โ”œโ”€โ”€ style-guides/ # Language-specific guides
โ”‚ โ”œโ”€โ”€ git-workflows/ # Git best practices
โ”‚ โ””โ”€โ”€ templates/ # PR and issue templates
โ”œโ”€โ”€
โ”œโ”€โ”€ ๐Ÿ’ก examples/ # Real-World Examples
โ”‚ โ”œโ”€โ”€ workflows/ # Complete project workflows
โ”‚ โ”œโ”€โ”€ integrations/ # Service integration examples
โ”‚ โ””โ”€โ”€ case-studies/ # Detailed project case studies
โ”œโ”€โ”€
โ”œโ”€โ”€ ๐Ÿ“ฆ sources/ # Extended Source Library
โ”‚ โ”œโ”€โ”€ agents/ # 200+ additional agents
โ”‚ โ””โ”€โ”€ slash-commands/ # Advanced command utilities
โ”œโ”€โ”€
โ””โ”€โ”€ ๐Ÿ”ง scripts/ # Utility Scripts
โ”œโ”€โ”€ install.sh # Easy installation
โ””โ”€โ”€ update.sh # Update utilities
```

---

## ๐ŸŽฏ Getting Started Paths

### ๐Ÿ‘ถ New to Claude Code?
1. **Install**: Run `./scripts/install.sh` (installs skills + agents + commands)
2. **Observe**: Skills work automatically - start coding and watch them detect issues
3. **Try Command**: `/scaffold react-component TestComponent --tests`
4. **Invoke Agent**: `@config-safety-reviewer` for configuration safety, `@security-auditor` for security analysis
5. **Learn**: Browse [GETTING-STARTED.md](GETTING-STARTED.md) for 5-min quick start

### ๐Ÿƒโ€โ™‚๏ธ Ready to Build?
1. **Skills monitor**: Automatic background checks (code quality, security, tests)
2. **Agent analysis**: `@config-safety-reviewer`, `@security-auditor`, `@test-engineer` for deep dives
3. **Command workflows**: `/review --scope staged`, `/test-gen --file utils.js`
4. **Full workflow**: Skills detect โ†’ Agents analyze โ†’ Commands orchestrate

### ๐Ÿ‘ฅ Team Lead?
1. **Standards**: Implement `standards/style-guides/javascript.md`
2. **Workflows**: Set up `standards/git-workflows/conventional-commits.md`
3. **Templates**: Use `standards/templates/` for consistency
4. **Training**: Share `examples/` with your team

### ๐Ÿ”ง Power User?
1. **Customize**: Adapt templates in `prompts/` for your needs
2. **Extend**: Explore additional utilities in `sources/`
3. **Build Custom**: Use [Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory) to generate proprietary skills
4. **Add Expertise**: Browse [Skills Library](https://github.com/alirezarezvani/claude-skills) for domain packages (marketing, product, engineering)
5. **Contribute**: Add your own utilities following `CONTRIBUTING.md`
6. **Automate**: Build custom workflows using the utilities

---

## ๐Ÿš€ Updates & Maintenance

### Automatic Updates
```bash
# Update all utilities
./scripts/update.sh

# Check for updates without applying
./scripts/update.sh --check

# Update specific components
./scripts/update.sh --commands-only
```

### Stay Current
- โญ **Star this repository** to get notified of updates
- ๐Ÿ‘€ **Watch releases** for new features and utilities
- ๐Ÿ“ข **Join discussions** to suggest improvements
- ๐Ÿค **Contribute** your own utilities and improvements

---

## ๐Ÿค Contributing

We welcome contributions from the community! Here's how to get involved:

### Quick Contributions
- ๐Ÿ› **Report bugs** in GitHub Issues
- ๐Ÿ’ก **Suggest features** in GitHub Discussions
- ๐Ÿ“– **Improve documentation** with clarifications
- โญ **Share your experience** with others

### Code Contributions
- ๐Ÿ”ง **Add new utilities** following our standards
- ๐ŸŽจ **Improve existing code** with enhancements
- ๐Ÿงช **Add test coverage** for utilities
- ๐Ÿ“š **Create examples** for complex workflows

### Process
1. **Fork** the repository
2. **Create** a feature branch: `git checkout -b feature/amazing-utility`
3. **Follow** our standards in `standards/` directory
4. **Test** your changes thoroughly
5. **Submit** a pull request using our template

See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.

---

## ๐Ÿ“Š Project Stats

**This Repository:**
- **โœจ Skills**: 8 autonomous background helpers (v2.0+)
- **๐Ÿค– Agents**: 133 total (8 core + 125 specialized) organized by team (v2.5+)
- **โšก Commands**: 19 total (4 dev + 5 workflow + 10 orchestration) (v2.7+)
- **Development**: scaffold, review, test-gen, docs-gen
- **Workflow**: prompt-create, prompt-run, todo-add, todo-check, handoff-create
- **Orchestration**: audit, vulnerability-scan, compliance-check, profile, benchmark, deploy-validate, health-check, incident-response, code-health, debt-analysis
- **๐Ÿ“ Prompt Templates**: 20+ battle-tested prompts
- **๐Ÿ“ Standards**: 5 comprehensive style guides
- **๐Ÿ’ก Examples**: 10+ real-world workflows
- **๐Ÿ“ฆ Source Library**: 200+ additional components
- **โฑ๏ธ Installation Time**: < 2 minutes
- **๐Ÿ“ˆ Version**: 2.7.0 (Major update: Orchestration Commands!)

**Complete Ecosystem:**
- **๐Ÿญ [Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory)**: Generate unlimited custom skills and agents
- **๐Ÿ“š [Skills Library](https://github.com/alirezarezvani/claude-skills)**: 26+ pre-built professional domain packages (Marketing, Product, Engineering, PM, C-Level)
- **๐Ÿ”„ Active Development**: All three repositories continuously updated
- **โš–๏ธ License**: MIT across all projects

---

## ๐Ÿ† Success Stories

### Individual Developers
> *"Claude Code Tresor cut my React setup time from hours to minutes. The testing utilities alone saved me weeks of work!"* - Sarah K., Frontend Developer

### Development Teams
> *"Our code quality improved dramatically after implementing the standards and review workflows. PRs are now focused on logic, not style."* - Mike R., Tech Lead

### Agencies & Consultancies
> *"We use Claude Code Tresor as our standard toolkit. It ensures consistency across all client projects and speeds up delivery."* - Jennifer L., CTO

---

## ๐Ÿ“„ License & Usage

This project is licensed under the **MIT License** - see [LICENSE](LICENSE) for details.

### You Can:
- โœ… Use for commercial and personal projects
- โœ… Modify and distribute
- โœ… Create derivative works
- โœ… Include in proprietary software

### Requirements:
- ๐Ÿ“„ Include copyright notice and license
- ๐Ÿท๏ธ Credit original author when sharing

---

## ๐Ÿ™ Acknowledgments

- **Claude Code Team**: For creating an amazing development platform
- **Open Source Community**: For inspiration and best practices
- **Contributors**: Everyone who has helped improve these utilities
- **Users**: For feedback and real-world testing

Special thanks to developers worldwide who believe in sharing knowledge and tools to make development better for everyone.

---

## ๐Ÿ“ž Support & Community

### Get Help
- ๐Ÿ“‹ **Issues**: [GitHub Issues](https://github.com/alirezarezvani/claude-code-tresor/issues) for bugs and feature requests
- ๐Ÿ’ฌ **Discussions**: [GitHub Discussions](https://github.com/alirezarezvani/claude-code-tresor/discussions) for questions and ideas
- ๐Ÿ“– **Documentation**: Browse `examples/` directory for detailed guides
- ๐Ÿ” **Search**: Use repository search to find specific utilities

### Connect
- ๐Ÿฆ **Twitter**: [@alirezarezvani](https://twitter.com/alirezarezvani)
- ๐Ÿ’ผ **LinkedIn**: [Alireza Rezvani](https://linkedin.com/in/alirezarezvani)
- ๐ŸŒ **Website**: [https://alirezarezvani.com] (Portfolio Website)
- ๐ŸŒ **Claude Code Tutorials and Guides**: [https://medium.com/@alirezarezvani] (Medium Blog)
### Professional Support
For professional support, custom utilities, or team training:
- ๐Ÿ“ง **Email**: [Your professional email]
- ๐Ÿ’ผ **Consulting**: Available for custom development and team training

---

## โญ Star History

If you find Claude Code Tresor valuable, please consider starring the repository! It helps others discover these utilities and motivates continued development.

[![Star History Chart](https://api.star-history.com/svg?repos=alirezarezvani/claude-code-tresor&type=Date)](https://star-history.com/#alirezarezvani/claude-code-tresor&Date)

---

**Made with โค๏ธ by [Alireza Rezvani](https://github.com/alirezarezvani)**

*Empowering developers with world-class Claude Code utilities*

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
[![Code Quality](https://img.shields.io/badge/Code%20Quality-A+-brightgreen.svg)](standards/)

**๐Ÿš€ [Get Started Now](#-quick-start) | ๐Ÿ“š [View Examples](examples/) | ๐Ÿค [Contribute](CONTRIBUTING.md)**