rulesync: 다양한 AI 코딩 툴의 규칙 파일을 통합 관리하는 CLI 도구

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

- AI 코딩 툴(Claude Code, Cursor, GitHub Copilot 등)을 사용하는 개발자

- 여러 AI 툴 간 규칙 파일을 매뉴얼로 관리하는 개발팀

- 툴 간 일관된 코드 품질 유지가 필요한 프로젝트 팀

- 중간 수준 이상의 JavaScript/Node.js 개발자(이미 npm 설치 필요)

핵심 요약

• rulesync는 .rulesync/*.md 파일 하나로 Claude Code, Cursor, GitHub Copilot 등 6개 AI 툴의 규칙 파일을 일괄 생성/관리
• 프로젝트별 규칙 파일 일관성 유지 및 툴 간 전환 시 수동 동기화를 완전히 제거
• npm 패키지로 제공되어 npx rulesync 명령어로 즉시 사용 가능

섹션별 세부 요약

1. 도구 소개 및 목적

• rulesync는 AI 코딩 툴의 규칙 파일 형식이 툴마다 다르며, 규칙 변경 시 수동 동기화가 필요하다는 문제를 해결
• npx rulesync init 명령어로 초기 설정, npx rulesync generate로 규칙 파일 일괄 생성
• 생성된 파일 위치: .github/instructions/, .cursor/rules/, .claude/memories/ 등

2. 지원 툴 및 파일 구조

• 지원 툴: Claude Code, Gemini CLI, GitHub Copilot, Cursor, Cline, Roo Code
• 각 툴별 생성 파일 예시:

- CLAUDE.md → .claude/memories/*.md

- GEMINI.md → .gemini/memories/*.md

- .github/instructions/*.instructions.md

- .cursor/rules/*.mdc

3. 핵심 기능 및 이점

• 툴 간 규칙 파일 동기화 자동화 → npx rulesync import --cursor로 기존 파일을 .rulesync/*.md로 변환 가능
• 프로젝트별 규칙 파일 일관성 유지 → 동일한 규칙 내용을 모든 툴에 적용 가능
• 사용자 자유도 보장 → rulesync 사용 중단 시 생성된 파일 그대로 유지, 수동 관리로 전환 가능

4. 구현 방식 및 테스트

• Claude Code로 전체 구현 → 개발자는 코드 작성 없이 명세 전달 → 테스트 코드도 Claude Code가 생성
• 테스트 커버리지 90% 이상 달성 → 로컬 실행 환경이 단순한 CLI 도구 특성 활용
• 네트워크 기반 복잡 시스템과의 차이 → Rails 앱 생성 및 Cloud Run 배포는 개발자 개입 필요

5. 사용 편의성 및 확장성

• .gitignore 자동 추가 기능 → npx rulesync gitignore으로 생성 경로 자동 .gitignore 등록
• Frontmatter 기반 Markdown 파일 지원 → 예:

```markdown

root: true

targets: ["*"]

description: "rulesync project overview and architecture guide"

globs: ["*"]

```

결론

• AI 코딩 툴 규칙 파일 관리의 복잡성을 해결하는 CLI 도구로, npx rulesync로 즉시 사용 가능
• 사용자 편의성과 툴 간 유연성을 동시에 확보한 솔루션
• 규칙 파일 일관성 유지 및 툴 전환 시 수동 작업 제거를 통해 개발 생산성 향상