study8677/repobrain

해결하는 문제

RepoBrain은 AI 에이전트가 대규모 코드베이스와 상호작용할 때 환각되거나 코딩 스타일을 잊는 것을 방지하는 다중 IDE 호환 리포지토리 지식 엔진을 제공합니다. AI가 수동으로 파일을 grep하거나 거대한 문서 파일을 읽는 비효율적인 과정을, 정확한 파일 경로와 행 번호를 포함하는 구조적이고 근거 있는 Q&A 시스템으로 대체합니다.

작동 방식

RepoBrain은 .repobrain/ 폴더 내에 여러 IDE 간에 이식 가능한 공유 지식 레이어를 생성합니다. 다중 에이전트 클러스터를 사용하여 코드베이스를 자율적으로 분석합니다:

1. 지식 생성 (rb-refresh): 에이전트의 파이프라인은 코드베이스를 스캔하고, 임포트 그래프와 디렉터리 구조에 따라 파일을 그룹화한 후 각 모듈에 대한 포괄적인 Markdown 지식 문서를 생성합니다. 맵 에이전트는 이를 map.md 파일에 인덱싱합니다.
2. uma Router 기반 Q&A (rb-ask): 사용자가 질문을 하면 라우터는 map.md 인덱스를 읽어 관련 모듈을 식별하고, 해당 에이전트 문서를 답변 에이전트에 전달합니다. 이후 답변 에이전트는 근거 있는 답변을 합성합니다.
3. 통합: Claude Code 및 Codex CLI용 플러그인으로, 또는 Cursor, Windsurf, VS Code와 같은 다른 호환 IDE용 MCP 서버로 통합됩니다.

대상 사용자

Claude Code, Cursor, Windsurf, Codex, Aider와 같은 AI 기반 IDE 및 에이전트를 사용하며, AI 어시스턴트가 특정 프로젝트 아키텍처와 코딩 규칙을 깊이 있고 근거 있는 방식으로 이해할 수 있도록 하고 싶은 개발자들입니다.

주요 특징

• 다중 IDE 호환성: 하나의 .repobrain/ 폴더가 여러 AI 에디터에서 작동합니다.
• 언어 독립성: AST 파싱이 아닌 LLM 기반의 디렉터리 구조 및 소스 코드 분석을 사용하므로, 어떤 프로그래밍 언어와도 호환됩니다.
• API 키 없이 사용 가능 모드: Claude Code나 Codex와 같은 기존 로그인된 CLI 세션을 활용하여 별도의 API 키 없이 엔진을 실행할 수 있습니다.
• 근거 있는 답변: 구체적인 파일 경로와 행 번호를 포함한 실제 코드 증거를 기반으로 한 답변을 제공합니다.
• Git 통합: "누가, 무엇을, 왜"에 대한 통찰을 분석하기 위한 전용 GitAgent를 포함합니다.