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
• 아키텍처: 하이브리드 모듈 구조
• 테스트 위치: 별도 분리

이 기술을 사용하는 경우

다음과 같은 경우 이 기술을 활성화하세요:

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

커밋 컨벤션

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

커밋 스타일: Conventional Commits

사용되는 접두사

• 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

명명 규칙

요소	규칙
파일	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)

기능 개발 (Feature Development)

표준 기능 구현 워크플로우

빈도: 월 약 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

언어 규칙 추가 (Add Language Rules)

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

빈도: 월 약 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

새로운 기술 추가 (Add New Skill)

새로운 기술을 시스템에 추가하고, 워크플로우, 트리거 및 사용법을 문서화하며, 종종 지원 스크립트를 포함합니다.

빈도: 월 약 4회

단계:

1. skills/{skill-name}/ 아래에 새 디렉토리 생성
2. 문서(사용 시기, 작동 방식, 예시 등)가 포함된 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

새로운 에이전트 추가 (Add New Agent)

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

빈도: 월 약 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

새로운 명령 추가 (Add New Command)

시스템에 새로운 명령을 추가하며, 종종 지원 기술과 쌍을 이룹니다.

빈도: 월 약 1회

단계:

1. commands/{command-name}.md 아래에 새 마크다운 파일 생성
2. (선택 사항) skills/{skill-name}/SKILL.md 아래에 지원 기술 추가 또는 업데이트

관련 파일:

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

예시 커밋 시퀀스:

Create a new markdown file under commands/{command-name}.md
Optionally add or update a backing skill under skills/{skill-name}/SKILL.md

카탈로그 수치 동기화 (Sync Catalog Counts)

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

하네스 교차 기술 복사본 추가 (Add Cross Harness Skill Copies)

다양한 에이전트 하네스(예: 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

훅 추가 또는 업데이트 (Add Or Update 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/

리뷰 피드백 반영 (Address Review Feedback)

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

빈도: 월 약 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에 의해 자동으로 생성되었습니다. 팀의 필요에 따라 검토하고 수정하세요.