dadbodgeoff/drift

해결하는 문제

Drift는 AI 에이전트가 기존 리포지토리 규칙을 위반하는 코드를 도입하는 것을 방지합니다. 특히 Next.js 프로젝트에서 API 라우트가 데이터 액세스 클라이언트를 직접 가져오지 않도록 하는 기존 아키텍처 패턴을 무시하는 문제에 초점을 맞춥니다.

작동 방식

Drift는 Rust 기반 스캔 엔진과 TypeScript CLI를 사용하여 코드를 분석하고 선언된 계층 계약을 강제합니다. 모든 작업은 로컬에서 실행되며, 상태와 리포지토리 지능은 SQLite 데이터베이스에 저장됩니다. 코드베이스를 분석하여 규칙을 식별하고, 인간이 해당 후보를 수락하거나 거부할 수 있습니다. 규칙이 리포지토리 계약의 일부가 되면, Drift는 새로운 변경사항(일반적으로 AI 에이전트에서 생성됨)이 이러한 규칙을 위반하는지 차이를 확인할 수 있습니다. 블록 모드로 설정된 경우, 위반 시 오류 코드로 종료하여 변경 사항을 차단합니다.

대상 사용자

AI 에이전트를 사용하여 코드를 생성하고, 수동으로 모든 줄을 규칙 위반 여부를 검토하지 않고도 아키텍처의 일관성을 유지하고자 하는 TypeScript 또는 JavaScript로 Next.js(앱 라우터 또는 페이지)를 사용하는 개발자들입니다.

주요 특징

• 로컬 우선 실행: 클라우드 동기화나 외부 서버 요구 없이 사용자 기계에서 완전히 실행됩니다.
• 결정론적 강제: 일반적인 LLM 기반 코드 리뷰에 의존하지 않고, 선언된 계약을 사용하여 위반을 차단합니다.
• 에이전트 호환: 리포지토리 맵과 발견 내용에 대한 컨텍스트를 에이전트에게 제공하는 읽기 전용 MCP(Model Context Protocol) 서버를 포함합니다.
• 증거 기반 보고: 규칙이 위반된 정확한 파일과 행을 보고합니다.
• 거버넌스 중심: 리포지토리 계약이나 거버넌스 결정의 변경에는 명시적인 인간의 승인이 필요합니다.