ai-rules handbook P19 완료)

P19 완료)

- GitHub: 140K+ Stars, 170+ contributors - npm 배포 (`ecc-universal`), selective install 지원 - 구성: 39개 에이전트, 181개 스킬, 79개 커맨드, 포괄적 hook 시스템

research 2026-04-14 docs/research/ecc-vs-ai-rules-after.md

작성일: 2026-04-14 — P1~P19 로드맵 완료 후 재평가 이전 분석: ecc-vs-ai-rules-evaluation.md (2026-04-09) 분석 대상: Everything Claude Code (ECC) v1.10.0, ai-rules (P19 완료 상태)


1. ECC (Everything Claude Code) 개요 (변동 없음)

  • GitHub: 140K+ Stars, 170+ contributors
  • npm 배포 (ecc-universal), selective install 지원
  • 구성: 39개 에이전트, 181개 스킬, 79개 커맨드, 포괄적 hook 시스템
agents/       — 39개 전문 에이전트
skills/       — 181개 재사용 지식 모듈
commands/     — 79개 slash command
hooks/        — PreToolUse/PostToolUse/Lifecycle 3계층
docs/         — 3종 가이드, 다국어 7개 언어
SOUL.md       — Agent-First 철학

ECC 평가 변동 없음: A+ (94/100)


2. ai-rules 하네스 개요 (After)

  • 적용 프로젝트: AX-Studio-plan, Slide-Studio + 15개 프로파일
  • 구성: 글로벌 CLAUDE.md + 프로젝트별 CLAUDE.md + agents/ + skills/ + hooks/ + governance/ + settings.json

Before → After 구조 변화

Before (2026-04-09):                          After (2026-04-14):

~/.claude/CLAUDE.md (1,660줄)                 ~/.claude/CLAUDE.md (409줄 slim)
{project}/CLAUDE.md (상속)                     {project}/CLAUDE.md (상속 + lazy-load 라우팅)
.claude/agents/ (9개)                          .claude/agents/ (6개 base + 프로젝트별 확장)
.claude/hooks/ (2개)                           .claude/hooks/ (7개)
.claude/settings.json                          .claude/settings.json (invocation caps 포함)
                                               .claude/commands/ (8개 스킬)
                                               .ai-governance/ (safety-manifest, thresholds, negative-examples)
                                               docs/reference/ (on-demand 상세 규칙)
                                               tests/scenarios/ (19개 Hook 테스트)
                                               .github/workflows/ (CI 회귀 테스트)

ai-rules 항목별 재평가

항목 Before 등급 Before 점수 After 등급 After 점수 변화 요인
전체 구조 A+ 95 A+ 97 lazy-load 아키텍처 + governance 계층 추가
CLAUDE.md 규칙 품질 A+ 96 A+ 97 변명 방지 테이블 (P2) + 409줄 경량화 (P1)
Hooks 구성 A 91 A+ 96 2개 → 7개 (PostToolUse + SessionStart + Tier 2 게이트)
Agents 정의 A 92 A 93 spec-reviewer + code-reviewer 분리 (P10)
Commands/Skills C 45 A 90 0개 → 8개 핵심 워크플로우 스킬 (P5)
문서화 A 90 A 92 reference docs + skill docs 추가
실사용성 A- 88 A 93 SessionStart 자동화 (P6), CI 검증 (P16)
독창성/철학 A+ 98 A+ 98 유지
테스트/검증 A 92 신규 — 19 시나리오 + CI 3x 실행 (P11, P16)
자기 개선 A 90 신규 — negative-example bank + self-improve 스킬 (P18)

Before 총점: A (87/100)After 총점: A+ (94/100)


3. 직접 비교 (재평가)

ECC가 앞서는 부분

