국회사무처 · 2026년도 11월 정보화교육

생성형 AI 업무 활용(심화): Claude Code법률안 검토보고서 에이전트 설계 및 업무 자동화

AI에게 어떻게 일을 맡기고, 결과는 어떻게 검증할 것인가

박주이 · 한양대학교 과학기술정책연구소 연구교수 · 2026. 11. 13.(금)

오늘의 목표는 맡기고 검증하는 법

검토보고서 실습으로 AI 에이전트에게 업무를 맡기고 결과를 검증하는 방법을 익혀 담당 업무에 적용

Ⅰ 에이전틱 엔지니어링 챗봇에서 에이전트로 AI에게 일 맡기기 위험과 검증 공정 개념 Ⅱ 에이전트 팀 운용 사례 운용 중인 팀 시연 의회의 AI 사례 교육생 전용 작성팀 구성 시연 Ⅲ 검토 기준 설계 작성팀 설치 스킬 뜯어보기 · 수정 법령 MCP 연결 · 인증키 해보기 ①~⑦ Ⅳ 검토보고서 초안 작성 · 검증 중요하게 보는 쟁점 먼저 적고 작성팀에 초안 요청 조문 대조 · 검수 kordoc 한글 변환 해보기 ⑧~⑪ Ⅴ 맞춤형 스킬 현업 적용 맡길 일 선정 기획안 · 나만의 도구 맡길 일 · 남길 일 정리 해보기 ⑫~⑬ AI가 놓친 쟁점은 사람이 찾아 보완

오늘의 최종 산출물

다음 법안에도 가져갈 파일은 점검 스킬과 나만의 도구 / 초안과 조문 원장은 법안마다 새로 작성

① 작업 폴더 「법률안실습」

작성팀 bill-review 설치 · 법령 도구 korean-law 연결

CLAUDE.md · 입력/(의안원문) · _workspace/(팀의 중간 산출)

② 점검 스킬

담당 업무 분야의 점검 스킬 하나 · 입법 업무는 위임 · 벌칙 · 부칙 중 선택, 다른 직무는 자기 업무의 점검 항목으로 만듦

SKILL.md 한 장 · 연결 도구 korean-law · 열린국회정보 · kordoc

③ 위임 요청문 · 초안 · 한글 문서

내 판단을 먼저 적은 위임 요청문으로 만든 초안 · kordoc으로 바꾼 한글 문서

01_검토설계 → 03b_조문원장 → 04_검토보고서 → 04c_조문대조 → 06_검토보고서.hwpx

④ 나만의 에이전트/도구

담당 업무의 반복 업무 하나를 내 에이전트나 도구로 만들어 가져감

기획안.md · .claude/agents/ 유사 법률안 조사관 · 조문 검사관

직무별로 옮겨 쓰는 실습 구조

법률안 검토보고서는 대표 실습 문서, 같은 구조를 다른 업무에 그대로 적용

예결산 ·조사 · 연구직무오늘 실습의사 ·행정 · 홍보직무의안원문사업설명서 ·요구자료 · 연구보고서회의 자료 · 공문 ·보도자료 초안착안점 스킬예결산 심사기준 ·회답 점검표공문서 ·보도자료 점검표검토보고서 초안분석 메모 ·회답서 초안회의 결과 ·보고 문서 초안조문 대조 검문소금액 · 통계의원출처 대조일정 · 수치 ·인용 대조실제 검토보고서와비교지난해 분석 보고서와비교확정 문서와비교
  • 실습마다 내 업무의 원문과 대조할 항목을 한 가지씩 선택

지금 AI를 어디까지 쓰고 있는가

내 활용 수준에 가장 가까운 단계 하나를 선택

오늘은 3단계에서 출발해 4 · 5단계까지 직접 해 보는 순서

참고: Zapier 「AI Fluency Rubric」을 참고해 쓰는 도구 기준으로 재구성 · 조회 2026. 10. 26.

이 초안, 그대로 넘길 수 있는가

원문을 주고 "요약해줘"만 요청하면 원문과 뜻이 다른 요약이 그럴듯하게 돌아올 수 있음

① 법률안 원문(의안원문 2쪽)

“개인형 이동장치를 시장ㆍ군수ㆍ구청장에게 등록할 수 있으며, 도난방지 및 식별, 무단 방치 처리, 규칙위반 단속 등을 위해 번호판을 부착할 수 있도록 함(안 제22조 및 제23조).”

→

② 요청

“이 법률안 요약해줘”

→

③ AI 요약(교육용 예시)

“개인형 이동장치 등록을 의무화함”

할 수 있다 → 의무화: 임의 등록이 의무 등록으로 변경되어 규제를 새로 만드는 법률안처럼 읽힘

결론도 달라짐: 의무 부과 근거 · 위반 시 제재를 따지는 검토의견이 나옴 · 낱말 하나라 두 줄을 대조해야 보임

출처: 의안번호 2117808 의안원문(2022. 10. 14.) 2쪽 · ③은 교육용 구성

Ⅰ. 에이전틱 엔지니어링

에이전트에게 일을 맡기고 결과를 검증하는 법

혹시 이렇게 쓰고 있지 않은가

"완료했다"라는 말을 그대로 믿고 보고서에 넣는다
결과가 틀리면 "아니야, 다시 해줘"라고만 말한다
잘 안 풀리면 새 창을 열고 처음부터 다시 설명한다
지난달에 한 작업을 이번 달에 처음부터 다시 설명한다
긴 대화에서 결과가 나빠져도 같은 요구를 반복한다 · 앞서 정한 기준이 빠졌을 수 있음
지시 한 번으로 그럴듯하지만 알맹이 없는 workslop을 받는다
에이전트를 몇 번 써 보고 "아직 쓸 만하지 않다"고 결론 내린다
용어workslop — 그럴듯해 보이지만 알맹이가 없어 받는 사람이 다시 일해야 하는 산출물을 가리키는 말. 2025년 하버드비즈니스리뷰 기고에서 쓰이며 퍼졌다

잘 쓰는 기준은 프롬프트에서 위임으로

좋은 문장을 쓰는 요령에서 일을 맡기고 결과를 판정하는 능력으로 중심이 이동

문장프롬프트어떻게 물을까요청 문구를 다듬어 답을 받음
맥락컨텍스트어떤 자료를 줄까의안원문 · 현행 조문을 함께 제공
문장
작업 환경하네스어떤 규칙과 검사를 둘까업무지침 · 조문 대조 검사
맥락
문장
위임과 판정에이전트 운용무엇을 맡기고 어떻게 판정할까쟁점 승인 · 원문 대조 · 결론 판단
작업 환경
맥락
문장
앞 단계 위에 뒤 단계가 쌓이는 변화: 사람의 일은 맡길 일 선정 · 기준 명시 · 결과 판정으로 확장

참고: Anthropic(2025. 9. 29.) 컨텍스트 엔지니어링 · Mitchell Hashimoto(2026. 2. 5.) 하네스 · Anthropic(2026. 10. 16.) 메타 작업 비중

챗봇(Answer Engine)과 에이전트(Action Engine)

핵심은 도구 실행과 결과 확인을 연결해 일을 이어 가는지 여부

같은 사례: 자전거법 개정안 한 건챗봇 · 답을 받아 내가 문서 작성에이전트 · 작업 폴더에서 AI가 초안 작성달라지는 지점묻는다답을 받는다내가 문서를 씀폴더의 지침서를 읽게 함초안 파일로 제출누가 파일을만드는가내가 쓴다받는 것은 텍스트 답변에이전트가 파일로 낸다검토의견 초안 · 신구조문대비표규칙이남는가대화 · 저장 설정에 따라 유지규칙이 파일로 남음“조문은 붙여 쓴다” 같은 규칙대조가공정에 있는가사람의 원문 대조 · 연결 도구인용 조문 대조를 공정에 넣을 수 있음

에이전틱 엔지니어링(Agentic Engineering)

지시 · 설계 · 검증은 사람의 일, 도구를 쓰며 반복하는 것은 에이전트의 일

사람 쟁점 · 기준을 정하고 결과를 판정 지시 · 쟁점과 요청 설계 · 기준 정하기 에이전트 · 도구를 쓰며 스스로 반복 계획 도구 실행 관찰 파일 · 검색 · 조회 결과를 보고 다음 행동을 고름 산출물 검토의견 · 대비표 작업 폴더에 파일로 검증 · 맞는지 판정하고 다음 지시로

지시 · 에이전트를 운용해 일하는 역량

초안은 에이전트 · 사람은 쟁점 · 검증 · 품질 기준을 잡음

설계 · 에이전트가 일할 기준을 정하는 기술

읽을 자료 · 수정해도 되는 파일 · 사람 승인을 기다릴 단계를 미리 정함

왜 Claude Code인가

도구의 기능은 이미 서로 비슷해졌고, 선택 기준은 내 업무 환경에 맞는지 여부

내 자료를 직접 다룸

내 폴더의 한글 · PDF · 엑셀을 읽고 · 수정하고 · 만듦

의안원문 · 검토보고서 PDF가 그대로 재료가 됨

기획부터 산출물까지 한 흐름

조사 → 작성 · 수정 → 한글 문서로 내보내기까지 한 자리에서

법령이 개정되면 다시 돌려 같은 산출물을 새로 산출함

규칙을 파일로 고정

업무지침도 절차서도 md 파일 한 장으로 읽고 · 수정 · 복사

부서원이 같은 지침 파일을 복사해 같은 기준으로 작업 가능

팀으로 나누고 검증을 공정에

역할별 팀원과 독립 검증자를 공정 안에 둠

초안을 쓴 쪽이 스스로 통과시키지 못하는 구조

  • 엑셀 · 파워포인트 · 워드 안에서는 Claude 추가 기능으로 붙여 씀(Claude for Microsoft 365)
이름은 '코드'지만 산출물은 업무 결과물 · 터미널 없이 앱에서 자연어로 씀

Claude 채팅과 Claude Code의 구분

의안원문 · 한글 파일을 다루는 일은 Claude Code, 묻고 구상하는 일은 Claude 채팅

머릿속에 있는 일 Claude 채팅 개념 질문 초안 구상 반론 점검 짧은 문안 폴더 · 파일에 있는 일 Claude Code Claude Code 폴더의 의안원문 읽기 한글 변환 · 조문 대조 스킬 · CLAUDE.md로 남음 같은 일을 다시 할 것 문체 · 양식 · 출처 대조 Claude Code 결과를 기계로 검사 조문 대조 · 표 행수 · 링크 검증 Claude Code 외부 자료 · 브라우저로 원문 확보 간단한 것은 채팅 커넥터 예약 작업 사람 없을 때 돌아야 함 회부 법률안 주간 감시 서브에이전트 한 대화 분량을 넘는 큰 일 50쪽 · 출처 100건
제안이유의 뜻을 물을 때는 채팅 · 폴더의 의안원문을 읽고 대조표 파일을 저장할 때는 이 실습의 Code 탭 사용

하네스(Harness): 에이전트의 작업 환경과 안전장치

규칙 파일에 한 줄

같은 실수가 나오면 에이전트가 늘 읽는 파일을 고침

출처 없는 조문을 또 인용하면 · 업무지침에 ‘출처 미확인 시 [확인 필요] 표시’를 적음

검증 도구 붙이기

결과를 기계가 다시 확인하는 스크립트

법률안 검토라면 · 인용문을 원문과 대조하는 절차를 추가

오늘의 질문

AI가 같은 실수를 되풀이하면 매번 당부할 것인가, 규칙과 검문소로 방지할 것인가?

anytime you find an agent makes a mistake, you take the time to engineer a solution such that the agent never makes that mistake again — Mitchell Hashimoto · 「My AI Adoption Journey」 Step 5 “Engineer the Harness”(2026. 2. 5)요지: 에이전트가 실수하면 다시는 같은 실수를 하지 않도록 해결책을 설계하는 데 시간을 들임

출처: Mitchell Hashimoto(2026. 2. 5) “My AI Adoption Journey”

무엇을 쓰나: 채팅 · 검색형 · 에이전트

일의 종류로 선택 · 실습은 공개 자료로 진행, 실제 업무자료 입력 가능 여부는 기관 지침에서 확인

같은 자료: 의안원문의 제안이유채팅ChatGPT · Claude · Gemini검색형Perplexity · 각 서비스 웹 검색에이전트Claude Code · Cowork · Codex맞는 일묻고 구상하기 · 짧은 문안출처가 필요한 검색내 폴더의 파일을 읽고 만드는 일맡기는 일제안이유를 붙여 넣고뜻을 물어봄제안이유의 근거 자료를출처와 함께 검색폴더의 의안원문을 읽고제안이유를 파일로 정리받는 것대화창의 답링크가 달린 답폴더의 파일볼 것대화가 길어지면 새 창규칙은 프로젝트 지시로답마다 링크원문을 직접 열어 확인바뀔 내용을 권한 창에서 읽고 허용kordoc 연결 시 원본 서식 · 표 확인

개인 유료 요금(월)

ChatGPT Plus ₩29,000 · Claude Pro $22(연간 $18) · Google AI Plus ₩7,500 · Perplexity Pro $20

요금제의 학습 설정(기관 지침과 별도 항목)

팀 · 기업 요금제는 기본적으로 학습에 쓰지 않음 · 개인 요금제는 설정에서 거부

출처: 각 서비스 공식 요금 페이지(한국 화면) · ChatGPT · Claude · Gemini · Perplexity · 조회 2026. 10. 26.

초안은 에이전트, 쟁점 판단과 결론은 사람

사람은 시작할 때 검토 범위와 자료를 정하고, 초안을 받으면 쟁점과 인용 근거를 확인

조수 모드 질문 한 문장 · 1턴 1답 사람 질문 한 문장 AI 답 하나 사람 붙여넣기 · 옮겨 적기 · 다시 확인 다음 질문으로 되돌아감 · 턴 사이를 사람이 메움 위임 모드 킥오프 · 업무지침 사람 · 시작할 때 검토 범위 · 자료 결정 킥오프 · 업무지침 에이전트 · 스스로 반복 의안원문 → 조문 조회 → 초안 → 대조 사람 · 초안을 받으면 쟁점 승인 · 인용 근거 확인 결론 선택 · [확인 필요] 판정

미 의회조사국의 AI 법안 요약 시험 사례

미 의회조사국은 시험 뒤 요약 업무를 단계별로 나누어 AI가 도울 작업을 선정

미국 의회조사국(CRS) · 2024회계연도LLM 6종이 만든 법안 요약 3,000건 중 기준 통과 비율(단위: 건 · %)3% 미만기준 통과요약 3,000건 전체0100%(3,000건)기준: 정확성 · 일관성 · 관련성 · 객관성이후 요약 업무를 단계별로 나누어 AI 활용처를 선정

미국 하원 법제실

수정 부담AI로 쓴 법안 문안을 수정하는 데 처음부터 쓰는 것보다 시간이 더 듦

법제실 자문 인사의 말(보도, 공식 입장 아님)

법제실 도구는 자리를 확신하지 못하면 오류를 돌려줌

검토보고서 에이전트도 문안만 작성하는 도구가 아니라 틀린 자리를 표시하고 모르면 멈추는 쪽으로 설계

출처: Donfried CRS 국장 서면증언(2026. 6. 25., 미 하원 행정위원회) · The Next Web(2026. 8. 18.) Politico 보도 인용

AI가 한쪽 분석 방법을 권하면 전문가의 선택도 달라질까

에이전트와 함께 사업 평가를 한 전문 분석가는 누구의 판단을 따랐을까

전문 분석가 인과분석 경력자 실제와 비슷한 사업 평가 과제 Claude Code와 함께 분석 농업 자문사업 확대 여부 평가 결과 지표 · 비교 방법 · 대상 범위 · 가중치 분석 선택마다 에이전트가 한쪽으로 기울도록 무작위 설정(분석가는 모름) 분석가의 선택은 에이전트를 따랐을까, 자기 판단을 지켰을까?
  • 참여 61명 중 에이전트를 쓴 50명의 분석을 집계 · 에이전트의 기울기는 동전 던지기로 정함
  • 검토보고서도 쟁점 선정 · 근거 선택 · 결론 방향을 정하는 선택의 연속

출처: Anthropic(2026. 10. 27.) “How AI agents shape experts' judgment calls”

전문가의 분석 선택 86%가 에이전트의 방향을 따름

가상 사업 평가 실험: 분석 선택의 86%가 에이전트가 기운 쪽 · 분석가는 이를 자기 판단처럼 설명

단위 %분석가 50명이 내린 분석 선택 중86%에이전트가 기운 쪽을고른 비율약 50%비교용 기대치영향이 없다면먼저 밝힌 선호(38건)60%에이전트 반대 시입장 변경6%에이전트 동의 시입장 변경설명의 출처77%분석가 중 답변 하나 이상에에이전트 논리 사용15%에이전트를출처로 밝힘
  • 쓴 집단이 더 빠르고 오류가 적었음(미사용 11명은 자기 선택 · 직접 비교 불가): 판단의 순서 문제
  • 쟁점 판단은 내가 먼저 적어 두고, 변경할 때는 이유를 기록 · 에이전트에게는 반론을 요청

출처: Anthropic(2026. 10. 27.) “How AI agents shape experts' judgment calls”

그냥 시킬까, 팀을 짤까

기본값은 목표 · 재료 · 판정 기준만 주고 시키는 것, 장치는 필요가 생긴 자리에만

이런 신호가 오면 그때 붙이는 장치 기본값 그냥 시킴 목표 · 재료 · 판정 기준만 예: 의안원문 한 건 요약 이 항목을 적어 요청 같은 말을 세 번째 하고 있음 지침 파일 · 스킬로 적음 같은 표기 지시를 되풀이하면 지침 파일에 저장 틀리면 치명적 · 제출 · 조문 · 수치 점검기 · 검수 관문을 붙임 인용 조문 · 법정형 균형 한 대화에 처리할 분량 초과 · 파일 수십 개 나눔 · 서브에이전트 → 워크플로 조문 원장 100건 대조 사람이 없을 때도 돌아야 함 예약 작업 담당 업무 접수 목록
처음에는 바로 요청하고, 같은 말을 세 번 하거나 조문 · 수치가 틀리면 장치 추가 · 결론에 영향을 주는 조문 대조는 처음부터

‘관련 입법례’는 어디까지 조사할까

“전동킥보드 관련 입법례 찾아줘”에서 빠진 정보는 검토하려는 쟁점

사람 조수가 범위를 확인한 경우

“안전 규제인가요, 주차 문제인가요?”

의뢰자 “위원께 길에 방치된 킥보드 문제를 설명하려고요”

조사 대상 무단 방치 · 견인에 관한 입법례

AI 에이전트가 한 해석으로 시작한 경우

‘관련’을 안전 규제로 해석해 입법례 수집

결과 헬멧 착용 · 속도 제한을 비교한 자료

누락 안전 규제를 다루지 않은 방치 · 견인 입법례

