lifedever/claude-rules

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에서 아무 프로젝트나 열고 다음을 실행하십시오:

/init-rules

플러그인은 다음 작업을 수행합니다:

• 프로젝트의 기술 스택 (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 규칙 템플릿 라이브러리