alirezarezvani/claude-code-tresor

Claude Code 유틸리티의 세계적인 컬렉션: 개발 워크플로 (workflow)를 강화하는 자율 기술 (autonomous skills), 전문가 에이전트 (expert agents), 슬래시 명령어 (slash commands) 및 프롬프트 (prompts)를 제공합니다.

저자 (Author): Alireza Rezvani
생성일 (Created): 2025년 9월 16일
업데이트일 (Updated): 2025년 12월 17일 (v2.7.0 - Tresor 워크플로 프레임워크 (Workflow Framework))
품질 (Quality): 9.7/10 (Exceptional)
라이선스 (License): MIT
저장소 (Repository): https://github.com/alirezarezvani/claude-code-tresor

주요 릴리스 (Major Release) - 10개의 새로운 오케스트레이션 (Orchestration) 명령어 + Tresor 워크플로 프레임워크 (Workflow Framework)!

• 🚀
  10가지 오케스트레이션 (Orchestration) 명령어- 프로덕션급 (Production-grade) 지능형 오케스트레이션 (12,682줄의 코드)
• 🔒
  보안 (Security):/audit, /vulnerability-scan, /compliance-check
• ⚡
  성능 (Performance):/profile, /benchmark
• 🔧
  운영 (Operations):/deploy-validate, /health-check, /incident-response
• 📊
  품질 (Quality):/code-health, /debt-analysis
• 🔒
• 🤖
  지능형 에이전트 선택 (Intelligent Agent Selection)- 기술 스택 (tech stack)에 따라 141개의 에이전트 중에서 자동 선택
• 🔄
  다단계 오케스트레이션 (Multi-Phase Orchestration)- 병렬 및 순차 실행을 포함한 3~4단계 단계
• 🛡️
  의존성 검증 (Dependency Verification)- 안전한 병렬 에이전트 실행 보장
• 🔄
  Tresor 워크플로 프레임워크 (Workflow Framework)- 메타 프롬프팅 (Meta-prompting), 할 일 관리 (todo management), 컨텍스트 핸드오프 (context handoff)
• 📦
  통합된 구조 (Consolidated Structure)- /subagents/ 내의 통합된 에이전트 디렉토리 (총 133개 에이전트)

품질 우수 릴리스 (Quality Excellence Release) - 9.7/10의 탁월한 품질 등급 달성!

• 🎨
  디자인 카테고리 변환 (Design Category Transformation)- 4.0에서 8.0/10으로 개선 (+100% 품질 향상)
• 📚
  12개의 강화된 예시 (Enhanced Examples)- 주요 에이전트에 포괄적인 사용 예시 추가
• 📋
  일관성 개선 (Improved Consistency)- 9개의 특화된 에이전트에 표준 섹션 추가
• ✅
  베스트 프랙티스 (Best Practices)- config-safety-reviewer 및 security-auditor에 추가
• 🤝
  협업 가이드 (Collaboration Guide)- 팀 간 워크플로 문서 작성 완료
• 📖
  간소화된 문서 (Streamlined Docs)- 21개의 파일을 3개의 가이드와 아카이브로 통합

하위 호환성 유지 (Backward Compatible) - v2.5.0으로부터 중단되는 변경 사항(breaking changes) 없음

에이전트 재편성 및 확장 (Agent Reorganization & Extension) - 141개의 에이전트가 팀 및 기능별로 정리되었습니다!

• 🏗️
  새로운 구조 (New Structure)- subagents/

10개의 색상으로 구분된 팀 카테고리가 포함된 디렉토리 - 📦
총 141개의 에이전트 (141 Total Agents)- 모든 개발 도메인에 걸쳐 8개의 코어 에이전트 + 133개의 서브에이전트 (subagents) - 🔄
코어 에이전트 이름 변경 (Core Agent Renaming)- systems-architect, config-safety-reviewer, root-cause-analyzer - 🎨
색상 코드 시스템 (Color Coding System)- 시각적 팀 식별 (10가지 팀 색상) - 📚
포괄적인 문서화 (Comprehensive Documentation)- 450KB 분량의 가이드, 카탈로그 및 참조 자료

중대한 변경 사항 (BREAKING CHANGES) (v2.5.0 전용):

@architect

→ @systems-architect

@code-reviewer

→ @config-safety-reviewer

@debugger

→ @root-cause-analyzer

Claude Code Tresor은 Claude Code 사용자들을 위한 **전문가급 유틸리티 (professional-grade utilities)**의 궁극적인 컬렉션입니다. 개인 개발자이든 팀의 일원이든, 이 리포지토리는 귀하의 개발 워크플로 (workflow)에 원활하게 통합되는 검증된 도구들을 제공합니다.