왜 추정이 생기나

안전 규제와 주차 문제 모두 요청 문구에 맞는 해석

검토 목적을 공유해야 조사 대상 결정 가능

조사 전에 붙일 한 문장

“‘관련’의 범위와 추천안을 먼저 보여 줘.
내가 범위를 정하면 찾아 줘.”

결과를 받을 때는 경계에 걸린 자료 하나의 포함·제외 이유를 확인

요청에 적을 의도와 판정 기준

단독이든 팀이든 같은 것을 적고, 없으면 누가 요청해도 같은 글이 나옴

# 실습 법률안 2117808 자전거법 일부개정법률안 — 요청에 붙이는 목표
줄마다 지키는 것
①의도행정안전위원회 위원이 개인형 이동장치 등록 근거 신설의 쟁점과 결론 범위를 검토의견 첫 쪽에서 잡는다
①의도
이 문서를 읽은 사람이 어떤 판단을 할 수 있어야 하는가
②판정 기준① 인용 조문이 기준일 조문 원장과 글자가 같다 ② 쟁점마다 결론 방향(긍정 · 중립/신중)과 필요한 수정의견이 있다 ③ 대비표 현행 칸이 원장 원문과 같다 ④ 장부에 없는 통계 · 입법례가 본문에 없다
②판정 기준
예/아니오로 판정 가능한 문장 3~5개
③★ 가정기준 시점은 위원회 상정일 2023. 2. 16. ‘보유하는 사람’에 법인 포함 여부는 [확인 필요]로 둔다
③★ 가정
틀리면 결론이 달라지는 것을 먼저 보임
④재료 경계의안원문 · 기준일 조문 원장 · 근거 장부만, 부처 의견은 장부에 없으면 〔판단 필요〕
④재료 경계
제공한 자료만 쓰고 수치 · 근거는 추론 금지
⑤범위 밖이 법률안의 실제 검토보고서 · 심사보고서 · 회의록은 열지 않는다
⑤범위 밖
하지 않을 것을 한 줄로
⑥기한 · 분량 ·
양식
쟁점 2개 · Ⅲ장 5쪽 안 · 위원회 편집 양식(Ⅰ → Ⅱ → Ⅲ)
⑥기한 · 분량 · 양식
숫자로

정부 AI 시범의 시간 절감은 자기보고 중심

정부 시범의 시간 절감은 대부분 자기보고이고, 검증 · 편집 시간이 그 일부를 상쇄

주당 절감 시간(단위: 분) · 둘 다 자기보고영국 정부 2만 명 시험2025. 6. 보고 · 응답 7,115명약 130분응답자가 선택한 시간 구간의 중간값으로 계산 · 하루 26분 × 5일 환산영국 국세청2026. 7. 9. 보고 · 무작위 배정약 60분근무시간의 2~3% · 약 20% 낮춰 잡음

영국 산업통상부

생산성 향상의 증거 없음 · 시간 절감이 생산성으로 이어졌다는 증거를 찾지 못함(생산성은 평가의 주목적이 아님)

호주 연방정부

속도 향상 체감 69% · 품질 61% · 검증 · 편집 시간이 절감 일부를 상쇄

  • 같은 정부 · 같은 도구도 측정 방법과 대상 직무에 따라 절감이 두 배 넘게 차이
  • 검증 시간을 업무 설계에 넣지 않으면 절감은 체감으로만 남음

출처: 영국 GDS(2025. 6.) · 영국 국세청(2026. 7. 9.) · 영국 산업통상부(2025. 8.) · 호주 DTA(2024. 10.)

Claude Code 팀의 위험도별 검토 사례

에이전트가 작성하는 코드가 늘자 사람의 줄 단위 검토 대신 위험도에 따라 검토를 분담

Claude Code 팀 제출 전 자체 점검 테스트 · 새 맥락의 재검토 모든 변경에 AI 검토 개발팀은 지적을 수정하거나 미반영 이유를 기록해야 검토 종료 위험도 분류 사람 승인 0 · 1 · 2명 단계 배포 빠른 되돌리기 검토보고서에 옮기면 조문 · 수치 자동 대조 검수관의 관문 판정 쟁점 무게에 따라 상급자 검토 작성자 책임
  • Claude Code 팀 사례: 승인 0명 경로는 신뢰 작성자의 저위험 변경만 · 에이전트 승인은 사람 승인으로 치지 않음
  • 반복 지적은 지침 파일로 옮김 · 되돌려야 했던 변경의 비율 40% 넘게 감소(6~9월)

출처: Osmani · Lunt · Wang(2026. 10. 15.) “How the Claude Code team does code review”

법률안 검토의 최대 위험은 그럴듯한 조문

위원이 검토보고서의 조문을 근거로 질의하면 그 질의와 답변이 회의록에 남음

검토보고서 인용 조문 · 쟁점 위원 배부 상정 48시간 전 대체토론 위원 질의 · 답변 회의록 공개 기록 내용 삭제 불가 자구 정정만 · 취지 변경 불가 가장 쉽게 바로잡는 구간은 배부 전
  • AI가 내는 오류의 모양 · 없는 조문 번호 · 폐지된 조항 · 지어낸 판례와 입법례
  • 검토보고서의 조문은 위원 질의의 출발점 · 질의와 답변은 회의록에 남음
  • AI 환각 자료를 다룬 각국 법원 · 심판 결정 2,266건(2026. 11. 5. 기준)
근거국회법 제58조제1항 · 제9항: 검토보고를 듣고 대체토론, 상정일 48시간 전 배부 · 제117조: 회의록은 자구 정정만, 발언 취지 변경 · 속기 내용 삭제 불가

작성과 검증의 분리

초안 작성과 인용 확인을 분담 · 검수자는 인용한 조문을 직접 열어 시행일과 원문을 대조

들어온 한 줄 · "현행 ○○법 제△조는 등록을 의무로 정하고 있음(○○부 설명자료)" ① 출처 등급을 매긴다 1 법령 원문 · 정부 공식 · 2 학술지 3 주요 언론 · 4 블로그 · SNS 4등급은 그것만으로 근거가 안 됨 등급이 낮으면 다른 출처를 하나 더 요구 ② 서로 맞는지 대조한다 조문 번호 · 시행일 · 기관명을 대조 같은 보도자료를 받아쓴 기사끼리는 교차검증이 아닌 재인용 사슬 출처가 여럿이어도 뿌리가 하나면 한 건으로 집계 ③ 실제로 열어 본다 그 조문이 기준일에 있는가 원문에 그 문구가 있는가 할 수 있다 · 하여야 한다가 맞는가 옛 조문 · 옛 위원회 이름이 여기서 걸림 챗봇이라면 문장이 매끄러우니 그대로 통과시킴 조문 표기가 붙어 있으면 확인된 것처럼 읽힘 검수자라면 매끄러울수록 더 의심함 확인하지 못한 것은 [확인 필요]로 표시하고 내역을 기록함
용어재인용 사슬 — 같은 보도자료를 여러 곳이 받아써 출처가 많아 보이는 현상

부탁에서 규칙으로, 규칙에서 검사로

같은 "조문 조심해줘"도 파일에 적으면 매번 읽고, 코드로 확인하면 정한 오류를 잡아냄

말로 부탁"조문 틀리지 않게 해줘"
  • 새 대화에 자동 반영되지 않을 수 있음
파일에 적기CLAUDE.md · SKILL.md
  • 관련 작업에서 규칙을 읽음
  • 다른 폴더에 복사해 같은 규칙 적용

다만 읽고도 어길 수는 있음

코드로 대조인용 조문 ↔ 원장 원문
  • 대비표 현행 칸 · 개정안 칸 · 표기까지 글자로 대조
  • 불일치하면 산출을 보류하고 반려

글자 대조는 LLM보다 코드에 맡김

  • 저장 전 자동 점검 · 지침 파일로 지켜지지 않던 규칙이 커밋(저장) 전 검사로 매번 지켜진 사례

출처: Simon Willison(2026. 10. 13.) Geoffrey Huntley 인용

숙련자는 법률안에서 무엇을 다르게 보는가

‘어떤 표현이 변경되었나’에서 ‘변경된 조문으로 집행기관이 어디까지 정할 수 있나’로 질문을 확장

처음 하는 사람 숙련자 문제를 분류하는 기준 Chi 외 1981 · 물리 문제 실험 문제에 보이는 표면 특징으로 경사면 · 도르래 같은 겉모양 적용할 원리로 에너지 보존 같은 풀이 원리 쓰는 지식 Collins 외 1987 개념 · 사실 · 절차 교과서와 교재로 배우는 것 + 언제 어떤 지식을 꺼낼지 아는 전략 지식 대개 암묵적 · 문제를 해결해 보며 체득함 정책직 역량 기준 영국 공무원 정책직 표준 2021 1단계 · 문제 밑에 깔린 질문의 중요성을 인식 모든 정책직의 기준선 2단계 · 핵심 정책 아이디어를 찾아 말로 표현 목표가 모호해도 핵심을 집어냄
  • 처음 하는 사람: 어느 조가 · 어떤 글자로 변경되었나를 봄
  • 숙련자: 위임 범위 · 재정 수반 · 타법 충돌을 물음
  • 숙련자의 물음은 교재에 다 적혀 있지 않아 내 점검 질문으로 적어 에이전트에게 줌

출처: Chi 외(1981) 초록 · pp.125 · 129 · Collins 외(1987) pp.2·13–14 · UK Policy Profession Standards Annex(2021) p.7 · 조회 2026. 10. 20.

내 업무 기준을 점검 절차로 문서화

내가 늘 보는 착안점을 왜 묻는지 자기 말로 설명하고 점검 절차로 전환

있는 문서 표준교재 착안점 · 선례 검토보고서 점검 질문 · 행동 단계로 정리 조건별 할 일까지 · 여기가 설계이자 학습 절차서 파일 SKILL.md · CLAUDE.md 에이전트 실행 → 결과 쟁점 표 · 초안 무엇이 틀렸는지 글로 적어 절차서를 수정

있는 문서가 재료

운영 절차 · 정책 문서를 그대로 에이전트 절차의 재료로 · 단계마다 행동 하나 · 조건에 따라 할 일까지 적음

예: "시행일이 있으면 날짜를 적고, 없으면 부칙에서 시행일 규정을 다시 찾아줘"

OpenAI 「에이전트 구축 실무 안내」 p.11

말로 표현하면 암묵지가 명시지로 전환

말로 표현해 적은 지식은 특정 상황을 벗어나 다른 과제에도 적용됨 · 전문가의 풀이와 비교하며 성찰

Collins 외 「인지적 도제」 pp.8·17

피드백을 말로 적을 수 있는 과업

사람이 피드백을 말로 표현할 때 결과가 눈에 띄게 좋아지는 과업이 평가와 개선을 반복하는 이 구조에 맞음

Anthropic 「Building effective agents」

출처: OpenAI(2025. 4.) Practical guide to building agents p.11 · Collins 외(1987) pp.8·17 · Anthropic(2024. 12.) · 조회 2026. 10. 20.

확인하지 못한 근거의 표시

조문은 원문과 대조하고, 쟁점은 실제 검토보고서와 비교 · 근거를 확인하지 못한 대목은 표시

에이전트 초안 쟁점 · 인용 조문 ① 실제 검토보고서와 쟁점마다 대조 맞음 · 부분 · 놓침 · 틀림 · 과잉 · 비교 근거가 있는 검토 ② 조문 대조 검문소 · 코드 인용 조문이 원장 원문과 글자로 같은가 · 종료코드로 답함 조문 불일치는 산출 보류 근거를 확인 못 한 대목은 표시해 작성자에게 전달
  • 검사는 에이전트가 읽을 수 있는 신호면 됨 · 테스트 · 종료코드 · 검사 스크립트 · 기준 파일과 대조
  • 미국 GAO의 AI 책임성 틀 · 거버넌스 · 데이터 · 성능 · 모니터링 원칙마다 물을 질문 목록을 붙임
  • 미국 의회조사국(CRS) 분석가 기준 · 비밀유지 · 적시성 · 정확성 · 객관성 · 균형 · 초당파성

출처: Anthropic, Claude Code: Best practices(저장본 2026. 10. 20.) · GAO-21-519SP(2021) 안내 페이지 · CRS RL33471(2011) · 조회 2026. 10. 20.

Ⅱ. 에이전트 팀 운용 사례

[시연] 가상연구실: AI 에이전트 팀 구조

반복 업무를 쪼개고, 쪼갠 일마다 업무기술서(마크다운)로 AI 역할을 정한 실제로 운용 중인 구조

3F · 관제 · 인프라
서버실GPU · MCP
회의실관문 판정 · 팀 간 회의
자료실규칙 · 위키 · 산출 파일
프로젝트실팀장 · 검증(제안요청서 · 분량)제안요청서 분석 · 제안서 초안 · 운영 일정
2F · 실무 에이전트
동향조사팀③팀장 · 교차검증(URL · 출처등급)②정책 · 언론 · 논문 · 특허
데이터분석팀팀장 · 검증(재현성)통계 · 질적 · 시뮬레이션
AI개발팀팀장 · 리뷰어(설계 · 보안)기획 · 데모 · 개발
논문작성팀팀장 · 검증(인용 정합)문헌 검토 · 초안 · 교정
강의준비팀팀장 · 검증(적합성)슬라이드 · 강의안 · 시연
1F · 외부 · 사람
나 — 연구실장① ④지시 · 승인 · 최종 판정
라운지사실 · 오류 공유 · 개선안
전문가 네트워크외부 협력자 · 자문
홍보실외부 발신 · 배포
안내실요청 접수 · 분배

[시연] 실제로 운용 중인 에이전트 팀과 자동화

반복 업무마다 팀장(위임) · 실무(작업) · 검수(관문)를 파일로 정해 하나씩 확대해 온 구조

멀티에이전트 시스템 — 팀장 · 실무 · 검수 정해진 시간이나 새 메일이 작업을 시작하고, 발송 전 사람이 확인 정책연구 에이전트팀 팀장 실무 A 실무 B 검수읽기 전용 정책브리프 · 연구보고서 · 한글 문서 단계마다 파일 · 관문 2개 데이터분석팀 팀장 실무 A 실무 B 검수읽기 전용 논문 · 특허 · 과제 분석, 코드와 결과 보고서 단계마다 파일 · 관문 2개 기술트렌드 모니터링 매주 에이전트 새 신호만 브리핑 보낼지 말지는 사람 나만의 뉴스레터 매주 월 에이전트 공고 · 동향 메일 초안 보낼지 말지는 사람 간단 업무 자동화 메일 오면 에이전트 보관 · 교정 · 공문 초안 보낼지 말지는 사람
요청 한 줄주제 · 독자 · 분량사람
→
설계 · 목차관문 ①설계자 · 검수관
→
목차 승인방향 결정사람
→
병렬 조사 · 집필출처 부착조사관 · 집필가
→
출처 검증관문 ②검수관
→
한글 문서최종 판정변환가 · 사람

[시연] 킥오프 한 줄: 결산 이월·불용 브리핑

요청 한 줄이 조사 계획과 목차로 돌아옴

정책연구 킷으로 4쪽짜리 정책브리프를 만들어줘. 주제: 최근 결산의 이월·불용 추이와 쟁점 공개 자료만 쓰고, 모든 수치·날짜에 출처와 발행일을 붙일 것.
  • 출처 규율·검증 절차·관문이 이미 팀 안에 있어서 요청은 한 줄
  • 팀장 역할이 먼저 설계 담당에게 연구 질문과 목차 작성을 요청
  • 설계 담당이 연구질문·목차·분석틀을 짜고, 검수관이 실행 가능한지 판정함
  • ★목차 승인 관문에서 멈추고 사람을 기다림

▶ 목차 승인 → 병렬 조사

목차를 수정해 승인하면 조사관들이 동시에 움직임

관문에서 할 수 있는 개입

  • 범위 좁히기 — "기금은 빼고 일반회계만"
  • 순서 바꾸기 — "불용 절을 앞으로"
  • 누락 항목 추가 — "부처별 비교 절 추가"
  • 분량 조절 — "쟁점은 늘리고 제언은 줄여"

승인 후 벌어지는 일

  • 조사관 여럿이 동시에 맡은 갈래를 조사함
  • 각자 출처를 달아 근거 파일로 남김
  • 화면에는 여러 작업이 병렬로 도는 것이 보임
  • 사람은 다른 업무 처리 후 결과 · 근거 확인

[시연] 현행 법령 확인

AI가 제시한 조문이 실재하는지, 지금도 그 내용인지 원문으로 대조

「국가첨단전략산업법」 제1조를 현행 원문으로 찾아 시행일과 함께 보여줘
  • 국가법령정보를 대화창에서 바로: 법령 · 판례 · 행정규칙
  • AI가 댄 "○○법 제○조"가 실재하는지 대조
  • 시행일이 함께 와서 개정 전 조문을 현행처럼 쓰는 오류를 방지
  • 법제처 오픈 API 키 필요(무료 발급)
# 실제 응답 — 2026. 10. 20. 조회(korean-law MCP → 국가법령정보) ▸ search_law("국가첨단전략산업법") 정확매칭 1건 국가첨단전략산업 경쟁력 강화 및 보호에 관한 특별조치법 [현행] 법령ID 014238 · MST 286519 · 공포 2026-06-02 · 시행 2026-06-02 · 법률 부분매칭 2건 — 시행령(대통령령) · 시행규칙(산업통상부령) ▸ get_law_text(mst=286519, jo="제1조") 조회기준일 2026-10-20 — 위 시행일 버전 본문 제1조(목적) 이 법은 국가첨단전략산업의 혁신생태계 조성과 기술역량 강화를 통하여 산업의 지속가능한 성장기반을 구축함으로써 국가·경제 안보와 국민경제 발전에 이바지함을 목적으로 한다.

출처: chrisryugj/korean-law-mcp(GitHub, 오픈소스) · 국가법령정보센터 · 응답은 2026. 10. 20. 실제 조회 결과

사람은 무엇을 했고, 에이전트는 무엇을 했나

사람이 맡는 일은 쟁점 승인과 근거 · 결론 판정

  • 사람이 정할 일: 주제의 가치 · 어떤 제언을 먼저 제시할지 · 어느 정도의 근거로 어떤 결론까지 말할지
  • 에이전트가 보조한 것: 출처 붙이기 · 유령 인용 찾기 · 수치–연도 세트 확인 · 표 개수 대조

되묻고 수정 의견을 저장하는 에이전트

먼저 되묻게 하고 수정 의견을 파일에 저장하면 같은 말을 반복하지 않음

① 의도를 파악하게 한다

바로 만들지 않고 계획을 먼저 보이고 되묻게 함(플랜 모드 · 목차 승인 · 모르는 것은 추측 대신 질문)

② 피드백을 저장해 다음에 반영한다

계속 적용할 수정 의견은 업무지침 파일에 저장하고, 다음 작업에서 그 파일을 읽었는지 확인

