English | 中文
AI 코딩 어시스턴트 (AI coding assistants)를 위한 코딩 표준 템플릿 라이브러리입니다. 기본 (base) + 언어 (language) + 프레임워크 (framework) 레이어를 결합하여, AI가 생성한 코드를 깨끗하고 일관되게 유지하는 프로젝트별 규칙 파일을 생성합니다.
AI 코딩 어시스턴트는 기존 프로젝트의 코드 스타일을 모방하는 경향이 있으며, 여기에는 나쁜 습관도 포함됩니다. 이 라이브러리의 핵심 원칙은 다음과 같습니다:
기존 코드 (legacy code)를 모방하지 마십시오. 표준에 따라 리팩터링 (Refactor) 하십시오.
모든 규칙은 구체적이고 실행 가능한 지침(모호한 "적절한 XX를 사용하세요"가 아님)이며, "Bad / Good" 코드 비교 예시를 포함하고 있습니다.
claude-rules/
├── base/ # 공통 (필수)
│ ├── core.md # 핵심 원칙: 기존 코드에 대한 태도, 품질 지표, 명명 규칙 (naming), 아키텍처 (architecture)
...
┌─────────────────────────────────────────────┐
│ base (필수) │ core.md + git.md
│ 기존 코드에 대한 태도 / 품질 지표 / │ 모든 프로젝트에 적용
...
규칙 우선순위 (Rule priority): 프레임워크 (framework) > 언어 (language) > 기본 (base) (특정 규칙이 일반 규칙을 덮어씁니다)
# 1단계: 마켓플레이스 추가
claude plugin marketplace add lifedever/claude-rules
# 2단계: 플러그인 설치
...
Claude Code에서 아무 프로젝트나 열고 다음을 실행하십시오:
플러그인은 다음 작업을 수행합니다:
- 프로젝트의 기술 스택 (tech stack) 자동 감지 (TypeScript, Vue, React 등)
- 감지된 스택 확인 요청
- 플러그인에서 일치하는 규칙 파일 읽기
- 프로젝트 루트에
CLAUDE.md 생성
업스트림 (upstream)에 새로운 규칙이 추가되면 로컬 캐시를 업데이트하십시오:
claude plugin marketplace update claude-rules
그 다음 Claude Code를 재시작하십시오. 이미 CLAUDE.md가 있는 프로젝트에 업데이트된 규칙을 적용하려면 /init-rules를 다시 실행하십시오. 플러그인이 덮어쓰기 전에 확인을 요청할 것입니다.
claude plugin uninstall init-claude-rules@claude-rules
claude plugin marketplace remove claude-rules
이 저장소를 클론 (Clone) 하고 필요한 규칙 파일들을 결합하십시오:
git clone https://github.com/lifedever/claude-rules.git
cd claude-rules
# 예시: Vue 3 + TypeScript 프로젝트
...
이 규칙들은 일반적인 Markdown 형식이며 모든 AI 코딩 도구와 함께 작동합니다. 사용 중인 도구가 요구하는 위치에 출력물을 배치하기만 하면 됩니다:
| 도구 | 대상 파일 |
|---|
| Claude Code | CLAUDE.md |
| ... | |
실행 가능성 (Actionable)— 모든 규칙은 AI에 의해 직접 실행 가능하며, 모호한 표현을 사용하지 않습니다.
예시 제공 (Exemplified)— 주요 규칙에는 "나쁜 (Bad)" 코드와 "좋은 (Good)" 코드의 비교가 포함됩니다.
정량화 (Quantified)— 함수 ≤30행, 파일 ≤300행, 중첩(nesting) ≤3단계, 파라미터(parameters) ≤4개.
최신성 유지 (Up-to-date)— 각 언어/프레임워크의 현대적인 API를 사용합니다 (@Observable, record, as const 등).
실질적 내용 (Not hollow)— "에러를 적절히 처리하라" 대신, 에러를 처리하는 구체적인 방법을 명시합니다.
새로운 언어나 프레임워크에 대한 PR (Pull Request)을 환영합니다. 다음 가이드라인을 준수해 주세요:
-
규칙은 구체적이고 실행 가능해야 합니다 — "적절한/올바른 사용"과 같은 표현은 피하세요.
-
주요 규칙에는 코드 예시(나쁜 사례 + 좋은 사례)를 포함해야 합니다.
-
현대적인 관용구 (modern idioms)를 권장하세요 — 오래된 API를 문서화하지 마세요.
-
영어로 작성하세요.
-
flyeric0212/cursor-rules — Cursor IDE 규칙 템플릿 라이브러리