intellectronica/ruler

어떤 프로젝트인가요?

핵심 기능

• 01모든 에이전트 지침을 하나의 `.ruler/` 디렉터리에 Markdown으로 저장합니다.
• 02Claude Code, Cursor, Copilot, Codex CLI, Windsurf를 비롯한 30개 이상의 에이전트용 규칙 파일을 생성합니다.
• 03`ruler.toml`의 MCP 서버 정의를 각 에이전트의 기본 MCP 설정 파일에 기록합니다.
• 04생성된 파일을 제외하도록 `.gitignore`를 자동으로 업데이트하고 `.bak` 백업 파일을 만듭니다.
• 05`ruler revert`로 `apply`가 적용한 변경 사항을 되돌릴 수 있습니다.
• 06모노레포에서 실험적인 중첩 규칙 로딩을 지원합니다.

활용 사례

• Claude Code와 Cursor를 함께 사용하며 두 도구에서 동일한 코딩 표준을 적용하려는 팀.
• 개발자마다 서로 다른 AI 어시스턴트를 사용해도 하나의 프로젝트 규칙을 동기화하려는 경우.
• 프런트엔드, 백엔드, 테스트 디렉터리마다 서로 다른 에이전트 지침이 필요한 모노레포.
• 각 설정을 직접 편집하지 않고 여러 코딩 에이전트에 공통 MCP 서버 설정을 배포하려는 경우.

빠른 시작

1. 1

   npm으로 Ruler를 전역 설치합니다

   npm install -g @intellectronica/ruler
2. 2

   프로젝트 루트로 이동해 .ruler/ 디렉터리를 초기화합니다

   ruler init
3. 3

   .ruler/의 규칙 파일을 수정한 다음 agent config 파일을 생성합니다

   ruler apply

사용 전 알아둘 점

• !Node.js ^20.19.0, ^22.12.0 또는 >=23이 필요합니다.
• !아직 베타 연구 프리뷰 단계이므로 동작이 변경될 수 있습니다.
• !중첩 규칙 로딩은 실험적 기능이며 향후 릴리스에서 변경될 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

ruler은(는) 무엇인가요?

`.ruler/`에 Markdown 규칙을 한곳에 관리하고, 30개가 넘는 AI 코딩 에이전트의 지침 파일과 MCP 설정 파일을 생성하는 CLI입니다. Ruler는 여러 AI 코딩 어시스턴트에서 같은 코딩 지침을 유지하기 어렵다는 문제를 해결합니다. 각 도구는 `CLAUDE.md`, `.cursor` 규칙, `.clinerules`처럼 서로 다른 파일을 사용합니다. `.ruler/` 디렉터리에 Markdown 파일로 지침을 한 번 작성하면 `ruler apply` 명령이 각 지원 에이전트가 읽는 설정 파일에 배포합니다.

ruler은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ruler은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ruler은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ruler의 마지막 커밋은 2026년 11월 4일입니다.

ruler은(는) 어디에 사용할 수 있나요?

Claude Code와 Cursor를 함께 사용하며 두 도구에서 동일한 코딩 표준을 적용하려는 팀. 개발자마다 서로 다른 AI 어시스턴트를 사용해도 하나의 프로젝트 규칙을 동기화하려는 경우. 프런트엔드, 백엔드, 테스트 디렉터리마다 서로 다른 에이전트 지침이 필요한 모노레포. 각 설정을 직접 편집하지 않고 여러 코딩 에이전트에 공통 MCP 서버 설정을 배포하려는 경우.

ruler는 어떻게 설치하나요?

npm으로 Ruler를 전역 설치합니다: npm install -g @intellectronica/ruler 프로젝트 루트로 이동해 .ruler/ 디렉터리를 초기화합니다: ruler init .ruler/의 규칙 파일을 수정한 다음 agent config 파일을 생성합니다: ruler apply

ruler은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/intellectronica/ruler