[시연] 데이터 분석 및 대시보드

키워드 하나로 연도별 추이 · 국가 · 기관 집중도 표와 그래프까지

sci-concentration으로 "autonomous driving" 2015~2025 논문 추이 · 국가 · 기관 집중도를 표와 그래프로
자율주행 논문 연도별 추이 2015~2025
자율주행 논문 국가별 참여 비율 상위 10
2015~2025 42,239건 · 중국 36.8% · 미국 11.7% · 한국 2,130건 5.0% 4위 · 검색식에 없는 문헌은 집계되지 않음

자료: OpenAlex API(조회 2026. 10. 20.) · 검색식 "autonomous driving"(제목 · 초록) · 국가는 중복 집계

[시연] 공개 목록 DB와 대시보드

흩어진 공개 자료를 한 번 축적해 두면 매번 다시 검색하지 않는 자산이 됨

과학기술정책 국무회의 아카이브 대시보드 — 반도체 검색 화면
국무회의 아카이브 — 안건 16,742건 · 447회, '반도체' 검색(발언 37건)
$ prism_db.py search "자율주행" # 로컬 DB, 0.3초 ■ '자율주행' 검색 결과 10건 · 자율주행자동차 도로운행 등에 관한 법률 발전 방향 [과학기술] 경찰청 | 2025-06-09 | 29,800,000원 | 원문 공개 · 치안정책연구소 자율주행차 준법운행 평가센터 구축방안 [과학기술] 경찰청 | 2025-05-21 | 계약금액 미수집 | 원문 부분공개 · 솔라시도 미래차 산업 육성 전략 연구용역 [과학기술] 전남광주통합특별시 | 2025-04-30 | 97,000,000원 | 원문 공개 $ prism_db.py stats → 총 74,258건 · 과학기술 4,965건
내 PC에서 0건으로 나와도 원래 공개 목록에서 같은 검색어와 기간으로 조회해 누락을 확인

자료: 정책연구용역 목록(PRISM 공공데이터 API → 로컬 DB) · 국무회의 의사일정 원문(2018. 9.~2026. 7.) · 화면은 2026. 10. 20. 실제 조회

[시연] 리서치봇(밤새 조사하고 아침에 선별: 예약 실행)

사람조정자도구 · 저장소낮 · 이동 중밤새아침저장메모 · 회의록 전달메신저 / Tiro로 입력Research Bot 접수요청을 조사와 일정으로 분담캘린더 등록일정 항목은 캘린더로조사 위임Claude Code에 요청 전달Claude Code 조사자료 수집 · 정리아침 브리핑밤새 한 일 보고★ 남길 것 선택사용자 확인 · 나머지는 제외선택분 저장사용자가 고른 결과만위키저장 · 자가 점검123456
실제 작업은 Claude Code가 하고 축적될수록 위키가 충실해짐 · 무엇을 남길지는 끝까지 사람이 정함

[시연] 나만의 뉴스레터

관심 영역의 공고를 매주 수집 · 선별해 나만의 뉴스레터를 자동으로 제작

주간 공고 동향 2026-10-05 발행본 화면
발행본 2026. 10. 5.호 — 예약 실행이 만든 실제 화면
트리거 — 매주 월요일 08:00 예약 실행사람이 켜지 않아도 자동 실행(예약 작업 파일 한 장) 수집 — 출처별 공고를 받아 옴 NTIS 통합공고 나라장터 용역 연구재단 공모 선별 — 관심 영역 파일 기준으로 선별AI · 인력양성 · 실태조사 … 파일을 수정하면 다음 호부터 반영 산출 — 요약 · 마감일 · 출처가 붙은 발행본HTML 발행본(왼쪽 화면) + 메일 초안, 수집 실패 출처는 실패로 표시 관문 — 사람이 읽고 보낼지 정함자동화는 초안까지, 발송은 사람

[시연] 공문서 자동화 · 교정교열 스킬

한글 문서를 넣으면 수정한 자리가 파란색, 삭제한 글은 회색 취소선으로 표시된 검토본이 나옴

이 한글 문서를 교정교열해줘. 고친 자리는 파란색, 뺀 글은 회색 취소선으로 표시한 검토본과 표시 없는 최종본, 교정내역을 같은 폴더에
  • 원본 서식 · 표 · 이미지는 그대로, 본문 글자만 손댐
  • 검토본 · 최종본 · 교정내역(md) 3종이 남음
  • 문서 형식과 수치 보존 확인 표 7 → 7 · 문단 62 → 62 · 수치 소실 0
교정 검토본 1쪽
검토본 1쪽
교정 검토본 2쪽 — 파란 삽입과 회색 취소선
2쪽 — 파란 삽입 · 회색 취소선(시연용 견본)

[시연] 읽기 전 경보와 로컬 비식별

탐지 · 치환 · 검증이 전부 내 컴퓨터의 코드로 돌고, 모델은 원문을 한 글자도 보지 않음

무엇이 가려지나 개인정보 성명 · 주민등록번호 · 연락처 · 주소 · 계좌 소속 기관 · 부서 사업 기밀 과제번호 · 예산 · 지정 키워드 — 포맷 9종(hwpx · docx · pptx · xlsx · pdf · hwp · md …) 원문 연구계획서명단 · 보고서 in/ 폴더 guard 열기 전 경보없음·참고·주의·위험 ① 탐지 — 규칙 · 표 · 형태소로 찾음 정규식 · 체크섬 주민번호 · 전화 · 계좌 13종 성명 열에서 이름을 찾아같은 이름을 문서 전체에서 검색 형태소 · 접미사 ○○연구원 · ○○대학교 같은 기관 ② 가명 일관 치환 홍길동 → 연구자A, 어디서나 같게 자간 벌린 표기 · 도형 속 글자 ·숨은 속성 · 첨부 파일명까지 마무리 훑기로 한 번 더 ③ 검증 게이트 산출물을 다시 전수 스캔 원값이 한 글자라도 남으면그 실행 전부 불합격 부분 통과 없음 out/ 가명 사본검사 통과분만 저장 _private/ 매핑원값 ↔ 가명, 잠근 폴더 모델이 보는 것은 가명 사본과 마스킹 요약(홍*동)뿐 · 원문 · 매핑은 내 PC 밖으로 나가지 않음 가명 처리 검사 통과 → 사본의 잔여 정보 확인 → 기관 기준에 따라 AI 입력 · 외부 공유 가능 여부 판단

언제 장치를 만드나: 반복 · 암묵지 · 오류 영향 · 크기

하나도 해당 없으면 만들지 않고, 둘 이상이면 만듦

둘 이상 해당하면 장치를 만듦 반복 같은 지시를 세 번째 타이핑하는가 검토보고서 문체 · 대비표 표기 · 조문 표기 암묵지 모델이 내 기준을 모르는가 교재 착안점 · 위원회 편집 양식 · 결론 유형 오류가 미치는 영향 틀리면 결론이 달라지는가 인용 조문 · 법정형 균형 · 시행일 크기 한 컨텍스트에 안 들어가는가 조문 원장 100건 대조 · 유사 법률안 수십 건
예외 · 틀리면 결론에 영향을 주는 조문은 장치를 만들지 않아도 한 건이라도 원문과 대조 · 반복하는 지시는 파일에 저장
deciding to delegate to AI depends on three variables: Human Baseline Time … Probability of Success … AI Process Time — 내가 직접 하면 걸리는 시간 · 한 번에 기준을 넘길 확률 · 요청하고 기다리고 평가하는 데 드는 시간을 견준다 · Ethan Mollick · 「Management as AI superpower」(2026. 1. 27)

출처: Mollick(2026. 1. 27) “Management as AI superpower”

장치는 무엇부터 만드나

반복되는 지시부터 파일로 남기고, 필요한 검사와 도구를 추가

아래 단부터 · 필요할 때만 한 단씩 메모 한 줄 같은 말을 두 번 했을 때 1분 스킬 같은 일을 세 번째 할 때 30분 점검 스크립트 규칙 위반이 반복될 때 반나절 검수 관문 잘못된 조문이나 수치가 결론에 영향을 줄 수 있을 때 호출 한 번 서브에이전트 한 대화 분량을 넘을 때 여러 역할을 호출하면 사용량이 늘어남 예약 작업 사람이 없을 때도 돌 때 범위를 좁게
자체 운영 A/B 비교: 규칙·점검기 적용 전 22·21 → 적용 후 38·38점(40점 만점)

출처: 운영 기록(2026. 10. 9.) · 가상 공고 1건을 AI 판정자 2명이 블라인드 채점

팀을 짤 때 지키는 것: 파일 이름과 도구 목록

원칙은 부탁이 아니라 파일 이름과 도구 목록으로 걸어 둠

지키는 것법률안 검토보고서 작성팀(bill-review)에서
역할은 입출력 파일로검토설계자는 00_요청.md를 읽고 01_검토설계.md를 씀, 산출은 06까지 번호 파일
생성과 평가를 나눔검수관의 도구 목록에 Write · Edit · Bash 없음, 판정서는 응답으로 돌려주고 팀장이 저장
점검표 밖도 한 번 더 찾음검수관은 점검표 확인 뒤 표에 빠진 오류도 찾음, 예: 본문과 각주가 같은 조문을 가리키는지 대조
자기보고를 믿지 않음검수관이 04c_조문대조.md를 직접 읽고 조문을 다시 조회, 변환가가 약 45% 소실을 무손실로 보고한 전례
병렬은 파일을 중복되지 않게조사관은 03_근거장부_A · _B로 나눠 쓰고 남의 파일을 건드리지 않음
작게 돌려 보고 키움교육용 실행(classroom)은 쟁점 최대 2개 · 웹 검색 쟁점당 5회, 못 판 항목은 "상한 도달"로 표시
관문은 집필 전후에만관문①(설계) → ★ 쟁점 승인(사용자) → 관문②(초안), 그 사이는 코드 검문소
문제 하나는 한 질문지적은 위치 · 문제 · 권고로, 사용자 질문은 최대 3개에 기본 가정을 붙임

자료: github.com/parkjui92/AI-Assembly · 운영 기록(2026. 10.)

하지 말 것: 팀을 먼저 설계하기

문서 한 건을 먼저 맡겨 보고 같은 오류가 반복되는 단계에 지침 · 검사를 추가

하지 말 것대신
작은 브리프에 5인 팀산출물 크기보다 장치가 크면 짐, 장치는 산출물에 맞춤
규칙 과잉"내 최종본이 걸리면 규칙이 틀린 것"으로 규칙을 깎음
모델 버릇 기준 규칙모델이 변경되면 깨짐, 결과 기준("한 줄에 두 문장 금지")으로 씀
플랫폼 전용 설정에 기대기모드 · 전용 설정보다 md 규칙 · 스크립트 · SKILL.md가 오래감
승인 없이 밖으로 나가는 자동화예약 작업은 범위를 좁히고, 초록 상태를 성공으로 읽지 않음
팀을 먼저 설계하기문서 한 건을 먼저 맡겨 보고 반복 오류 단계에 지침 · 검사를 추가
조문 대조까지 미루기틀리면 결론에 영향을 주는 조문 대조는 처음부터 둠
we recommend finding the simplest solution possible, and only increasing complexity when needed — 가장 단순한 해법을 찾고, 필요할 때만 복잡하게 한다 · Anthropic · 「Building effective agents」(2024. 12. 19)

출처: Anthropic(2024. 12. 19) “Building effective agents”

전문위원 검토보고의 법적 근거와 기능

위원은 검토보고를 듣고 대체토론에 들어가고, 보고서는 상정 48시간 전까지 배부

전문위원 정치적 중립 조사 · 연구 직무 배부한다 상정 48시간 전 위원 검토보고를 듣는다 대체토론 질의 · 답변이 남는다 회의록 제42조제2항 · 제4항 조사와 집필이 한 직무 쟁점별 찬반 논거 · 근거 제시, 자료로 확인되는 범위 표시 제58조제9항 상정 일정이 곧 작성 마감 제58조제1항 위원 토론의 출발점

정책 전문성

정책 목표 · 수단 · 집행 가능성의 논거를 정리

법제 전문성

법체계 검토 · 조문 수정의견 마련

의사 전문성

대안 마련 · 관련위원회 등 절차 조언

출처: 「국회법」(2026. 10. 2. 시행) 제42조 · 제58조 · 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 24~27쪽

검토보고서의 짜임

Ⅰ. 제안경위 → Ⅱ. 제안이유 및 주요내용 → Ⅲ. 검토의견(쟁점마다 번호)

① 표지

회기 · 위원회 · 쟁점을 적은 부제 · 대표발의 · 의안번호

③ 1쪽

발의자 · 발의일 · 회부일, 제안이유는 의안원문 그대로

자전거 이용 활성화에 관한 법률 일부개정법률안 검토보고서의 표지, 목차, 1쪽
행정안전위원회 검토보고(2023. 2.) · 의안번호 제2117808호 · ① 표지 · ② 목차 · ③ 1쪽
주요 내용현행에서 달라지는 부분
→
제도 설명개정 대상 제도 · 현황
→
개정안의 취지왜 발의됐는가
→
쟁점 검토효과 · 부작용 · 입장 · 대안

위 흐름은 일부개정법률안의 검토의견 · 제정법률안은 제정 필요성 → 제정안의 체계 → 조문별 검토

출처: 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 57~59쪽 · 행정안전위원회(2023. 2.) 검토보고

법률안검토 표준교재(2024): 목차와 내용

검토보고서 작성 준비 → 작성 → 후속조치의 흐름으로 짠 입법조사관 지침서

편장(시작 쪽)담긴 내용
제1편 총론Ⅰ 입법과정과 입법실무(3) · Ⅱ 검토보고 제도(24)발의에서 공포까지 · 검토보고의 근거
제2편 작성 준비Ⅰ 기본원칙(31) · Ⅱ 사전준비(37) · Ⅲ 구성 사례(57)쟁점 중심 · 의견 수렴 · 자료 조사
제3편 작성Ⅰ 제안 배경 · 주요 내용(63) · Ⅳ 결론(330)결론 유형: 긍정적 · 중립적/신중
 착안점 ① 정책Ⅱ 정책분석(79)개입 필요성 · 수단 · 비용 · 이해득실 · 집행 · 유사 사례
 착안점 ② 법제Ⅲ 법제분석(165)정책의도 · 법제화 방식 · 체계 · 일관성 · 위임 · 벌칙 · 부칙 · 용어
제4편 후속조치Ⅰ 상정(339) · Ⅱ 소위원회(342) · Ⅲ 의결 · Ⅳ 법사위요약자료 · 심사자료 · 심사보고서
착안점은 질문마다 의의 · 유의사항 · 사례의 같은 틀 → 점검 질문 스킬로 옮기기 좋은 구조

출처: 국회의정연수원(2024. 8.) 「법률안검토 표준교재」 차례 · 발간사

법률안 검토보고서 작성팀 설계: 표준교재를 팀으로

AI가 교재의 질문으로 쟁점 후보를 정리하면 담당자가 조사할 쟁점을 고르고 결론을 결정

제2편 작성 준비 제3편 보고서 작성 제4편 후속조치 기본원칙 · 구성 사례 31~36 · 57~59쪽 review-writing 스킬: 작성 원칙 · 보고서 골격 초기 검토: 쟁점 파악 · 검토방향 38~40쪽 검토설계자 bill-designer: 쟁점 · 목차 · 원장 목록 자료 조사 44~54쪽 자료조사관 bill-investigator · bill-sources 스킬 의견 수렴 · 예비검토 · 전문위원 보고 41~43 · 55~56쪽 사람: ★ 쟁점 승인 · 부처 의견 수렴 제안배경 · 주요내용 63~78쪽 집필가 bill-writer: 제안이유 · 주요내용은 원문 그대로 정책 · 법제 착안점 79~329쪽 review-criteria 스킬: 점검 질문 · 확인할 자료 · 쪽 결론 작성 330~335쪽 사람: 결론 유형 판단(집필가는 〔판단 필요〕) 소위원회 심사자료 · 요약자료 339~377쪽 팀 밖: 내 스킬로 만들 후보
  • 교재 밖에서 더한 장치: 조문 대조 검문소 · 관문 판정 기준 · 한글 변환

출처: 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 차례 · 작성팀 저장소 github.com/parkjui92/AI-Assembly

법률안 검토보고서 작성팀 구조도

킥오프 한 줄이 공정을 지나며 단계마다 번호 붙은 파일을 남기는 구조

팀장 스킬 bill-review: 팀원을 순서대로 부르고 관문에서 멈춤 요청 원장 내 요청 · 승인 발언 기록 00_요청.md 검토설계자 쟁점 · 목차 · 기준 시점 조문 원장 목록 01_검토설계.md 관문① 설계 판정 검수관 · 읽기 전용 NO-GO면 되돌림 02_설계판정.md ★ 쟁점 승인 사람이 더하기 · 빼기 · 순서 00_요청.md에 발언 원문 자료조사관 여럿이 동시에 근거 수집 조문 원문은 03b 폴더에 보관 03_근거장부 · 03b_조문원장 집필가 검토보고서 문체 · 대비표 원장 · 장부에 있는 것만 04_검토보고서.md 조문 대조 검문소 article_check.py · 코드 불일치하면 산출 보류 04c_조문대조.md 관문② 초안 검수 조문 2~3개 다시 조회 수정 필요면 되돌림 05_검수판정.md 변환가 편집 양식 한글 문서 06_검토보고서.hwpx 사람의 판정 [확인 필요] · 〔판단 필요〕 결론은 사람이 정함 최종 보고 목록

팀장 · bill-review 스킬: 순서와 관문

글을 쓰지 않고 팀원을 정해진 순서로 부르고 관문에서 멈춤

사용자 요청 담당 사용자 00_요청.md 기록 담당 팀장 · 글자 그대로 검토 설계 담당 검토설계자 관문① 검수관이 설계 점검 통과 여기서 멈춤 ★ 쟁점 승인 수강생이 조사할 쟁점을 선택해 승인 NO-GO면 되돌림 승인 근거 조사 조사관 여럿 · 동시에 집필 담당 집필가 조문 대조 검문소 담당 팀장 · 코드 통과 관문② 담당 검수관 통과 한글 변환 담당 변환가 사람이 판정할 목록 담당 팀장 · 보고 불일치면 재조회 · 수정 최대 2회 · 남으면 보류 수정 필요면 되돌림
  • 조문 대조 검문소는 어떤 모드에서도 생략하지 않음 · 사람의 승인 발언을 대신 만들어 넣지 않음
  • 내놓는 것: 00_요청.md · _진행기록.md · 04c_조문대조.md · 최종 보고

검토설계자 · bill-designer: 쟁점과 검토 방향

한 줄도 쓰기 전에 무엇을 · 어떤 착안점으로 · 어떤 자료로 볼지 정함

