everything-claude-code-conventions

name	everything-claude-code-conventions
description	everything-claude-code를 위한 개발 컨벤션 및 패턴. Conventional Commits를 사용하는 JavaScript 프로젝트.

Everything Claude Code 컨벤션

2026-03-20에 affaan-m/everything-claude-code로부터 생성됨

개요

이 스킬은 Claude에게 everything-claude-code에서 사용되는 개발 패턴과 컨벤션을 가르칩니다.

기술 스택

• 주요 언어: JavaScript
• 아키텍처: 하이브리드 모듈 조직
• 테스트 위치: 별도 분리

이 스킬의 사용 시점

다음의 경우 이 스킬을 활성화하세요:

• 이 저장소에 변경 사항을 적용할 때
• 확립된 패턴에 따라 새로운 기능을 추가할 때
• 프로젝트 컨벤션에 맞는 테스트를 작성할 때
• 적절한 메시지 형식으로 커밋을 생성할 때

커밋 컨벤션 (Commit Conventions)

500개의 분석된 커밋을 바탕으로 다음 커밋 메시지 컨벤션을 따르세요.

커밋 스타일: Conventional Commits

사용되는 접두사 (Prefixes)

• fix
• test
• feat
• docs

메시지 가이드라인

• 평균 메시지 길이: 약 65자
• 첫 줄은 간결하고 설명적으로 유지
• 명령조 사용 ("Add feature" 사용, "Added feature" 금지)

커밋 메시지 예시

feat(rules): add C# language support

커밋 메시지 예시

chore(deps-dev): bump flatted (#675)

커밋 메시지 예시

fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691)

커밋 메시지 예시

