alirezarezvani/claude-code-tresor

Claude Code Tresor 🏆

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

Also available on Smithery:

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 to build custom skills, or browse the Claude Skills Library for pre-built professional domain packages. See Related Projects for details.

📖 Complete Augmentation Guide - 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

✨ What's Included

🚀 Slash Commands (19 Total)

Development Commands (4):

Tresor Workflow Commands (5):

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

🤖 Core Agents (8 Production-Ready)

Expert-level assistance for complex development tasks:

🌍 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 | Agent Index | Technical Reference

✨ Skills (8 Autonomous) - NEW!

Automatic background helpers that work while you code:

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

Learn more: Skills Guide · Getting Started · Architecture

📝 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

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

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 (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

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 →

Quick Links

• Installation Guide → - Install in 5 minutes
• Getting Started → - Your first workflow
• FAQ → - Common questions answered
• Troubleshooting → - Fix issues

Full Documentation

• User Guides → - Installation, configuration, troubleshooting, migration, contributing
• Technical Reference → - Complete skills, agents, and commands documentation
• Workflows → - Git workflow, GitHub automation, agent-skill integration

🚀 Quick Start

Option 1: Automated Installation (Recommended)

# 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 for 5-minute quick start.

Option 2: Manual Installation

# 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

# 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

# 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

# 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

# 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

# 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 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 to generate proprietary skills
4. Add Expertise: Browse Skills Library 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

# 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 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: Generate unlimited custom skills and agents
• 📚 Skills Library: 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 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 for bugs and feature requests
• 💬 Discussions: GitHub Discussions for questions and ideas
• 📖 Documentation: Browse examples/ directory for detailed guides
• 🔍 Search: Use repository search to find specific utilities

Connect

• 🐦 Twitter: @alirezarezvani
• 💼 LinkedIn: Alireza Rezvani
• 🌐 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.