하는 일

  • 의안 정보와 기준 시점(지난 법률안은 위원회 상정일)
  • 제안이유와 조문의 실제 변경 내용 대조
  • 착안점 대조표: 해당 · 비해당 · 확인 필요와 이유
  • 쟁점 · 목차 · 조문 원장 목록 · 조사 분할

지키는 원칙

  • 의사결정이 필요한 쟁점만, 중요한 것부터
  • 조문을 기억으로 쓰지 않음 · 대비표 글자만
  • 긍정 · 중립/신중 등 가능한 결론과 확인할 근거만, 선택은 보류
읽는 것00_요청.md · 00_input/(의안원문) · 내_검토기준.md
내놓는 것01_검토설계.md · 쟁점 · 목차 · 조문 원장 목록 · 조사 분할
도구읽기 · 쓰기 · 웹 검색 · review-criteria · bill-sources 스킬
하지 않는 것근거 수집 · 본문 집필 · 판정

자료조사관 · bill-investigator: 근거마다 출처와 조회일

출처 없는 근거는 근거가 아님 · 한 줄마다 출처 · 기준 시점 · 조회일 · 표시

하는 일

  • 승인된 쟁점의 근거 번호([2-3])별로 수집
  • 사용자 자료 → 법령 · 의안 공식 창구 → 연구 · 통계
  • 원장 분할: 조문을 기준일로 조회해 응답 그대로 저장
  • 오늘 기준도 받아 두 시점이 다르면 [시점 차이]

지키는 원칙

  • 〔원문〕 · 〔요약〕 · 〔계산〕을 나눠 표시
  • 〔부처 주장〕은 사실이 아니라 의견
  • 못 찾으면 [확인 필요] · 지어내지 않음
읽는 것01_검토설계.md의 내 담당 분할 · 00_input/ · 00_요청.md
내놓는 것03_근거장부.md · 03b_조문원장/ · 미확보 목록
도구국가법령정보(korean-law) · 웹 검색 · 분할마다 여럿이 동시에
하지 않는 것쟁점 판단 · 집필 · 미공개 자료 입력

집필가 · bill-writer: 첫 쪽에서 쟁점 파악

위원이 첫 쪽에서 개정 내용과 판단할 쟁점을 파악하도록 초안을 작성

하는 일

  • Ⅰ. 제안경위 → Ⅱ. 제안이유 및 주요내용 → Ⅲ. 검토의견
  • 제안이유 · 주요내용은 의안원문 글자 그대로
  • 쟁점마다 가. 개정안의 내용 · 나. 검토의견
  • 신구조문대비표 「(생 략)」 · 「(현행과 같음)」 표기

지키는 원칙

  • 원장에 없는 조문 · 장부에 없는 근거는 쓰지 않음
  • 부처 의견이 없으면 지어내지 않고 〔판단 필요〕
  • 저장 뒤 검문소로 스스로 점검
읽는 것01_검토설계.md · 03_근거장부.md · 03b_조문원장/ · 의안원문
내놓는 것04_검토보고서.md
도구읽기 · 쓰기 · 검문소 실행
하지 않는 것쟁점 추가 · 삭제 · 조문 조회 · 판정

조문 대조 검문소

초안의 조문을 조문 원장(기준일 원문)과 코드로 대조하고, 불일치하면 산출 보류

04_검토보고서.md 집필가 초안: 인용 조문 · 대비표 03b_조문원장/ 조사관이 기준일에 받은 원문 그대로 의안원문 개정안 칸과 맞출 글자 article_check.py 사람도 AI도 아닌 코드 · 공백과 연혁 표시는 무시하고 글자 대조 인용한 조문과 그 항 · 호가 원장에 있는가 대비표 현행 칸 = 원장 원문 대비표 개정안 칸 = 의안원문의 글자 「(생 략)」 · 「(현행과 같음)」 · 「<신 설>」 자리 종료코드 0 · 통과 관문② 초안 검수로 종료코드 1 · 산출 보류 조사관 재조회 · 집필가 수정 뒤 다시 종료코드 2 · 실행 오류 파일 · 원장 형식을 수정하고 다시
  • 방지하는 것: 없는 조문 번호 · 개정 전 문구 · 변경된 부처 이름 같은 그럴듯한 조문
  • 못 보는 것: 뜻을 잘못 옮긴 해석 → 검수관의 재조회와 사람의 판정
내 업무에 적용할 때 변경할 검사 항목예결산은 표의 금액을 원자료와 대조, 의사 업무는 인용문을 공개 회의록과 대조

자료: github.com/parkjui92/AI-Assembly · bill-review/skills/article-check

임의 등록과 의무 등록으로 보는 조문 검증

조문 번호가 맞아도 할 수 있다를 하여야 한다로 바꾸면 뜻이 달라짐

연습용 초안 문장

“개정안은 개인형 이동장치 등록을 ① 의무화함”

① 오류 문장 · ‘의무화’

등록 의무 신설로 요약

대조불일치

의안원문 2쪽

② 등록할 수 있으며 · 번호판을 부착할 수 있도록 함

② 근거 · ‘등록할 수 있으며’

대비표 5~6쪽 · 등록 대상이 자전거에서 자전거등으로 확대

판정등록 의무 신설이라는 요약은 개정안과 불일치
보완 문장개인형 이동장치의 등록과 번호판 부착 근거 마련
③ 사람의 질문임의 등록으로 안전 확보 목적을 달성할 수 있는가
  • 추가 확인: 등록 유인 · 집행 부담 · 소관부처 의견

출처: 의안번호 2117808 의안원문(2022. 10. 14.) 2 · 5~6쪽 · 오류 문장은 교육용 구성

검수관 · bill-reviewer: 읽기 전용 판정

쓰는 사람과 판정하는 사람을 나눔 · 쓰기 도구가 아예 없음

하는 일

  • 관문① 요청 · 의안원문을 먼저 읽고 설계와 대조 → GO · NO-GO
  • 관문② 쟁점 누락 · 근거 없는 단정 · 대비표 · 중립성
  • 결론을 받치는 조문 2~3개를 직접 다시 조회
  • 지적마다 위치 · 문제 · 권고

지키는 원칙

  • 검문소 통과는 글자가 맞다는 뜻일 뿐
  • 찬반 이견이 있는 판단을 한쪽 논거로만 맺으면 [필수]
  • 자료의 찬반이 갈리면 양쪽 주장 · 각 근거를 함께 제시하도록 지적
읽는 것00 · 01 · 03 · 03b · 04 · 04c · 의안원문
내놓는 것판정서 · 팀장이 02_설계판정.md · 05_검수판정.md로 저장
도구읽기 · 웹 검색 · 법령 조회만 · Write · Edit · Bash 없음
하지 않는 것파일 쓰기 · 다시 쓰기 · 새 쟁점 설계

변환가 · bill-exporter: 검토보고서 한글 문서

관문②를 통과한 원고를 위원회 검토보고서 편집 양식 한글 문서로 옮김

하는 일

  • 검수 통과를 확인하고 시작
  • 첫 쟁점의 표 · 번호를 시험 변환해 표기 확인
  • 전체 원고를 한글 파일로 저장
  • 다시 읽어 표 · 대비표 행 · 표시 개수를 원고와 1:1 대조

지키는 원칙

  • 불일치하면 "이상 없음"이라 쓰지 않음
  • 실물 검토보고서(.hwpx)가 있으면 표 서식을 따름
  • kordoc이 없으면 변환을 보류하고 설치법 안내
읽는 것04_검토보고서.md · 05_검수판정.md · 실물 .hwpx(있으면)
내놓는 것06_검토보고서.hwpx · 06a_변환용.md · 변환 보고
도구kordoc MCP · 읽기 · 쓰기
하지 않는 것문장 · 조문 · 표시 수정

Ⅲ. 검토 기준 설계

설치 · 착안점 · 점검 스킬 · 자료원 연결

법률안이 법률이 되는 길

검토보고는 취지 설명 다음, 대체토론 전에 거치는 위원회 심사의 필수 절차

소관위원회 심사 보고서 배부: 상정 48시간 전 헌 = 「대한민국헌법」 · 국 = 「국회법」 · ①②⑨는 항 제안 의원 발의 · 정부 제출 헌 제52조 · 국 제79조 소관위원회 회부 입법예고 10일 이상 국 제81조 · 제82조의2 상정 · 취지 설명 숙려기간이 지난 뒤 국 제59조 · 제58조① 전문위원 검토보고 회의에서 보고 국 제58조①⑨ 대체토론 제안자 질의 · 답변 포함 국 제58조① 소위원회 심사 축조심사 · 수정 · 대안 국 제58조② 위원회 의결 찬반토론 · 표결 국 제58조① 체계 · 자구 심사 법제사법위원회 국 제86조 심사보고서 제출 국회의장에게 서면 보고 국 제66조 본회의 심의 · 의결 심사보고 · 질의 · 표결 국 제93조 정부 이송 의안정리 뒤 국 제97조 · 제98조 공포 · 법률 확정 15일 이내 · 재의요구 헌 제53조
  • 법률안 내용의 논의는 대부분 위원회 심사에서 이뤄짐
  • 검토보고서는 소위원회 심사자료의 기초가 되고 심사보고서에도 실림

출처: 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 6쪽 그림 1 재구성 · 4 · 19 · 26 · 28 · 35쪽

늘어난 법률안: 제16대 2,507건 → 제21대 25,858건

제안 건수가 약 10배로 증가해 건당 시간이 짧아지므로 쟁점을 먼저 제시

2,507건 25,858건 제16대 국회 제21대 국회 약 10배

읽는 쪽 · 건당 시간이 짧아짐

위원 · 보좌직원이 법률안 하나에 쓸 시간이 많지 않아 쟁점 위주로 써야 함

쓰는 쪽 · 전부 세부까지는 어려움

중요도 · 소위원회 심사 가능성을 보고 투입할 시간과 노력을 조정

건당 시간이 줄수록 조사와 초안은 맡기고 쟁점 판단에 시간을 씀

출처: 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 발간사 · 11 · 35~36쪽

검토보고서 작성 원칙

검토보고서에 담는 것은 의사결정이 필요한 쟁점과 그 판단에 쓸 정보

한 법률안의 두 작성 방식 · 국가와 지방자치단체의 조달계약에서 국산제품 우선구매 의무화 관련 정보 나열형 쟁점 중심 법률안과 관련된 내용을 모두 나열 의사결정이 필요한 사항 · 대안 · 판단 정보 선별 효과 등 관련 정보를 나열 · 협정 충돌은 미검토 「정부조달에 관한 협정」 비차별 원칙과 충돌 여부 달라지는 지점 핵심 쟁점을 빠뜨리면 심사에서 다뤄지지 못함 중요한 쟁점 · 논거부터 심사자료로 제시
작성 원칙가. 쟁점을 중심으로 · 나. 전체 입법과정을 고려 · 다. 필요한 경우 수정의견
기본원칙정치적 중립성 · 객관성 · 균형성 · 전문성 · 정확성 · 명료성
초심자가 흔히 하는 실수는 관련 정보를 모두 나열하는 것

출처: 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 31~36쪽

검토의견의 정치적 중립: 질문과 검토 절차

중립 의무는 전문위원과 공무원에게 있고, AI 답은 질문에 담긴 입장 쪽으로 기울 수 있음

생기는 일

  • 질문에 입장이 드러나면 그 입장이 근거를 찾는 기준이 됨
  • 한쪽 근거가 빠졌는지는 답만 보고 알기 어려움
  • AI가 "중립적으로 검토함"이라고 적어도 그 자체로 판정이 아님

대응 절차

  • 질문에서 내 입장을 제외
  • 찬반 근거를 각각 찾아 출처를 붙이고, 자료가 부족한 쪽은 한계 표시
  • 반대 입장에서 다시 검토시키고, 결론 유형은 사람이 선택
  • 시연: 같은 법률안을 찬성 · 반대 입장으로 각각 검토시켜 결론 차이 확인

출처: 「국회법」 제42조제2항

입력 금지 정보 확인

미공개 법률안 초안 · 의원실 내부자료 · 개인정보는 반입 금지

자료 입력 금지 정보가 포함돼 있는가? 포함 미포함 공개 여부 확인 공개 확인 공개 여부 불명 내부 회의자료 · 내가 쓴 미공개 업무 초안 입력 중단 미공개 법률안 초안 · 의원실 내부자료 · 개인정보 원본 미공개 부처 제출 자료 · 비공개 회의 자료 · 인증키 사용 의안원문 · 검토보고서 · 법령 · 판례 공개 자료만으로 오늘 실습에서 쓴 초안 부서 확인 전 입력 보류 공개 여부가 불분명한 자료 조건부 · 비식별 전처리 후 부서 판단 내부 회의자료 · 개인정보 제거본 내가 쓴 미공개 업무 초안
  • 비식별 전처리: 이름 · 연락처를 내 PC에서 가명 처리한 사본만 넣음(공개 도구 deident)
  • 외부 문서 · 웹페이지에 적힌 지시문은 따르지 않고 자료로만 취급
프롬프트와 첨부 자료는 외부 서버로 전송

에이전트의 보안 위험

파일을 수정하고 명령을 실행하므로 입력 자료 외에 권한과 연결 도구까지 점검

구분공식 문서가 밝힌 위험내가 할 일
권한수동 모드는 수정 · 실행 전 승인 요청, 동작은 모드마다 다름시작 전 권한 모드 확인
승인한 명령은 작업 폴더 밖에도 기록 가능대상 경로를 읽고 허용
권한 생략 모드는 격리 환경 전용업무 PC에서 사용하지 않음
외부 지시문문서 · 웹페이지에 숨긴 지시가 AI 행동을 변경출처 불명 문서는 입력하지 않음
사람 눈에 보이지 않아도 작동 · 완벽한 방어는 없음제안된 명령은 읽은 뒤 승인
플러그인 · MCP플러그인은 내 계정 권한으로 코드 실행 가능제공처와 설치 항목 확인
Anthropic은 MCP 서버의 보안 감사 · 관리를 하지 않음제공처를 모르면 연결하지 않음
범위MCP 디렉터리에는 등재 심사가 있으나 서버의 보안 감사와 관리는 하지 않음

출처: Claude Code Security · Permission modes · Plugin security · OWASP LLM01:2025 · 확인 2026. 11. 10.

AI를 어디까지 써도 되나

넣지 않을 자료는 지침이 정하고, 결과의 책임은 쓴 사람에게

기관 지침 국가정보원 보안 가이드라인 (2023. 6.) 부서 · 정보화 담당 사무처 내부 지침은 업무 적용 전 이 담당에게 확인 사용자(작성자) 결과를 원문으로 확인한다 최종 책임을 진다 인사혁신처 지침(2026. 5. 22.) AI 제공자 「인공지능 기본법」 제31조② · 시행령 제23조④ 넣지 않을 자료를 정한다 기준을 확인한다 기준 확인 전 공개 자료만 입력 표시 의무를 진다
  • 망: 모든 자료를 막던 망분리에서 등급별 차등으로 전환되는 중(국가망보안체계 2025. 9.)
국회 기준을 확인하기 전에는 공개 자료만 넣고, AI가 쓴 부분은 원문으로 확인한 뒤에 씀

출처: 국가정보원(2023. 6.) 「챗GPT 등 생성형 AI 활용 보안 가이드라인」 · 「인공지능 기본법」 제31조 · 인사혁신처 보도자료(2026. 5. 22.) · 조회 2026. 10. 26. · 11. 5.

실습 화면과 작업 폴더 준비

작업 폴더 법률안실습을 선택하면 화면은 세션 · 대화 · 변경 비교가 전부

ChatCoworkCode세션법률안실습지난 세션지난 세션이 세션의 설정환경 · 폴더 · 모델 · 권한채팅이 폴더에 뭐가 있는지 보여줘파일 목록입니다경로: 바탕화면/법률안실습권한 창 — CLAUDE.md를 만들어도 될까요?대상: 바탕화면/법률안실습/CLAUDE.md무엇을 시킬지 여기에 적는다변경 비교+ CLAUDE.md+ 자전거법_주요내용.md터미널 · 파일$ lsCLAUDE.md 입력/ _workspace/앱 안에서 열린다여기서 폴더를 선택한다오늘은 Code 탭변경된 파일이 같은 화면에
Claude 데스크톱 앱 Code 탭 — 강의용 구성도(배치는 앱 버전에 따라 다를 수 있다)
파일을 만들거나 명령을 돌릴 때 뜨는 노란 권한 창: 대상 경로를 읽고 허용, 작업 폴더 밖이면 거부

★ 해보기 ① 팀 플러그인 설치

공개 저장소 parkjui92/AI-Assembly를 마켓플레이스로 등록하고 작성팀 설치

GitHub 저장소 parkjui92/AI-Assembly를 플러그인 마켓플레이스로 추가하고 bill-review 플러그인을 설치해줘.
순서할 일완료 확인
폴더 선택법률안실습 폴더 열기경로가 바탕화면/법률안실습
설치 요청위 요청문을 붙여 넣기bill-review 플러그인 활성화
새 세션설치 후 같은 법률안실습 폴더에서 새 대화(세션) 열기팀원과 스킬 목록 조회
준비 점검"교육용 실습 준비 상태만 확인해줘" 입력Python · 검문소 확인(법령 도구는 해보기 ⑦에서)
오류 시새 세션에 목록이 없으면 앱을 닫고 다시 열기같은 폴더에서 목록 재확인

명령 예: claude plugin marketplace add parkjui92/AI-Assembly
claude plugin install bill-review@ai-assembly

출처: Claude Code · 플러그인 마켓플레이스 · github.com/parkjui92/AI-Assembly · 확인 2026. 10. 26.

설치 확인: 팀원과 스킬 목록

설치된 법률안 검토보고서 작성팀의 팀원이 누구이고 각자 무엇을 하는지, 스킬은 무엇이 있는지 표로 보여줘
  • 확인: 새 세션에서 검토설계자 · 자료조사관 등 설치한 역할 목록이 나오면 완료 · 안 되면 손을 들어 줄 것
팀원검토설계자 · 자료조사관 · 집필가 · 검수관(읽기 전용) · 변환가
스킬팀장 · 착안점 · 문체 · 조문 대조 · 자료원 · 관문 판정 · 한글 변환 · 교육용 실행
관문설계 판정 · 조문 대조 검문소 · 초안 검수 · 쟁점 승인(사람)
팀원 이름을 외울 필요 없이 "검토보고서 초안 써줘" 한마디면 순서대로 불려 나옴

실습 법률안과 자료 구분

기본은 자전거법 일부개정안 2117808 · 담당 분야는 조건을 맞춘 법률안만

