agent-safety-oss 분석건설 안전문서를 AI 에이전트 업무흐름으로 바꾸는 오픈소스
Ratelworks가 공개한 agent-safety-oss는 산안법·기준규칙·중처법·KOSHA Guide·현장 기록을 작업 → 위험요인 → 통제대책 → 법령 근거 → 문서 → 증빙의 사슬로 묶는다. 핵심은 안전문서를 대신 쓰는 챗봇이 아니라, 근거를 확인하며 문서를 만드는 에이전트 업무흐름이다.
먼저 결론
- agent-safety-oss의 의미는 문서 자동화보다 근거 기반 업무흐름에 있다. 법령·가이드·현장 정보가 먼저 조립되고, 그 다음 문서 생성과 확인이 따라오는 구조다.
- 현재 npm에는 1.3.1이 올라와 있지만, README와 설정 문서에는 publish 전 안내가 일부 함께 남아 있다. 실제 도입 전에는 패키지 실행과 host 연결을 한 번 확인해야 한다.
- 안전관리 업무 특성상 결과물을 그대로 제출하는 도구가 아니라, 현장 담당자가 빈칸·사진·결재·책임 판단을 마무리하는 보조 계층으로 보는 편이 맞다.
1. 이 저장소가 겨냥하는 문제
건설현장의 안전관리 자료는 법령, KOSHA Guide, TBM 일지, 작업계획서, 위험성평가표, MSDS, 사진 증빙, 개선조치 기록처럼 여러 곳에 흩어진다. 자료가 많아도 서로 이어져 있지 않으면, 실제 품질은 담당자의 기억과 숙련도에 크게 의존한다.
agent-safety-oss는 이 문제를 “AI가 문서를 예쁘게 써준다”가 아니라 “문서를 쓰기 전에 필요한 근거와 현장 맥락을 구조화한다”로 접근한다. README는 작업에서 위험요인, 통제대책, 법령 근거, 문서, 증빙, 개선조치, 보고로 이어지는 사슬을 제시한다. 이 사슬이 중요한 이유는 안전문서가 단순 보고서가 아니라 실제 작업, 교육, 보호구, 작업허가, 사고 대응, 보관기간과 연결되기 때문이다.
2. 저장소 구조가 말하는 제품 성격
저장소를 실제로 확인하면 단순 데모보다 운영형 도메인 팩에 가깝다. TypeScript 기반 Node 패키지이고, 명령어는 agent-safety-oss로 제공된다. src/tools에는 위험 분석, 의무 확인, 문서 가이드, 문서 생성, 문서 확인, 사진 증빙, 현장 이슈, 개선조치, 안전 보고서 관련 도구 파일이 나뉘어 있다. src/ontology 쪽에는 법령·양식·가이드·그래프 노드 자료가 대량으로 들어 있다.
공식 문서가 반복해서 강조하는 표현은 “작성 주체는 안전관리자, 도구는 보조”다. 이 문구가 중요하다. 안전관리 문서는 법적·현장적 책임이 뒤따르기 때문에, AI가 만든 결과를 그대로 제출하는 방식은 위험하다. 이 저장소는 법령 근거를 임의로 만들지 않고, 필수 항목이 비어 있으면 결재 가능 상태로 보지 않는 쪽으로 설계 방향을 잡고 있다.
| 구성 | 확인한 내용 | 실무 의미 |
|---|---|---|
| README | 19종 법정 안전관리 문서, 8개 법령 본문, 1,039건 KOSHA Guide 번들을 강조 | 현장 문서 작성과 근거 확인을 한 화면에서 묶으려는 방향 |
| docs/ARCHITECTURE | 작업·위험·통제·법령·문서·증빙을 그래프로 연결 | 단순 검색보다 맥락 조립과 누락 확인에 초점 |
| docs/SETUP_* | Claude Desktop과 OpenAI Codex CLI 연결 안내 | 별도 대형 SaaS보다 기존 AI host에 붙이는 도입 방식 |
| examples/ | 도구 목록 확인, 법령 검색, TBM 생성 스크립트 제공 | 개발자나 운영 담당자가 동작을 재현하기 쉽다 |
3. 법령·가이드 번들이 강점인 이유
AI 업무툴이 안전관리 영역에서 바로 막히는 지점은 “근거가 맞는가”다. 일반 챗봇은 그럴듯한 문장을 만들 수 있지만, 산업안전보건법 조문, 기준규칙, 중대재해처벌법, 위험성평가 고시, KOSHA Guide의 권고 성격을 섞어 쓰면 실무에서는 오히려 위험하다.
agent-safety-oss는 이 부분을 근거 등급으로 나누려 한다. 법령과 규정은 의무 판단에 쓰고, KOSHA Guide는 기술적 권고로 구분한다. 재해사례, 안전보건자료, MSDS, 보호구 인증은 참고 근거로 다룬다. 국가법령정보센터 기준으로도 산업안전보건법·시행령·시행규칙, 중대재해 처벌 등에 관한 법률·시행령은 별도 법령 체계로 확인된다. 따라서 글이나 문서에서는 “법령상 의무”와 “가이드상 권고”를 섞지 않는 것이 핵심이다.
4. 실제로 어떤 일을 시킬 수 있나
README의 사용 예시는 현장 언어에 가깝다. “30억, 상시 12명 건설현장에 적용되는 안전보건 의무를 알려줘”, “오늘 굴착 작업 TBM 주제와 필요한 보호구를 정리해줘”, “MSDS 비치대장을 작성하고 법령 근거가 맞는지 확인해줘” 같은 요청을 상정한다.
내부적으로는 의무 확인, 문서 가이드 조회, 그래프 컨텍스트 조립, 문서 생성, 근거 확인, 로컬 보관 도구가 순서대로 호출된다. 이 흐름이 제대로 동작하면 안전관리자는 매번 빈 양식을 찾고, 비슷한 문장을 복사하고, 법령 근거를 따로 검색하는 시간을 줄일 수 있다. 특히 신규 담당자나 겸임 현장소장에게는 “어디부터 확인할지”를 잡아주는 효과가 있다.
작업 전 회의 주제 자동 정리
오늘 작업, 위험요인, 보호구, 신호수 배치, 작업 전 조치 같은 항목을 한 번에 묶어 회의 자료의 뼈대를 만든다.
위험요인과 통제대책 연결
공종과 장비를 기준으로 어떤 위험이 있고 어떤 대책을 붙여야 하는지 그래프에서 찾아 문서에 반영한다.
화학물질 자료의 확인 흐름
MSDS 비치, 교육, 게시 위치, 보호구처럼 현장에서 빠뜨리기 쉬운 항목을 체크하는 데 쓸 수 있다.
보고 순서와 문서 확인
중대재해나 현장 이슈 발생 시 보고, 증빙, 개선조치, 후속 보고서 흐름을 시간순으로 정리하는 데 도움이 된다.
5. Claude Desktop·Codex에 붙이는 방식
도입 방식은 별도 웹서비스 가입보다 기존 AI host 설정에 서버를 추가하는 구조다. Claude Desktop은 설정 JSON에 서버 명령을 추가하고, Codex CLI는 ~/.codex/config.toml에 서버 섹션을 넣는다. 최신 npm 기준으로는 npx -y agent-safety-oss serve 형태가 안내되어 있으며, 소스 빌드본을 직접 연결할 때는 node build/cli.js serve를 절대경로로 지정한다.
다만 README와 설정 문서 일부에는 “npm registry publish 전” 안내가 남아 있고, 실제 npm 조회에서는 1.3.1이 확인된다. 즉 문서는 빠르게 변하는 중이다. 처음 도입할 때는 Node.js 20.19 이상, 패키지 실행, host에서 도구 목록 노출, 공공 OpenAPI 키가 필요한 기능과 키 없이 되는 기능을 구분해서 점검하는 편이 좋다.
| 확인 항목 | 왜 중요한가 | 권장 확인 |
|---|---|---|
| Node 버전 | 패키지 요구 조건이 Node.js 20.19 이상이다. | node --version으로 먼저 확인한다. |
| host 연결 | 도구가 목록에 떠야 자연어 요청에서 호출된다. | Claude Desktop 재시작 또는 codex mcp list 확인 |
| 공공 API 키 | 일부 실시간 조회 도구는 키가 필요하다. | 키 없이 되는 번들 기능과 키 필요한 외부 조회를 분리한다. |
| 로컬 저장 | 프로파일, 사진, 이슈, 문서가 사용자 홈에 저장된다. | 저장 경로, 권한, 백업 정책을 사전에 정한다. |
6. 보안과 책임 경계는 반드시 정해야 한다
안전관리 도구는 편의성보다 책임 경계가 먼저다. 저장소의 CHANGELOG에는 path traversal 가드, PII 기본 마스킹, 로컬 저장소 경로 정리 같은 보안성 보강이 적혀 있다. 이는 좋은 신호다. 동시에 이 도구가 다루는 정보는 사업장명, 공사금액, 인원, 협력업체, 사진 증빙, 사고·이슈 기록처럼 민감할 수 있다.
따라서 실제 현장에 붙일 때는 세 가지를 정해야 한다. 첫째, 어떤 정보를 로컬에 저장할지. 둘째, 회사 키나 공공 API 키를 어디에 둘지. 셋째, AI host가 읽을 수 있는 폴더 범위를 어디까지 허용할지. 특히 사진 증빙과 사고 기록은 향후 분쟁·조사·보험·발주처 대응과 연결될 수 있으므로, 저장·삭제·공유 권한을 명확히 해야 한다.
7. 실무 도입 순서
바로 전 현장에 적용하기보다, 샘플 현장과 더미 데이터로 좁게 시작하는 편이 안전하다. 처음부터 모든 법정문서를 맡기면 결과가 좋아도 책임 경계가 흐려지고, 결과가 틀리면 어디서 틀렸는지 추적하기 어렵다.
- 1단계: 읽기 전용 확인. 저장소를 설치하고 도구 목록, 법령 검색, 문서 가이드 조회가 되는지 본다.
- 2단계: 더미 현장 프로파일. 가상의 사업장명, 공사금액, 인원으로 의무 문서 목록을 확인한다.
- 3단계: 한 문서만 생성. TBM 또는 굴착 작업계획서처럼 범위가 좁은 문서를 하나 만든다.
- 4단계: 근거 대조. 법령 근거, KOSHA Guide 권고, 빈칸 표시가 실제 문서 목적과 맞는지 확인한다.
- 5단계: 운영 기준 작성. 사람이 반드시 채울 항목, 결재 전 확인 항목, 저장·삭제 권한을 정한다.
8. 이 저장소가 보여주는 더 큰 흐름
agent-safety-oss는 AI 업무툴이 범용 챗봇에서 도메인별 업무 운영층으로 내려오는 흐름을 잘 보여준다. 그동안 많은 AI 도구는 “무엇이든 물어보세요”에 가까웠다. 그러나 실제 업무에서는 질문보다 맥락, 양식, 근거, 승인, 보관, 이력 관리가 더 중요하다.
건설 안전관리처럼 규정과 현장성이 강한 분야에서는 특히 그렇다. 좋은 AI 시스템은 답변을 길게 쓰는 도구가 아니라, 어떤 근거를 찾아야 하고, 어떤 빈칸이 남았고, 어떤 조치를 다음에 해야 하는지 알려주는 운영 보조층에 가깝다. 이 저장소의 가치는 바로 그 방향을 오픈소스로 보여준다는 데 있다.
한 줄로 정리하면, agent-safety-oss는 “AI 문서작성기”가 아니라 건설 안전관리 업무를 근거·양식·현장 기록의 사슬로 정리하려는 도메인형 에이전트 실험이다.
출처 및 확인 기준
- GitHub, ratelworks/agent-safety-oss — 저장소 설명, 최신 변경 시점, 파일 구조, README 확인.
- README.md — 19종 법정문서, 8개 법령 본문, 1,039건 KOSHA Guide, Claude Desktop·Codex 연결 안내 확인.
- docs/ARCHITECTURE.md — 작업·위험·통제·법령·문서·증빙 그래프 구조와 로컬 저장 경로 확인.
- docs/DATA_SOURCES.md — 법령, KOSHA Guide, 재해사례, MSDS, 보호구 인증의 근거 등급과 데이터 원칙 확인.
- npm, agent-safety-oss — 2026-05-21 기준 npm registry의 1.3.1 버전 노출 확인.
- 국가법령정보센터 — 산업안전보건법, 산업안전보건법 시행령·시행규칙, 중대재해 처벌 등에 관한 법률·시행령 존재 확인.