🚀 프로덕션 준비 완료 (Production-Ready): 모든 유틸리티는 실제 프로젝트에서 테스트되고 사용되었습니다.
📚 포괄적 (Comprehensive): 전체 개발 라이프사이클 (development lifecycle)을 다룹니다.
🛠️ 간편한 설치 (Easy Installation): 자동 업데이트가 포함된 단일 명령 설정.
🎨 맞춤 설정 가능 (Customizable): 귀하의 특정 요구 사항과 기술 스택 (tech stack)에 맞춰 템플릿을 조정할 수 있습니다.
👥 팀 친화적 (Team-Friendly): 협업 가이드라인 및 표준을 포함합니다.
📖 잘 정리된 문서 (Well-Documented): 모든 구성 요소에는 상세한 예시와 사용 가이드가 포함되어 있습니다.

💡 에코시스템 팁 (Ecosystem Tip): 더 많은 것을 찾고 계신가요? 커스텀 스킬을 구축하려면 Claude Code Skill Factory를 확인하거나, 미리 구축된 전문 도메인 패키지를 보려면 Claude Skills Library를 살펴보세요. 자세한 내용은 관련 프로젝트 (Related Projects)를 참조하십시오.

📖 완전한 증강 가이드 (Complete Augmentation Guide)- FAQ, 사용 사례 및 설치 지침이 포함된 포괄적인 가이드

개발 명령 (Development Commands) (4):

명령 (Command)	목적 (Purpose)	사용 예시 (Example Usage)
/scaffold	프로젝트 구조, 컴포넌트 및 보일러플레이트 (Boilerplate) 생성	/scaffold react-component UserProfile --hooks --tests
/review	보안 및 성능 분석을 포함한 자동 코드 리뷰 (Automated code review)	/review --scope staged --checks security,performance
/test-gen	포괄적인 테스트 스위트 (Test suites) 자동 생성	/test-gen --file utils.js --coverage 90
/docs-gen	코드와 주석으로부터 문서 생성	/docs-gen api --format openapi

Tresor 워크플로 명령 (Tresor Workflow Commands) (5):

명령 (Command)	목적 (Purpose)	사용 예시 (Example Usage)
/prompt-create	복잡한 작업을 위한 최적화된 프롬프트 (Prompts) 생성	/prompt-create Build user authentication system
/prompt-run	서브 에이전트 (Sub-agents)에서 생성된 프롬프트 실행	/prompt-run 001 --parallel
/todo-add	대화 도중 아이디어 캡처	/todo-add Fix performance issue in API
/todo-check	캡처된 할 일(Todos) 검토 및 작업 수행	/todo-check
/handoff-create	컨텍스트 인계 (Context handoff) 문서 생성	/handoff-create

오케스트레이션 명령 (Orchestration Commands) (10) - v2.7.0에서 신규 추가!

🔒 보안 명령 (Security Commands) (3)

명령 (Command)	목적 (Purpose)	소요 시간 (Duration)	주요 기능 (Key Features)
/audit	포괄적인 보안 감사 (Security audit)	2-4시간	OWASP Top 10, 침투 테스트 (Pentesting), 인프라 검토, 근본 원인 분석 (RCA)
/vulnerability-scan	CVE 및 의존성 (Dependency) 스캔	30-60분	NVD 상관관계 분석, 정적 애플리케이션 보안 테스트 (SAST), 익스플로잇 (Exploit) 탐지, 자동 수정
/compliance-check	규제 준수 (Regulatory compliance) 검증	1-2시간	GDPR, SOC2, HIPAA, PCI-DSS, ISO 27001, CCPA

⚡ 성능 명령 (Performance Commands) (2)

명령 (Command)	목적 (Purpose)	소요 시간 (Duration)	주요 기능 (Key Features)
/profile	성능 프로파일링 (Performance profiling)	15분-2시간	병목 현상 (Bottleneck) 분석, 코어 웹 바이탈 (Core Web Vitals), 쿼리 최적화
/benchmark	부하 테스트 (Load testing)	5-30분	시나리오 생성, 스트레스 테스트 (Stress testing), 용량 계획 (Capacity planning)

🔧 운영 명령 (Operations Commands) (3)

명령 (Command)	목적 (Purpose)	소요 시간 (Duration)	주요 특징 (Key Features)
/deploy-validate	배포 전 검증 (Pre-deployment validation)	10-20분	테스트 스위트 (Test suite), 설정 안전성 (Config safety), 진행/중단 결정 (Go/no-go decision)
/health-check	시스템 상태 확인 (System health verification)	5-15분	다층 점검 (Multi-layer checks), 이상 탐지 (Anomaly detection), 알림 (Alerting)
/incident-response	운영 장애 대응 (Production incident coordination)	30분-2시간	긴급 분류 (Emergency triage), 근본 원인 분석 (RCA), 비난 없는 사후 검토 (Blameless postmortem)