담당 분야 선택 시 담당 분야 법률안이 조건에 맞는가? 일부개정안 · 개정 조문 5개 이내 검토보고서 발간분 조건 밖 충족 기본 실습 · 자전거법 2117808 입력/의안원문_2117808.pdf 자전거등 정의 · 등록 근거 자전거법 상정일 2023. 2. 16. 담당 분야(선택) 공통 실습을 마친 교육생 선택한 법률안의 검토 기준일 확인 초안 작성 쟁점 1~2개 대비표 1~2개 ① 초안 저장 ② 그 뒤 실제 검토보고서 받기 의안정보시스템
  • 비교자료는 초안을 저장한 뒤에 받고, 작성 중에는 찾아 읽지 않음
  • 의안원문의 통계 · 전망은 제안자의 설명으로 구분해 원출처 확인
내 업무 적용예결산 · 조사: 사업설명서 · 요구자료 · 연구보고서 / 의사 · 행정 · 홍보: 회의 자료 · 공문 · 보도자료 초안

★ 해보기 ② 의안원문 내려받기

대화창에 답만 받지 않고 작업 폴더에 파일이 생기는 것까지 확인

의안정보시스템에서 의안번호 2117808의 의안원문 PDF를 내려받아 입력/ 폴더에 의안원문_2117808.pdf로 저장해줘. 주소: https://likms.assembly.go.kr/filegate/servlet/FileGate?bookId=51621BDE-4DCB-C7F4-932C-E5C192D431F9&type=1
확인무엇이 보이면 되나안 보이면
권한 창대상 경로가 법률안실습/입력 안밖이면 거부 · 폴더 다시 선택
파일입력/에 의안원문_2117808.pdf · 7쪽"파일로 저장해줘"만 다시
내용첫 쪽 의안번호 2117808 · 자전거법주소를 다시 붙여 요청
  • 의안정보시스템 의안 화면의 의안원문 PDF 파일 주소를 그대로 씀
  • 파일은 앱의 파일 목록이나 Finder · 파일 탐색기에서 직접 열어 확인

실제 폴더 구조: agents · skills · references

구조도의 칸은 전부 폴더 안의 파일

bill-review/ MIT 해보기 ① 설치 ├─ .claude-plugin/plugin.json 플러그인 명세 ├─ agents/ 팀원 업무기술서 │ ├─ bill-designer.md 검토설계자 │ ├─ bill-investigator.md 자료조사관 │ ├─ bill-writer.md 집필가 │ ├─ bill-reviewer.md 검수관 · 읽기 전용 │ └─ bill-exporter.md 변환가 ├─ skills/ 절차서 │ ├─ bill-review/ 팀장 │ ├─ review-criteria/references/ 착안점 │ ├─ article-check/ 조문 대조 검문소 │ └─ review-writing/ · bill-sources/ … └─ CLAUDE.template.md 업무지침 예시
법률안실습/ 오늘 내 폴더 ├─ CLAUDE.md 업무지침(선택) ├─ .claude/skills/부칙-점검/ 해보기 ④ 점검 스킬 ├─ 내_검토기준.md 내 검토 기준 ├─ .env 인증키 · 채팅창 금지 ├─ 입력/ 의안원문 └─ _workspace/ 해보기 ⑧ 초안 작성부터 팀이 남김 ├─ 00_요청.md · 01_검토설계.md ├─ 02_설계판정.md · 03_근거장부.md ├─ 03b_조문원장/ · 04_검토보고서.md └─ 04c_조문대조.md · 05_검수판정.md · 06 .hwpx

마크다운 읽는 법: 기호 몇 개가 전부

팀원도 스킬도 업무지침도 검토보고서 초안도 전부 메모장으로 열리는 .md 파일

# 마크다운 예시: 검토 메모의 생김새 # 자전거법 개정안 검토 메모 ① ## 개정안의 주요내용 ② 1. **안 제2조제1호의3** '자전거등' 정의 ③ ## 근거 - **기준일: 2023. 2. 16.** 위원회 상정일 ④ - **[확인 필요]** 소관 부처 의견 조회 전 ⑤ - 출처: `03b_조문원장/` ⑥
번호기호뜻
①#제목
②##하위 제목
③1.번호 목록
④-글머리 목록
⑤**굵게**강조
⑥`코드`파일 이름 · 명령
---머리말의 시작과 끝

반복 지시를 절차서로 만드는 스킬

대비표 점검 순서를 스킬 파일에 저장하면, 새 의안원문에도 "대비표 표기 점검해줘"로 요청

같은 사례: 신구조문대비표 표기 CLAUDE.md 업무지침 언제 읽히는가 항상 읽힘 대비표 작업 읽힘 다른 작업 읽힘 표기 · 금지 · 검증 규칙 예: "조문은 붙여 씀" 스킬 작업 절차서(SOP) 언제 읽히는가 해당 작업 때만 불림 대비표 작업 불림 다른 작업 안 불림 순서 · 항목 · 기준 절차 예: "대비표 표기 절차"
스킬 대상의 기준: 반복되고 · 틀이 있고 · 기준을 말로 설명할 수 있는 일

스킬의 생김새: 발동 조건 · 절차 · 금지

머리말(이름 · 발동 조건)과 본문(절차 · 금지)이 전부

# skills/article-check/SKILL.md — 작성팀 파일 발췌(기호 하나는 말로 풀어 씀) --- name: article-check description: "조문 대조 검문소. … 인용 조문이 현행에 없거나 대비표가 원문과 다르면 종료코드 1로 산출을 보류한다. … '조문 대조', '인용 조문 확인', '신구조문대비표 검사', '검문소' 요청에도 사용." ① --- # 조문 대조 검문소 — "조문 조심해줘"는 파일로, 대조는 코드로 ② ## 1. 흐름 조사관(원장 분할): 법령 도구로 기준일 원문 조회 → 03b_조문원장/<법령>@<기준일>.md (응답 그대로) 팀장: article_check.py → 04c_조문대조.md 어긋난 조문이 있으면 산출 보류 ③ ## 2. 원장 파일 형식 … - 원장은 조사관만 쓴다. 집필가·팀장은 고치지 않는다(틀렸으면 다시 조회해 새로 쓴다) ④
①발동 조건
②여기부터 한국어 업무 지시서
③절차
④금지

작성팀의 스킬: 팀원이 읽는 절차서

팀장 스킬(bill-review)이 순서를 잡고, 팀원은 일마다 정해진 스킬을 읽고 일함

스킬무엇핵심누가 읽나
bill-review팀장 · 순서와 관문팀원을 정해진 순서로 부르고 관문 · ★ 쟁점 승인에서 멈춤지금 대화(팀장)
review-criteria착안점 색인교재 제3편 착안점 → 점검 질문 · 확인할 자료 · 쪽검토설계자 · 검수관
review-writing문체 · 골격 · 표기골격 Ⅰ→Ⅱ→Ⅲ · 개조식 종결 · 대비표 표기 · 결론 유형집필가 · 검수관
article-check조문 대조 검문소인용 조문 · 대비표를 원장과 코드로 대조팀장 · 조사관 · 집필가
bill-sources자료원 · 기준 시점법령 · 의안 자료원 · 기준 시점 · 실제 검토보고서는 초안 저장 뒤 열기자료조사관 · 검토설계자
review-check관문 판정 기준관문①② 점검표 · [필수]/[권고] · 실물 대조표검수관 · 팀장
hwpx-export한글 변환 절차kordoc 범용 모드 · 번호 · 표기 보존 · 1:1 대조변환가
classroom교육용 첫 실습준비 점검 · 쟁점 최대 2개 · 승인 · 검문 · 검수팀장(교육용 실행)

팀장 스킬 실물: 순서와 관문

팀장은 직접 일하지 않고 누구를 어떤 순서로 부르고 어디서 멈출지만 적은 스킬 파일 한 장

# skills/bill-review/SKILL.md — 작성팀 실물 발췌 --- name: bill-review description: "법률안 검토보고서 작성팀의 팀장(조율) 스킬. … '법률안 검토보고서 초안', '이 법률안 검토해줘', '의안번호 ○○ 검토보고서' … 요청 시 반드시 사용. …" ① --- # 팀장 — 순서대로 부르고, 관문에서 멈춘다 ## 3단계 — ★ 쟁점 승인 관문 (사용자) ② **승인 전에는 조사로 넘어가지 않는다.** 한 화면에 아래만 보인다 … ③ - 사용자의 답은 **원문 그대로** `00_요청.md` ⑤에 시각과 함께 덧붙인다 ## 6단계 — 조문 대조 검문소 (생략하지 않는다) - **종료코드 1(✕ — …)** → 원인을 가른다 … **최대 2회.** 그래도 ✕가 남으면 **산출을 보류한다** … ④
①이 팀을 부르는 말
②사람이 승인하는 단계
③쟁점 관문: 승인 전 조사 금지
④검문소: 불일치 시 산출 보류
00_요청.md의 ⑤는 파일 안의 항목 번호 · 여기에 수강생의 승인 발언을 기록

표준교재에서 스킬로: 착안점을 점검 질문으로

교재의 서술형 착안점을 법률안마다 던질 질문 · 확인할 자료 · 쪽으로 전환해 둠

법률안검토 표준교재 106쪽 4. 국가가 개입할 문제인가? 가. 의의 · 나. 분석시 유의사항
표준교재 106쪽 · 나. 분석시 유의사항의 ③

→ 작성팀 skills/review-criteria/references/1-policy.md

착안점P4-3 법률 개정 외 해결 방안
점검 질문현행 제도 보완 · 행정 조치로 해소할 수 있지 않은가?
자율규제 · 노사 합의 같은 민간 장치가 있는가?
확인할 자료현행 법령 · 하위법령(korean-law)
부처 기존 사업 · 자율규제 기구 심의 실적
국가인권위 결정례(인권e) · 관계부처 의견
쪽106~107 · 113~115쪽 · 판단이 걸리면 폄

출처: 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 106쪽 · github.com/parkjui92/AI-Assembly bill-review/skills/review-criteria

착안점 스킬: 질문 · 확인할 자료 · 교재 쪽

교재의 착안점 한 절이 점검 질문 표 한 장으로 · 결정하기 어려우면 표에 적힌 교재 쪽을 확인

# skills/review-criteria/references/4-delegation-penalty-addenda-terms.md — 작성팀 실물 발췌(표 한 행을 문장으로 정리) ## 이 파일을 펴야 하는 신호 ① 언제 펴나 - 10절 부칙: 부칙에 시행일·유효기간·다른 법률의 폐지·준비행위·적용례·특례·경과조치·다른 법률의 개정·다른 법령과의 관계 조항이 있거나, … (p.292~298) ### 10. 부칙은 제대로 규정되었나? (p.292~318) ② 교재의 절 D10-3 시행일의 유예기간 ③ 착안점 ID 점검 질문 하위법령·조례 정비나 국민 준비가 필요한데 공포일 시행으로 두지 않았는가? … 확인할 자료 부칙 시행일, 본칙의 위임 조항 수(하위법령·조례 정비 소요), 「법령 등 공포에 관한 법률」 제13조의2, … 쪽 p.293~294, 301 ④ 시행 유예기간이 충분한지 결정하기 어려우면 표준교재의 이 쪽을 확인
references 파일교재 제3편펴는 때
1-policy.mdⅡ장 · 79~164쪽모든 법률안 · 정책분석
2-intent-form.mdⅢ장 1~5절 · 165~211쪽모든 법률안 · 의도 반영 · 방식
3-system.mdⅢ장 6 · 7절 · 212~259쪽정의 · 인용 조문 · 다른 법률
4-delegation-….mdⅢ장 8~11절 · 260~329쪽위임 · 벌칙 · 부칙 · 용어 문구
교체예결산: 심사기준 · 회답 점검표 / 의사 · 행정 · 홍보: 공문서 · 보도자료 점검표

★ 해보기 ③ 착안점 스킬로 쟁점 찾기

입력창에 @ 입력 → 입력/에서 의안원문 PDF 선택 → 아래 요청문 전송

이 법률안의 쟁점을 정책·법제 착안점으로 찾아줘
결과 칸무엇이 적혀 있나
판정착안점마다 해당 · 비해당 · 확인 필요
이유의안원문의 조문 · 대비표 글자를 가리키는 한 줄
쪽결정하기 어려우면 확인할 교재 쪽
쟁점 후보근거 착안점 번호가 붙은 쟁점 문장
  • 결과는 착안점 대조표와 쟁점 후보
  • 법률안은 입력/의 의안원문 중 자전거법 2117808 · 실제 검토보고서는 열지 않음
내 업무 적용예결산 · 조사: 사업설명서를 심사기준으로 점검 / 의사 · 행정 · 홍보: 회의 자료 · 공문을 점검표로 점검

쟁점 목록 읽기: 근거 쪽수와 지어낸 것

쟁점 후보는 교재 쪽과 의안원문 글자로 재확인해 내가 판정

착안점 판정 이유 쪽 번호 · 이름 해당 조문 · 대비표 글자 교재 쪽 번호 · 이름 비해당 조문을 가리킴 교재 쪽 번호 · 이름 안 본 행 부분 대조로 표시 쟁점 후보: 근거 착안점 번호가 붙은 쟁점 문장 판례 · 입법례 · 통계 · 부처 의견이 든 자리 ② ① ③ ④ ⑤ ① 교재 쪽 같은 착안점이 아니면: 쟁점에서 빼거나 확인 필요 표시된 쪽을 펴서 같은 착안점인지 봄 ② 의안원문 글자 조문이 없으면: 의안원문 글자로 다시 요청 가리킨 조문이 의안원문에 실제로 있음 ③ 비해당 조문을 못 가리키면: 확인 필요로 되돌림 예: 벌칙 내용을 살펴보고 해당 없음 확인 → 비해당 · 확인 위치 기록 ④ 안 본 행 비해당과 구분 예: 그 절을 아직 보지 않음 → 부분 대조로 표시 · 남은 절 명시 ⑤ 착안점 밖 근거 출처가 없으면: 지우거나 받을 것 목록으로 판례 · 입법례 · 통계 · 부처 의견에 출처
  • 쟁점으로 올릴지 · 순서는 쟁점 승인 관문에서 사람이 정함

★ 해보기 ④ 담당 업무의 검토 기준을 점검 스킬로

표준교재의 착안점이나 내 업무의 검토 기준 메모를 질문과 판정 기준으로

첨부한 자료의 착안점으로 점검 스킬을 만들어줘. 질문마다 확인할 자료를 적어줘. 교재는 쪽수, 내 업무 메모는 근거로 삼은 문장을 표시해줘.
확인할 곳스킬에 있어야 할 것내가 수정할 것
발동 조건어떤 요청에 이 절차를 쓸지내가 실제로 쓸 요청문
점검 질문시행일 · 적용례 · 경과조치담당 업무의 질문 한 줄(예: 예결산 심사기준)
근거교재 쪽 · 메모의 근거 문장 · 대조할 조문실제 교재 · 메모와 대조
판정해당 · 비해당 · 확인 필요근거 없는 단정 금지
  • 교재는 위임 260~272쪽 · 벌칙 273~291쪽 · 부칙 292~318쪽, 또는 내 업무 메모 · 첨부는 PDF · 텍스트로
  • 교재 원문이 없으면 쪽수를 만들지 않고 원문 확보 뒤 보완
  • 저장 위치: 법률안실습/.claude/skills/부칙-점검/SKILL.md(폴더 이름은 내 스킬 주제로)

★ 해보기 ⑤ 실행하고 SKILL.md로 확인

발동 조건에 적은 표현으로 요청하고, 결과보다 파일로 저장된 절차를 열어 봄

실행

이 법률안 부칙 점검해줘

부칙 자리에 내 스킬 주제 · 예: "이 법률안의 벌칙 점검해줘"

확인

방금 만든 점검 스킬의 SKILL.md를 열어서 발동 조건, 점검 질문, 금지 줄이 어디 있는지 표시해줘
볼 것어디서안 되면
스킬이 불렸나적용한 스킬 이름 · 파일 경로스킬을 지정해 다시 요청
근거점검 질문마다 붙은 교재 쪽 · 메모의 근거 문장절차에 "질문마다 교재 쪽" 명시
판정 이유의안원문 조문을 가리키는지금지 줄에 "조문 없이 판정 않음"
없는 근거판례 · 입법례를 지어내지 않는지금지 줄에 "출처 없으면 [확인 필요]"

★ 해보기 ⑥ 담당 업무의 검토 기준 반영

교재 착안점 위에 담당 업무에서 늘 볼 것을 추가함

[담당 위원회] 법률안을 검토할 때 늘 확인할 것을 나에게 하나씩 물어서 내_검토기준.md에 표로 적어줘
확인어떻게
지금내_검토기준.md에 질문이 저장됐는지
작성팀 실행 뒤01_검토설계.md 대조표 끝에 '파일: 내 기준' 행이 있는지
작성팀 실행 뒤02_설계판정.md에서 내 기준으로 본 지적이 있는지
  • 위원회 업무가 아니면 [담당 업무]로: 예결산 분석 · 현안 보고서 · 보도자료
  • 업데이트 때 덮어써지므로 플러그인 파일은 직접 수정하지 않고 내 기준은 내 폴더에

API와 MCP로 외부 자료 연결

사람이 에이전트에 요청 MCP로 붙인 도구 도구가 가져오는 곳 에이전트가 받는 것 법령 조회 요청 조문 · 기준일 지정 korean-law 법령 조회 도구 법제처 API 대개 인증키 필요 조문 원문 요청한 기준일의 자료 MCP로 부름 API로 조회 돌려줌 파일 읽기 요청 한글 · PDF 문서 지정 kordoc 한글 문서 도구 내 폴더의 문서 API 조회 없음 읽어 낸 표 원본 문서와 대조 MCP로 부름 파일을 읽음 돌려줌
용어API: 기관이 프로그램용으로 공개한 자료 조회 규격
용어MCP Model Context Protocol: 도구를 AI에 붙이는 공통 규격 · 2024년 공개된 개방형 표준

도구 없이 물으면: 지난해 법령의 답

도구 없이 기억으로만 답하면 배운 시점의 조문과 위원회 이름이 나올 수 있음

같은 질문  기억으로만 답해줘. 「국회법」 제37조에 따라 재정 · 경제 부처, 환경 · 노동 부처, 성평등 · 가족 부처를 맡는 상임위원회 이름은?
기억으로 나올 수 있는 이름 소관 · 시행일 조회한 현행 기획재정위원회 재정 · 경제 2026. 1. 2. 시행 재정경제기획위원회 환경노동위원회 환경 · 노동 2025. 10. 1. 시행 기후에너지환경노동위원회 여성가족위원회 성평등 · 가족 2025. 10. 1. 시행 성평등가족위원회
  • 볼 것: 답에 시행일 · 조회 시점이 붙었는가 · 옛 이름을 현행처럼 썼는가
기억이 아니라 창구에서 가져오도록 도구를 연결함

현행 원문: 국가법령정보센터 「국회법」 제37조 · 시점별 조회(2026. 10. 20.)

★ 해보기 ⑦ korean-law로 현행 조문 조회

법제처 API에서 조문을 조회하는 공개 도구 · 기준일 판과 현행 판을 별도로 받음 MIT

