intellectronica/ruler

해결하는 문제

AI 코딩 어시스턴트의 지침을 관리하는 것은 어렵습니다. 각 도구(예: Cursor, Claude Code, Aider, GitHub Copilot)마다 서로 다른 구성 파일과 형식을 사용하기 때문입니다. 이로 인해 지침이 일관되지 않고, 작업이 중복되며, 프로젝트 요구 사항이 변경됨에 따라 '컨텍스트 드리프트'가 발생합니다. Ruler는 모든 AI 지침에 대한 단일 정보원을 제공하며, 각 에이전트가 필요로 하는 올바른 구성 파일로 자동으로 배포합니다.

작동 방식

Ruler는 프로젝트 내의 중앙 .ruler/ 디렉토리를 사용하여 AI 지침을 Markdown 파일로 저장합니다. ruler apply 명령을 실행하면 도구가 이러한 규칙을 집계하여 선택한 AI 에이전트가 요구하는 특정 구성 파일에 주입합니다. 중첩된 규칙 로딩을 지원하므로 프로젝트 루트에서 전역 규칙을 정의하고, 하위 디렉토리(예: src/ 또는 tests/)에서 구성 요소별 규칙으로 이를 재정의하거나 확장할 수 있습니다.

대상 사용자

이 도구는 여러 AI 보조 코딩 도구를 사용하며, 수동으로 구성을 업데이트하지 않고도 모든 도구에서 일관된 프로젝트 가이드라인, 코딩 표준 및 아키텍처 제약 조건을 유지하려는 개발자와 팀을 위해 설계되었습니다.

주요 특징

• 중앙 집중식 관리: 표준 Markdown 파일을 사용하여 모든 AI 지침을 한곳에서 관리합니다.
• 광범위한 에이전트 지원: Cursor, Aider, Claude Code, GitHub Copilot을 포함한 수십 개의 인기 있는 AI 코딩 에이전트와 호환됩니다.
• 중첩 구성: 계층적 규칙 로딩을 지원하여 모노레포나 복잡한 구성 요소가 있는 프로젝트에 적합합니다.
• 자동화된 워크플로우: MCP (Model Context Protocol) 서버 설정을 자동으로 처리하고 .gitignore를 업데이트하여 생성된 파일이 버전 제어에 포함되지 않도록 합니다.
• 안전한 복구: revert 명령이 포함되어 있어 변경 사항을 쉽게 롤백하고 원래 구성을 복원할 수 있습니다.