Guardian

Guardian이란?

Guardian은 AI 보조 코드 변경을 위한 릴리스 결정 레이어입니다. 단순히 문제를 감지하는 데 그치지 않고, 위험하거나 AI 중심의 코드 업데이트를 정책에 대해 평가하여 명확한 릴리스 결정(통과, 경고와 함께 통과, 차단)을 증거와 함께 생성합니다.

이 제품은 소규모 엔지니어링 팀이 코드가 배포되기 전에 승인 방식을 표준화하도록 설계되었습니다. Guardian은 데스크톱, CLI, CI 워크플로 전반에 동일한 정책 기반 검사를 적용하며, 고위험 오버라이드에 대한 사람 승인 프로세스와 감사 가능한 이력을 포함합니다.

주요 기능

• 릴리스 결정 레이어 (단순 감지가 아님): AI 보조 코드 변경에 대한 명확한 진행/중단 결정을 생성하며, 이유를 함께 제공합니다. 문제 목록만 출력하지 않습니다.
• AI 중심 / 대규모 변경 유입 라우팅: AI 보조 또는 비정상적으로 큰 리팩토링 풀 리퀘스트를 식별하여 릴리스 전에 더 엄격한 리뷰 경로로 안내합니다.
• 팀 규칙 기반 정책 적용: 아키텍처, 보안, 품질 규칙을 정책으로 정의하여 위험한 변경에 적용하고, 평이한 언어로 위반 사항을 설명합니다.
• 책임 있는 사람 승인 워크플로: 고위험 흐름에서 명명된 승인자, 오버라이드 소유자, 기록된 이유를 감사 이력에 캡처합니다.
• 환경 전반의 로컬 우선 정책-코드 워크플로: 정책-코드를 리포지토리에 유지하며, 필요 시 로컬에서 작동하는 데스크톱 + CLI 흐름을 지원합니다.

Guardian 사용 방법

1. 팀 정책 정의 (아키텍처, 보안, 품질 규칙)를 정책-코드로 작성하여 리포지토리에 저장합니다.
2. 데스크톱/CLI 또는 CI 워크플로에서 Guardian 사용하여 AI 보조 및 비정상적으로 큰 변경이 릴리스 전에 일관되게 평가되도록 합니다.
3. 위험한 변경에 대한 정책 적용 결과 검토, 정책 위반 이유 설명 포함.
4. 필요 시 사람 승인 수행: 적절한 결정 경로(통과, 경고와 함께 통과, 차단)를 선택하고, 차단을 오버라이드할 경우 명명된 승인자/소유자와 이유를 제공합니다.
5. 최종 답변으로 릴리스 결정 활용: 감사 이력으로 뒷받침되는 명확한 결정과 증거를 사용합니다.

사용 사례

• 대규모 AI 보조 풀 리퀘스트 제어: 개발자가 Copilot/Claude/Cursor 같은 도구로 큰 PR을 생성할 때, Guardian이 AI 중심 또는 비정상적으로 큰 변경을 감지하여 릴리스 전에 더 엄격한 평가로 안내합니다.
• AI 생성 작업의 아키텍처 드리프트 포착: Guardian은 AI 중심 변경의 아키텍처 및 정책 위반을 강조하고, 리뷰어에게 왜 중요한지 설명합니다.
• 릴리스 게이트의 보안 및 품질 규칙 적용: 팀이 위험한 변경에 아키텍처, 보안, 품질 정책을 적용하여 리포지토리 규칙과 일치하는 릴리스 결정을 내릴 수 있습니다.
• 도구 전반의 승인 행동 표준화: 데스크톱, CLI, CI 전반에 동일한 리포지토리 정책을 적용하여 누가 리뷰하고 어떻게 결정하는지에 대한 변동성을 줄입니다.
• 오버라이드 감사 이력 유지: 차단에도 불구하고 고위험 항목을 허용할 경우, Guardian이 누가 승인했는지, 누가 오버라이드했는지, 왜 했는지를 기록하여 결정을 감사 가능하게 합니다.

자주 묻는 질문

• Guardian은 문제를 발견하는 즉시 변경을 중지하나요? 아니요. Guardian은 증거와 함께 릴리스 결정(통과, 경고와 함께 통과, 차단)을 생성하는 릴리스 결정 레이어로 설명되며, 단순히 문제를 나열하지 않습니다.

• Guardian이 더 높은 위험으로 간주하는 변경 유형은 무엇인가요? AI 보조 변경과 비정상적으로 큰 리팩토링 풀 리퀘스트에 중점을 두며, 더 엄격한 평가 경로로 안내합니다.

• Guardian은 고위험 승인에 대한 책임을 어떻게 처리하나요? 고위험 흐름에서 명명된 승인자와 오버라이드 소유자를 요구하며, 이유를 감사 이력에 기록합니다.

• 정책은 어디에 정의되고 저장되나요? Guardian은 리포지토리에 저장된 정책-코드를 사용하며, 필요 시 로컬에서 작동하는 데스크톱 + CLI 흐름을 지원합니다.

• 최종 결정은 어떻게 전달되나요? Guardian은 감사 이력으로 뒷받침되는 통과, 경고와 함께 통과, 차단 결정으로 릴리스 게이트 질문에 명확히 답변합니다.

대안

• 내부 체크리스트를 사용한 수동 코드 리뷰: 감사 가능한 결정 표면을 생성하는 정책 기반 릴리스 게이트 대신, 팀은 리뷰어와 문서를 통해 출시할 수 있는 것을 결정합니다.
• 정적 분석 또는 보안 스캐너: 이러한 도구는 일반적으로 탐지와 문제 보고에 중점을 둡니다; Guardian은 “발견된 문제”만이 아닌 거버넌스 스타일 릴리스 결정(증거와 승인/오버라이드 이력 포함)을 생성하도록 위치합니다.
• 소프트웨어 배포를 위한 일반 정책/컴플라이언스 플랫폼: 인접 카테고리에는 거버넌스 워크플로를 관리하는 도구가 포함되지만, Guardian의 구체적 초점은 데스크톱/CLI/CI 전반의 정책-코드 방식으로 AI 보조 및 비정상적으로 큰 코드 변경에 대한 결정입니다.
• 에이전트 리뷰만 (채팅/세션 기반): 일관된 정책 적용과 명확한 릴리스 결정 표면 없이 에이전트 제안에만 의존하면 프롬프트, 모델, 운영자 간 결정 품질이 달라질 수 있습니다—Guardian은 릴리스 게이트 프로세스를 표준화하도록 설계되었습니다.