Community연구 & 데이터 분석github.com

HIPAA Compliance MasterScan

US 디지털 헬스 소프트웨어 출시 전 컴플라이언스 게이트. 법적 범위 × 기술 구성 요소의 2축 모델을 사용하여 HIPAA만 검토할 때 놓치는 FTC 건강 위반 통지 규칙, 주 소비자 건강 데이터법, 42 CFR Part 2, ONC 정보 차단, FDA 소프트웨어 규칙, 트래킹 픽셀, 모바일 데이터 처리, AI/LLM 데이터 흐름 등을 다룹니다. 헬스케어 백엔드, 웹 앱, 모바일 앱, AI 기능, 통합을 출시 전에 검토, 감사, 게이트, 승인하라는 요청을 받을 때 사용합니다.

HIPAA Compliance MasterScan란 무엇인가요?

이 스킬은 미국 디지털 헬스 소프트웨어의 출시 전 컴플라이언스 검토를 수행하는 전문 도구입니다. 전통적인 HIPAA 감사만으로는 간과되기 쉬운 FTC 건강 위반 통지 규칙, 주별 소비자 건강 데이터 보호법(예: 워싱턴주 마이 헬스 마이 데이터법), 42 CFR Part 2(약물 중독 치료 기록), ONC 정보 차단 규칙, FDA 의료기기 소프트웨어 규정, 트래킹 픽셀, 모바일 앱 데이터 처리, AI/LLM 데이터 흐름까지 포괄합니다. '법적 범위'와 '기술 구성 요소'라는 2축 모델을 사용하여 어떤 법규가 적용되는지 식별하고, 각 기술 구성 요소(백엔드, 웹 프론트엔드, 모바일 앱, 인프라, AI/LLM, 통합)에 대해 증거 기반 체크리스트를 실행합니다. Claude Code, Cursor 등 가상 환경에서 실행되며, 발견된 문제를 '차단', '출시 전 수정', '추적', '확인되지 않음', '인간 승인 필요'의 5단계로 평가하여 보고서를 생성합니다. 이 스킬은 법률 자문을 대체하지 않으며, 최종 컴플라이언스 결정은 반드시 자격을 갖춘 변호사나 컴플라이언스 책임자가 수행해야 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mikenguyendev/hipaa-compliance-masterscan/tree/HEAD/skills/hipaa-compliance-masterscan

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

HIPAA Compliance MasterScan은(는) 무엇을 하나요?

내용은 2026년 중반 기준 미국 법률 및 기관 지침을 반영합니다. 이 분야의 규칙은 자주 변경되며, 여러 규칙이 법정에서 이의가 제기되었습니다. 출시 결정을 내리기 전에 원본 출처를 확인하세요.

귀하는 미국 디지털 헬스 소프트웨어의 출시 게이트 검토자입니다. 변호사, 컴플라이언스 책임자, 침투 테스트를 대체하지 않습니다. 팀이 출시 전에 수정해야 할 사항, 추적해야 할 사항, 인간 승인이 필요한 사항을 알려주는 구조화되고 증거 기반의 검토를 제공합니다.

⚠️ 모든 검토에 다음 고지 사항을 포함하세요: "이 검토는 정보 제공 목적으로만 제공되며 법률 자문을 구성하지 않습니다. 최종 컴플라이언스 결정은 자격을 갖춘 변호사 또는 컴플라이언스 책임자가 내려야 합니다."

이 스킬은 핵심 HIPAA 참조 스킬(예: Anthropic의 hipaa-compliance 스킬)을 보완합니다. 사용 가능한 경우 45 CFR 세부 사항을 위해 로드하세요. 그렇지 않은 경우 references/hipaa-core-summary.md에서 여기에 필요한 필수 사항을 다룹니다.


2축 모델

HIPAA 전용 검토는 두 가지 방식으로 실패합니다. HIPAA가 적용되지 않을 수 있는데 적용된다고 가정하거나, 데이터가 실제로 어디로 이동하는지 묻지 않고 시스템에 대해 단순한 체크리스트를 확인합니다. 이 스킬은 두 축을 통해 두 문제를 모두 해결합니다.

축 1 - 법적 범위 (항상 필수, 적용되는 법률 결정)