항목 ECC ai-rules (Before) ai-rules (After) 격차 변화
Commands 79개 없음 8개 큰 격차 → 여전히 차이 있으나 핵심 커버
Skills 181개 없음 8개 (+ on-demand reference) 큰 격차 → 양은 차이, 핵심 워크플로우 동등
PostToolUse hooks 파일 저장 후 lint 등 미구현 lint-on-save.sh 구현 격차 → 해소
Lifecycle hooks 세션 시작/종료 자동화 미구현 session-bootstrap.sh 구현 격차 → 해소
언어 생태계 12+ (Go, Rust, Python 등) 미분리 extensions/ 분리 (P14) 격차 → 축소
커뮤니티 검증 170+ contributors 단일 팀 단일 팀 변동 없음

ai-rules가 앞서는 부분

항목 ai-rules ECC 변화
가역성 등급 (R0/R1/R2) 3단계 + 예외 추적 + 만료 규칙 없음 강화
규칙 충돌 매트릭스 7가지 시나리오 판정표 없음 유지
Tie-breaker 원칙 4문장으로 예외 명시 차단 없음 유지
DB 안전 규칙 실제 사례 기반 상세 일반적 수준 유지
계약 기반 작업 COMPLETED-FEATURES.md 회귀 방지 없음 유지
규칙 강제성 "예외는 상위 규칙 무효화 불가" 권고 수준 유지
변명 방지 테이블 4개 규칙에 18+ 패턴 없음 신규 (P2)
Tier 2 게이트 누적 변경량 기반 경고/차단 없음 신규 (P19)
자기 개선 루프 negative-example bank + self-improve 없음 신규 (P18)
CI 회귀 테스트 19 시나리오 + 3x 실행 + median 판정 없음 신규 (P11, P16)
거버넌스 프리셋 solo/small-team/saas 없음 신규 (P17, P19)
컨텍스트 효율 409줄 slim + lazy-load SOUL.md + 전체 주입 신규 (P1, P15)

4. 핵심 통찰 — 양 vs. 실효성 (재평가)

이전 분석의 핵심 발견 (유효)

"얼마나 많이 만들었냐"보다 "얼마나 강제할 수 있냐"가 실질적 품질 기준이다.

이 원칙은 여전히 유효하다. ECC의 181개 스킬은 여전히 마크다운 텍스트 파일이며, Claude가 무시하면 강제할 수단이 없다.

강제력 기준 재비교

구분 ECC ai-rules (Before) ai-rules (After)
텍스트 규칙 (Advisory) 181개 스킬 CLAUDE.md 각 섹션 409줄 slim + 8 스킬 + reference
실제 차단 (Deterministic) hooks.json (Node.js) 2개 hook 7개 hook + Tier 2 게이트
강제 수준 높음 (다양한 hook) 중간 (핵심 2개만) 높음 (Tier 0~3 전체 커버)
자기 검증 없음 없음 19 시나리오 + CI 회귀
학습/개선 없음 없음 negative-example bank

재평가 점수

기준 ECC ai-rules (Before) ai-rules (After)
양(규모) 기준 A+ (94) A (87) A+ (94)
실효성(강제력) 기준 B+ (82) B+ (85) A+ (95)
종합 A (88) B+ (86) A+ (95)

5. 이전 개선 방향 이행 상태

단기 (강제력 강화)

제안 상태 담당 P#
PostToolUse hook — .ts/.tsx 저장 후 eslint 자동 실행 lint-on-save.sh P7
Lifecycle hook — SessionStart 시 환경 자동 체크 session-bootstrap.sh P6

중기 (편의성 추가)

제안 상태 담당 P#
/commit — conventional commit 자동 생성 commit.md 스킬 P5
/review — reviewer 에이전트 호출 code-review.md 스킬 (2단계 분리) P5, P10
/plan — INTENT.md 작성 워크플로우 planning.md 스킬 P5
designer 에이전트 완성 ⬜ 미완

장기 (모듈화)

제안 상태 담당 P#
프로젝트별 특화 스킬 분리 extensions/ 분리 P14
CLAUDE.md를 작은 스킬 파일로 분해 409줄 slim + lazy-load + reference P1, P15

이행률: 7/9 (78%) — designer 에이전트와 프로젝트 특화 스킬(prisma-migration 등) 미완.


