intellectronica/ruler

해결하는 문제

GitHub Copilot, Cursor, Claude 등의 여러 AI 코딩 어시스턴트의 지침을 관리하면 가이드라인의 불일치, 여러 구성 파일 간의 중복 작업, 컨텍스트의 이탈이 발생하기 쉽습니다. Ruler는 이러한 지침에 대한 단일 진실 소스를 제공하여, 사용하는 도구에 관계없이 프로젝트 내 모든 AI 에이전트가 동일한 규칙을 따르도록 보장합니다.

작동 방식

Ruler는 Markdown 파일을 사용하여 .ruler/ 디렉터리에 AI 지침을 중앙 집중화합니다. apply 명령을 실행하면 이 규칙들을 결합하고, 다양한 지원되는 AI 에이전트에 필요한 특정 구성 파일로 자동으로 배포합니다. 중첩된 규칙 로딩을 지원하여, 하위 디렉터리에 .ruler/ 디렉터리를 배치함으로써 프로젝트의 다양한 구성 요소(예: 프론트엔드와 백엔드용 별도 규칙)에 맞는 컨텍스트 기반 지침을 제공할 수 있습니다.

대상 사용자

여러 AI 코딩 도구를 사용하면서 코드베이스 전체에 걸쳐 일관된 AI 행동과 프로젝트별 지침을 유지하고자 하는 개발자 및 팀.

주요 기능

• 중앙 집중 관리: Markdown을 사용해 모든 지침을 한 곳에 저장.
• 광범위한 에이전트 지원: GitHub Copilot, Claude Code, Cursor, Windsurf, Aider 등 수많은 도구와 호환.
• 중첩 규칙 로딩: 재귀적인 .ruler/ 디렉터리 탐색을 통해 복잡한 프로젝트 구조와 모노레포에 대응.
• MCP 서버 전파: Model Context Protocol (MCP) 서버 설정을 에이전트 간에 관리하고 배포.
• 자동화: 생성된 에이전트 구성 파일이 버전 관리에 포함되지 않도록 .gitignore를 자동으로 업데이트.