docs: add Antigravity setup and usage guide (#552)

커밋 메시지 예시

merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer

커밋 메시지 예시

Revert "Add Kiro IDE support (.kiro/) (#548)"

커밋 메시지 예시

Add Kiro IDE support (.kiro/) (#548)

커밋 메시지 예시

feat: add block-no-verify hook for Claude Code and Cursor (#649)

아키텍처

프로젝트 구조: 단일 패키지

이 프로젝트는 하이브리드 모듈 조직을 사용합니다.

설정 파일

• .github/workflows/ci.yml
• .github/workflows/maintenance.yml
• .github/workflows/monthly-metrics.yml
• .github/workflows/release.yml
• .github/workflows/reusable-release.yml
• .github/workflows/reusable-test.yml
• .github/workflows/reusable-validate.yml
• .opencode/package.json
• .opencode/tsconfig.json
• .prettierrc
• eslint.config.js
• package.json

가이드라인

• 이 프로젝트는 하이브리드 조직을 사용합니다.
• 새로운 코드를 추가할 때 기존 패턴을 따르세요.

코드 스타일

언어: JavaScript

명명 규칙 (Naming Conventions)

요소	컨벤션
파일	camelCase
함수	camelCase
클래스	PascalCase
상수	SCREAMING_SNAKE_CASE

임포트 스타일: 상대 경로 임포트 (Relative Imports)

익스포트 스타일: 혼합 스타일 (Mixed Style)

권장 임포트 스타일

// 상대 경로 임포트 사용
import { Button } from '../components/Button'
import { useAuth } from './hooks/useAuth'

테스트

테스트 프레임워크

특정 테스트 프레임워크가 감지되지 않았습니다 — 저장소의 기존 테스트 패턴을 사용하세요.

파일 패턴: *.test.js

테스트 유형

• 단위 테스트 (Unit tests): 개별 함수 및 컴포넌트를 격리하여 테스트
• 통합 테스트 (Integration tests): 여러 컴포넌트/서비스 간의 상호작용 테스트

커버리지

이 프로젝트는 커버리지 보고가 구성되어 있습니다. 80% 이상의 커버리지를 목표로 하세요.

에러 처리

에러 처리 스타일: Try-Catch 블록

표준 에러 처리 패턴

try {
  const result = await riskyOperation()
  return result
} catch (error) {
  console.error('Operation failed:', error)
  throw new Error('User-friendly message')
}

공통 워크플로우

커밋 패턴 분석을 통해 다음 워크플로우가 감지되었습니다.

데이터베이스 마이그레이션

마이그레이션 파일을 통한 데이터베이스 스키마 변경

빈도: 월 약 2회

단계:

1. 마이그레이션 파일 생성
2. 스키마 정의 업데이트
3. 타입 생성/업데이트

관련 파일:

• **/schema.*
• migrations/*

커밋 시퀀스 예시:

feat: implement --with/--without selective install flags (#679)
fix: sync catalog counts with filesystem (27 agents, 113 skills, 58 commands) (#693)
feat(rules): add Rust language rules (rebased #660) (#686)

기능 개발

표준 기능 구현 워크플로우

빈도: 월 약 22회

단계:

1. 기능 구현 추가
2. 기능에 대한 테스트 추가
3. 문서 업데이트

관련 파일:

• manifests/*
• schemas/*
• **/*.test.*
• **/api/**

커밋 시퀀스 예시:

feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies
fix: address PR review — skill template (When to use, How it works, Examples), bun.lock, next build note, rust-reviewer CI note, doc-lookup privacy/uncertainty

언어 규칙 추가

규칙 시스템에 새로운 프로그래밍 언어를 추가하며, 코딩 스타일, 훅, 패턴, 보안 및 테스트 가이드라인을 포함합니다.

빈도: 월 약 2회

단계:

1. rules/{language}/ 아래에 새 디렉토리 생성
2. 언어별 내용이 포함된 coding-style.md, hooks.md, patterns.md, security.md, testing.md 파일 추가
3. 선택적으로 관련 기술 참조 또는 링크 추가

관련 파일:

• rules/*/coding-style.md
• rules/*/hooks.md
• rules/*/patterns.md
• rules/*/security.md
• rules/*/testing.md

커밋 시퀀스 예시:

Create a new directory under rules/{language}/
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
Optionally reference or link to related skills

새로운 기술(Skill) 추가

시스템에 새로운 기술을 추가하고 워크플로우, 트리거, 사용법을 문서화하며, 흔히 보조 스크립트를 동반합니다.

빈도: 월 약 4회

단계:

1. skills/{skill-name}/ 아래에 새 디렉토리 생성
2. 문서(When to Use, How It Works, Examples 등)가 포함된 SKILL.md 추가
3. 선택적으로 skills/{skill-name}/scripts/ 아래에 스크립트 또는 보조 파일 추가
4. 리뷰 피드백 반영 및 문서 반복 개선

관련 파일:

• skills/*/SKILL.md
• skills/*/scripts/*.sh
• skills/*/scripts/*.js

커밋 시퀀스 예시:

Create a new directory under skills/{skill-name}/
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
Optionally add scripts or supporting files under skills/{skill-name}/scripts/
Address review feedback and iterate on documentation

새로운 에이전트 추가

코드 리뷰, 빌드 해결 또는 기타 자동화된 작업을 위해 시스템에 새로운 에이전트를 추가합니다.

빈도: 월 약 2회

단계:

1. agents/{agent-name}.md 아래에 새 에이전트 마크다운 파일 생성
2. AGENTS.md에 에이전트 등록
3. 선택적으로 README.md 및 docs/COMMAND-AGENT-MAP.md 업데이트

관련 파일:

• agents/*.md
• AGENTS.md
• README.md
• docs/COMMAND-AGENT-MAP.md

커밋 시퀀스 예시:

Create a new agent markdown file under agents/{agent-name}.md
Register the agent in AGENTS.md
Optionally update README.md and docs/COMMAND-AGENT-MAP.md

새로운 워크플로우 표면(Surface) 추가

워크플로우 엔트리포인트를 추가하거나 업데이트합니다. 기술(Skill) 우선 방식을 기본으로 하며, 레거시 슬래시 명령어 호환성이 필요한 경우에만 명령어 심(shim)을 추가합니다.

빈도: 월 약 1회

단계:

1. skills/{skill-name}/SKILL.md 아래에 표준 워크플로우 생성 또는 업데이트
2. 필요한 경우에만 호환성 심으로 commands/{command-name}.md를 추가하거나 업데이트

관련 파일:

• skills/*/SKILL.md
• commands/*.md (의도적으로 레거시 심을 유지하는 경우에만)

커밋 시퀀스 예시:

Create or update the canonical skill under skills/{skill-name}/SKILL.md
Only if needed, add or update commands/{command-name}.md as a compatibility shim

카탈로그 카운트 동기화

AGENTS.md와 README.md에 문서화된 에이전트, 기술, 명령어 개수를 실제 저장소 상태와 동기화합니다.

빈도: 월 약 3회

단계:

1. AGENTS.md에서 에이전트, 기술, 명령어 개수 업데이트
2. README.md(빠른 시작, 비교 표 등)에서 동일한 개수 업데이트
3. 선택적으로 다른 문서 파일 업데이트

관련 파일:

• AGENTS.md
• README.md

커밋 시퀀스 예시:

Update agent, skill, and command counts in AGENTS.md
Update the same counts in README.md (quick-start, comparison table, etc.)
Optionally update other documentation files

크로스 하네스 기술 복제본 추가

플랫폼 간 호환성을 보장하기 위해 서로 다른 에이전트 하네스(예: Codex, Cursor, Antigravity)용 기술 복제본을 추가합니다.

빈도: 월 약 2회

단계:

1. SKILL.md를 .agents/skills/{skill}/SKILL.md 및/또는 .cursor/skills/{skill}/SKILL.md로 복사하거나 조정
2. 선택적으로 하네스 전용 openai.yaml 또는 설정 파일 추가
3. CONTRIBUTING 템플릿에 맞게 리뷰 피드백 반영

관련 파일:

• .agents/skills/*/SKILL.md
• .cursor/skills/*/SKILL.md
• .agents/skills/*/agents/openai.yaml

커밋 시퀀스 예시:

Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
Optionally add harness-specific openai.yaml or config files
Address review feedback to align with CONTRIBUTING template

훅(Hook) 추가 또는 업데이트

워크플로우, 품질 또는 보안 정책을 강제하기 위해 git 또는 bash 훅을 추가하거나 업데이트합니다.

빈도: 월 약 1회

단계:

1. hooks/ 또는 scripts/hooks/에 훅 스크립트 추가 또는 업데이트
2. hooks/hooks.json 또는 유사한 설정에 훅 등록
3. 선택적으로 tests/hooks/에 테스트 추가 또는 업데이트

관련 파일:

• hooks/*.hook
• hooks/hooks.json
• scripts/hooks/*.js
• tests/hooks/*.test.js
• .cursor/hooks.json

커밋 시퀀스 예시:

Add or update hook scripts in hooks/ or scripts/hooks/
Register the hook in hooks/hooks.json or similar config
Optionally add or update tests in tests/hooks/

리뷰 피드백 반영

명확성, 정확성 또는 컨벤션 일치를 위해 문서, 스크립트 또는 설정을 업데이트하여 코드 리뷰 피드백을 반영합니다.

빈도: 월 약 4회

단계:

1. 리뷰어의 코멘트를 반영하기 위해 SKILL.md, 에이전트 또는 명령어 파일 수정
2. 요청된 대로 예시, 제목 또는 설정 업데이트
3. 모든 리뷰 피드백이 해결될 때까지 반복

관련 파일:

• skills/*/SKILL.md
• agents/*.md
• commands/*.md
• .agents/skills/*/SKILL.md
• .cursor/skills/*/SKILL.md

커밋 시퀀스 예시:

Edit SKILL.md, agent, or command files to address reviewer comments
Update examples, headings, or configuration as requested
Iterate until all review feedback is resolved

모범 사례

코드베이스 분석을 바탕으로 다음 관행을 따르세요:

권장 사항 (Do)

• Conventional Commit 형식(feat:, fix: 등)을 사용하세요.
• *.test.js 명명 패턴을 따르세요.
• 파일 이름에 camelCase를 사용하세요.
• 혼합 익스포트(Mixed exports)를 선호하세요.

금지 사항 (Don't)

• 모호한 커밋 메시지를 작성하지 마세요.
• 새로운 기능에 대한 테스트를 생략하지 마세요.
• 논의 없이 확립된 패턴에서 벗어나지 마세요.

---

이 기술은 ECC Tools에 의해 자동으로 생성되었습니다. 팀의 필요에 따라 검토하고 커스터마이징하세요.