Prelint

Prelint: AI가 작성한 코드의 제품 드리프트를 방지하는 완벽한 가이드

현대 소프트웨어 개발 환경에서 AI 에이전트는 코드를 작성하는 강력한 도구로 자리 잡았습니다. 하지만 AI는 제품의 세부 사양이나 비즈니스 의도를 완전히 이해하지 못한 채 코드를 생성하곤 합니다. 이로 인해 발생하는 **제품 드리프트(Product Drift)**는 비즈니스 모델의 붕괴나 규정 위반으로 이어질 수 있습니다. Prelint는 이러한 문제를 해결하기 위해 등장한 혁신적인 제품 리뷰 솔루션입니다.

What's Prelint?

Prelint는 모든 풀 리퀘스트(Pull Request, PR)를 제품 사양(Product Specs)과 대조하여 검토하는 자동화 도구입니다. 기존의 코드 리뷰가 기술적인 오류나 보안 취약점을 찾는 데 집중했다면, Prelint는 "이 코드가 제품 사양에 부합하는가?"와 "이 코드가 존재해야 하는 이유가 있는가?"를 검토합니다.

AI가 작성한 코드는 기술적으로 완벽할 수 있지만, 회사의 경제 모델이나 규제 노출, 혹은 전략적 방향성과 일치하지 않을 수 있습니다. Prelint는 이러한 간극을 메우기 위해 제품의 의도(Product Intent)를 자동으로 강제하며, 사람이 직접 개입하기 전에 AI 에이전트가 스스로 오류를 수정할 수 있도록 돕습니다.

AI 코드 드리프트가 발생하는 6가지 방식

AI는 사양을 읽을 수는 있지만 그 이면의 의도를 이해하지는 못합니다. Prelint는 다음과 같은 6가지 유형의 제품 드리프트를 감지하고 방지합니다.

1. 비즈니스 로직 오류 (Business Logic)

AI는 재무적 영향을 이해하지 못한 채 가격 책정, 할인 또는 빌링 규칙을 변경할 수 있습니다. 예를 들어, 환율 위험(FX Risk)을 고려하지 않고 결제 통화 기준을 변경하여 수익 누수를 초래할 수 있습니다.

2. 규정 준수 위반 (Compliance)

AI는 데이터 저장 방식이나 동의 절차, 보유 규칙을 무시할 수 있습니다. 사용자 활동 로그를 저장하면서 IP 주소 보존 정책을 누락하면 GDPR이나 CCPA 위반으로 이어질 수 있으며, 이는 감사 전까지 발견되지 않을 위험이 큽니다.

3. 도구 및 인프라 분산 (Tooling & Infrastructure)

AI는 이미 사용 중인 표준 도구(예: AWS SNS) 대신 새로운 벤더(예: Twilio)를 임의로 도입할 수 있습니다. 이는 불필요한 비용 발생과 인프라 파편화를 초래합니다.

4. 도메인 언어 불일치 (Domain Language)

코드베이스 내에서 확립된 내부 언어 대신 일반적인 산업 용어를 사용하여 개념을 혼란스럽게 만듭니다. 'Merchant' 대신 'Seller', 'Vendor', 'Partner'를 혼용하여 팀 간의 소통 오류를 유발합니다.

5. 범위 이탈 (Scope Creep)

필요하지 않은 기능을 과도하게 구축하는 경우입니다. 미국 전용 제품에 12개국 언어 지원 i18n 프레임워크를 추가하는 등 불필요한 복잡성을 증대시킵니다.

6. 전략적 이탈 (Strategic Drift)

로드맵에 없는 기능을 구축하거나 내부 도구를 위한 공용 API를 만드는 등 계획되지 않은 추상화를 진행하여 개발 리소스를 낭비하게 만듭니다.

Features (핵심 기능)

Prelint는 단순한 체크리스트 이상의 기능을 제공하여 제품의 정렬을 유지합니다.

