본문으로 건너뛰기

산업안전보건법 검증 워크스페이스 만들기

하태준

2026.07.28

산업안전보건법 검증 워크스페이스 만들기 본문 이미지

##만들게 된 계기
- 현재 안전팀에서 근무하고 있는데, 언젠가는 안전관계법령을 할루시에이션 없이 검토하는 도구를 만들어보고 싶었습니다.
- 안전관계법령은 여러가지가 있지만 그중에서 가장 기본이되는 산업안전보건법을 기준으로 제대로 구축해보고 다른걸 확장해보면 어떨까 싶어서, 산업안전보건법을 기준으로 워크스페이스를 만들어봤습니다.

76이라는 숫자가 적힌 한국 신문의 스크린샷


- 그러던 중에 버디님이 발표하신 세법 구축 자료를 보면서 저런식으로 하면 되지 않을까 싶어서 일단 진행해봤습니다(제가 개념상 헷갈려하는 부분이 많아서 구현이 쉽지 않았네요)



## 📝 한줄 요약

  • 산업안전보건법·시행령·시행규칙·안전보건기준규칙 원문 1,247개 조문과 위임행정규칙 49건을 국가법령정보 공식 API로 직접 받아와, "원문을 확인하지 않고는 답하지 않는" 법령 검증 하네스의 워크스페이스와 원문 코퍼스를 만들었습니다. 실제로 참/거짓을 자동 판정하는 부분은 아직 다음 단계입니다.

바쁘시면 이것만 읽어도 돼요:

- 지피타쿠 show-me-the-prd(PRD 생성) + goaljaby(골 실행) 스킬로 설계 문서를 워크스페이스를 만들고, Claude Code로 실제 법령 코퍼스를 구축


## 🎯 이런 분들께 도움돼요

- 안전보건 담당자 — 안전과 관련되어서 궁금한게 생겼을 때 조문 근거에 시간을 들이는 분들

- 법률/컴플라이언스 업무자 — 다른 법령 도메인에도 같은 구조를 적용하고 싶은 분들

- AI로 "정확성이 생명인" 자료를 다루는 작업을 시도해보고 싶은 비개발자

## 😫 문제 상황 (Before)

실무 질문에 답하다 보면 "이거 법적으로 맞나요?"라는 질문을 계속 받습니다. 문제는 산업안전보건 관련 규범이 한 층이 아니라는 겁니다 . 산업안전보건법 → 시행령 → 시행규칙 → 안전보건기준에 관한 규칙 → 그 아래 다시 고시·예규·훈령까지, 조문 하나의 근거를 찾으려면 최소 서너 단계를 오르내려야 합니다. 게다가 이 법령들은 수시로 개정되기 때문에, 기억이나 예전에 봤던 자료로 답했다가는 이미 바뀐(구법) 조문을 근거로 안내하는 사고로 이어질 수 있습니다. 매번 국가법령정보센터에서 하나하나 검색해서 대조하는 건 반복되는데도 줄지 않는 일이었습니다.

## 🛠️ 사용한 도구

- Claude Code (Opus 5) : 계획 수립, 실측, 통합, 버그 수정, 문서화

- Codex CLI (GPT-5.6-sol 모델) : PRD/워크스페이스 골격 자동 구현

- 지피타쿠 스킬 : show-me-the-prd(설계 문서 생성), goaljaby(골 실행)

- 국가법령정보 OpenAPI : 법령 원문 수집처

- 워크스페이스 : 스터디장님의 research-survey 워크스페이스(폴더 구조 등 참고)

---

## 🔧 작업 과정

### 설계부터 먼저 — 지피타쿠 스킬로 PRD 확정

바로 코드부터 짜지 않았습니다. 먼저 지피타쿠의 show-me-the-prd 스킬로 "무엇을 만들 것인가"를 문서로 정리했습니다. 판정은 참/거짓/부분참/판단불가 네 가지로만 하고, 근거가 없으면 무조건 판단불가로 떨어뜨린다는 원칙, 조문 하나를 JSONL 한 줄로 저장한다는 데이터 구조, 그리고 "조문 번호를 지어내지 마라" 같은 절대 규칙까지 — 이 단계에서 확정해뒀습니다.

오연연연연연'이라는 문구가 적힌 문서
한국어 텍스트가 있는 검은 화면

이어서 goaljaby 스킬로 이 설계 문서를 실제 골격으로 구현하도록 Codex CLI에 맡겼습니다. 참고 구조는 스터디장님이 만든 research-survey 워크스페이스를 썼습니다.

### 계획을 실제 구현

골격이 서고 나서 진짜 작업, 법령 원문 다운로드를 시작했습니다.

```

오케이 법령 다운받는걸로 하자. 이거는 어떻게 다운받고 어떻게 정리할건지 구체적으로 계획부터 짜보자.

자료 다운 받는건 기존에 산업안전보건법 프로젝트에서 했던 로직을 참고하면 좋을거 같아.

- open api
- korean law mcp

```

### 실제로 받아오다

