vn-law-check란 무엇인가요?
vn-law-check는 AI 코딩 에이전트가 베트남 법률에 따른 잠재적 준수 위험을 검토할 수 있도록 돕는 무료 지침, 체크리스트, 참고 자료 및 스캔 스크립트 모음입니다. Claude Code, Cursor, GitHub Copilot, Windsurf, Cline, Codex에서 사용할 수 있습니다.
에이전트에 프로젝트 감사를 요청하면 관련 기능이 있는지 코드를 검사하고, 파일과 줄 단위로 가능한 문제를 식별하며, 적용 가능한 법률 조항을 인용하고, 변경 사항을 제안합니다. 그런 다음 에이전트에 우선순위가 높은 문제를 해결하도록 요청할 수 있습니다.
애플리케이션이 이름, 이메일 주소 또는 전화번호를 수집하거나, Google Analytics 또는 Facebook Pixel과 같은 서비스를 사용하거나, 계정, 장바구니 또는 결제 기능을 제공하거나, AI 챗봇을 포함하는 경우 이 프로젝트가 유용합니다. 간단한 정적 사이트도 검토하여 관련 데이터 수집이 발견되지 않았는지 보고할 수 있습니다.
vn-law-check는 초기 검토 도구이며 변호사를 대체하지 않습니다. 보고서와 생성된 정책에는 누락이나 오류가 있을 수 있으므로, 중요한 결과는 자격을 갖춘 법률 전문가의 검토를 받아야 합니다.
주요 기능
- 소스 코드 및 URL 감사: 로컬 프로젝트를 검토하거나 웹사이트에서 공개적으로 접근 가능한 페이지를 스캔합니다.
- 파일 단위 결과: 보고서에서 파일, 줄, 문제가 되는 텍스트 또는 구현, 법적 근거 및 제안된 수정 사항을 확인할 수 있습니다.
- 우선순위가 지정된 결과: 결과는 🔴 즉각적인 조치 필요, 🟡 개선 권장, 🟢 준수, ⚪ 해당 없음으로 분류됩니다.
- 개인정보 보호정책 작성: 에이전트가 코드에서 감지한 데이터 흐름과 타사 서비스를 바탕으로 개인정보 보호정책 초안을 작성할 수 있습니다.
- 동의 안내: 체크리스트에 동의 양식과 쿠키 배너에 관한 안내가 포함되어 있습니다.
- 모바일 앱 지원: 스캐너가 권한, 추적 또는 광고 SDK, 계정 삭제 기능을 검사할 수 있습니다.
- 다양한 AI 도구 지원: 저장소 파일은 지원되는 에이전트가 선호하는 지침 형식을 통해 동일한 핵심 준수 지침을 불러올 수 있도록 구성되어 있습니다.
다루는 법률 영역
저장소에 따르면 참고 자료에는 2026년 11월까지 최신 베트남 법률 문서가 포함되어 있습니다. 대상 영역에는 개인정보 보호, 전자상거래, 사이버 보안, 광고, 인공지능, 소비자 보호 및 전자거래가 포함됩니다. 전문 링크와 시행일은 sources/legal-references.md에서 관리됩니다.
README는 특히 개인정보 보호법 91/2025 및 시행령 356/2025를 강조합니다. 2026년 1월 1일부터 조직은 개인정보를 수집하는 이유를 명확히 공개하고 적절한 동의를 받아야 한다고 설명합니다. 또한 저장소는 폐지되거나 대체된 규정을 여전히 인용하는 오래된 정책을 사용하지 않도록 경고합니다.
설치 및 설정
옵션 1: Claude Code에 설치
일반 터미널이 아니라 Claude Code 내부에서 다음 명령을 입력합니다.
/plugin marketplace add mhfed/vn-law-check
/plugin install vn-law-check설치가 끝나면 Claude Code에서 검토할 프로젝트를 엽니다.
옵션 2: Cursor, Windsurf, Copilot, Cline 또는 Codex에 설치
프로젝트 디렉터리에서 터미널을 열고 다음을 실행합니다.
curl -fsSL https://raw.githubusercontent.com/mhfed/vn-law-check/main/install.sh | bash설치 프로그램은 체크리스트를 .vn-law-check/에 배치하며 프로젝트 파일을 덮어쓰지 않습니다. 프로젝트에 AGENTS.md 또는 CLAUDE.md와 같은 지침 파일이 이미 있으면, 스크립트는 설치된 체크리스트에 대한 짧은 참조만 추가합니다. 설치 프로그램을 다시 실행하면 중복 참조를 삽입하지 않고 통합 내용을 업데이트합니다.
옵션 3: 스킬 수동 복제
마켓플레이스를 사용하지 않고 Claude에 스킬을 전역 설치하려면 다음을 실행합니다.
git clone --depth=1 https://github.com/mhfed/vn-law-check ~/.claude/skills/vn-law-check프로젝트별로 설치하려면 홈 디렉터리 경로 대신 해당 프로젝트 내부의 .claude/skills/vn-law-check에 복제합니다.
첫 번째 법률 감사 실행
열려 있는 프로젝트 감사
지원되는 AI 코딩 에이전트에서 프로젝트를 열고 저장소에서 권장하는 베트남어 프롬프트를 입력합니다.
audit pháp lý website này theo luật Việt Nam이는 “베트남 법률에 따라 이 웹사이트를 감사하라”는 뜻입니다. 에이전트는 먼저 사이트 유형을 분류한 다음 관련 체크리스트를 적용합니다. 프로젝트에 따라 양식, 추적 도구, 계정 시스템, 쇼핑 기능, 결제, AI 통합, 호스팅 세부 정보 및 관련 고지 사항을 확인할 수 있습니다.
공개 URL 감사
소스 코드가 없다면 공개 웹사이트 주소를 제공합니다.
audit pháp lý https://ten-mien-cua-ban.vnURL 감사에서 저장소의 fetch-site.sh 스크립트는 지정된 사이트의 공개 페이지를 다운로드하여 scan.sh가 검사할 수 있도록 합니다. README에 따르면 이 과정은 동일한 도메인에서 15개 페이지와 20개 JavaScript 파일로 제한됩니다. 수집된 사이트 데이터를 다른 곳으로 전송하지 않습니다.
URL만 사용하는 스캔으로는 공개적으로 노출되지 않은 비공개 서버 코드나 설정을 검사할 수 없습니다. 결과는 기본 시스템에 대한 완전한 평가가 아니라 접근 가능한 사이트에 대한 검토로 간주해야 합니다.
보고서 이해하기
각 결과에는 다음 네 가지 분류 중 하나가 지정됩니다.
- 🔴 즉시 주의: 조속히 조사하고 시정해야 하는 잠재적으로 심각한 문제입니다.
- 🟡 개선 권장: 개선이 필요한 취약점 또는 불완전한 구현입니다.
- 🟢 만족: 검토한 항목이 관련 체크리스트를 충족하는 것으로 보입니다.
- ⚪ 해당 없음: 해당 요구사항이 검토한 프로젝트 또는 기능에 적용되지 않습니다.
발견 사항에는 문제가 있는 문구, 해당 문구의 출처 위치, 인용된 법적 근거 및 권장 변경 사항이 포함될 수 있습니다. 데모의 한 예에서는 웹사이트를 계속 이용하는 것을 동의로 간주하는 개인정보 처리방침을 지적합니다. 보고서는 침묵 또는 응답하지 않는 행위를 동의로 간주할 수 없다고 규정한 Law 91/2025/QH15 제9조 제4항 d호를 인용하며, 데이터를 수집할 때 명시적인 동의를 요청할 것을 권고합니다.
관련 정보를 수집하지 않는 블로그나 정적 사이트는 긴 발견 사항 목록 대신 짧은 결론만 받을 수 있습니다.
에이전트에게 중요한 발견 사항 수정을 요청하기
보고서를 검토한 후 에이전트에게 빨간색 항목을 처리하도록 요청하세요.
sửa giúp các mục 🔴이는 “🔴 항목을 수정해 주세요”라는 뜻입니다. 수정 사항을 수락하기 전에 제안된 변경 내용을 검토하고, 영향을 받는 양식과 추적 동작을 테스트하며, 구현이 실제 비즈니스 프로세스와 일치하는지 확인하세요. 코드 변경만으로는 저장소에 없는 조직 관련 사실을 검증할 수 없습니다.
개인정보 처리방침 초안 생성하기
프로젝트에 개인정보 처리방침이 없거나 현재 일반적인 복사본을 사용하고 있다면 프로젝트에 맞는 초안을 요청하세요.
soạn chính sách bảo mật cho dự án này에이전트는 코드를 검사하여 애플리케이션이 수집하는 것으로 보이는 데이터와 해당 데이터를 전달받을 수 있는 서비스를 확인할 수 있습니다. 여기에는 Google Analytics, Firebase 또는 OpenAI와 같은 통합 서비스도 포함됩니다. 그런 다음 방침 문구의 초안을 작성하고 동의 양식과 쿠키 배너의 업데이트를 제안할 수 있습니다.
조직의 법적 명칭이나 세금 식별 번호처럼 코드만으로 확인할 수 없는 정보는 귀하가 작성할 수 있도록 비워 둡니다. 초안을 게시하기 전에 모든 항목, 데이터 이용 목적, 수신자, 보존 관행 및 연락처 정보를 확인하세요.
고급 사용 팁
가능하면 소스 코드 감사를 우선하세요
로컬 소스 감사는 공개 URL에서 드러나지 않을 수 있는 구현 세부 정보를 검사할 수 있습니다. 저장소에는 코드 디렉터리를 스캔할 때 scan.sh가 로컬 파일만 읽는다고 명시되어 있습니다. 따라서 소스 감사는 내장 SDK, 조건부 추적기, 모바일 권한, 계정 삭제 로직 및 렌더링된 페이지에서 쉽게 확인할 수 없는 통합 기능을 탐지하는 데 더 적합합니다.
동의 전에 추적이 이루어지는지 확인하세요
방문자가 동의 여부를 선택하기 전에 로드되는 분석 및 광고 스크립트에 특히 주의하세요. 또한 개인정보 고지가 프로젝트에서 확인된 서비스를 정확하게 설명하고, 계속해서 탐색하거나 침묵하거나 활동하지 않는 것을 동의로 간주하지 않는지 확인하세요.
기술적 사실과 비즈니스 사실을 구분하세요
에이전트는 많은 구현 세부 정보를 추론할 수 있지만, 코드만으로 모든 운영 관행을 안정적으로 파악할 수는 없습니다. 데이터 관리자의 신원, 보존 기간, 내부 접근 규칙, 국경 간 처리, 계약 관계 및 고객 지원 절차와 같은 사실은 조직의 담당자에게 확인하세요.
AI 에이전트 없이 체크리스트 사용하기
현재 자동화된 워크플로에는 지원되는 AI 도구 중 하나가 필요합니다. AI 코딩 에이전트를 사용하지 않더라도 저장소의 references 디렉터리에 있는 파일을 읽고 수동 자체 검토 체크리스트로 사용할 수 있습니다.
제3자 감사를 책임감 있게 수행하세요
소유하지 않은 사이트를 스캔하는 경우 결과를 비공개로 유지하고 사이트 소유자에게 직접 전달하세요. 프로젝트는 스캔 결과를 근거로 조직을 공개적으로 망신 주는 행위를 명시적으로 지양합니다.
검증되지 않은 참고 자료를 주의 깊게 검토하세요
관리자는 자신을 변호사가 아닌 개발자로 밝히고 있으며, 전체 법률 원문과 대조되지 않은 참고 자료에는 CHƯA XÁC MINH, 즉 “아직 검증되지 않음”이라는 표시를 붙입니다. README에 따르면 이러한 항목이 수십 개 남아 있으며, 주로 처벌 참고 자료와 Decree 356/2025 관련 자료에 있습니다. 이러한 항목은 각별히 주의하여 다루세요.
수정 사항 기여하기
법률 인용과 체크리스트는 변경될 수 있으므로 커뮤니티의 검토가 중요합니다. 잘못된 조항 번호, 오래된 문서, 부정확한 처벌 내용, 누락된 법률, 체크리스트에서 다루지 않은 일반적인 문제 또는 잘못된 사이트 분류를 신고하려면 GitHub 이슈를 등록할 수 있습니다. 원본 법률 문서의 링크를 포함하면 관리자가 수정 사항을 확인하는 데 도움이 됩니다.
풀 리퀘스트를 제출하는 개발자는 저장소에 지정된 소스 파일을 편집하고, tools/sync.sh를 실행하여 도구별 사본을 재생성해야 합니다. 또한 scripts/scan.sh를 변경한 후에는 tests/run.sh를 실행해야 합니다. 생성된 사본이 동기화되지 않으면 지속적 통합에서 오류를 보고합니다.
비용, 라이선스 및 제한 사항
저장소는 무료입니다. 유일한 사용 비용은 기존 코딩 도구에서 부과하는 AI 사용 요금입니다. 코드와 저장소 구조는 MIT 라이선스에 따라 제공되며, 참조된 베트남 법률 원문은 정부 공개 문서이므로 해당 소프트웨어 라이선스의 적용을 받지 않습니다.
무엇보다도 감사가 완전한 법적 준수를 보장하는 것은 아닙니다. vn-law-check를 사용하여 잠재적인 문제를 파악하고, 개선 작업을 체계화하며, 초안을 작성하세요. 중요한 발견 사항과 정책 문서는 프로덕션 환경에서 사용하기 전에 자격을 갖춘 법률 전문가에게 검토받으세요.
결론
vn-law-check는 베트남 규정 준수 체크리스트와 AI 지원 소프트웨어 개발을 연결하는 실용적인 수단을 제공합니다. 지원되는 에이전트에 설치하고, 소스 코드 또는 공개 URL을 감사한 다음, 우선순위가 지정된 보고서를 검토하고, 구체적인 수정이나 개인정보 처리방침 초안 작성을 요청하세요. 이 워크플로는 초기 검토를 가속화할 수 있지만, 최종적인 법률 결정에는 검증된 사실, 최신 법령 원문 및 전문가의 판단이 여전히 필요합니다.