• 자동화된 제품 의도 강제: 제품 사양을 GitHub에 저장하면 모든 PR이 이를 기준으로 자동 체크됩니다. 미팅 없이도 일관성과 완성도를 보장합니다.
• 기계 판독 가능한 제품 제약 조건: Prelint는 전체 제품 컨텍스트를 이해합니다. 사양 간의 모순, 기술 선택의 충돌, 중복된 작업을 사람이 확인하기 전에 먼저 찾아냅니다.
• 엔지니어를 방해하지 않는 답변 (MCP): 이해관계자가 "왜 이렇게 구축했나요?"라고 질문하면 사양에 근거한 답변을 즉시 제공합니다. 엔지니어는 흐름을 끊지 않고 작업에 집중할 수 있습니다.
• 풀스택 리뷰 커버리지: 기존의 코드 리뷰가 '코드가 작동하는가'를 본다면, Prelint는 '비즈니스 제약 조건을 준수하는가', '로드맵에 포함된 내용인가'를 검토합니다.

How to Use (사용 방법)

Prelint는 기존의 GitHub 워크플로우에 자연스럽게 통합됩니다.

1. 저장소에 제품 사양 보관: 제품 제약 조건을 Markdown, YAML 등 AI 에이전트가 읽을 수 있는 형식으로 코드와 함께 저장합니다.
2. 에이전트의 PR 생성: AI 에이전트가 기능을 구현하고 풀 리퀘스트를 열면 Prelint가 자동으로 활성화됩니다.
3. 수 초 내의 제품 리뷰: Prelint가 전체 컨텍스트를 바탕으로 리뷰를 진행합니다. 드리프트, 충돌, 누락된 사양이 인라인으로 표시되며, 에이전트는 이를 보고 사람이 개입하기 전에 스스로 수정할 수 있습니다.

Use Case (활용 사례)

사례 1: 환율 리스크 방지

AI 에이전트가 예약 시점의 환율로 결제 금액을 변환하여 저장하는 코드를 작성했을 때, Prelint는 "항상 공급업체 통화로 청구 금액을 저장하라"는 제품 사양을 근거로 이를 차단합니다. 이를 통해 플랫폼이 환율 변동 차액을 흡수하게 되는 재무적 손실을 방지합니다.

사례 2: 엔터프라이즈 인증 요구사항 대응

마케팅 팀에서 Google 로그인을 추가해달라고 요청했을 때, Prelint는 기존의 엔터프라이즈 요구사항 문서를 근거로 "고객사가 필요로 하는 것은 단순 소셜 로그인이 아닌 SAML/OIDC 기반의 SSO"임을 지적합니다. 또한 이미 기획된 SAML 지원 사양을 안내하여 잘못된 방향의 개발을 막고 우선순위 결정을 돕습니다.

Security (보안)

Prelint는 엔터프라이즈급 보안 표준을 준수합니다.

• 제로 리텐션(Zero Retention): 각 조직은 격리된 인프라에서 실행되며 데이터가 공유되지 않습니다.
• 학습 금지: 사용자의 코드는 어떠한 모델의 학습에도 사용되지 않습니다.
• 최소 권한 원칙: 필요한 GitHub 권한만 요청합니다.
• 전 구간 암호화: 전송 중에는 TLS 1.3, 저장 시에는 AES-256 암호화를 적용합니다.

FAQ

Q: Prelint는 구체적으로 무엇을 리뷰하나요?

A: 구현 방식이 아닌 '의도'를 리뷰합니다. 모든 PR을 제품 사양, 규정 준수 규칙, 비즈니스 제약 조건과 대조하여 회사의 결정 사항을 위반하는 경우 즉시 알립니다.

Q: 일반적인 코드 리뷰와 어떻게 다른가요?

A: 코드 리뷰는 컴파일 여부, 패턴 준수, 보안 등을 확인합니다. 반면 Prelint는 제품 사양 일치 여부, 비즈니스 제약 준수, 로드맵 포함 여부 등 제품 측면의 정렬을 확인합니다.

Q: 설정하는 데 얼마나 걸리나요?

A: 단 몇 분이면 충분합니다. 기존 GitHub 워크플로우에 통합되어 다음 풀 리퀘스트부터 즉시 리뷰를 시작할 수 있습니다.

Q: 비개발자도 Prelint를 활용할 수 있나요?

A: 네, 이해관계자들은 Prelint를 통해 제품 사양에 근거한 답변을 얻을 수 있어 엔지니어에게 일일이 확인하지 않고도 의사결정의 근거를 파악할 수 있습니다.