ciembor/agent-rules-books

What it solves

이 프로젝트는 AI 코딩 에이전트(Cursor, Claude Code, Codex 등)가 확립된 소프트웨어 엔지니어링 원칙을 따르도록 보장하기 위해 즉시 사용 가능한 규칙 세트와 "기술" 라이브러리를 제공합니다. 단순히 에이전트에게 "Clean Code를 따르라"고 말하는 대신, 이 프로젝트는 에이전트가 리팩토링 및 개발 과정에서 잘못된 아키텍처 결정을 내리거나 산업 표준 디자인 패턴을 무시하는 것을 방지하기 위한 구체적이고 정제된 지침을 제공합니다.

How it works

본 프로젝트는 고전적인 소프트웨어 엔지니어링 서적(예: Clean Code, Domain-Driven Design, Refactoring)의 핵심 원칙을 도구에 구애받지 않는 Markdown 파일로 추출합니다. 이러한 규칙은 세부 사항과 컨텍스트 윈도우(context window) 제한 사이의 균형을 맞추기 위해 세 가지 크기로 제공됩니다:

• Full: 전체 참조 버전.
• Mini: 대부분의 작업에 권장되는 버전.
• Nano: 매우 제한된 컨텍스트 예산(context budgets)을 위한 컴팩트 버전.

사용자는 CLI 도구(npx skills)를 사용하여 이러한 규칙을 "기술"로 설치하거나, AGENTS.md 또는 CLAUDE.md와 같은 프로젝트 특정 지침 파일에 수동으로 추가할 수 있습니다.

Who it’s for

AI 코딩 어시스턴트를 사용하는 개발자 중, 에이전트의 기본(그리고 때로는 일관성 없는) 동작에 의존하기보다 검증된 아키텍처 패턴을 기반으로 에이전트가 더 높은 품질의 유지보수가 용이한 코드를 생성하도록 원하는 분들.

Highlights

• Comprehensive Library: DDD, Clean Architecture, legacy code handling, 데이터 집약적 시스템 등 광범위한 도메인을 다룹니다.
• Context-Aware Sizing: 토큰 사용량을 최적화하기 위해 다양한 규칙 밀도(Full, Mini, Nano)를 제공합니다.
• Tool Agnostic: Cursor, Claude Code, Codex, GitHub Copilot을 포함한 주요 AI 에디터 및 에이전트와 호환됩니다.
• Empirically Tested: 구체적인 규칙을 제공하는 것이 단순히 책 이름을 언급하는 것보다 아키텍처 판단력을 크게 향상시킨다는 것을 보여주는 검증 실험을 포함합니다.