configure-ecc

name	configure-ecc
description	Everything Claude Code를 위한 대화형 설치 프로그램 - 사용자 또는 프로젝트 수준 디렉터리에 스킬과 규칙을 선택하고 설치하는 과정을 안내하고, 경로를 검증하며, 선택적으로 설치된 파일을 최적화합니다.
origin	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

카테고리: 데이터베이스 (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/ 디렉터리는 항상 사용자 수준입니다. 이는 의도된 것이며 에러가 아닙니다.