configure-ecc

Everything Claude Code (ECC) 구성

Everything Claude Code 프로젝트를 위한 대화형 단계별 설치 마법사입니다. AskUserQuestion을 사용하여 스킬과 규칙을 선택적으로 설치하도록 안내하며, 정확성을 검증하고 최적화 옵션을 제공합니다.

활성화 시점

• 사용자가 "configure ecc", "install ecc", "setup everything claude code" 또는 이와 유사한 요청을 할 때
• 이 프로젝트에서 스킬이나 규칙을 선택적으로 설치하고 싶을 때
• 기존 ECC 설치를 검증하거나 수정하고 싶을 때
• 프로젝트에 맞게 설치된 스킬이나 규칙을 최적화하고 싶을 때

사전 요구 사항

이 스킬은 활성화 전에 Claude Code에서 접근 가능해야 합니다. 부트스트랩하는 두 가지 방법은 다음과 같습니다.

1. 플러그인을 통한 방법: /plugin install ecc@ecc — 플러그인이 이 스킬을 자동으로 로드합니다.
2. 수동 방법: 이 스킬만 ~/.claude/skills/configure-ecc/SKILL.md에 복사한 후 "configure ecc"라고 말하여 활성화합니다.

---

0단계: ECC 저장소 클론

설치 전에 최신 ECC 소스를 /tmp에 클론합니다.

rm -rf /tmp/everything-claude-code
git clone https://github.com/affaan-m/everything-claude-code.git /tmp/everything-claude-code

이후 모든 복사 작업의 소스로 ECC_ROOT=/tmp/everything-claude-code를 설정합니다.

클론이 실패하면(네트워크 문제 등), AskUserQuestion을 사용하여 사용자에게 기존 ECC 클론의 로컬 경로를 제공해 달라고 요청합니다.

---

1단계: 설치 수준 선택

AskUserQuestion을 사용하여 설치 위치를 묻습니다.

질문: "ECC 구성 요소를 어디에 설치할까요?"
옵션:
  - "사용자 수준 (~/.claude/)" — "모든 Claude Code 프로젝트에 적용됩니다"
  - "프로젝트 수준 (.claude/)" — "현재 프로젝트에만 적용됩니다"
  - "둘 다" — "공통/공유 항목은 사용자 수준에, 프로젝트 전용 항목은 프로젝트 수준에 설치합니다"

선택 사항을 INSTALL_LEVEL로 저장하고 대상 디렉터리를 설정합니다.

• 사용자 수준: TARGET=~/.claude
• 프로젝트 수준: TARGET=.claude (현재 프로젝트 루트 기준 상대 경로)
• 둘 다: TARGET_USER=~/.claude, TARGET_PROJECT=.claude

대상 디렉터리가 없으면 생성합니다.

mkdir -p $TARGET/skills $TARGET/rules

---

2단계: 스킬 선택 및 설치

2a: 범위 선택 (코어 vs 니치)