github.com/chrisryugj/korean-law-mcp의 README에 따라 korean-law 플러그인을 설치해줘
자전거 이용 활성화에 관한 법률 제22조를 2023년 2월 16일 기준과 현행으로 원문 그대로 보여줘
단계무엇이 일어나나오류가 나면
설치인증값(LAW_OC)은 플러그인 설정란에 본인이 입력 · 같은 폴더에서 새 대화설정 화면의 플러그인에서 추가
확인응답 첫 줄에 어느 판인지 · 조문이 원문 그대로키 승인 전이면 보조강사와 공동 확인
활용받은 원문을 조문 원장에 그대로 둠확인 못 한 인용은 [확인 필요]
  • 확인: 두 판이 다르면 오류가 아니라 시점 차이 · 본문에 기준일을 밝힘

법령 답의 확인: 도구 호출 기록부터

“「국회법」 제37조의 상임위원회 이름을 찾아줘” MCP가 없을 때 학습해 둔 기억에서 문장을 만듦 또는 웹의 안내문 · 요약본을 옮김 · 옛 위원회 이름을 현행처럼 답할 수 있음 · 시행일자가 붙지 않음 · 출처가 기관 안내문 · 블로그일 수 있음 맞는지 보려면 내가 법령을 다시 찾아야 함 MCP가 있을 때 get_law_text 도구를 부름 → 법제처 오픈 API 응답 · 오늘자 현행 조문 · 기준일 판도 별도 · 시행일자가 함께 옴 · 어느 판(시행일)을 불렀는지 남음 호출 기록과 원문을 대화 안에서 확인
MCP는 매번 주소를 치던 일을 대화 안으로 들여놓는 것
① 도구 호출 기록도구를 실제로 호출했는지
→
② 법령명묻은 법령이 맞는지
→
③ 기준일 · 시행일어느 판을 불렀는지
→
④ 인용 원문답의 문구가 조문과 같은지

정식 키 발급: 국가법령정보 · 열린국회정보

기관별로 발급받은 인증값을 도구가 안내한 설정란 또는 .env에 등록

창구주소받는 법쓰는 곳
국가법령정보open.law.go.krOPEN API 활용 신청 · 승인조문 현행 · 기준일 확인
열린국회정보open.assembly.go.kr회원 가입 후 인증키 신청의안 정보 · 유사 법률안
  • 키는 채팅창에 붙이지 않고 AI에게 키 파일을 열어 보게 하지도 않음 · 값은 내가 직접 입력
  • 부서 저장소에 올릴 때는 .gitignore에 한 줄 적어 .env를 올리지 않음
  • 도구 설명에서 인증키를 읽는 위치 확인 · 설정 화면이면 설정란, .env 지원이면 안내된 파일

인증키 안전하게 보관하기

플러그인이 요구하면 안내된 설정란, 파일에서 읽는 도구는 안내된 위치의 .env에 본인이 입력

① 신청open.law.go.kr 가입 · Open API 신청 · 사전 과제
→
② 발급인증값(OC) · 무료 · 본인만 사용
→
③ 저장플러그인은 설정란 · 파일에서 읽는 도구는 .env에 직접 입력
→
④ 제외.gitignore에 .env 한 줄 · 노출되면 재발급
이 폴더에 빈 .env 파일을 만들어줘. 항목은 LAW_OC와 ASSEMBLY_KEY, 값은 비워 둬. 실제 값은 내가 직접 넣을게. .gitignore에도 .env를 추가해줘.
키의 종류예발급 · 비용
무료 · 사전 신청국가법령정보(LAW_OC)강의 전 신청 · 해보기 ⑦에서 사용
무료 · 로그인 발급열린국회정보(ASSEMBLY_KEY)실습 뒤 현업 적용 때 · 키가 없으면 한 번에 5건까지
유료 · 쓴 만큼검색 API · 모델 API(Anthropic · OpenAI)노출되면 요금 사고 · 한도부터 설정
용어.env — 인증키를 적어 두는 설정 파일 · .gitignore — 저장소에 올리지 않을 파일 목록

Ⅳ. 검토보고서 초안

작성 · 조문 대조 · 한글 변환

번호 순서로 생성되는 산출 파일

단계마다 번호 붙은 파일이 생성되어 _workspace/ 폴더만 열면 진행 단계가 보임

오후 시작 전 확인할 것☐ 의안원문 PDF를 직접 열었음☐ 설치한 팀의 역할 목록을 확인했음☐ 기준일과 시행일이 적힌 법령 원문을 받았음인증키 승인 대기: 보조강사와 공동 확인 후 오후 실습 이어 감
설계 조사 · 집필 후속 요청 00_요청.md 내 요청 글자 그대로 01_검토설계.md 쟁점 · 기준 시점 · 원장 목록 02_설계판정.md 관문① 설계 판정 ★ 쟁점 승인 사람이 쟁점을 수정해 승인 03_근거장부.md 근거 · 출처 · 조회일 03b_조문원장/ 기준일 조문 원문 그대로 04_검토보고서.md 초안 · 신구조문대비표 04c_조문대조.md 코드 검문소 · 불일치하면 보류 05_검수판정.md 관문② 초안 검수 교육용 첫 실행은 쟁점 최대 2개로 첫 실행은 05_검수판정.md와 판정할 목록 제시까지 06_검토보고서.hwpx “한글 문서로 변환해줘” 대조표 “실제 검토보고서와 비교해줘”
용어조문 원장 — 기준일에 법령 도구로 받은 조문 원문을 한 글자도 수정하지 않고 수집해 둔 파일

킥오프 전 내 판단 기록

쟁점 판단을 먼저 적어 두면 에이전트의 쟁점 표를 대조할 기준이 생김

  • 먼저 메모장 등으로 입력/내_판단.md를 만들고 내가 선정한 쟁점과 이유를 한 줄씩 적어 저장
칸내가 적을 것예: 자전거법 일부개정안 2117808
핵심 쟁점가장 먼저 볼 쟁점과 이유집행 가능성: 등록 주체가 누구인지, 등록 업무를 실제로 수행할 수 있을지 확인하고 싶다
결론 방향긍정 · 신중 · 판단 보류신중: 등록 기반 확인 필요
꼭 볼 조문대조할 현행 조문자전거등 정의 · 등록 근거 조문
반론 요청에이전트에게 받을 것내 판단과 다른 쟁점은 근거와 함께
내 판단은 입력/내_판단.md에 있으니 다른 곳은 근거와 함께 표시해줘
  • 위 문장은 해보기 ⑧ 요청문에 포함 · 저장 뒤 전송 · 쟁점 표를 본 뒤 판단을 변경하면 변경 이유를 한 줄 기록

★ 해보기 ⑧ 위임 요청문으로 작성팀 킥오프

요청문을 보내면 검토설계자가 쟁점 표를 제시하고 대기함

입력/의 의안번호 2117808로 행정안전위원회 검토보고서 초안을 교육용으로 써줘. 쟁점은 최대 2개로 하고 실제 검토보고서는 열지 마. 내 판단은 입력/내_판단.md에 있으니 다른 곳은 근거와 함께 표시해줘.
  • 발동 — "교육용으로"가 교육용 실행을 부름 · 쟁점은 최대 2개
칸작성법
의안번호기본 2117808 · 담당 분야는 조건을 맞춘 법률안
위원회기본 행정안전위원회 · 담당 분야는 소관 위원회
내 판단입력/내_판단.md · 쟁점 표와 대조할 기준
내 업무 적용예결산 · 조사: 사업설명서로 분석 메모 초안 / 의사 · 행정 · 홍보: 회의 자료로 보고 문서 초안

★ 쟁점 표 수정 후 승인

먼저 적은 내 판단과 대조해 누락된 쟁점을 추가하고 순서를 조정해 승인

그냥 승인하면

  • 관문이 있으나 마나가 됨
  • 초안을 다 받은 뒤에 수정하게 됨

수정해 승인하면

  • 한 문장으로 검토의 방향이 바뀜
  • 변경 이유가 00_요청.md에 그대로 남음
① 쟁점 표를 받으면
쟁점은 최대 2개로 유지하고 집행 가능성을 먼저 보도록 고친 표를 보여줘
② 고친 표를 본 뒤
이 쟁점과 순서로 조사해줘

도는 동안: 파일 이름으로 진행 확인

작성 중에는 파일 이름으로 진행 단계를 확인 · 03_근거장부가 생기면 근거 한 줄의 출처와 기준일을 확인

03근거장부.md근거 · 출처
→
03b조문원장/기준일 원문
→
04검토보고서.md초안 · 대비표
→
04c조문대조.md검문소 출력
→
05검수판정.md관문② 판정서

03_근거장부.md에서 볼 것

  • 근거 한 줄마다 출처 · 기준일 · 조회일
  • 〔원문〕 · 〔요약〕 · 〔부처 주장〕 표시
  • 끝의 미확보 목록과 받을 것 목록

03b_조문원장/에서 볼 것

  • 파일 이름 = 법령명@기준일
  • 기준일 판과 오늘 판이 별도로 있음
  • 도구 응답 그대로 · 누구도 수정하지 않음

관문② 판정서 읽기: 초안 검수

읽기 전용 검수관은 수정하지 않고 위치 · 문제 · 권고로 지적만

관문① 설계 판정조사 시작 전요청 · 기준 시점 · 착안점 · 원장 목록02_설계판정 · [필수] 하나면 NO-GO · 설계로 되돌림조사 · 집필조문 대조관문② 초안 검수집필 · 조문 대조 뒤쟁점 · 근거 · 조문 · 표시 · 중립성 · 형식05_검수판정 · 결론을 받치는 조문은 직접 다시 조회
05_검수판정.md · [필수] 지적(강의용 예시)첫 줄: 판정과 지적 건수 · 마지막: 쟁점 · 근거 · 조문 등 검토 항목별 결과① 위치쟁점2 검토의견의 표 밖 문장어디를 열어 볼지② 문제‘안 제22조는 등록을 의무로 정함’: 임의 등록을 의무로 바꿔 요약무엇이 틀렸는지③ 권고의안원문 문구대로 수정(‘등록할 수 있으며’)어떻게 고칠지
등급뜻예
[필수]그대로 두면 틀린 보고서가 나감원장에 없는 조문 · 부처 주장을 사실로 단정
[권고]수정하면 개선됨어조 한 단계 · 표현 · 단락 순서

조문 대조 검문소: 불일치하면 산출 보류

인용 조문과 대비표를 기준일에 다시 조회한 원문과 코드로 맞춤

04_검토보고서.md 인용 조문 · 신구조문대비표 03b_조문원장/ 기준일에 받은 조문 원문 의안원문 개정안 칸의 글자 article_check.py 조문 대조 검문소 · 사람도 AI도 아닌 코드 출력 전문 → 04c_조문대조.md 종료코드 0 · 통과 관문②로 종료코드 1 · 불일치 수정해 재실행 · 2회 뒤에도 남으면 보류 종료코드 2 · 실행 오류 파일 · 원장 형식을 수정해 다시
  • 인용 조문이나 대비표가 원문과 다르면 작성팀은 다음 단계로 진행하지 않음 · 원문을 다시 조회해 수정한 뒤 재검사
  • 확인은 다시 조회해서 · 기억으로 쓴 조문이 아니라 원장 글자와 맞춤
  • 같은 모델의 재확인은 같은 착각을 되풀이할 수 있어 대조는 코드로

★ 해보기 ⑨ 인용 조문 대조

검문소가 남긴 확인 필요를 국가법령정보에서 직접 열어 하나씩 대조

조문 대조의 확인 필요 항목을 원장 원문과 나란히 표로 보여줘
판정뜻초안에서는
원문과 같음인용 · 요약이 기준일 원문과 맞음표시를 지우고 그대로 둠
원문과 다름글자 · 항 · 호 · 요약이 기준일 원문과 다름기준일 원문대로 수정하고 조문 대조 재실행
시점 차이기준일 판과 오늘 판이 다름기준일로 쓰고 시점 차이를 밝힘
확인 못 함원문을 열지 못함[확인 필요]로 남기고 더 볼 곳을 적음
기준일 원문과 다른 인용만 고쳐서 다시 대조해줘. 날짜가 달라 생긴 차이는 기준일을 적고, 원문을 못 본 항목은 [확인 필요]로 남겨줘

검토보고서 편집 양식: 번호 체계와 표기

기본 골격은 Ⅰ. 제안경위 → Ⅱ. 제안이유 및 주요내용 → Ⅲ. 검토의견

번호 체계

표기쓰임
표지▣ ○○○의원 대표발의(의안번호)
Ⅰ. Ⅱ. Ⅲ.장 · 제안경위부터 검토의견까지
1. 2.쟁점마다 하나
가. 나. 다.개정안의 내용 · 검토의견 · 부처 의견
□ ○ -단락 부호 · 문서 안에서 통일

표기 규율

  • 법령명은 「 」 · 첫 등장에 약칭을 정함
  • 조문은 붙여 씀: 제2조제19호의2
  • 날짜는 2022. 10. 14. 꼴
  • 표 위 < 제목 > · (단위: ) · 표 아래 자료:
  • 위원회마다 골격이 다름 · 서식 견본이 필요하면 같은 위원회의 다른 공개 안건 보고서를 사용
  • 실습 대상 의안의 실제 검토보고서는 초안을 저장한 뒤 비교용으로 열기

한글 문서의 표 읽기: kordoc 없이 · kordoc으로

글자만 추출하면 병합 머리글이 덮는 범위가 사라져 묶음 합계에서 오답

① 원본 표
에너지 · 화학
석유제품석유화학이차전지
69.240.07.4

합계 116.6억 달러

석유제품부터 이차전지까지 한 머리글 아래

② kordoc 없이: 글자만 추출
…
에너지·화학
소재·기계
…
석유제품
석유화학
이차전지
…

109.2억 달러

묶음 범위가 없어 이차전지를 제외

③ kordoc으로 읽기
에너지 · 화학 (3칸 병합)
석유제품석유화학이차전지
69.240.07.4

116.6억 달러

병합 구조가 유지돼 원본과 같음

  • 칸 순서로 답이 나오는 질문은 양쪽 모두 정답 · 병합 범위가 필요한 질문에서만 갈림
  • kordoc: 한글(HWP · HWPX) · PDF의 본문과 표 구조를 읽고 쓰는 공개 도구(MCP)

자료: 산업통상부 보도자료 「2026년 10월 수출입 동향」(2026. 11. 1., .hwpx) 6쪽 품목별 수출액 표를 방법별로 읽은 결과(2026. 11. 11.)

★ 해보기 ⑩ kordoc으로 한글 문서 연결

저장소의 README대로 설치시키고, 확인은 의안원문의 대비표를 실제로 읽혀 보는 것 MIT

github.com/chrisryugj/kordoc 저장소의 README대로 설치해줘. Node.js가 없으면 설치하기 전에 먼저 알려줘.
입력 폴더의 자전거법 의안원문을 kordoc으로 읽어서 신구조문대비표를 표 그대로 정리해줘
단계무엇이 일어나나오류가 나면
준비Node.js(도구 실행 환경) 20 이상 필요nodejs.org에서 LTS 설치 뒤 재시작
설치kordoc이 MCP로 추가됨 · 새 대화에서 다음 요청설정 화면의 플러그인에서 직접 추가
확인도구 목록에 kordoc · 대비표를 PDF와 대조새 대화를 열거나 앱 재시작
  • PDF에서 같은 행을 열어 현행 칸과 개정안 칸이 뒤바뀌거나 합쳐지지 않았는지 확인
  • 읽힐 파일은 공개 자료만 · 구형 .hwp는 표가 뭉개질 수 있어 원본과 대조

★ 해보기 ⑪ 한글 문서(.hwpx) 변환

관문②를 통과한 초안을 편집 양식의 한글 문서로

한글 문서로 변환해줘
변환가 보고원고와 문서에서 같아야 할 것
번호 부호Ⅰ. · 1. · 가. · □ · ○ 개수
대비표대비표마다 행 수 · (현행과 같음) · <신 설> 개수
표시[확인 필요] · 〔판단 필요〕 개수
남은 손작업표지 · 머리말 · 쪽번호는 한글에서
  • 확인 — 06_검토보고서.hwpx를 한글에서 열기 · 입력/의 원본은 그대로

실습 완료 기준

파일 생성에 더해 근거 대조와 수정 이유까지 남으면 실습 완료

산출물완료 기준
검토보고서 초안제안경위 · 주요내용 · 쟁점별 논거와 결론
조문 대조 결과기준일 명시 · 대비표 한 행을 직접 대조
한글 문서본문 · 표 행수 · 번호 · 확인 필요 표시 보존
남은 판단자료 부족 · 의견 조회 대상을 별도 기재
  • 다른 교육생에게 수정한 문장과 근거 한 곳을 설명
  • 확인하지 못한 내용은 표시를 남기고 검토 완료로 처리하지 않음

Ⅴ. 맞춤형 스킬 · 현업 적용

불편 문장에서 출발하는 기획

기획의 첫 문장은 "회부될 때마다 유사 법률안을 손으로 찾는다" 같은 불편 한 줄

솔루션을 문제로 착각한 문장누가, 언제, 무슨 일을 반복하는가
법률안 검토 AI 챗봇을 만든다회부될 때마다 유사 법률안과 지난 검토보고서를 손으로 찾는다
계류의안 알림 시스템을 도입한다소관 법률안이 회부됐는지 의안정보시스템을 수시로 열어 본다
입법례 검색 AI가 필요하다입법례를 찾을 때마다 법령명 · 조문제목으로 검색을 되풀이한다
부처 자료 검증을 자동화한다부처가 낸 국내외 사례를 원출처와 하나씩 맞춰 본다
내 업무 적용의사 · 행정: "회의 때마다 지난 자료에서 안건 · 결정 사항을 옮겨 적는다" / 홍보: "보도자료의 일정 · 수치를 자료와 하나씩 대조한다"

출처: 국회사무처 의정연수원(2024. 8.) 「법률안검토 표준교재」 38 · 45 · 49 · 50쪽

검토보고서 밖의 업무에 적용

업무마다 원문 자료원을 먼저 정하고, AI에게는 정리와 대조를 맡김

업무원문 자료원AI에게 시킬 일원문과 대조할 것
해외 입법례국회도서관 입법자료포털 · 법제처 세계법제정보센터번역 초안 · 국가별 비교표조문 번호 · 시행일 · shall/may
회의록국회회의록 시스템 · 열린국회정보쟁점별 발언 표발언자 · 일자 · 직접 인용
비용추계예산정책처 추계서 · 「국회법」 제79조의2산식 · 가정 요약 · 연도별 표금액은 원자료에서 계산 · 단위 · 합계 검산
요구자료요구 문안 · 부처 원자료요구 질문 목록 · 답 없는 질문 표시질문별 제출 자료 연결 · 수치 출처
예산정책처 비용추계 회답은 원칙적으로 비공개 · 넣기 전 공개 여부를 확인

