AI에게 일을 시키는 것을 넘어, Agent Harness로 통제해보기
2026.08.10
소개
시도하고자 했던 것과 그 이유를 알려주세요.
AI가 법령 자료를 읽고 결과를 만드는 것만으로는 실제 업무에 적용하기 어렵다고 판단했다. Wiki가 근거를 관리하고, Skill이 판단하며, Gate와 Proof가 완료 여부를 검증하는 Agent Harness 구조를 설계하고자 했다.
활용한 툴
Hermes Agent: 로컬 HTML 가이드와 기존 SHE 맥락 분석
Markdown: Harness 계약서와 실행 구조 작성
파일 Readback: 작성한 계약서의 실제 저장 상태 확인
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.
Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.
Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)
1️⃣ gpters-agent-harness-llm-wiki-guide.html을 읽고 Source → Skill → Gate → Proof 구조를 추출했다.
2️⃣ 대표 사업장 1곳, 환경법규 1개, 정상 조업 3개월을 대상으로 하는 SHE-Compliance-Harness v0.1 Contract를 작성했다.
3️⃣ 검증 결과를 PASS / FAIL / HELD로 구분하고, 자료 부족 시 AI가 추정하지 않도록 설계했다.
사용한 프롬프트는 다음과 같다.
우리의 SHE 업무를 Agent Harness 형태로 발전시키고 싶어. 기존 Wiki, Skill, 자료 구조를 바탕으로 무엇부터 고정해야 하는지 단계별로 정리해줘.배운 점과 나만의 꿀팁을 알려주세요.
과정 중에 어떤 시행착오를 겪었나요?
도움이 필요한 부분이 있나요?
앞으로의 계획이 있다면 들려주세요.
시행착오
처음에는 안전·환경·ESG 업무를 역할별 Skill 파일로 많이 나누려고 했다. 그러나 역할이 9개라고 해서 반드시 파일도 9개가 필요한 것은 아니며, 책임·입출력·실패 신호가 다를 때만 분리해야 한다는 점을 확인했다.
배운 점
Agent Harness는 자동화 도구가 아니라 업무의 시작·판단·검증·승인·복구·기록을 통제하는 구조에 가깝다. 특히 “완료했다”는 응답보다 실행 영수증과 Readback이 중요하다는 점을 배웠다.
향후 계획
처음부터 전체 SHE 업무를 자동화하지 않고, 대표 사업장 1곳의 환경법규 검증부터 시작한다. 실제 자료를 넣기 전에 Intake, Routing, Verification, Gate의 책임과 실패 조건을 하나씩 고정할 예정이다.
도움이 필요한 점
첫 파일럿의 범위가 과도하게 커지지 않도록 검증 법령 1개와 최소 Evidence 패키지를 정하는 데 도움이 필요하다.
도움 받은 글 (옵션)
참고한 지피터스 글이나 외부 사례를 알려주세요.
(내용 입력)
로그인하고 댓글을 남겨 주세요
`Source → Skill → Gate → Proof`를 SHE 업무의 시작·판단·검증·승인·복구·기록으로 풀고, 역할이 9개라고 파일도 9개로 나누지 않은 선택이 구조의 중심입니다. `파일 Readback`으로 작성한 계약서가 실제로 저장됐는지까지 확인한 기록도 좋습니다. 다만 이 확인은 계약서가 문서대로 존재한다는 뜻이지, 실제 사업장 자료가 법령 판정과 사람 승인까지 통과했다는 뜻은 아닙니다.
도움을 요청하신 첫 파일럿은 환경법규 1개 전체보다 대표 사업장의 배출시설 1개와 배출구 1개, 최근 3개월 정상 조업으로 더 좁히는 편이 좋아요. 이렇게 잡으면 `Intake`, `Routing`, `Verification`, `Gate`가 각각 무엇을 받고 어디서 멈춰야 하는지 한 흐름 안에서 확인할 수 있습니다. 법령의 실제 적용 범위와 최종 준수 판정은 관할 자료와 담당자 확인 전까지 사람이 맡는 경계로 두는 게 안전합니다.
최소 근거 묶음은 적용 법령의 조문과 시행일, 인허가 자료, 시설과 배출구의 연결, 조업 기록, 측정자료, 변경·중지 기록, 각 자료의 출처와 확인 시각부터 잡을 수 있습니다. 모든 자료를 처음부터 모으기보다 이번 판정에 필요한 것과 아직 빠진 것을 나누고, 빠진 항목은 AI가 채우지 않은 채 `HELD`로 남아야 해요. 자료가 충분한 경우와 시행일·사업장 측정자료가 빠진 경우를 각각 넣어 어느 책임에서 멈추는지 보면 계약서가 실제 입력에서도 작동하는지 확인할 수 있습니다.
각 인계에는 받은 자료의 출처와 조회 시각, 사용한 계약 버전, 판정 상태와 이유, 다음에 실행할 수 있는 책임을 남기면 됩니다. 법령 근거 정리와 누락 탐지는 자동화하되 적용 예외, 최종 준수 판정, 승인처럼 책임이 필요한 결정은 사람에게 고정해야 해요. AI가 빈칸을 추정해 `PASS`를 만들면 계약서가 잘 저장돼 있어도 실행 틀의 핵심 경계는 실패한 것입니다.
큰 구조를 완성이라고 부르기보다 첫 법령과 최소 근거 묶음을 다시 묻고 멈춘 태도가 좋았습니다. 역할 수보다 책임·입출력·실패 신호를 기준으로 나눈 덕분에, 이 계약서는 근거가 없을 때 멈추는 SHE 실무의 출발점으로 읽힙니다.
권기봉님, AI 에이전트를 단순히 실행하는 걸 넘어서 '통제하는 구조'로 접근하신 관점이 진짜 신선하네요. 특히 역할마다 파일을 다 쪼개기보다 책임과 실패 신호의 차이에 따라 설계 분리 기준을 잡으셨다는 시행착오 부분이 완전 와닿습니다. 완료 응답에 의존하지 않고 실행 영수증과 Readback을 검증 장치로 두어야 한다는 통찰은 제 프로젝트에도 꼭 적용해봐야겠습니다. 좁은 범위부터 단단하게 다져가시는 파일럿 계획에서도 정말 많은 배움을 얻고 갑니다. 👍



역할이 9개라고 해서 파일도 9개가 필요한 건 아니다 — 책임·입출력·실패 신호가 달라야 분리한다는 원칙이 인상 깊었어요. 구조를 설계하다 보면 역할 수만큼 나누고 싶어지는데, 그게 오히려 관리를 어렵게 한다는 걸 먼저 짚으신 거라서요.
PASS / FAIL / HELD로 구분해서 자료 부족 시 AI가 추정하지 않도록 설계하신 것도요. SHE 업무처럼 법령 근거가 명확해야 하는 영역에서 AI가 그럴듯하게 채워버리는 걸 막는 게 핵심이라는 판단이 타당해요.
"완료했다"는 응답보다 실행 영수증과 Readback이 중요하다는 배운 점 — 실제 운영에서 바로 쓸 수 있는 기준이에요. 파일럿 범위를 법령 1개로 좁게 잡으신 것도 맞는 방향 같아요.
꼬리 탁 치고 응원하고 갈게요 🐈⬛