기본값은 코어 (권장) 입니다 — .agents/skills/*와 리서치 우선 워크플로를 위한 skills/search-first/를 복사합니다. 이 번들은 엔지니어링, 평가(evals), 검증, 보안, 전략적 압축(compacting), 프론트엔드 디자인 및 Anthropic 교차 기능 스킬(article-writing, content-engine, market-research, frontend-slides)을 다룹니다.

AskUserQuestion을 사용합니다 (단일 선택).

질문: "코어 스킬만 설치할까요, 아니면 니치(niche)/프레임워크 팩을 포함할까요?"
옵션:
  - "코어만 (권장)" — "tdd, e2e, evals, 검증, 리서치 우선, 보안, 프론트엔드 패턴, 압축, Anthropic 교차 기능 스킬"
  - "코어 + 선택한 니치" — "코어 설치 후 프레임워크/도메인별 스킬 추가"
  - "니치만" — "코어를 건너뛰고 특정 프레임워크/도메인 스킬만 설치"
기본값: 코어만

사용자가 니치 또는 코어 + 니치를 선택하면 아래 카테고리 선택으로 진행하여 선택한 니치 스킬만 포함합니다.

2b: 스킬 카테고리 선택

아래에 7개의 선택 가능한 카테고리 그룹이 있습니다. 이어지는 상세 확인 목록에는 8개 카테고리에 걸친 45개의 스킬과 1개의 독립 템플릿이 포함되어 있습니다. AskUserQuestion에서 multiSelect: true를 사용하세요.

질문: "어떤 스킬 카테고리를 설치하시겠습니까?"
옵션:
  - "프레임워크 및 언어" — "Django, Laravel, Spring Boot, Go, Python, Java, 프론트엔드, 백엔드 패턴"
  - "데이터베이스" — "PostgreSQL, ClickHouse, JPA/Hibernate 패턴"
  - "워크플로 및 품질" — "TDD, 검증, 학습, 보안 리뷰, 압축"
  - "리서치 및 API" — "심층 리서치, Exa 검색, Claude API 패턴"
  - "소셜 및 콘텐츠 배포" — "X/Twitter API, content-engine과 함께 사용하는 크로스포스팅"
  - "미디어 생성" — "VideoDB와 함께 사용하는 fal.ai 이미지/비디오/오디오"
  - "오케스트레이션" — "dmux 다중 에이전트 워크플로"
  - "모든 스킬" — "사용 가능한 모든 스킬 설치"

2c: 개별 스킬 확인

선택한 각 카테고리에 대해 아래의 전체 스킬 목록을 보여주고 특정 스킬을 확인하거나 선택 해제하도록 요청합니다. 목록이 4개 항목을 초과하면 텍스트로 목록을 보여주고 AskUserQuestion에서 "목록의 모두 설치" 옵션과 사용자가 특정 이름을 붙여넣을 수 있는 "기타" 옵션을 제공합니다.

카테고리: 프레임워크 및 언어 (21개 스킬)

스킬	설명
backend-patterns	Node.js/Express/Next.js를 위한 백엔드 아키텍처, API 설계, 서버 사이드 모범 사례
coding-standards	TypeScript, JavaScript, React, Node.js를 위한 범용 코딩 표준
django-patterns	Django 아키텍처, DRF를 이용한 REST API, ORM, 캐싱, 시그널, 미들웨어
django-security	Django 보안: 인증, CSRF, SQL 인젝션, XSS 방지
django-tdd	pytest-django, factory_boy, 모킹, 커버리지를 이용한 Django 테스트
django-verification	Django 검증 루프: 마이그레이션, 린팅, 테스트, 보안 스캔
laravel-patterns	Laravel 아키텍처 패턴: 라우팅, 컨트롤러, Eloquent, 큐, 캐싱
laravel-security	Laravel 보안: 인증, 정책, CSRF, 대량 할당, 속도 제한
laravel-tdd	PHPUnit과 Pest, 팩토리, 페이크(fake), 커버리지를 이용한 Laravel 테스트
laravel-verification	Laravel 검증: 린팅, 정적 분석, 테스트, 보안 스캔
frontend-patterns	React, Next.js, 상태 관리, 성능, UI 패턴
frontend-slides	의존성 없는 HTML 프레젠테이션, 스타일 프리뷰 및 PPTX-to-web 변환
golang-patterns	견고한 Go 애플리케이션을 위한 관용적인 Go 패턴 및 컨벤션
golang-testing	Go 테스트: 테이블 구동 테스트, 하위 테스트, 벤치마크, 퍼징
java-coding-standards	Spring Boot를 위한 Java 코딩 표준: 명명법, 불변성, Optional, 스트림
python-patterns	파이썬다운 관용구, PEP 8, 타입 힌트, 모범 사례
python-testing	pytest, TDD, 픽스처, 모킹, 파라미터화를 이용한 Python 테스트
springboot-patterns	Spring Boot 아키텍처, REST API, 계층화된 서비스, 캐싱, 비동기
springboot-security	Spring Security: 인증/인가, 유효성 검사, CSRF, 시크릿 관리, 속도 제한
springboot-tdd	JUnit 5, Mockito, MockMvc, Testcontainers를 이용한 Spring Boot TDD
springboot-verification	Spring Boot 검증: 빌드, 정적 분석, 테스트, 보안 스캔

카테고리: 데이터베이스 (3개 스킬)

스킬	설명
clickhouse-io	ClickHouse 패턴, 쿼리 최적화, 분석, 데이터 엔지니어링
jpa-patterns	JPA/Hibernate 엔티티 설계, 관계, 쿼리 최적화, 트랜잭션
postgres-patterns	PostgreSQL 쿼리 최적화, 스키마 설계, 인덱싱, 보안

카테고리: 워크플로 및 품질 (8개 스킬)

스킬	설명
continuous-learning	레거시 v1 중단 훅 세션 패턴 추출. 신규 설치에는 continuous-learning-v2 권장
continuous-learning-v2	확신 점수 기반의 본능 학습. 스킬, 에이전트 및 선택적 레거시 커맨드 심(shim)으로 진화
eval-harness	평가 주도 개발(EDD)을 위한 공식 평가 프레임워크
iterative-retrieval	서브에이전트 컨텍스트 문제를 해결하기 위한 점진적 컨텍스트 정제
security-review	보안 체크리스트: 인증, 입력값, 시크릿, API, 결제 기능
strategic-compact	논리적 간격에서 수동 컨텍스트 압축 제안
tdd-workflow	80% 이상의 커버리지로 TDD 강제: 단위, 통합, E2E
verification-loop	검증 및 품질 루프 패턴

카테고리: 비즈니스 및 콘텐츠 (5개 스킬)

스킬	설명
article-writing	노트, 예시 또는 소스 문서를 사용하여 제공된 목소리로 작성하는 장문 글쓰기
content-engine	다중 플랫폼 소셜 콘텐츠, 스크립트 및 콘텐츠 재가공 워크플로
market-research	출처가 명시된 시장, 경쟁사, 펀드 및 기술 조사
investor-materials	피치 덱, 원페이저, 투자 메모 및 재무 모델
investor-outreach	개인화된 투자자 콜드 메일, 따뜻한 소개(warm intro) 및 후속 조치

카테고리: 리서치 및 API (3개 스킬)

스킬	설명
deep-research	firecrawl 및 exa MCP를 이용해 출처가 명시된 보고서를 제공하는 다중 소스 심층 리서치
exa-search	웹, 코드, 기업 및 인물 조사를 위한 Exa MCP 기반 뉴럴 검색
claude-api	Anthropic Claude API 패턴: Messages, 스트리밍, 도구 사용, 비전, 배치, 에이전트 SDK

카테고리: 소셜 및 콘텐츠 배포 (2개 스킬)

스킬	설명
x-api	포스팅, 스레드, 검색 및 분석을 위한 X/Twitter API 통합
crosspost	플랫폼별 최적화를 포함한 다중 플랫폼 콘텐츠 배포

카테고리: 미디어 생성 (2개 스킬)

스킬	설명
fal-ai-media	fal.ai MCP를 통한 통합 AI 미디어 생성 (이미지, 비디오, 오디오)
video-editing	실제 영상을 자르고, 구조화하고, 보강하기 위한 AI 보조 비디오 편집

카테고리: 오케스트레이션 (1개 스킬)

스킬	설명
dmux-workflows	병렬 에이전트 세션을 위한 dmux 기반 다중 에이전트 오케스트레이션

독립 항목

스킬	설명
docs/examples/project-guidelines-template.md	프로젝트별 스킬 생성을 위한 템플릿

2d: 설치 실행

선택한 각 스킬에 대해 전체 스킬 디렉터리를 복사합니다.

cp -r $ECC_ROOT/skills/<skill-name> $TARGET/skills/

참고: continuous-learning 및 continuous-learning-v2에는 추가 파일(config.json, 훅, 스크립트)이 있으므로 SKILL.md만 복사하지 말고 디렉터리 전체를 복사해야 합니다.

---

3단계: 규칙 선택 및 설치

AskUserQuestion에서 multiSelect: true를 사용하세요.

질문: "어떤 규칙 세트를 설치하시겠습니까?"
옵션:
  - "공통 규칙 (권장)" — "언어 중립적 원칙: 코딩 스타일, git 워크플로, 테스트, 보안 등 (8개 파일)"
  - "TypeScript/JavaScript" — "TS/JS 패턴, 훅, Playwright를 이용한 테스트 (5개 파일)"
  - "Python" — "Python 패턴, pytest, black/ruff 포맷팅 (5개 파일)"
  - "Go" — "Go 패턴, 테이블 구동 테스트, gofmt/staticcheck (5개 파일)"

설치 실행:

# 공통 규칙 (rules/로 플랫 복사)
cp -r $ECC_ROOT/rules/common/* $TARGET/rules/

# 언어별 규칙 (rules/로 플랫 복사)
cp -r $ECC_ROOT/rules/typescript/* $TARGET/rules/   # 선택된 경우
cp -r $ECC_ROOT/rules/python/* $TARGET/rules/        # 선택된 경우
cp -r $ECC_ROOT/rules/golang/* $TARGET/rules/        # 선택된 경우

중요: 사용자가 언어별 규칙은 선택했지만 공통 규칙은 선택하지 않은 경우 다음과 같이 경고합니다.

"언어별 규칙은 공통 규칙을 확장한 것입니다. 공통 규칙 없이 설치하면 커버리지가 불완전해질 수 있습니다. 공통 규칙도 함께 설치하시겠습니까?"

---

4단계: 설치 후 검증

설치 후 다음의 자동화된 점검을 수행합니다.

4a: 파일 존재 확인

설치된 모든 파일을 나열하고 대상 위치에 존재하는지 확인합니다.

ls -la $TARGET/skills/
ls -la $TARGET/rules/

4b: 경로 참조 확인

설치된 모든 .md 파일에서 경로 참조를 스캔합니다.

grep -rn "~/.claude/" $TARGET/skills/ $TARGET/rules/
grep -rn "../common/" $TARGET/rules/
grep -rn "skills/" $TARGET/skills/

프로젝트 수준 설치의 경우, ~/.claude/ 경로에 대한 참조를 표시합니다.

• 스킬이 ~/.claude/settings.json을 참조하는 경우 — 이는 보통 괜찮습니다 (설정은 항상 사용자 수준입니다).
• 스킬이 ~/.claude/skills/ 또는 ~/.claude/rules/를 참조하는 경우 — 프로젝트 수준에만 설치된 경우 깨질 수 있습니다.
• 스킬이 이름으로 다른 스킬을 참조하는 경우 — 참조된 스킬도 설치되었는지 확인합니다.

4c: 스킬 간 상호 참조 확인

일부 스킬은 다른 스킬을 참조합니다. 이러한 종속성을 확인하세요.

• django-tdd는 django-patterns를 참조할 수 있음
• laravel-tdd는 laravel-patterns를 참조할 수 있음
• springboot-tdd는 springboot-patterns를 참조할 수 있음
• continuous-learning-v2는 ~/.claude/homunculus/ 디렉터리를 참조함
• python-testing은 python-patterns를 참조할 수 있음
• golang-testing은 golang-patterns를 참조할 수 있음
• crosspost는 content-engine 및 x-api를 참조함
• deep-research는 exa-search를 참조함 (상호 보완적인 MCP 도구)
• fal-ai-media는 videodb를 참조함 (상호 보완적인 미디어 스킬)
• x-api는 content-engine 및 crosspost를 참조함
• 언어별 규칙은 common/ 규칙을 참조함

4d: 이슈 보고

발견된 각 이슈에 대해 다음을 보고합니다.

1. 파일: 문제가 있는 참조가 포함된 파일
2. 줄: 줄 번호
3. 이슈: 무엇이 잘못되었는지 (예: "python-patterns 스킬이 설치되지 않았는데 ~/.claude/skills/python-patterns를 참조함")
4. 권장 수정 사항: 수행할 작업 (예: "python-patterns 스킬 설치" 또는 ".claude/skills/로 경로 업데이트")

---

5단계: 설치된 파일 최적화 (선택 사항)

AskUserQuestion을 사용합니다.

질문: "프로젝트에 맞게 설치된 파일을 최적화하시겠습니까?"
옵션:
  - "스킬 최적화" — "관련 없는 섹션 제거, 경로 조정, 기술 스택에 맞게 맞춤화"
  - "규칙 최적화" — "커버리지 목표 조정, 프로젝트 전용 패턴 추가, 도구 설정 커스터마이징"
  - "둘 다 최적화" — "설치된 모든 파일의 전체 최적화"
  - "건너뛰기" — "그대로 유지"

스킬을 최적화하는 경우:

1. 설치된 각 SKILL.md를 읽습니다.
2. 사용자에게 프로젝트의 기술 스택이 무엇인지 묻습니다 (이미 알고 있는 경우 제외).
3. 각 스킬에 대해 관련 없는 섹션 제거를 제안합니다.
4. 설치 대상 위치($TARGET/)에 있는 SKILL.md 파일을 직접 수정합니다 (소스 저장소 아님).
5. 4단계에서 발견된 경로 문제를 해결합니다.

규칙을 최적화하는 경우:

1. 설치된 각 규칙 .md 파일을 읽습니다.
2. 사용자에게 선호 사항을 묻습니다.
   • 테스트 커버리지 목표 (기본값 80%)
   • 선호하는 포맷팅 도구
   • Git 워크플로 컨벤션
   • 보안 요구 사항
3. 설치 대상 위치에 있는 규칙 파일을 직접 수정합니다.

중요: 설치 대상($TARGET/)에 있는 파일만 수정하고, 소스 ECC 저장소($ECC_ROOT/)에 있는 파일은 절대로 수정하지 마십시오.

---

6단계: 설치 요약

클론된 저장소를 /tmp에서 삭제합니다.

rm -rf /tmp/everything-claude-code

그런 다음 요약 보고서를 출력합니다.

## ECC 설치 완료

### 설치 대상
- 수준: [사용자 수준 / 프로젝트 수준 / 둘 다]
- 경로: [대상 경로]

### 설치된 스킬 ([개수])
- skill-1, skill-2, skill-3, ...

### 설치된 규칙 ([개수])
- 공통 (8개 파일)
- typescript (5개 파일)
- ...

### 검증 결과
- [개수]개의 이슈 발견, [개수]개 수정됨
- [남아 있는 이슈 목록]

### 적용된 최적화
- [변경된 사항 목록, 또는 "없음"]

---

문제 해결

"Claude Code에서 스킬을 인식하지 못함"

• 스킬 디렉터리에 SKILL.md 파일이 포함되어 있는지 확인하세요 (낱개 .md 파일만 있으면 안 됨).
• 사용자 수준: ~/.claude/skills/<skill-name>/SKILL.md가 존재하는지 확인하세요.
• 프로젝트 수준: .claude/skills/<skill-name>/SKILL.md가 존재하는지 확인하세요.

"규칙이 작동하지 않음"

• 규칙은 하위 디렉터리가 아닌 플랫 파일입니다. $TARGET/rules/coding-style.md (올바름) vs $TARGET/rules/common/coding-style.md (플랫 설치 시 잘못됨).
• 규칙 설치 후 Claude Code를 재시작하세요.

"프로젝트 수준 설치 후 경로 참조 에러 발생"

• 일부 스킬은 ~/.claude/ 경로를 가정합니다. 4단계 검증을 실행하여 이를 찾아 수정하세요.
• continuous-learning-v2의 경우 ~/.claude/homunculus/ 디렉터리는 항상 사용자 수준입니다. 이는 의도된 것이며 에러가 아닙니다.