계획이 승인된 뒤 실제 다운로드를 실행했습니다. 산업안전보건법·시행령·시행규칙·안전보건기준에 관한 규칙 조문과 별표를 받고, 그 아래 위임된 고시·예규 52건 중 실제로 확인 가능한 49건을 받았습니다.

# ✅ 결과 (After)

### Before vs After

| 항목 | Before | After |

|------|--------|-------|

| 조문 근거 확인 | 국가법령정보센터에서 매번 수동 검색·대조 | 로컬 코퍼스에서 즉시 원문 대조 |

| 근거 없는 답변 | 기억·예전 자료로 답하는 경우 존재 | "근거 없으면 판단불가"라는 원칙과, 그 근거로 쓸 원문 코퍼스는 마련됨 (자동 판정 기능은 다음 단계) |

| 개정 전 조문 사용 위험 | 사람이 매번 시행일을 직접 확인해야 함 | 시행일·공포번호가 조문마다 기록되어 있음 |

| 확보한 데이터 | 없음 | 조문 1,247건 + 별표 196건 + 위임행정규칙 49건 |

  • 산업안전보건법

  • 산업안전보건법 시행령

  • 산업안전보건법 시행규칙

  • 산업안전보건기준에 관한 규칙

한국 컴퓨터 화면의 스크린샷
한국사이트 스크린샷

## 💬 이 과정에서 배운 AI 활용 팁

이번에 지피타쿠님 스킬(`show-me-the-prd`, goaljaby)을 처음부터 끝까지 직접 써봤는데, 결과물이 기대 이상이었습니다.

- `show-me-the-prd`로 뽑은 설계 문서(prd)가 작업 내내 기준점이 됐습니다. 요구사항·데이터 구조·"절대 하지 마" 목록까지 처음에 딱 정리해두니, 이후 작업 전부(Codex에게 골격을 맡길 때도, 제가 직접 API를 실측할 때도)가 이 문서 하나만 계속 다시 펼쳐보면 됐습니다. 매번 "이거 어떻게 하기로 했더라"를 새로 정할 필요가 없었습니다

- `goaljaby`로 실행한 골(goal)이 사람 개입 없이 끝까지 갔습니다. Phase 1 워크스페이스 골격을 통째로 맡겼는데, 자체 검증 스크립트가 8/8 통과할 때까지 스스로 확인하고 커밋까지 마쳤습니다. "일단 던져놓고 나중에 결과만 확인"이 실제로 되는 걸 보고 신뢰가 생겼습니다

## ❓ 아직 궁금한 것들

직접 만들면서도 스스로 확신이 안 서는 부분이 꽤 있습니다. 혹시 아시는 분 있으면 조언 부탁드리고 싶어서 그대로 적어봅니다.

1. 워크스페이스 구조를 이렇게 짜도 되는 건가요? 10단위 폴더(`00-system`~`90-archive`) + "절차는 RUNBOOK 한 곳에만 쓰고 나머지는 링크로만 가리킨다" 같은 규약을 세워뒀는데, 이게 실제로 맞는 구성인지 헷갈리네요.
00-system
10-planning
20- knowledge-base
30-teamplates
...

한국사이트 스크린샷

2. 법 조문을 JSONL 양식으로 가져온 게 맞는 방식인가요? 마크다운 파일로 가져오는게 맞는지 해당 양식으로 가져오는게 맞는지 궁금하네요.

3. 원래는 판례도 같이 가져오려고 했는데, 크롤링으로 인한 차단이슈가 있었습니다.
- 판례 유료사이트에서 크롤링을 진행했는데 이게 사이트에 걸려서 계정정지를 당하고 말았네요. 혹시 판례를 쌓으신 분들은 어떻게 쌓으셨는지 팁 좀 알려주시면 감사하겠습니다.

한국어 웹사이트 스크린샷
  • 해당 사이트 robot.txt

한국어 Python 스크립트의 스크린샷
  • 하지만 그거랑 별개로 이번에 처음으로 aside라는 툴을 사용해봤는데, 상당히 괜찮았던거 같습니다.


4. 장기간 작업에 대한 불안감(?)
- 과거에는 너무 짧게 작업을 하고 대화를 걸어서 귀찮았는데, 최근에는 너무 길게 작업을 해서 이거 잘못됐으면 어떡하지????! 라는 불안감..(중간중간에 뭐를 걸어둬야되나??)

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

리히토 프로필 이미지
리히토2026.07.28
  1. 워크스페이스는..생각보다 처음부터 잘 만들어질 수도 있고 않을 수도 있는데 일단은 써보시고 문서끼리 연결이 잘 안된다거나 할 때 에이전트한테 연결을 잘 될 것 같아요 어떻게 될지 같이 얘기하면서 고민하시면 좋을 것 같고요.

  2. 법조문은 openAPI에서 받으신거면 아마 선택하는게 여러개있는데 html xml json등 다양한 형태로 제공을 합니다! 일단 받고나면 거기서 필요한 부분이나 내용물을 원하는 형식의 md파일에 맞게 가져와달라고 하면 됩니다!

  3. 유료사이트는 왠지 관련 정책이라거나 이런게 있으려나요ㅠㅠ openAPI쪽에 판례쪽도 조회 될거같은데 시간되면 좀 해보겠습니다.

