매번 똑같은 AI 코딩 지침을 반복하는 것이 지겨워져서 ai-rules를 만들었습니다
요약
AI 코딩 에이전트 사용 시 매번 반복되는 지침 입력의 번거로움을 해결하기 위해 개발된 'ai-rules'를 소개합니다. 이 도구는 로컬 기반의 CLI로, 프로젝트별로 필요한 규칙을 효율적으로 관리할 수 있게 해줍니다.
핵심 포인트
- 매 세션마다 동일한 코딩 지침을 반복해야 하는 불편함 해결
- 대규모 지침 파일의 비효율성과 관련 없는 규칙 노출 문제 개선
- 로컬 우선 방식의 CLI 도구로 Markdown 파일을 통해 규칙 관리
- 개인별 맞춤형 AI 코딩 규칙을 프로젝트 맥락에 맞게 적용 가능
저는 점점 더 많은 AI 코딩 에이전트 (AI coding agents)를 사용하고 있는데, 한 가지 계속 저를 짜증 나게 하는 것이 있었습니다:
매 세션마다 똑같은 지침을 반복해야 한다는 점이었습니다.
예를 들면 다음과 같은 것들입니다:
- diff를 작게 유지할 것
- React 컴포넌트 내부에서 직접 데이터를 가져오지 말 것
- 기존 아키텍처 (architecture)를 따를 것
- 동작이 변경될 때 테스트를 추가할 것
- 필요하지 않다면 새로운 패턴을 도입하지 말 것
- 위험한 변경을 수행하기 전에 미리 설명할 것
처음에는 AGENTS.md와 같은 커다란 지침 파일로 이를 처리했습니다. 잠시 동안은 효과가 있었지만, 두 가지 문제가 있었습니다:
- 파일이 계속 커집니다.
- 대부분의 지침이 현재 작업과 관련이 없습니다. 만약 제가 에이전트에게 React 컴포넌트를 변경해 달라고 요청한다면, 커밋 메시지 (commit messages), 백엔드 핸들러 (backend handlers), 데이터베이스 마이그레이션 (database migrations) 또는 릴리스 노트 (release notes)에 관한 규칙은 아마 필요하지 않을 것입니다. 그리고 여러 프로젝트를 넘나들며 작업한다면, 그 지침들을 여기저기 복사하거나 다시 작성해야 합니다.
그래서 저는 ai-rules를 만들었습니다.
ai-rules란 무엇인가
ai-rules는 개인용 AI 코딩 규칙을 위한 작고 로컬 우선 (local-first) 방식의 CLI입니다. 규칙은 다음 경로의 Markdown 파일로 저장됩니다:
~/.config/ai-rules/rules/
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기