6. 항목별 대결 (After 기준)

항목 ECC ai-rules (After) 승자
에이전트 수 39개 6개 ECC
스킬 수 181개 8개 ECC
커맨드 수 79개 8개 ECC
Hook 다양성 PreToolUse/PostToolUse/Lifecycle PreToolUse/PostToolUse/SessionStart 동등
Hook 강제력 hooks.json (Node.js) shell hook 7개 + Tier 2 게이트 ai-rules
규칙 설계 깊이 SOUL.md (철학) R0/R1/R2 + 충돌 매트릭스 + tie-breaker ai-rules
변명 방지 없음 18+ 패턴 ai-rules
테스트/검증 없음 19 시나리오 + CI 3x ai-rules
자기 개선 없음 negative-example + self-improve ai-rules
컨텍스트 효율 SOUL.md + 전체 로드 409줄 slim + lazy-load ai-rules
멀티 도구 Claude Code 전용 7개 도구 동시 배포 ai-rules
프로젝트 적응 one-size-fits-all 15+ 프로파일 + extensions ai-rules
커뮤니티 170+ contributors 단일 팀 ECC
npm 배포 ecc-universal sync 스크립트 ECC
언어 생태계 12+ 언어 커버 extensions/ 분리 (2개) ECC
다국어 문서 7개 언어 한국어 + 영어 ECC

승패: ECC 6 / ai-rules 8 / 동등 1


7. 결론

Before (2026-04-09)

ai-rules는 철학과 규칙 설계 깊이에서 ECC를 넘어서지만, 자동화 편의 레이어(skills/commands)가 없어 총점에서 밀린다. Commands/Skills 핵심 20개만 추가해도 A+ 진입 가능.

After (2026-04-14)

8개 핵심 스킬 + 7개 Hook + Tier 2 게이트 + 19 테스트 시나리오 + CI 회귀 + 자기 개선 루프 추가.

Before:  ECC A+ (94) > ai-rules A (87)   — 격차 7점
After:   ECC A+ (94) ≤ ai-rules A+ (95)  — 역전 (실효성 기준)
관점 ECC ai-rules (After)
양(규모) A+ — 181 스킬, 79 커맨드, 39 에이전트 A — 8 스킬, 8 커맨드, 6 에이전트
깊이(설계) B+ — SOUL.md 철학, 권고 수준 A+ — R0/R1/R2, 충돌 매트릭스, tie-breaker
강제력 B+ — 다양한 hook, Advisory 의존 A+ — 7 hook + Tier 2 게이트 + 검증
자기 검증 C — 없음 A — 19 시나리오 + CI 회귀
자기 개선 C — 없음 A — negative-example + self-improve
종합 A (88) A+ (95)

핵심 변화

이전 분석의 통찰 — "얼마나 많이 만들었냐보다 얼마나 강제할 수 있냐" — 이 P19 완료로 실현됨.

  • 양에서 밀리던 것 → 8개 핵심 스킬로 워크플로우 커버 (181개를 모두 따라잡을 필요 없음)
  • 강제력에서 앞서던 것 → Hook 7개 + Tier 2 게이트 + 테스트 + CI로 실증 가능한 수준으로 강화
  • 없었던 것 → 자기 개선 루프(P18), 컨텍스트 최적화(P1/P15), 거버넌스 프리셋(P17/P19)

ECC가 여전히 앞서는 것: 규모(181 스킬), 커뮤니티(170+ contributors), 배포 편의(npm), 언어 생태계(12+), 다국어 문서(7개).

ai-rules가 앞서는 것: 규칙 설계 깊이, 결정적 강제력, 자기 검증, 자기 개선, 멀티 도구 동기화, 프로젝트별 적응, 컨텍스트 효율.

"넓고 많은 ECC" vs "깊고 강한 ai-rules" — 이제 ai-rules도 깊이를 유지하면서 실질적 강제력과 자기 검증까지 갖춤. 양보다 실효성을 기준으로 하면 역전.