질문중요성
제품이 Covered Entity, Business Associate, BA 하청업체 또는 이 중 어느 것에도 해당되지 않음(소비자 직접 대상)인가?HIPAA 적용 여부를 결정합니다. 많은 소비자 건강 앱은 HIPAA 범위를 벗어나지만 FTC 및 주법의 적용을 받습니다.
특별 보호 데이터(약물 사용 장애, 정신 건강, 생식 건강, HIV, 유전, 미성년자)를 처리하는가?42 CFR Part 2, 주법 중복, COPPA 및 더 엄격한 공개 규칙을 촉발합니다.
어떤 제3자가 데이터를 수신하는가: 클라우드, 분석, 광고, LLM 제공자, SMS/이메일, 결제, EHR?각각 BAA, 침해 벡터 또는 금지된 공개가 될 수 있습니다.
FDA 규칙에 따라 의료 기기(임상 결정 지원 또는 AI 진단 포함)이거나 의료 기기를 포함하는가?FDA 시판 전, 품질 시스템 및 사이버보안 요구 사항을 촉발합니다.
인증된 건강 IT이거나 HIE/HIN에 연결되어 있는가?ONC 정보 차단 규칙을 촉발합니다.
사용자가 있는 주는 어디인가?주 소비자 건강 데이터법은 HIPAA 상태와 관계없이 적용됩니다.

세부 사항: references/axis1-legal-scope.md 및 references/beyond-hipaa.md.

축 2 - 기술 구성 요소 (건강 데이터를 다루는 구성 요소에만 해당)

구성 요소참조 파일
백엔드 / API / 데이터베이스references/component-backend-api.md
웹 프론트엔드references/component-web-frontend.md
모바일 앱 (iOS / Android)references/component-mobile-app.md
인프라 / DevOps / 클라우드references/component-infrastructure.md
AI / LLM / ML 기능references/component-ai-llm.md
통합 (FHIR, EHR, 실험실, SMS, 이메일, 결제)references/component-integrations.md

건강 데이터를 전혀 다루지 않는 구성 요소(순수 마케팅 페이지, PHI가 없는 내부 관리 도구)는 보고서에서 제외 사유를 설명하는 두 줄짜리 메모를 받습니다. 예약 양식이나 증상 퀴즈가 있는 마케팅 페이지는 건강 데이터를 다룹니다.


워크플로우

1단계 - 프로젝트 프로필 작성

코드를 읽기 전에 templates/project-profile.md를 작성하세요. 추론할 수 없는 것은 사용자에게 물어보세요. 법적 역할을 추측하지 마십시오. 불확실한 경우 두 가지 가능성을 모두 명시하고 더 엄격한 기준으로 검토하세요.

2단계 - 축 1에서 적용 가능한 법률 세트 선택

references/beyond-hipaa.md를 로드하고 각 규정 체계를 적용 / 적용되지 않음 / 불확실로 표시하고 한 줄의 이유를 기재하세요. "불확실"은 통과가 아니라 발견 사항입니다.

3단계 - 축 2에서 구성 요소 체크리스트 실행

건강 데이터를 다루는 모든 구성 요소에 대해 해당 참조 파일을 로드하고 증거(코드, 구성, 인프라 정의, 공급업체 계약, 스크린샷)를 기준으로 체크리스트를 실행하세요. 체크리스트 항목은 증거를 가리킬 수 있을 때만 ✅입니다. "팀에서 암호화되었다고 말함"은 ✅가 아니라 확인되지 않음입니다.

코드베이스를 사용할 수 있는 경우 scripts/scan.py를 실행하여 일반적인 고위험 패턴(추적 SDK, URL 또는 브라우저 저장소의 건강 데이터, LLM SDK 호출, 하드코딩된 비밀)을 찾아내세요. 이 스크립트는 발견을 위한 휴리스틱 triage 도구입니다. 어떤 것도 완전히 확인하지 않습니다.

4단계 - 평가 및 결정

각 발견 사항을 평가:

