마크다운 파일에서 AI 규칙 추출을 위한 mq 도구 활용
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
DevOps
대상자
- 소프트웨어 개발자 (특히 다중 시스템 AI 규칙 관리 필요성 있는 프로젝트 담당자)
- 난이도: 중급 이상 (명령어 기반 툴 사용 경험 필요)
핵심 요약
- 단일 원천 파일 관리: 모든 AI 규칙을
master-ai-rules.md하나의 파일로 통합 (Single source of truth) - 자동화된 규칙 생성:
mq명령어로 특정 시스템(예: Claude, GPT) 규칙 파일을 자동 생성 (Automatic generation) - 버전 관리 최적화: 하나의 파일로 변경 내역 추적 가능 (
Version control friendly)
섹션별 세부 요약
1. 문제 정의 및 솔루션 소개
- 다중 시스템(AI) 규칙 파일 관리의 복잡성 강조
mq툴을 통해 하나의 마스터 파일에서 여러 규칙 파일 생성 가능- 예시:
Claude Rules,GPT Rules,Gemini Rules별로 분리된 파일 생성
2. 명령어 예시 및 사용법
mq명령어 구조:
```bash
$ mq 'nodes | sections(2) | filter(fn(s): contains(first(s), "Claude Rules")) | first() | map(decrease_header_level) | to_markdown_string()' master-ai-rules.md > claude-rules.md
```
- 필터링 조건: 헤더에 "Claude Rules" 포함된 섹션 추출
- 헤더 레벨 조정:
map(decrease_header_level)으로 구조 재정의
3. 주요 장점 강조
- 유지보수성 향상: 규칙 수정 시 단일 파일에서 이루어짐
- 플랫폼 독립성: 생성된 파일은 일반 Markdown 형식 (Vendor lock-in 방지)
- CI/CD 통합 가능성: 자동화 스크립트로 배포 프로세스에 쉽게 통합
4. 설치 및 활용 방법
- 설치 명령어:
```bash
$ brew install harehare/tap/mq
```
- 활용 사례: GitHub 저장소, 온라인 플레이그라운드, 문서화 자료 제공
결론
- 실무 적용 팁: 복잡한 AI 규칙 관리 시
mq를 활용해 마스터 파일로 통합하고, 필요 시 자동 생성 - 추천: 다중 시스템 규칙 관리 프로젝트에서
mq도구 도입을 고려 (예: Claude, GPT, Gemini 규칙 파일 분리) - 참고: GitHub 저장소와 문서화 자료를 통해 명령어 세부 구문 확인 가능