everything-claude-code

# Everything Claude Code (ECC) — 에이전트 지침

이것은 소프트웨어 개발을 위한 25개의 특화 에이전트, 108개의 스킬, 57개의 명령어, 자동화된 훅 워크플로우를 제공하는 **프로덕션 레디 AI 코딩 플러그인**입니다.

## 핵심 원칙

1. **에이전트 우선** — 도메인 작업은 특화된 에이전트에 위임
2. **테스트 주도** — 구현 전 테스트 작성, 80% 이상 커버리지 필수
3. **보안 우선** — 보안에 절대 타협하지 않음; 모든 입력 검증
4. **불변성** — 항상 새 객체를 생성하고, 기존 객체를 절대 변경하지 않음
5. **실행 전 계획** — 복잡한 기능은 코드 작성 전 계획 수립

## 사용 가능한 에이전트

| 에이전트 | 목적 | 사용 시기 |
|---------|------|----------|
| planner | 구현 계획 수립 | 복잡한 기능, 리팩토링 |
| architect | 시스템 설계 및 확장성 | 아키텍처 결정 |
| tdd-guide | 테스트 주도 개발 | 새 기능, 버그 수정 |
| code-reviewer | 코드 품질 및 유지보수성 | 코드 작성/수정 후 |
| security-reviewer | 취약점 탐지 | 커밋 전, 민감한 코드 |
| build-error-resolver | 빌드/타입 오류 수정 | 빌드 실패 시 |
| e2e-runner | E2E Playwright 테스트 | 핵심 사용자 플로우 |
| refactor-cleaner | 불필요한 코드 정리 | 코드 유지보수 |
| doc-updater | 문서 및 코드맵 업데이트 | 문서 업데이트 |
| go-reviewer | Go 코드 리뷰 | Go 프로젝트 |
| go-build-resolver | Go 빌드 오류 해결 | Go 빌드 실패 |
| kotlin-reviewer | Kotlin 코드 리뷰 | Kotlin/Android/KMP 프로젝트 |
| kotlin-build-resolver | Kotlin/Gradle 빌드 오류 | Kotlin 빌드 실패 |
| database-reviewer | PostgreSQL/Supabase 전문가 | 스키마 설계, 쿼리 최적화 |
| python-reviewer | Python 코드 리뷰 | Python 프로젝트 |
| java-reviewer | Java 및 Spring Boot 코드 리뷰 | Java/Spring Boot 프로젝트 |
| java-build-resolver | Java/Maven/Gradle 빌드 오류 | Java 빌드 실패 |
| chief-of-staff | 커뮤니케이션 분류 및 초안 작성 | 멀티 채널 이메일, Slack, LINE, Messenger |
| loop-operator | 자율 루프 실행 | 안전한 루프 실행, 정체 모니터링, 개입 |
| harness-optimizer | 하네스 설정 튜닝 | 안정성, 비용, 처리량 |
| rust-reviewer | Rust 코드 리뷰 | Rust 프로젝트 |
| rust-build-resolver | Rust 빌드 오류 해결 | Rust 빌드 실패 |

## 에이전트 오케스트레이션

사용자 프롬프트 없이 에이전트를 능동적으로 사용:
- 복잡한 기능 요청 → **planner**
- 방금 작성/수정한 코드 → **code-reviewer**
- 버그 수정 또는 새 기능 → **tdd-guide**
- 아키텍처 결정 → **architect**
- 보안에 민감한 코드 → **security-reviewer**
- 멀티 채널 커뮤니케이션 분류 → **chief-of-staff**
- 자율 루프 / 루프 모니터링 → **loop-operator**
- 하네스 설정 안정성 및 비용 → **harness-optimizer**

독립적인 작업에는 병렬 실행을 사용 — 여러 에이전트를 동시에 실행하세요.

## 보안 지침

**모든 커밋 전:**
- 하드코딩된 비밀정보 없음 (API 키, 비밀번호, 토큰)
- 모든 사용자 입력 검증
- SQL 인젝션 방지 (파라미터화된 쿼리)
- XSS 방지 (HTML 살균)
- CSRF 보호 활성화
- 인증/권한 확인
- 모든 엔드포인트에 속도 제한
- 오류 메시지에 민감한 데이터 노출 금지

**비밀정보 관리:** 절대 비밀정보를 하드코딩하지 마세요. 환경 변수 또는 비밀정보 관리자를 사용하세요. 시작 시 필수 비밀정보를 검증하세요. 노출된 비밀정보는 즉시 교체하세요.

**보안 이슈 발견 시:** 중단 → security-reviewer 에이전트 사용 → CRITICAL 이슈 수정 → 노출된 비밀정보 교체 → 유사한 이슈가 있는지 코드베이스 검토.

## 코딩 스타일

**불변성 (필수):** 항상 새 객체를 생성하고, 절대 변경하지 마세요. 변경 사항이 적용된 새 복사본을 반환하세요.