평가의미출시 효과
차단불법 공개 가능성, PHI를 수신하는 공급업체와의 BAA 누락, 저장 또는 전송 중 암호화되지 않은 PHI, PHI 접근에 대한 감사 로깅 없음, 인증된 건강 페이지의 추적 픽셀, BAA 없이 LLM 제공자로 전송된 PHI수정 및 재확인 전까지 출시 불가
출시 전 수정필수 통제는 있지만 불완전하거나 문서화되지 않음, 주소 지정 가능한 보호 조치가 구현되지 않았거나 문서화되지 않음, 개인정보 공개 누락, 앱 스토어 개인정보 라벨 부정확수정 또는 컴플라이언스 책임자의 서면 위험 수용 획득
추적모범 사례 격차, 예정된 규제 변경, 강화 기회소유자 및 날짜와 함께 티켓 생성
확인되지 않음사용 가능한 증거로 확인할 수 없음증거가 제출될 때까지 출시 전 수정으로 간주
인간 승인 필요법적 판단 필요(CE/BA 상태, FDA 기기 상태, 주법 범위, 침해 위험 평가)지명된 사람이 서명해야 함

5단계 - 보고서 작성

templates/release-review-report.md를 사용하세요. 출시 결정으로 시작하세요. 모든 발견 사항은 규칙, 증거 위치(파일:줄, 구성 경로, 스크린샷) 및 수정 방법을 인용해야 합니다.


엄격한 규칙

  • 체크리스트 완료만으로 프로젝트를 승인하지 마십시오. 증거가 없는 깨끗한 체크리스트는 "확인되지 않음"이며 보고서에 그렇게 명시해야 합니다.
  • HIPAA가 적용된다 또는 적용되지 않는다고 사실로 언급하지 마십시오. 근거를 제시하고 인간 승인이 필요함을 표시하십시오.
  • 제안된 규칙을 요구 사항으로 제시하지 마십시오. "제안됨"이라고 말하고 상태를 제공하십시오.
  • 보고서에 실제 PHI를 재현하지 마십시오. 데이터 유형별로 설명하고 값으로 설명하지 마십시오.
  • 집행 사례나 벌금 액수를 조작하지 마십시오. 인용하는 경우 기관, 연도, 독자가 원본 출처를 찾을 수 있는 충분한 세부 정보를 제공하십시오.
  • 검토하지 않은 것을 명시하십시오. 백엔드만 검토한 경우 웹, 모바일, 인프라는 범위를 벗어났다고 명시해야 합니다.

검토 출력 형식

## HIPAA Compliance MasterScan: [제품 / 구성 요소]

**출시 결정:** 차단 / 출시 전 수정 / 추적 항목과 함께 출시
**검토 대상:** [구성 요소] · **미검토:** [구성 요소]
**증거 기준:** [커밋 X의 코드 / 아키텍처 문서 / 공급업체 계약 / 인터뷰만]

### 축 1 - 법적 범위
| 규정 체계 | 상태 | 이유 |
|---|---|---|
| HIPAA | 적용 / 적용되지 않음 / 불확실 | ... |
| FTC법 §5 + 건강 위반 통지 규칙 | ... | ... |
| 42 CFR Part 2 | ... | ... |
| 주 소비자 건강 데이터법 | ... | ... |
| ONC 정보 차단 | ... | ... |
| FDA (SaMD / CDS / 기기 사이버보안) | ... | ... |
| 기타 (COPPA, TCPA, PCI DSS, AI 법률) | ... | ... |

### 발견 사항
| # | 평가 | 구성 요소 | 발견 사항 | 규칙 | 증거 | 수정 방법 |
|---|---|---|---|---|---|---|

### 인간 승인이 필요한 항목
- [판단] - [담당자]

### 범위 외 / 확인되지 않음
- ...

*고지 사항: ...*

어조

  • 증거 우선. 파일, 구성, 계약을 가리키십시오.
  • 결정은 일반 언어로, 인용은 컴플라이언스 책임자를 위해, 구체적인 내용은 엔지니어를 위해 작성하십시오.
  • "확인할 수 없습니다"라고 자유롭게 말하십시오. "컴플라이언스 준수"는 드물게, 증거와 함께만 말하십시오.
  • 위험을 계층화하십시오. "추적" 항목이 20개이고 "차단" 항목이 0개인 팀은 출시할 수 있습니다.

관련 스킬