출처: 입법자료포털 · 세계법제정보센터 · 국회회의록 · 국회예산정책처 법안비용추계 안내 · 「국회법」 제79조의2 · 조회 2026. 10. 26.

AI에게 맡길 일 선정

업무마다 확인이 쉬운가 · 틀리면 위험한가를 표시해 첫 대상 하나를 선택

확인 쉬움 어려움 틀려도 위험 낮음 틀리면 위험 높음 먼저 맡김 의안정보 조회 · 회의록 발언 표 자료 제출 현황 점검 맡기고 자동 대조 인용 조문 · 신구조문대비표 수정안 자료끼리 일치 확인 초안만 맡김 검토보고 요약자료 초안 입법례 조사 메모 내가 판단 · AI는 반론 쟁점 선정 · 검토 결론 수정의견
  • 같은 칸이면 자주 반복되고 크기가 작은 일부터 · 선정한 하나를 기획안의 개요에 적음

기획 전 준비: 반복 업무 하나와 기획 칸

사람에게 인수인계하듯 설명할 수 있어야 에이전트도 그 업무를 함

칸적을 것예시: 유사 법률안 찾기
① 업무 하나한 스킬 = 한 업무회부된 법률안의 유사 법률안 찾기
② 지금 방식누가 · 얼마나 자주 · 몇 시간회부될 때마다 입법조사관이 직접 검색
③ 입력'관련 자료' 대신 파일 이름입력/의 의안원문 PDF
④ 절차신입에게 인수인계하듯 순서대로제안이유 읽기 → 검색어 → 비교표
⑤ 출력표 양식 · 목차 · 종결 어미까지의안번호 · 제안자 · 처리 결과 표
⑥ 틀리면 안 될 것잘못되면 결과를 쓸 수 없는 조건 한 줄의안번호를 원문에서 찾을 수 없으면 표에 확정해 쓰지 않음
연결기획 프롬프트의 짝: ①②④ → 〈내 업무〉 · ③ → 〈입력 파일〉 · ⑤ → 〈결과〉 · ⑥ → 〈확인 기준〉

★ 해보기 ⑫ 기획안 작성하기

새 대화에 붙여 넣기 · 〈 〉 안은 맡길 일 선정 결과로 · 모호한 곳은 AI가 하나씩 물어 옴

나는 Claude Code로 〈내 업무〉를 돕는 AI 에이전트를 만들려고 해. 같이 기획안을 짜자. ⚠ 코드 구현은 하지 마. 이번 결과는 기획안.md 한 개야. 모호한 곳과 내 업무 노하우는 한 번에 하나씩 나에게 물어봐. 배경 · 내 업무: 〈내 업무〉(지금 방식 · 내가 하는 순서 ①→②→③ · 단계마다 보는 자료 · 판단 기준 · 자주 나는 실수를 듬뿍) · 입력: 〈입력 파일〉(파일 이름으로) · 산출: 〈결과〉(표 양식 · 파일 이름 · 잘된 예시) · 확인: 〈확인 기준〉(잘못되면 결과를 쓸 수 없는 조건 · 보안 · 비공개 자료 제약) · /명령어와 대시보드는 내 업무에 필요할 때만 제안해줘 기획안은 아래 9항목으로, 읽고 바로 만들 수 있게 써 줘 1 개요(한 줄 정의·대상·문제·성공 기준) 2 범위(첫 버전 포함/제외 · 뭘 뺄지와 이유는 네가 제안) 3 핵심 시나리오(입력→처리→출력을 구체 예시로) 4 예상 병목(항목별 문제/대응 방안) 5 구성요소 설계(CLAUDE.md 규칙 초안 · 스킬의 이름/역할/발동조건 · /명령어의 이름/하는 일/인자 · 서브에이전트의 역할/허용 도구 · 붙일 도구의 이름/용도/이유) 6 하네스 설계(폴더 구조 · 권한과 금지작업 · 피드백 루프 · 실패 처리 · 입력과 기대 결과를 적은 테스트 3개 이상) 7 워크플로우(전체 흐름 · 단계별 역할/입력 파일/출력 파일/도구 표 · 내 노하우는 "조건 → 행동" 규칙으로 · 사람이 확인할 지점) 8 산출물 형태(형식과 파일 이름 · 대시보드가 필요한 업무에만 포함) 9 구현 순서(단계별 체크리스트 · 단계마다 완료 기준) 다 되면 기획안.md 파일로 저장해줘.
예〈내 업무〉 회의록 인용 정리 · 〈입력 파일〉 공개 회의록 한 건 → 〈결과〉 직접인용 표 → 〈확인 기준〉 발언자와 원문 쪽 대조

작게 시작하는 법

입력 하나 · 출력 하나 · 검증 하나로 첫 동작

① 원본 복사원본 보존 · 되돌릴 수 있게② 복사본 3건으로 실행법률안 100건 돌리기 전에③ 결과 파일 대조기대 결과와 단계마다 확인기대 결과와일치하는가?대상 확대일치하면 그때예아니오 → 100건도 소용없음 · 복사본 3건으로 되돌림
이렇게 잡으면 실패이렇게 쪼개면 오늘 안에 됨
"법률안 검토를 자동화""의안원문 한 건의 쟁점 후보를 교재 쪽과 함께 표로"
"유사 법률안 조사를 자동화""실습 법률안 한 건의 유사 법률안을 의안번호 · 처리 결과 표로"
"조문 대조를 자동화""초안이 인용한 조문 10개를 조문 원장과 대조해 표로"
대상 하나 · 건수 몇 건 · 산출 표 하나로 시작하고 되면 그때 늘림

기획안.md가 나오면: 플랜 모드로 구현 시작

요청은 한 줄, 만들기 전에 플랜 모드로 계획부터 받아 보기

기획안.md 읽고 구현 시작해줘
플랜 모드일어나는 일내가 할 일
켜기보내기 버튼 옆 모드 선택에서 Plan요청을 보내기 전에 먼저 고름
계획파일을 읽고 조사만 · 수정하지 않고 단계별 계획을 내놓음기획안의 구현 순서와 맞는지 읽음
승인승인하면 플랜 모드가 끝나고 만들기 시작수정할 곳이 있으면 승인하지 않고 말로 되돌림
요청문이 짧은 이유: 규칙 · 단계 · 검증이 이미 기획안 안에 있음

출처: Claude Code 문서 — permission modes(2026. 10. 2 확인)

에이전트 = 업무기술서 한 장

bill-review 플러그인 안에 있는 것은 전부 사람이 읽는 파일

bill-review/ ├── agents/ ← 팀원의 업무기술서 │ bill-designer.md 검토설계자 │ bill-investigator.md 자료조사관 │ bill-writer.md 집필가 │ bill-reviewer.md 검수관 ← 먼저 열 파일 │ bill-exporter.md 변환가 ├── skills/ ← 절차서 │ 팀장 · 착안점 · 문체 · 조문 대조 · 자료원 · 관문 · 한글 변환 · 교육용 ├── examples/ ← 법률안 한 건을 돌린 예시 └── CLAUDE.template.md ← 업무지침 예시
  • 역할 · 절차 · 금지는 문장, 도구는 머리말
  • 팀장이 부를 때 이 파일대로 일함
  • 인수인계 문서 형식이 곧 에이전트 정의
  • 복사 · 수정 · 버전 관리가 되는 파일
  • 착안점 · 조문 규칙은 복제본에서 수정
먼저 열 파일agents/bill-reviewer.md · 수정 권한이 없는 검수관

팀원 파일 실물: 머리말과 업무 원칙

머리말이 누구인지 · 언제 부르는지 · 어떤 AI 모델을 쓰는지에 더해 무엇을 쓸 수 있는지까지 정함

# agents/bill-reviewer.md — 작성팀 실물 발췌 --- name: bill-reviewer ① 부를 때 쓰는 이름 description: "법률안 검토보고서 팀의 검수관(읽기 전용). 관문①: 검토설계(01)를 요청 원문(00)·의안원문·착안점과 대조해 GO/NO-GO를 판정한다. … tools: Read, Grep, Glob, WebFetch, WebSearch, mcp__…korean-law__get_law_text … ② Write · Edit · Bash 없음 model: inherit ③ model은 사용할 AI 모델 · inherit은 팀장과 같은 모델 사용 --- # 검수관 — 고치지 않고 판정만 하는 사람 당신의 도구 목록에는 Write·Edit·Bash가 없다. 부탁이 아니라 구조로, 당신은 지적만 할 수 있다. ④ 본문도 같은 말 대신 법령 조회 도구는 있다 — **확인은 다시 조회해서 하는 것**이다. - 모든 지적은 **위치 · 문제 · 권고** 세 칸을 갖춘다. "약하다" 같은 말만 남기지 않는다 - **자기보고를 믿지 않는다.** 집필가가 "검문 통과"라고 했어도 `04c`를 직접 읽는다

업무 쪼개기: 검토 공정을 역할로

묻는다이 일의 답답이 정하는 것질문 ① 무엇이 반복되나매번 똑같이 하는 단계는?의안원문 읽기 · 신구조문대비표유사 법률안 검색 · 착안점 대조팀원의 업무질문 ② 근거는 어디서 오나입력 자료는 어디서 오는가?국가법령정보 · 의안정보시스템입법례 · 판례 · 부처 의견도구와 자료원질문 ③ 무엇이 틀리면 안 되나틀리면 결론이 달라지는 내용은 무엇인가?자동으로 대조할 표기는 무엇인가?결론이 달라지는 내용: 등록 의무 여부자동 대조 표기: 법령명 낫표검문소와 관문

역할 분리: 수집하는 자와 대조하는 자

검수관이 대조하는 자료는 초안의 인용과 근거 장부 · 조문 원장

팀장 — 말을 거는 유일한 창구 일을 나누고 · 결과를 취합하고 · 관문에서 멈춤 분할별로 동시에 출발 자료조사관 — 쟁점 ① 근거마다 출처 · 기준 시점 · 조회일 bill-investigator 자료조사관 — 쟁점 ② 못 찾은 것은 [확인 필요]로 bill-investigator 자료조사관 — 조문 원장 기준일 조문을 도구 응답 그대로 bill-investigator 검수관 — 초안을 쓴 적 없는 별도 자리 초안의 인용을 근거 장부 · 조문 원장 · 대조 결과와 대조 쓴 쪽이 스스로 통과시키지 못하게 하는 자리 검토보고서 통과한 것만 실림 사람의 역할 쟁점 승인 · 지적 판정
용어팀장 — 일을 배분하고 결과를 취합해 관문에서 멈추는 조율 스킬 · 컨텍스트 — AI가 지금 보고 있는 정보 전체 · 검수관은 집필 과정을 모르는 상태에서 시작

수정 권한을 나누는 권한 설계

만드는 쪽과 따지는 쪽을 나누고, 따지는 쪽에는 수정 권한을 주지 않음

작성팀 팀원머리말 tools 줄에 있는 도구쓰기(Write · Edit)
검토설계자읽기 · 검색 · 웹 · 명령 실행있음
자료조사관읽기 · 웹 · 법령 조회 · 한글 읽기 · 명령 실행있음
집필가읽기 · 검색 · 명령 실행있음
검수관읽기 · 검색 · 웹 · 법령 조회없음 · 명령 실행도 없음
변환가읽기 · 한글 문서 만들기 · 명령 실행Write만
  • 검수관은 집필 대화에 참여하지 않고 완성된 초안과 근거 자료를 새로 읽음
  • 검수관 권한: 원문 조회 가능 · 초안 수정 불가
  • 가장 싼 방법 — 새 대화를 열어 초안만 붙이고 "문제를 찾아줘"
용어서브에이전트 subagent — 자기 몫의 독립된 맥락과 권한을 갖는 보조 에이전트
사례영국 AI보안연구소(AISI) 평가: 122회 실행에서 실제 인터넷 대상 무단 행동 19건 → 인터넷 차단 · 실시간 감시로 변경 · AISI(2026. 8. 4.) · AISI(2026. 10. 1.)

★ 해보기 ⑬ 나만의 에이전트/도구 만들기

기획안의 팀원대로 · 없으면 수집하는 쪽과 따지는 쪽 예시 둘로

.claude/agents/에 서브에이전트를 만들어줘. 기획안.md에 정한 팀원이 있으면 그대로, 없으면 아래 둘로. ① 유사 법률안 조사관 — 의안원문의 제안이유로 취지가 같은 법률안과 그 검토보고서를 열린국회정보 · 의안정보시스템에서 찾아 의안번호 · 처리 결과 · 출처를 산출/조사노트.md에 쓴다. 도구: 웹검색, 웹읽기, 파일 읽기, 파일 쓰기. ② 조문 검사관 — 조사노트의 의안번호 · 법령명 · 인용 조문을 원문과 대조하고 지적만 한다. 고치지 않는다. 도구: 파일 읽기, 웹읽기, 법령 조회만. tools에는 조회 도구만 명시하고 Write·Edit·Bash·PowerShell은 주지 마.
의사 · 행정 · 홍보 직무
.claude/agents/에 서브에이전트 둘을 만들어줘. 회의록 정리 담당은 입력/의 공개 회의록에서 발언자 · 발언일 · 직접인용을 표로 산출/인용표.md에 저장하고, 인용 검사관은 그 표를 회의록 원문과 대조해 지적만 한다. 인용 검사관 tools에는 읽기 도구만 명시하고 Write·Edit·Bash·PowerShell은 주지 마. 회의록 정리 담당 도구: 파일 읽기, 파일 쓰기.
  • 공개 회의록: 국회회의록 시스템에서 한 건 내려받아 입력/에 저장
  • 완료 기준: agents/에 파일 · 검사관 tools 줄에 명시적 tools 목록 · 쓰기와 명령 실행 없음

보안 · 비용 · 책임은 작성자의 몫

검토보고는 회의에서 보고되어 회의록에 남고, 그 판단의 책임은 작성자에게

① 보안 · 반입 기준

공개 의안 · 공개 검토보고서 · 법령만 넣고, 미공개 법률안 초안 · 의원실 내부자료 · 개인정보는 넣지 않음

② 비용 · 구독

구독료와 사용량 한도 · 팀원 여럿이 함께 도는 팀 실행은 채팅보다 한도를 빨리 씀

③ 책임 · 회의록

속기로 작성한 회의록은 삭제할 수 없고 자구 정정도 발언 취지를 바꾸지 못함

④ 검증 의무

AI 초안이 인용한 조문 · 판례 · 입법례는 담당자가 원문을 열어 번호 · 문구 · 기준일을 확인한 뒤 사용

출처: 「국회법」 제117조(시행 2026. 10. 2.)

작게 만들고 실행해 보고 검증하며 확장하기

① 시험공개 법률안 한 건
→
② 원문과 대조다른 검수 역할
→
③ 지침에 기록반복 오류
→
④ 재시험새 법률안
1
자연어로 말하듯 — "코드 짜줘" 대신 "이런 일을 하고 싶어" · 목적 · 제약 · 기대 결과를 문장으로
2
한 번에 완성하지 말고 반복으로 — 첫 결과물은 초안 · 대화를 이어가며 조각내 개선
3
작은 샘플로 먼저 검증 — 법률안 100건 돌리기 전에 3건부터 · 예상대로 되는지 보고 확장
4
검증은 필수, 환각은 상수 — 조문 · 인용 · 의안번호는 원문 재확인
5
민감정보는 처음부터 분리 — 개인정보 · 미공개 초안 · 의원실 자료 제외, 인증키는 안내된 설정란 · .env에
용어바이브 코딩 vibe coding — 코드를 직접 쓰지 않고 자연어 대화로 결과물을 만드는 방식 · 위 수칙이 그 안전 수칙

무엇을 맡기고 무엇을 남기나

막대가 길수록 내 검토가 꼭 필요한 일 · 확인이 쉽고 자주 하는 일부터 맡김

AI에 맡기고 원문 대조로 확인AI 초안 · 사람이 확인하고 수정사람이 판단 · AI는 근거 정리
의안원문 · 의안정보 조회조회한 주소를 열어 대조인용 조문 · 수치 대조글자 대조는 코드로현행 조문 · 시행일 확인기준일 · 시행일 표시 확인신구조문대비표 작성칸 · 표기를 원문과 대조유사 법률안 · 입법례 조사범위 · 누락을 확인수정의견 문안 작성문안 확정은 사람검토할 쟁점 선정내 판단을 먼저 적고 대조검토의견 결론 작성결론 유형은 사람이 선택
막대는 측정값이 아니라 판단 기준: 확인이 쉬운가 · 틀리면 위험한가 · 자주 하는가

만들기보다 판정: 오늘 만든 판정 장치

에이전트가 쓰는 양은 계속 늘고, 남는 일은 무엇이 맞는지 아는 것

위임 요청문

목표 · 판정 기준 · 금지를 적고, 내 판단을 먼저

점검 스킬 · 내_검토기준.md

내 업무의 기준을 질문으로 적어 매번 적용

조문 대조 검문소

글자 대조는 코드로, 불일치하면 산출 보류

법령 원문 조회

조문은 기억이 아니라 기준일 원문으로(korean-law)

제대로 따라왔는지는 내가 수정한 문장과 그 판단의 근거가 된 원문 한 곳을 설명해 보이면 됨

출처: Anthropic(2026. 10. 16.) · Osmani(2026. 10. 14.) “Agentic Verification”

마무리하며,

오늘 만든 업무지침과 점검 스킬로 담당 업무의 공개 자료 한 건부터 다시 실행

①
Claude 앱에서 기획담당 업무의 반복 업무 하나 · 범위 · 산출물 · 절차
②
Claude Code 설치새 PC에서 시작할 때만 · 로그인 · 도구 연결 확인
③
작은 첫 동작위임 요청문 한 장 · 공개 자료로
④
CLAUDE.md에 규칙 적기잘 된 지시 · 절차를 파일로
⑤
스킬로 정리 · MCP 연결반복 절차는 스킬로, 자료가 필요하면 그때 연결

재실행

새 작업 폴더에 업무지침 · 점검 스킬 복사 후 공개 법률안 · 회의록 한 건으로 실행

확산 경로

개인 학습부서 공유기관 절차
보관오늘의 산출물(업무지침 · 점검 스킬 · 기획안 · 팀원 파일)은 ④ · ⑤단계의 출발점

질의응답 · 연락처

질문 · 의견 · 함께 고도화할 아이디어 — 언제든 연락

박주이 · 한양대학교 과학기술정책연구소 연구교수

공개 저장소

  • AI-Assembly — 법률안 검토보고서 작성팀
  • kordoc · korean-law — 한글 문서 · 법령
  • deident — 문서 비식별 전처리
  • 더 보기 — 보고서 · 논문 · 강의자료 도구

[참고] 더 알아보기

[참고] 각국 의회의 AI 논의 동향

의회의 88%가 AI 사용을 보고(예비 집계) · 회의에서는 미분류 자료와 담당 인력 문제가 제기됨