**파일 구성:** 적은 수의 큰 파일보다 많은 수의 작은 파일을 선호. 일반적으로 200-400줄, 최대 800줄. 타입별이 아닌 기능/도메인별로 구성. 높은 응집력, 낮은 결합도.

**오류 처리:** 모든 수준에서 오류를 처리하세요. UI 코드에서는 사용자 친화적인 메시지를 제공하세요. 서버 측에서는 상세한 컨텍스트를 로깅하세요. 절대 오류를 묵묵히 무시하지 마세요.

**입력 검증:** 시스템 경계에서 모든 사용자 입력을 검증하세요. 스키마 기반 검증을 사용하세요. 명확한 메시지와 함께 빠르게 실패하세요. 외부 데이터를 절대 신뢰하지 마세요.

**코드 품질 체크리스트:**
- 함수는 작게 (<50줄), 파일은 집중적으로 (<800줄)
- 깊은 중첩 없음 (>4단계)
- 적절한 오류 처리, 하드코딩된 값 없음
- 읽기 쉽고, 잘 명명된 식별자

## 테스트 요구사항

**최소 커버리지: 80%**

테스트 유형 (모두 필수):
1. **단위 테스트** — 개별 함수, 유틸리티, 컴포넌트
2. **통합 테스트** — API 엔드포인트, 데이터베이스 작업
3. **E2E 테스트** — 핵심 사용자 플로우

**TDD 워크플로우 (필수):**
1. 테스트를 먼저 작성 (RED) — 테스트가 실패해야 함
2. 최소한의 구현 작성 (GREEN) — 테스트가 통과해야 함
3. 리팩토링 (IMPROVE) — 커버리지 80% 이상 확인

실패 문제 해결: 테스트 격리 확인 → 목 검증 → 구현 수정 (테스트가 잘못된 경우가 아니면 테스트를 수정하지 않음).

## 개발 워크플로우

1. **계획** — planner 에이전트 사용, 의존성과 위험 식별, 단계별 분할
2. **TDD** — tdd-guide 에이전트 사용, 테스트 먼저 작성, 구현, 리팩토링
3. **리뷰** — 즉시 code-reviewer 에이전트 사용, CRITICAL/HIGH 이슈 해결
4. **적절한 곳에 지식 기록**
   - 개인적인 디버깅 노트, 선호사항, 임시 컨텍스트 → auto memory
   - 팀/프로젝트 지식 (아키텍처 결정, API 변경, 런북) → 프로젝트의 기존 문서 구조
   - 현재 작업이 이미 관련 문서나 코드 주석을 생성한다면, 같은 정보를 다른 곳에 중복하지 않음
   - 명확한 프로젝트 문서 위치가 없으면, 새 최상위 파일 생성 전 먼저 질문
5. **커밋** — Conventional commits 형식, 포괄적인 PR 요약

## Git 워크플로우

**커밋 형식:** `<type>: <description>` — 유형: feat, fix, refactor, docs, test, chore, perf, ci

**PR 워크플로우:** 전체 커밋 히스토리 분석 → 포괄적인 요약 초안 작성 → 테스트 계획 포함 → `-u` 플래그와 함께 푸시.

## 아키텍처 패턴

**API 응답 형식:** 성공 표시자, 데이터 페이로드, 오류 메시지, 페이지네이션 메타데이터가 포함된 일관된 엔벨로프.

**Repository 패턴:** 표준 인터페이스(findAll, findById, create, update, delete) 뒤에 데이터 접근을 캡슐화. 비즈니스 로직은 저장 메커니즘이 아닌 추상 인터페이스에 의존.

**스켈레톤 프로젝트:** 검증된 템플릿 검색, 병렬 에이전트로 평가 (보안, 확장성, 관련성), 최적의 매치 클론, 검증된 구조 내에서 반복 개선.

## 성능

**컨텍스트 관리:** 대규모 리팩토링과 다중 파일 기능에는 컨텍스트 윈도우의 마지막 20%를 피하세요. 민감도가 낮은 작업(단일 편집, 문서, 간단한 수정)은 더 높은 사용률을 허용합니다.

**빌드 문제 해결:** build-error-resolver 에이전트 사용 → 오류 분석 → 점진적 수정 → 각 수정 후 검증.

## 프로젝트 구조

```
agents/          — 25개의 특화된 서브에이전트
skills/          — 102개의 워크플로우 스킬 및 도메인 지식
commands/        — 57개의 슬래시 명령어
hooks/           — 트리거 기반 자동화
rules/           — 항상 따라야 하는 지침 (공통 + 언어별)
scripts/         — 크로스 플랫폼 Node.js 유틸리티
mcp-configs/     — 14개의 MCP 서버 설정
tests/           — 테스트 스위트
```

## 성공 지표

- 모든 테스트가 80% 이상 커버리지로 통과
- 보안 취약점 없음
- 코드가 읽기 쉽고 유지보수 가능
- 성능이 허용 가능한 수준
- 사용자 요구사항 충족

More agent context in junimnjw/everything-claude-code

189 other files this repository gives its agents, the first 60 shown.