GitWhy

GitWhy란 무엇인가요?

GitWhy는 AI가 생성한 코드 뒤의 추론을 저장하고 공유하는 Git용 “컨텍스트 레이어”로, 이를 생성한 커밋에 직접 연결합니다. 목표는 프롬프트, 결정, 트레이드오프를 코드 변경과 함께 검토 가능하게 하여 채팅 창에만 남지 않도록 하는 것입니다.

구조화된 컨텍스트(원본 프롬프트, 추론, 결정, 거부된 대안 등)를 캡처해 커밋에 연결합니다. 제품은 저장된 추론을 풀 리퀘스트에 표시해 리뷰어들이 diff뿐만 아니라 변경 이유를 확인할 수 있게 합니다.

구조화된 “추론” 컨텍스트: 프롬프트, 추론, 결정, 거부된 대안, 파일, 커밋을 고정 형식으로 저장해 실행 간 일관성을 유지합니다.
커밋 연결 (git 네이티브 출처 증명): 저장된 각 컨텍스트를 생성한 정확한 커밋에 연결해 문서가 코드 히스토리에 고정되도록 합니다.
gitwhy-bot을 통한 PR 표시: 전체 추론을 풀 리퀘스트에 PR 댓글로 푸시해 코드 리뷰 시 컨텍스트를 제공합니다.
클라우드 동기화 및 공유: 저장된 컨텍스트를 클라우드에 동기화해 조직 내 팀 공유를 가능하게 합니다.
저장된 컨텍스트 검색: 키워드, 도메인, 주제로 저장된 추론을 검색해 이전 결정을 빠르게 찾을 수 있습니다.
MCP 호환 에이전트 지원: 모든 MCP 호환 에이전트(페이지에서 Claude Code, Cursor, Windsurf, Cline 명시)와 작동하도록 설계되었습니다.
터미널 UI 관리: 브라우저 없이 컨텍스트를 탐색, 검색, 관리할 수 있는 대화형 터미널 인터페이스를 제공합니다.

MCP 호환 에이전트로 코드 생성하고 캡처할 추론을 생성하도록 합니다.
추론 컨텍스트 저장, GitWhy가 구조화된 항목(프롬프트, 추론, 결정, 거부된 대안, 파일, 커밋)을 기록하고 관련 커밋에 연결합니다.
클라우드 동기화 (팀 공유용) 후 풀 리퀘스트를 엽니다.
PR에서 리뷰: GitWhy 봇이 저장된 추론을 풀 리퀘스트에 게시해 리뷰어들이 기본 결정과 트레이드오프를 읽을 수 있습니다.

AI 지원 변경 PR 리뷰: AI가 코드를 생성할 때 리뷰어들은 diff에서 의도를 추론하는 대신 PR 댓글의 저장된 추론과 결정을 읽을 수 있습니다.
반복 설계 선택 팀 지식 캡처: 인증, 데이터베이스, API 설계 결정 등을 도메인/주제별 컨텍스트 트리로 저장해 팀이 과거 근거를 재사용할 수 있습니다.
특정 커밋 뒤 “왜” 감사: 각 컨텍스트가 생성 커밋에 연결되어 개발자들이 결정 출처를 정확한 코드 변경으로 추적할 수 있습니다.
신규 작업 시 빠른 검색: 터미널, 에이전트, 팀 대시보드에서 키워드, 도메인, 주제로 저장된 컨텍스트를 검색해 관련 근거를 빠르게 찾습니다.
멀티 에이전트 워크플로: 서로 다른 MCP 호환 에이전트를 사용하는 팀이 단일 채팅 인터페이스 없이 한 곳에서 추론을 캡처하고 관리할 수 있습니다.

GitWhy는 각 컨텍스트에 어떤 정보를 저장하나요? 페이지에서 프롬프트, 추론, 결정, 거부된 대안, 파일, 커밋을 포함한 구조화된 형식을 설명합니다.
GitWhy는 추론을 코드에 어떻게 연결하나요? 저장된 각 컨텍스트를 생성한 정확한 커밋에 연결합니다.
리뷰어들은 추론을 어디서 보나요? GitWhy 봇이 전체 추론을 풀 리퀘스트에 PR 댓글로 게시합니다.
브라우저 없이 사용할 수 있나요? 네. 컨텍스트를 탐색, 검색, 관리할 수 있는 대화형 터미널 UI를 포함합니다.
어떤 에이전트가 지원되나요? 사이트에서 모든 MCP 호환 에이전트와 작동하며 Claude Code, Cursor, Windsurf, Cline을 구체적으로 언급합니다.

일반 PR 설명 또는 댓글: 팀이 수동으로 PR 텍스트에 추론을 붙여넣을 수 있지만, 변경 이유의 구조화된 커밋 연결 이력을 자동으로 보존하지 않습니다.
외부 문서화 시스템 (위키/지식 베이스): 팀이 결정 문서를 별도로 유지할 수 있지만, 이는 커밋에 본질적으로 연결되지 않으며 PR에 자동으로 노출되지 않습니다.
로컬 로그/채팅 기록 검토: 이전 채팅 로그를 읽으면 맥락을 제공할 수 있지만, 검색이 덜 편리하고 일반적으로 리포지토리 이력의 커밋과 연결되지 않습니다.
주석이 포함된 범용 코드 리뷰 도구: diff를 주석하는 도구는 변경 사항을 설명할 수 있지만, 여기 소스 텍스트는 gitwhy-bot을 통한 구조화된 커밋 연결 추론과 PR 게시를 강조하며, 이는 일반 리뷰 도구로 커버되지 않을 수 있습니다.