하태준 프로필 이미지
하태준2026.07.29

친절한 답변 감사합니다!!
1. 네 이것저것 테스트해보고, 나중에 에이전트한테 연결해달라고 해보겠습니다.
2. 네 말씀하신대로 다운 받은뒤에 양식을 바꿔야겠네요.
3. 유료사이트는 크롤링이 원칙적으로 차단이라고 하네요. 계정정지 하루만에 풀어주긴했는데.. 다음번에 또 걸리면 영구정지라고 겁주네요...ㅠ

엔지니어H 프로필 이미지
엔지니어H2026.08.05

법령을 다루는 도구를 만들면서 "실제로 참/거짓을 자동 판정하는 부분은 아직 다음 단계입니다." 를 한줄 요약 안에 넣은 것이 이 글의 축입니다. 코퍼스를 확보한 것과 판정이 되는 것은 다른 단계인데, 그 경계를 결과 발표의 첫 문단에서 그었습니다.

왜 이 표기가 중요한지는 법령이라는 자료의 성질에서 나옵니다. 조문을 로컬에 다 받아두면 화면상으로는 이미 답할 수 있는 상태처럼 보입니다. 그 상태에서 판정까지 된다고 적으면, 읽는 사람은 근거 대조가 자동으로 이뤄진다고 믿게 됩니다. 정확성이 생명인 자료에서는 그 오해 하나가 그대로 사고가 됩니다. "언젠가는 안전관계법령을 할루시에이션 없이 검토하는 도구를 만들어보고 싶었습니다" 라는 출발점과, 지금 어디까지 왔는지를 따로 적어둔 것이 앞뒤가 맞습니다.

설계 단계에서 세운 원칙도 그 성질에 맞습니다. "판정은 참/거짓/부분참/판단불가 네 가지로만 하고, 근거가 없으면 무조건 판단불가로 떨어뜨린다는 원칙" 을 코드보다 먼저 문서로 확정했고, "바로 코드부터 짜지 않았습니다." 로 그 순서를 밝혔습니다. 판단불가를 상태로 마련해 둔 것이 특히 좋았습니다 — 참/거짓 둘로 강제하면 근거가 모자란 사안까지 한쪽으로 밀리고, 그 순간 근거 대조라는 목적이 무너집니다. 상태를 하나 더 두는 것이 판정을 미루는 게 아니라 판정의 품질을 지키는 장치가 되는 구조입니다.

수치를 적은 방식도 같은 규율 위에 있습니다. "위임된 고시·예규 52건 중 실제로 확인 가능한 49건을 받았습니다" — 받은 49건만 쓰지 않고 대상이 52건이었음을 함께 남겼습니다. 분자만 적으면 49가 전부로 읽히고, 분모를 같이 적으면 3건이 아직 밖에 있다는 사실이 남습니다. 코퍼스를 쓰는 쪽에서 그 3건을 근거로 요구하는 질문이 들어올 수 있으니, 이 표기는 나중에 판정 단계에서 그대로 쓰일 정보입니다. 조문마다 시행일과 공포번호를 기록해 둔 것도 같은 계열입니다 — 구법 조문을 근거로 안내하는 사고를 막는 것은 조문 본문이 아니라 그 옆에 붙은 날짜입니다.

확인된 것과 남은 것이 명확히 갈립니다. 확인된 것은 코퍼스 쪽이고, "자체 검증 스크립트가 8/8 통과할 때까지 스스로 확인하고 커밋까지 마쳤습니다" 처럼 통과 근거가 붙어 있습니다. 남은 것을 적은 방식이 더 인상적입니다. "직접 만들면서도 스스로 확신이 안 서는 부분이 꽤 있습니다" 로 시작해 구조·양식·판례 세 갈래를 그대로 열어놨습니다. 특히 "판례 유료사이트에서 크롤링을 진행했는데 이게 사이트에 걸려서 계정정지를 당하고 말았네요" 를 적은 것은 결과가 좋지 않은 시도를 그대로 남긴 것입니다. 같은 벽을 만날 사람에게는 이 한 줄이 가장 실용적인 정보이고, 판례는 조문과 달리 공식 열람 경로부터 확인해야 하는 자료라는 신호도 됩니다.

옮겨갈 범위는 법령을 안 다루는 일에도 걸칩니다. 규정·약관·사내 기준처럼 원문이 정해져 있는 자료를 AI로 다룰 때, 원문 확보 단계와 판정 단계를 문서에서 분리해 적고 각 단계의 분모를 같이 남기는 것 — 이 두 가지만 해도 진행 상태가 부풀지 않습니다. 코퍼스가 다 모였다는 것과 판정이 된다는 것을 나눠 적는다 — 이 구분이 오래 남을 대목입니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기