우려

  • 환각 · 편향 · 오래된 정보(미 의회조사국 증언)
  • 승인 없는 개별 사용
  • 작업 초안 · 이메일 등 미분류 자료
  • 상용 모델 중단과 의존
  • 신규 직원의 업무 지식 전수
  • 에이전트의 인젝션 · 도구 오남용 · 유출

집중

  • 직원 지원 업무
  • 금지보다 공식 도구 제공
  • 작은 자료부터 관리
  • 역할별 담당 지정
  • 에이전트 도입 전 절차 재설계 · 사람 개입 통제 · 독립 감독
용어프롬프트 인젝션 prompt injection — 문서 · 웹페이지에 숨긴 지시문으로 AI의 행동을 바꾸는 공격

출처: IPU(2026. 7. 1.) 세계 e-의회 보고서 예비 집계 · 데이터과학 허브 회의 · Bromo 외(2026) Parliamentary Affairs · FedScoop(2026. 6. 25.)

[참고] 각국 의회의 AI 사용 규정 사례

브라질은 작성자 책임, 의회예산국은 분석관 검토, 국제의회연맹은 담당 직위를 적음

기관규정근거
브라질 하원생성형 AI 사용자는 만든 문서에 책임 · 공개 전 검토Portaria nº 227 제14조
사람 검토 없는 자동 결정은 피함 · 사람 결정 우선제14조 단일항 · 제4조
미국 의회예산국프로그래밍에 쓴 AI 산출물은 모두 분석관이 검토국장 서한(2025. 5. 12.)
AI는 분석관의 전문성과 판단을 대신하지 못함같은 서한
국제의회연맹기준을 못 지키는 AI를 운영에서 제외할 권한을 가진 직위 지정의회 AI 지침(2024. 12.)
“Os usuários de sistemas de IA generativa são responsáveis pelos documentos que criarem e publicarem”생성형 AI 사용자는 자신이 만들고 공개한 문서에 책임을 진다 — 브라질 하원 Portaria nº 227 제14조

출처: 브라질 하원(2025. 12. 23.) · CBO 국장 서한 · IPU 의회 AI 지침

[참고] 각국 의회의 AI 활용 사례

현행법 대비본 · 수정안 작성 · 입법 자료 조회처럼 검토보고서와 관련된 업무부터 적용

미국 하원 사무처 Comparative Print Suite 개정 지시를 현행법에 적용한 대비본 생성 2020년부터 운영 이탈리아 하원 NORMA · MSE 수정안 작성 보조(시제품) 수정안 · 심의 경과 자료 조회 2025. 7. 시제품 브라질 하원 Ulysses 의원 요청 분야별 배분 입법 문서 주제 분류 2019년 보도 대한민국 국회 AI 의정지원 플랫폼 제안이유 기준 유사 법률안 출처 · 원문을 함께 보인 답변 2026. 4. 7. 개통
  • 브라질 하원(2025. 12.): 직원의 Claude · Gemini · GPT 사용을 열고 위원회 배분 · 위헌 소지 탐지 도구 연결 발표

출처: 미국 하원 사무처 AI Use Case Inventory · 이탈리아 하원(2025. 7.) · 브라질 하원(2019. 8. · 2025. 12.) · 국회사무처(2026. 4. 7.)

[참고] 국내 공공 AI 사례

국회는 출처와 원문을 함께 제시하고, 법제처는 답변을 중간 검토 자료로 한정

국회AI의정지원플랫폼(2026. 4. 7. 개통)

AI 어시스턴트 · 지능형 검색 · 법률안 서비스

답변에 참조한 자료의 출처와 원문을 함께 제공

국회 데이터센터 안에 시스템을 설치해 운영

법제처 AI 법령 비서(2026. 7. 14. 시범)

판례 6만 건 · 법령 · 행정규칙 24만 건 기반 답변

AI 답변은 최종 법적 판단이 아니므로 중간 검토 자료로만 활용

전 공무원 대상 · 온AI 실험실

플랫폼이 찾기 · 요약 · 초안을 맡으면, 남는 일은 검증 관문과 책임 표시

출처: 국회사무처 보도자료(2026. 4. 7.) · 법제처 보도자료(2026. 7. 13.)

Claude Code 기본 조작

할 일은 말로, 파일은 @로, 바뀔 내용은 권한 창에서 읽고 허용

@의안원문_2117808.pdf 주요내용을 표로 정리해줘 무엇을 시킬지 여기에 적고 Enter + 정지 Manual Accept edits Plan Auto 입력창 아래 모드 선택 권한 확인 창 대상: 바탕화면/법률안실습/… 바뀔 내용(diff)을 보여 줌 수락 거부 1 2 3 4 5
조작방법
① 입력할 일을 말로 적고 Enter
② 파일 넣기@ 뒤에 입력/에서 파일 선택(해보기 ②에서 저장) · + 버튼 · 입력창에 끌어 놓기
③ 권한 허용대상 경로와 바뀔 내용을 읽고 수락 · 법률안실습 밖이면 거부
④ 멈추기정지 버튼 · Esc · 멈추지 않고 수정할 내용을 적어 Enter
⑤ 플랜 모드모드 선택에서 Plan: 파일을 수정하지 않고 계획만 받아 승인

출처: Claude Code 문서 — Desktop(2026. 10. 20. 확인)

체크아웃: 폴더에 있어야 할 것

에이전트의 말이 아니라 직접 열어 본 파일만 누르기

★ 더 해보기 금지 줄 더하고 다시 돌려 비교

같은 자료 · 같은 요청에서 달라진 것은 파일 한 줄뿐

먼저 지금까지의 점검 결과를 산출/수정전_결과.md로 보관해줘. 그다음 내가 만든 점검 스킬의 금지 줄에 "조문은 의안원문에서 그대로 인용하고, 원문에 없는 조문 번호나 내용을 만들어 넣지 않는다."를 추가하고, 입력/ 폴더의 같은 의안원문으로 다시 점검한 결과를 산출/수정후_결과.md로 저장해줘. 마지막으로 두 파일에서 무엇이 달라졌는지 표로 비교해줘.
비교할 것수정 전과 후에서 볼 곳
인용 방식조문을 요약하지 않고 의안원문 문구 그대로 옮겼는가
조문 번호의안원문에 있는 번호만 썼는가 · 표기는 붙여 썼는가(제2조제19호의2)
새 내용원문에 없는 경과조치 · 적용례를 새로 만들어 넣지 않았는가
  • 먼저 이전 결과를 수정 전 파일로 보관 · 같은 입력으로 다시 점검한 결과를 새 파일로 저장해 두 결과를 비교
  • 따옴표 안을 내 금지 줄로 변경해도 됨

★ 더 해보기 스킬 가져오기: 교정교열 설치 · 적용

스킬은 주소를 주고 말로 설치 · 어디서나 쓸 것은 전역, 이 폴더에서만 쓸 것은 프로젝트 폴더에

https://github.com/parkjui92/paper-proofread.git — 이 스킬을 글로벌과 프로젝트 폴더에 전부 설치해줘
아래 문단을 교정교열해줘. 동 개정안은 개인형 이동장치의 등록 근거를 신설 하려는 것으로 판단되어지며, 향후 관계부처와의 협의 결과를 면밀히 검토 해야 할 필요성이 있다고 사료되어진다. 정부는 등록 절차를 최소화 함으로서 이용자의 부담을 보다 더 경감 할수 있을것이다.
확인무엇이 보이면 되나안 보이면
설치skills/paper-proofread/에 SKILL.mdgit 오류면 Git 설치 뒤 앱 재시작
발동스킬 이름을 부르지 않아도 "교정교열"이라는 말에 불려 나옴새 대화를 열고 다시(스킬은 대화 시작 때 읽힘)
결과수정본과 교정교열표 · 수정한 자리마다 원문 · 수정 · 이유적용 스킬 이름 · 파일 경로 확인 후 교열표 요청

[참고] 에이전트가 먼저 맡는 역할: 자료 수집 · 대조

모자란 것은 늘 검토 시간과 자료이고, 에이전트의 첫 일은 판단보다 수집 · 대조

상임위 직원이 꼽은 문제 · 조사인력 부족 · 검토시간 부족 · 정부와의 자료 비대칭 · 정치적 중립성 · 객관성 · 담당자 전문성 전문위원이 입법조사관의 보좌를 받아 검토보고서를 만듦(서울신문 2014) 에이전트가 먼저 맡는 일 수집 현행 법령 · 유사 법률안 · 입법례 · 통계 03_근거장부 · 03b_조문원장/ 대조 인용 조문 ↔ 원장 · 대비표 ↔ 의안원문 04c_조문대조 형식 편집 양식 번호 · 대비표 표기 · 한글 문서 06_검토보고서.hwpx 사람이 맡는 것 · 쟁점 선정 · 승인 · 검토의견의 결론 · 수정의견 · 부처 의견 판단 처음 몇 건은 손으로 써 보고 에이전트의 초안과 대조
용어자료 비대칭 — 집행 자료는 정부가 보유하고 있어 상임위가 공개 자료만으로 확인하기 어려운 경우

출처: 배용근(2011) 『의정논총』 6(1) 초록만 대조 · 서울신문(2014. 5. 22.) 보도 · 조회 2026. 10. 20.

[참고] 에이전트를 이루는 모델 · 도구 · 기억 · 루프

모델은 판단만 하고, 기억 · 도구 · 루프 · 감독은 모델 바깥에 있음

에이전트 핵심 구조 · 이 테두리 전체가 작업 환경(하네스)
기억단기 — 대화 컨텍스트 (휘발)장기 — CLAUDE.md · 착안점 스킬
에이전틱 루프① 프롬프트 구성② 추론 · 계획 — 플랜 모드③ 실행 · 결과 처리 — 반복
다핵심 모델판단
라감독 · 평가승인 관문 — 사람이 판정검수 · 조문 대조기록 — 로그 · 이력
가나도구 (API · MCP)파일 · 검색 · 실행한글 문서 · 법령 · 의안정보스킬 · MCP 서버
사용자지시 · 승인 · 판정
외부 API · 서비스
산출물 파일
웹 · 데이터베이스
저장 · 조회 반복 호출 검증 · 개선 호출 지시 · 프롬프트 결과 · 기록

한 번 도는 예 · 가 원문 PDF 열기 → 나 제22조 찾기 → 다 찾은 문구 확인 → 라 인용문과 비교

[참고] 최근 에이전트 설계의 방향

부서마다 에이전트를 두기보다 에이전트 하나가 절차서(스킬)를 펼쳐 일하는 구조로 이동

조직도를 본뜬 구조

분류기 → 고정 단계 → 팀별 서브에이전트 → 총괄 에이전트

모델이 이제 스스로 하는 일을 구조가 대신하고 있었음

에이전트 하나 + 스킬

에이전트 하나가 계획 · 실행 · 절차는 스킬 · 승인 관문과 검증은 도구로

서브에이전트는 자료가 많아 앞의 근거를 놓치거나 여러 자료를 따로 조사할 때 분담

  • 한 기업 사례: 다중 에이전트 대신 단일 루프로 실행 시간 약 2배 단축
  • 스킬 형식은 리눅스재단 산하 재단에 기증 · 70개 넘는 에이전트 플랫폼이 채택
  • 이 실습의 작성팀은 팀장 스킬이 절차를 관리하고, 초안을 쓴 역할과 다시 확인하는 역할도 분리
  • 팀 구성도 모델이 함: 몇 문장으로 팀을 스케치하자 모델이 에이전트 13개를 띄움

출처: Anthropic(2026. 10. 22.) Building agents · Anthropic(2026. 10. 22.) Agent Skills 기증 · Mollick(2026. 10. 1.)

[참고] 에이전트 능력의 측정 방식 변화

가장 많이 인용되던 작업 시간 지평 측정은 갱신이 멈추고, 다른 잣대가 등장

잣대내용읽을 점
작업 시간 지평사람이 보통 몇 시간 걸리는 과제를 AI가 절반의 확률로 완료하는지 나타낸 값16시간 넘는 측정은 신뢰 불가(2026. 5.)
"더 이상 적극적으로 갱신하지 않음" 명시METR(2026. 9. 8.)
과제 맥락을 거의 모르는 사람 기준 · 예: 사람 기준 2시간짜리 과제에이전트의 자율 작업 시간이 아님
검증된 작업당 비용토큰 단가가 아니라 검증을 통과한 작업 1건당 총비용Google Cloud(2026. 11. 3.)
에이전트로 시작한 일코드 변경 요청(PR)의 40% 이상이 에이전트로 시작됨(2026. 9.)GitHub Octoverse(2026. 10. 28.)
  • "AI가 몇 시간짜리 일을 한다"는 숫자는 맥락이 많은 국회 업무에 그대로 옮기지 않음

출처: METR Time Horizons · Google(2026. 11. 3.) · GitHub Octoverse 2026

[참고] 검토보고서_최종_진짜최종.hwp

파일 이름으로는 무엇을 왜 바꿨는지 남지 않음

익숙한 폴더
검토보고서_초안.hwp
검토보고서_최종.hwp
검토보고서_최종_수정.hwp
검토보고서_최종_소위의견반영_v3.hwp
검토보고서_최종_진짜최종.hwp
검토보고서_최종_진짜최종_제출용.hwp
남는 것파일 여러 개와 날짜
안 남는 것어디를 바꿨는지
안 남는 것왜 바꿨는지
안 남는 것어느 판에서 나온 판인지
생각해 볼 것

네 번째 파일에서 무엇이 변경되었는지 지금 말할 수 있는가

[참고] Git 용어: 저장소 · 커밋 · diff

업무지침(.md)은 변경된 줄을 비교할 수 있고, 수정 이유는 저장할 때 작성자가 커밋 메시지에 기록

용어뜻익숙한 것으로 치면
저장소 repository버전이 관리되는 폴더 하나사진을 보관하는 앨범
커밋 commit지금 상태에 이유를 붙여 저장게임의 세이브 포인트
diff두 시점 사이에 변경된 줄만 추출한 것한글의 변경 내용 추적 · 빨간펜 교정
커밋 메시지작성자가 저장할 때 적는 수정 이유 한 줄개정 이력의 비고란
.gitignore기록하지 않을 파일 목록앨범에 넣지 않을 것의 목록
푸시 · 브랜치 push · branchGitHub로 올리기 · 원본을 두고 분기해 수정하기지금은 쓰지 않음
먼저 쓰는 것은 저장소 · 커밋 · diff까지

[참고] Git과 GitHub

Git은 내 컴퓨터의 기록 장치이고 GitHub는 그 기록을 올려 함께 보는 곳

Git — 내 컴퓨터의 기록

  • 혼자 쓰는 변경 이력
  • 저장 · 이력 · 되돌리기
  • 오늘 — 내 컴퓨터 안에서만

GitHub — 올려서 함께 보는 곳

  • 여럿이 주고받는 제안과 검토
  • 작성팀 bill-review도 여기서 받음
  • 부서 저장소로 착안점을 함께 고침
에이전트가 수정하는 초안 · 점검 스킬에도 기록하고 되돌리는 수단이 필요

[참고] 내 폴더를 저장소로

오늘 만든 법률안실습 폴더로 하고 올리기는 보류

이 폴더를 git 저장소로 만들어줘. 다음 규칙을 지켜줘. ① 폴더 안을 훑고 무엇을 추적하고 무엇을 뺄지 표로 먼저 보여줘 ② .gitignore — _workspace/, 원본(.hwp .hwpx .docx .pdf), .env는 제외하고 내가 만든 .md는 추적 ③ 첫 커밋 메시지는 "무엇이 든 폴더인지" 한 줄 — 6개월 뒤의 내가 읽을 문장으로 ④ 끝나면 추적/제외 파일 수를 알려줘. 아직 push는 하지 마 — 내가 확인하고 결정할게
확인무엇이 보이면 되나오류가 나면
보고추적 · 제외 표가 먼저 오고 _workspace/ · .env가 제외 쪽.env가 추적 쪽이면 중단하고 수정하게 함
커밋커밋 한 줄이 남음 · 아직 아무것도 공개되지 않음처음 기록 때 이름 · 이메일 입력(커밋 작성자 정보)

[참고] 올리기 전: 적대적 보안검토

올리기(push)는 되돌리기 어려워 공개된 순간 이미 복제됐다고 가정

이 저장소를 GitHub에 올리기 전에 적대적 보안검토를 해줘. 나를 안심시키지 말고, 공격자 입장에서 찾아줘. 범위는 내 PC에 있는 이 저장소의 추적 파일과 기존 커밋까지로 하고, 외부로 보내지 마. ① 추적 파일 전체에서 — API 키·비밀번호 · 개인정보 · 미공개 법률안 초안 · 의원실 자료 · 내부 경로 ② git 이력(예전 커밋)에도 남아 있는지 — 지금 없어도 예전 커밋에 있으면 노출된다 ③ 위험도 순 표로, 파일 위치 · 정보 종류 · 처리 방법(삭제/재발급/.gitignore)만 적어줘. 비밀값 원문은 채팅 · 화면 · 파일에 출력하지 말고 ****로 가려서 표시해. 고칠지는 내가 정한다. 아직 아무것도 바꾸지 마.
  • 왜 "적대적"인가 — "문제 없나 봐줘"라고 물으면 안심시키는 쪽으로 답하므로 역할을 못 박아야 실제로 찾음
  • 통과해도 비공개 저장소로 · 공개 여부와 자료 반입은 보안 담당과 정한 뒤
미공개 자료 · 개인정보 · 인증키는 한 번 올라가면 지워도 이력에 남음

[참고] 막혔을 때: 자주 나는 오류와 처방

로그인 · 긴 대화 · 플러그인 설치 · 법령 도구 · 스킬 발동에서 주로 오류가 남

증상원인처방
로그인이 안 됨계정 · 플랜 · 망 차단사전 안내의 계정으로 · 손 들고 보조강사 호출
답이 점점 이상해짐대화가 길어져 컨텍스트가 참새 대화를 염 · 중요한 것은 파일에 적고 시작
같은 실수를 반복함규칙이 대화에만 있고 파일에 없음CLAUDE.md에 한 줄 추가
조문이 그럴듯한데 못 믿겠음법령 도구 없이 기억으로 씀"법령 원문을 조회해 붙여줘" · [확인 필요]로 남기게
플러그인 설치가 안 됨git 오류 메시지 · 망 차단git-scm.com에서 Git 설치 후 앱 재시작 · 설정 화면으로 다시
스킬이 안 불려 나옴만든 뒤 같은 대화를 계속 씀새 대화를 열고 발동 조건의 말로 다시 요청
공통 처방: 오류 화면에서 키 · 개인정보 · 내부 경로를 가린 뒤, 어느 단계에서 무엇을 했고 어떤 오류가 났는지 보조강사에게 보여 주거나 질문

목차 — 클릭하면 이동 (O 로 닫기)

← → Space 이동
O 목차
T 밝게/어둡게 · F 전체화면
숫자+Enter 해당 장으로
? 이 도움말 닫기