📊 품질 명령 (Quality Commands) (2)

명령 (Command)	목적 (Purpose)	소요 시간 (Duration)	주요 특징 (Key Features)
/code-health	코드베이스 품질 평가 (Codebase quality assessment)	20-40분	품질 지표 (Quality metrics), 테스트 커버리지 (Test coverage), 유지보수성 점수 (Maintainability scoring)
/debt-analysis	기술 부채 식별 (Technical debt identification)	30-60분	부채 정량화 (Debt quantification), ROI 우선순위 지정 (ROI prioritization), 리팩터링 로드맵 (Refactoring roadmap)

복잡한 개발 작업을 위한 전문가 수준의 지원:

에이전트 (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 문서 (API docs), README 파일 (README files), 문제 해결 가이드 (Troubleshooting guides)
@systems-architect	시스템 설계 (System design), 기술 평가 (Technology evaluation)	아키텍처 리뷰 (Architecture reviews), 설계 결정 (Design decisions), 확장성 (Scalability)
@root-cause-analyzer	종합적인 RCA (Comprehensive RCA), 체계적인 디버깅 (Systematic debugging)	운영 장애 (Production incidents), 복잡한 버그 (Complex bugs), 성능 문제 (Performance issues)
@security-auditor	보안 평가 (Security assessment), OWASP 준수 (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 원칙 (SOLID principles)

총합: 141개 에이전트 (subagents/ 디렉토리에 구성된 8개의 핵심 에이전트 + 133개의 하위 에이전트)

10개의 색상별 카테고리에 따라 팀 및 기능별로 구성되어 있습니다:

🔵 Engineering(54) - 백엔드 (Backend), 프론트엔드 (Frontend), 모바일 (Mobile), 데브옵스 (DevOps), 보안 (Security), 테스트 (Testing), 16개 언어
🏆 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 엔지니어링 (AI/ML Engineering), 자동화 (Automation), 프롬프트 엔지니어링 (Prompt Engineering)
💙 Account/CS(8) - 계정 관리 (Account Management), 고객 성공 (Customer Success), 영업 (Sales), 지원 (Support)
🎨 Design(7) - UI/UX 디자인 (UI/UX Design), 비주얼 디자인 (Visual Design), 브랜딩 (Branding) (품질 9.7/10 ⭐)
🔶 Research(7) - 시장 조사 (Market Research), 경쟁 정보 (Competitive Intelligence), 데이터 리서치 (Data Research)
🌊 Operations(6) - 분석 (Analytics), 인프라 (Infrastructure), 지원 (Support)

품질 (Quality): 9.7/10 (Exceptional - 모든 에이전트에 대해 검증됨)

보기: 전체 에이전트 카탈로그 (Complete Agent Catalog) | 에이전트 인덱스 (Agent Index) | 기술 참조 (Technical Reference)

코딩하는 동안 백그라운드에서 작동하는 자동 백그라운드 헬퍼 (Automatic background helpers):

기술 (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	diff로부터 커밋 메시지 생성 (Generates commit messages from diff)	git diff --staged
security-auditor	취약점 탐지 (SQL 인젝션, XSS) (Detects vulnerabilities (SQL injection, XSS))	인증 코드, API 엔드포인트 (Auth code, API endpoints)
secret-scanner	노출된 비밀 정보가 포함된 커밋 차단 (Blocks commits with exposed secrets)	프리커밋 (Pre-commit), 코드 내 API 키 (API keys in code)
dependency-auditor	의존성 CVE 체크 (Checks dependencies for CVEs)	package.json 변경 (package.json changes)
api-documenter	OpenAPI 명세 자동 생성 (Auto-generates OpenAPI specs)	API 라우트 추가 (API routes added)
readme-updater	README 최신 상태 유지 (Keeps README current)	프로젝트 변경, 기능 (Project changes, features)

기술 (Skills) vs 에이전트 (Agents): 기술 (Skills)은 백그라운드에서 자동으로 작동합니다. 에이전트 (Agents)는 심층 분석을 위해 수동 호출 (@agent)이 필요합니다.

더 알아보기: 기술 가이드 (Skills Guide) · 시작하기 (Getting Started) · 아키텍처 (Architecture)

일반적인 개발 시나리오를 위한 즉시 사용 가능한 프롬프트 (Ready-to-use prompts):

프론트엔드 개발 (Frontend Development): React, Vue, Angular, JavaScript/TypeScript
백엔드 개발 (Backend Development): API, 데이터베이스 (Databases), 인증 (Authentication), 마이크로서비스 (Microservices)
디버깅 및 분석 (Debugging & Analysis): 오류 분석 (Error analysis), 성능 트러블슈팅 (Performance troubleshooting)
베스트 프랙티스 (Best Practices): 클린 코드 (Clean code), 보안 (Security), 리팩토링 전략 (Refactoring strategies)

전문적인 코딩 표준 및 스타일 가이드:

JavaScript/TypeScript ESLint/Prettier 설정이 포함된 스타일 가이드
Git 워크플로우 (Git workflows) Conventional commits를 활용한 워크플로우
코드 리뷰 (Code review) 체크리스트 및 PR 템플릿
팀 협업 (Team collaboration) 가이드라인

전체 워크플로우 시연:

React 앱 설정 (React App Setup): 처음부터 시작하는 완전한 현대적 React 애플리케이션
API 개발 (API Development): 테스트 및 문서화가 포함된 RESTful API
성능 최적화 (Performance Optimization): 체계적인 성능 개선
CI/CD 파이프라인 (CI/CD Pipelines): 자동화된 테스트 및 배포

v2.6.0 품질 지표 (Quality Metrics):

전반적인 품질 (Overall Quality): 9.7/10 (매우 우수 - v2.5.0의 7.1/10에서 상승)
YAML 유효성 검사 (YAML Validation): 100% (141개 에이전트 모두 유효)
콘텐츠 품질 (Content Quality): 9.7/10 (포괄적인 예시 및 베스트 프랙티스)
구성 (Organization): 100% (완벽한 분류 및 구조)
상호 참조 (Cross-References): 100% (모든 통합 사항 검증 완료)

검증 (Validation): 모든 에이전트는 4단계 검증 계층(YAML, 콘텐츠, 구성, 상호 참조)을 통해 테스트되었습니다.

Claude Code의 기능을 더욱 확장하고 싶으신가요? 다음의 동반 리포지토리(Companion repositories)를 확인해 보세요:

대규모의 맞춤형 스킬(Skills) 및 에이전트(Agents) 구축

처음부터 시작할 필요 없이, 프로덕션 환경에 즉시 사용 가능한 Claude 스킬 및 에이전트를 생성하기 위한 포괄적인 툴킷입니다. 이미 구축된 컬렉션에서 제공하는 것 이상의 전문화된 기능이 필요할 때 완벽한 솔루션입니다.

주요 기능 (Key Features):

Skills Factory: Python 코드, 문서 및 예제를 포함한 멀티 파일 스킬 패키지(multi-file skill packages) 생성
Agents Factory: 강화된 YAML 설정을 갖춘 단일 파일 전문가 에이전트(specialist agents) 생성
Smart Architecture: 기능적 코드(functional code)가 필요한 시점과 프롬프트 전용(prompt-only) 접근 방식이 필요한 시점을 자동으로 결정
7가지 참조 예시 (7 Reference Examples): 금융 분석, AWS 아키텍처, 콘텐츠 리서치, Microsoft 365 등
엔터프라이즈 표준 (Enterprise Standards): 타입 어노테이션(Type-annotated) 코드, 에러 핸들링(error handling) 및 컴포저블 디자인(composable design)

적합한 대상 (Best For): 커스텀 도메인 특화 기능이 필요한 개발자, 독자적인 워크플로우를 구축하는 팀, 또는 자사의 기술 스택에 맞춤화된 전문 AI 도구가 필요한 조직.

사용 사례 (Use Case): "우리 회사의 특정 Terraform 패턴을 분석하는 스킬이 필요합니다" → Skill Factory를 사용하여 생성

전문적인 도메인을 위한 프로덕션 준비 완료된 스킬 패키지

다양한 전문 직무를 위해 베스트 프랙티스(best practices), 분석 도구 및 전략적 프레임워크를 결합한 전문 스킬 패키지의 큐레이션된 컬렉션입니다. 전문가 수준의 역량을 즉시 배포하십시오.

사용 가능한 컬렉션 (Available Collections):

마케팅 (Marketing) (3개 패키지): 콘텐츠 전략, 수요 창출(demand generation), 제품 마케팅
C-Level 어드바이저리 (C-Level Advisory) (2개 패키지): CEO 및 CTO 전략적 가이드
제품 팀 (Product Team) (6개 패키지): 제품 관리, UX 리서치, 디자인 시스템, 애자일 인도(agile delivery)
프로젝트 관리 (Project Management) (6개 패키지): Jira, Confluence, Scrum, PMO, Atlassian 통합
엔지니어링 (Engineering) (9개 패키지): 아키텍처, 풀스택, QA, DevOps, 보안, 코드 리뷰
AI/ML/데이터 (AI/ML/Data) (출시 예정): 데이터 과학 및 머신러닝 워크플로우

주요 이점 (Key Benefits):