출력 파일을 만드는 것과 그 파일을 이용해 최선의 답을 얻는 것은 완전히 다른 문제입니다. Repomix가 제공하는 고품질의 컨텍스트를 100% 활용하려면, 그에 맞는 정교한 프롬프트가 필요합니다.

이 편은 공식 문서의 예제들을 모아 만든 Repomix 프롬프트 쿡북입니다. 상황에 맞는 템플릿을 복사해 사용하시고, 프로젝트 특성에 맞춰 조금만 수정해 보세요.

바로 쓰는 첫 질문 템플릿

처음으로 결과물을 올릴 때 가장 효과적인 시작 문장입니다.

이 파일은 내 저장소의 모든 파일을 하나로 합친 스냅샷입니다.
전체적인 구조를 먼저 파악해 주시고, [원하는 작업: 예: 리팩터링 방향/버그 원인]에 대해 분석해 주세요.

AI는 파일 탐색 없이 코드베이스 전체를 한 번에 읽으므로, 훨씬 종합적이고 일관성 있는 인사이트를 제공합니다.

코드 리뷰를 위한 전문 템플릿

리뷰 목적에 따라 다음 템플릿을 활용하세요.

1. 아키텍처 및 구조 리뷰

Analyze this codebase's architecture:
1. Evaluate the overall structure and patterns
2. Identify potential architectural issues
3. Suggest improvements for scalability
4. Note areas that follow best practices

Focus on maintainability and modularity.

2. 보안 및 취약점 리뷰

Perform a security review of this codebase:
1. Identify potential security vulnerabilities
2. Check for common security anti-patterns
3. Review error handling and input validation
4. Assess dependency security

Provide specific examples and remediation steps.

3. 성능 최적화 리뷰

Review the codebase for performance:
1. Identify performance bottlenecks
2. Check resource utilization
3. Review algorithmic efficiency
4. Assess caching strategies

Include specific optimization recommendations.

핵심 포인트: 모든 템플릿은 번호가 매겨진 평가 항목과 구체적인 결과 형식을 지정하고 있습니다. 이렇게 해야 AI가 횡설수설하지 않고 필요한 정보를 정확히 제공합니다.

문서 생성을 위한 전문 템플릿

코드를 바탕으로 고품질의 문서를 자동 생성할 때 유용합니다.

1. 상세 API 문서 생성

Generate comprehensive API documentation:
1. List and describe all public endpoints
2. Document request/response formats
3. Include usage examples
4. Note any limitations or constraints

2. 개발자 온보딩 가이드

Create a developer guide covering:
1. Setup instructions
2. Project structure overview
3. Development workflow
4. Testing approach
5. Common troubleshooting steps

3. 시스템 아키텍처 설계서

Document the system architecture:
1. High-level overview
2. Component interactions
3. Data flow diagrams
4. Design decisions and rationale
5. System constraints and limitations

팁: 저장소 루트에 repomix-instruction.md 파일을 만들고 설정 파일에 등록하세요. 그러면 AI가 분석할 때 "이 프로젝트의 코딩 컨벤션"이나 "특별한 주의사항"을 먼저 읽고 문서를 작성하게 됩니다.

심층 분석 및 개선을 위한 템플릿

1. 의존성 분석 및 최적화

Analyze the project dependencies:
1. Identify outdated packages
2. Check for security vulnerabilities
3. Suggest alternative packages
4. Review dependency usage patterns

Include specific upgrade recommendations.

2. 테스트 커버리지 진단

Review the test coverage:
1. Identify untested components
2. Suggest additional test cases
3. Review test quality
4. Recommend testing strategies

3. 전반적인 코드 품질 평가

Assess code quality and suggest improvements:
1. Review naming conventions
2. Check code organization
3. Evaluate error handling
4. Review commenting practices

Provide specific examples of good and problematic patterns.

실전 활용 사례와 질문 예시

실제 개발 현장에서 Repomix를 어떻게 활용하는지 정리한 사례집입니다.

