AI 코드 리뷰
IntentGuard
오픈소스 PR 정렬 검토 도구로, 모든 GitHub PR이 연결된 Linear 이슈 및 스프린트 의도와 일치하는지 병합 전에 확인합니다.
IntentGuard
IntentGuard란?
IntentGuard는 오픈소스 셀프호스팅 GitHub Action으로, 연결된 Linear 이슈 및 스프린트 컨텍스트에 대해 풀 리퀘스트를 자동으로 검토합니다. AI를 사용하여 PR을 ALIGNED, MISALIGNED, UNCLEAR로 분류하여 AI 네이티브 엔지니어링 팀이 코드 변경이 프로젝트 의도에 부합하도록 돕습니다.
IntentGuard vs 유사 도구
| 가격 모델 | 무료 | 무료 | 무료 | 유료 |
| 무료 크레딧 | ||||
| 주요 기능 |
|
|
|
|
| 장점 |
|
|
|
|
| 단점 |
|
|
|
|
| 추천 대상 |
|
|
|
|
IntentGuard 사용 방법
- 1워크플로 파일을 저장소에 추가하여 GitHub Action을 설치합니다.
- 2GitHub 토큰, Linear API 키, Anthropic API 키로 액션을 구성합니다.
- 3풀 리퀘스트를 엽니다.
- 4IntentGuard가 정렬 판정과 함께 자동으로 코멘트를 게시합니다.
- 5선택적으로 alignment.failCheckOnMisaligned를 true로 설정하여 정렬되지 않은 PR을 차단할 수 있습니다.
IntentGuard 주요 기능
- 연결된 Linear 이슈 및 스프린트 컨텍스트에 대해 PR 검토
- PR을 ALIGNED, MISALIGNED, UNCLEAR로 분류 및 이유 제시
- GitHub Actions를 통한 셀프호스팅, LLM 공급자를 제외하고 데이터 외부 전송 없음
- PR당 단일 코멘트 업데이트 (스팸 없음)
- 구성 가능한 엄격도, 무시 경로, 병합 차단
- API 키 없이 오프라인 테스트를 위한 모의 모드
IntentGuard 사용 사례
- AI 생성 코드가 병합 전 스프린트 목표에 부합하는지 확인
- 연결된 티켓에서 벗어난 PR 감지를 통해 스코프 크리프 방지
- Linear와 GitHub를 사용하는 팀의 정렬 검사 자동화
- 빠른 속도의 AI 네이티브 엔지니어링 팀에서 프로젝트 집중 유지
IntentGuard 가격 및 무료 크레딧
IntentGuard의 가격 모델은 무료입니다.
IntentGuard 장점과 단점
장점
- 오픈소스 및 셀프호스팅, 전체 데이터 제어
- GitHub 및 Linear와 직접 통합
- 보안 중심: PR 코드를 실행하지 않으며 pull_request_target 사용 안 함
- 이유와 출처가 포함된 실행 가능한 정렬 판정 제공
- 필요시 정렬되지 않은 PR 차단 가능
단점
- 라이브 사용을 위해 LLM API 키(Anthropic) 필요
- Linear 이슈 트래킹만 지원(Jira, Notion 등 미지원)
- 현재 GitHub App 설치 플로우 없음(GitHub Action으로 설정 필요)
- PR 볼륨이 많으면 LLM 비용 누적 가능
IntentGuard은 어떤 용도에 가장 적합한가요?
- Linear와 GitHub를 사용하는 엔지니어링 팀
- Copilot이나 Cursor 같은 AI 코딩 에이전트를 사용하는 팀
- PR이 스프린트 목표에 부합하는지 확인하려는 기술 리더
- 정렬 검사를 자동화하려는 오픈소스 프로젝트