Vercel, 타입스크립트 구조 규칙 검사 도구 ‘konsistent’ 오픈소스 공개

Vercel 공식 변경 로그에 따르면 회사는 1일(현지시간) 타입스크립트 코드베이스의 구조적 규칙을 검사하는 CLI 린터 ‘konsistent’를 오픈소스로 공개했다. 이 도구는 AI 코딩 에이전트와 사람이 같은 프로젝트 관례를 읽고 따를 수 있도록, 파일과 디렉터리 구조가 선언된 규칙에 맞는지 확인하는 데 초점을 둔다.

Vercel은 konsistent가 ESLint, Biome, oxlint 같은 기존 린터가 주로 파일 내부의 코드 스타일과 모범 사례를 다루는 것과 달리, 프로젝트 수준의 구조 규칙을 검사한다고 설명했다. 예컨대 특정 패턴의 파일이 정해진 함수와 타입을 내보내는지, 특정 파일을 가진 폴더가 함께 갖춰야 할 파일을 포함하는지, 지정된 클래스가 특정 타입을 구현하는지 같은 규칙을 konsistent.json에 선언할 수 있다.

공개 저장소 README도 같은 방향을 제시한다. konsistent는 타입스크립트 코드베이스에서 파일과 디렉터리가 선언된 구조 패턴과 일치하는지 검사하며, 일관된 프로젝트 구조가 온보딩과 유지보수를 단순하게 만들고 코딩 에이전트의 작업 품질에도 영향을 준다고 설명한다. Vercel은 이 도구를 AI SDK와 Chat SDK에서 구조적 코드 관례를 강제하는 데 사용한다고 밝혔다.

이번 공개는 AI 코딩 도구가 단순히 코드를 생성하는 단계를 넘어, 대규모 코드베이스의 반복 규칙과 패키지 경계를 안정적으로 따르도록 만드는 개발 환경 변화와 맞물린다. 생성형 AI 에이전트가 저장소 안에서 더 긴 작업을 수행할수록, 사람에게는 암묵적으로 익숙한 파일 배치와 export 규칙을 기계가 검증 가능한 형태로 읽는 장치가 중요해진다.

다만 konsistent는 범용 코드 품질 평가 도구라기보다 구조 규칙을 명시한 프로젝트에서 효과가 큰 보조 린터에 가깝다. 실제 도입 여부는 팀이 어떤 관례를 유지하려는지, 기존 ESLint나 타입 검사, CI 파이프라인과 어떤 역할 분담을 할지에 따라 달라질 수 있다.

출처: Vercel Changelog https://vercel.com/changelog/enforce-consistent-code-for-agents-and-humans-with-konsistent · GitHub https://github.com/vercel-labs/konsistent