활용 사례	실제 질문 예시 (요지)	기대 효과
버그 원인 조사	"서버에 메모리 누수가 발생해 몇 시간 후 크래시가 납니다. 전체 코드를 분석해 원인을 찾아주세요."	파편화된 로그 분석을 넘어 코드 간의 상관관계를 통한 원인 파악
신규 기능 설계	"사용자 인증 기능을 추가하고 싶습니다. 현재 아키텍처를 검토해 가장 적합한 구현 방법을 제안해 주세요."	기존 패턴을 유지하는 일관성 있는 설계 가능
리팩터링	"유지보수성을 높이기 위해 리팩터링하고 싶습니다. 기존 기능은 유지하면서 구조를 개선할 방안을 주세요."	전역적인 영향도를 고려한 안전한 리팩터링
코드 리뷰	"이 코드베이스의 전반적인 품질을 검토하고, 잠재적인 이슈와 개선안을 제안해 주세요."	휴먼 에러를 줄이는 1차 필터링
문서 자동화	"API 문서와 설치 가이드를 포함한 종합적인 개발자 문서를 만들어 주세요."	수동 문서 작성 시간 획기적 단축
온보딩 가이드	"신규 개발자를 위해 아키텍처 개요와 먼저 읽어야 할 핵심 파일들을 짚어 주세요."	빠른 도메인 지식 습득 및 적응
보안 감사	"SQL 인젝션, XSS 등 전형적인 보안 취약점이 있는지 전수 점검하고 해결책을 주세요."	보안 누락 지점을 빠르게 식별
마이그레이션	"[A 프레임워크]에서 [B 프레임워크]로 옮기려 합니다. 단계별 계획과 리스크를 분석해 주세요."	마이그레이션 전략 수립 및 공수 산정

최고의 결과를 얻는 네 가지 원칙

AI 모델의 성능을 극대화하는 프롬프팅 원칙입니다.

1. 구체적으로 (Be Specific): "잘 고쳐줘"가 아니라 "가독성과 유지보수성 관점에서 3가지 개선안을 제시해 줘"라고 요청하세요.
2. 컨텍스트 설정 (Set Context): "너는 10년 차 시니어 풀스택 엔지니어이자 보안 전문가야"처럼 역할과 전문성 수준을 지정하세요.
3. 형식 요구 (Specify Format): "표 형태로 정리해 줘", "코드 블록과 설명을 분리해 줘" 등 응답 구조를 명시하세요.
4. 우선순위 지정 (Prioritize): "다른 무엇보다 성능 최적화가 가장 중요해"라고 핵심 가치를 알려주세요.

모델별 한 줄 팁:

• Claude: XML 포맷을 가장 잘 다루며, 중요한 지시사항을 프롬프트 끝에 배치하는 것이 효과적입니다.
• ChatGPT: Markdown 포맷에 익숙하며, 대규모 프로젝트는 구간을 나누어 질문하는 것이 안정적입니다.
• Gemini: 다양한 포맷을 모두 잘 다루며, 단계별 추론(Chain-of-Thought)을 유도할 때 성능이 좋습니다.

라이브러리로 구현하기 (개발자 가이드)

Repomix는 단순한 CLI가 아니라 Node.js 라이브러리로도 제공됩니다. 이를 이용해 자신만의 AI 도구를 만들 수 있습니다.

npm install repomix

가장 간단한 방법은 runCli 함수를 사용하는 것입니다.

import { runCli, type CliOptions } from 'repomix';

async function packProject() {
  const options = {
    output: 'output.xml',
    style: 'xml',
    compress: true,
    quiet: true
  } as CliOptions;

  const result = await runCli(['.'], process.cwd(), options);
  return result.packResult; // 토큰 수, 파일 목록 등 메타데이터 포함
}

더 세밀한 제어가 필요하다면 내부 API(searchFiles, collectFiles, processFiles, TokenCounter)를 직접 조합하여 사용할 수 있습니다. 이를 통해 "특정 조건의 파일만 골라 토큰 수를 계산하고 AI에게 전달하는" 커스텀 파이프라인을 구축해 보세요.

마치며: AI와 협업하는 올바른 태도

Repomix의 저자는 AI와의 협업에서 가장 중요한 것은 "인간의 통제권"이라고 강조합니다.

• 핵심 기능부터: 한 번에 모든 것을 만들려 하지 말고, 핵심 기능을 먼저 구현하세요. 실제 동작하는 코드가 AI에게 가장 정확한 가이드가 됩니다.
• 작은 단위의 모듈화: 파일당 약 250줄 내외로 쪼개세요. 모듈이 작을수록 AI는 더 정확하게 이해하고, 사람은 더 쉽게 검토할 수 있습니다.
• 테스트 우선: 구현 전에 테스트 케이스를 먼저 작성하세요. 테스트는 AI에게 주는 가장 명확한 설계도이자, 결과물을 검증하는 유일한 객관적 지표입니다.
• 계획 $\rightarrow$ 구현 분리: 큰 기능은 먼저 계획(설계)을 논의하고, 구현은 별도의 세션에서 진행하세요. AI가 계획과 구현을 동시에 하면도중에 방향을 잃기 쉽습니다.

Repomix는 여러분의 코드베이스를 AI가 읽을 수 있는 형태로 정제해 주는 훌륭한 도구입니다. 하지만 정제된 데이터를 바탕으로 최종 결정을 내리고, 코드의 품질을 책임지는 것은 여전히 여러분의 몫입니다.

13편의 가이드를 통해 Repomix를 여러분의 강력한 개발 파트너로 활용하시길 바랍니다. 주제 페이지에서 전체 내용을 다시 확인하실 수 있습니다.