내 원고를 점검하는 proof

글을 쓴 뒤에도 남는 일

원고를 다 썼어도 참고문헌의 연도, 표의 합계, 본문과 표의 숫자, 약어의 통일, 보고 지침의 누락을 확인해야 합니다. proof는 이 일을 연구자의 원고 폴더 안에서 수행하도록 만든 플러그인입니다. 이 코스의 운영자가 개발하고 있습니다.

주장과 해석, 원고의 문장은 저자가 씁니다. proof는 점검 보고서와 기계적인 표현 수정 제안을 남깁니다. 이 레슨은 논문 자동 작성법이 아니라, 저자의 원고를 에이전트와 함께 확인하는 작업대를 준비하는 과정입니다.

Claude Code, Codex, proof는 각각 무엇인가요

Claude Code와 Codex는 모델을 불러 파일을 읽고 도구를 실행하는 에이전트입니다. proof는 그 안에서 사용할 점검 절차와 실행 프로그램을 묶은 플러그인입니다. proof만 내려받는다고 대화할 모델이 생기지는 않습니다.

이 실습의 기본 경로는 Claude Code입니다. 공식 시작 안내에서 운영체제에 맞게 설치하고 로그인합니다. 로그인 뒤 원고 폴더를 열어 작업합니다. 계정의 이용 조건과 비용은 공식 안내에서 확인하십시오.

Hermes도 폴더와 도구를 사용하는 에이전트이며 모듈 3–4에서 다뤘습니다. 다만 이 레슨에서는 proof를 Hermes에 설치하는 절차를 제공하지 않습니다. 같은 스킬 형식을 읽는 것과 플러그인 전체가 지원되는 것은 별개입니다.

1. proof 명령을 준비합니다

proof 저장소의 Code → Download ZIP으로 내려받아 압축을 풉니다. 풀린 폴더 이름은 proof-master일 수 있습니다. 이 레슨에서는 그 폴더를 ‘proof 폴더’라고 부릅니다. Git을 이미 사용하는 분은 git clone https://github.com/junhewk/proof.git으로 받아도 됩니다.

proof 폴더를 파일 탐색기로 엽니다. 폴더 안에 package.json, skills/, bin/, dist/가 있는지 확인하십시오. 터미널에서 그 폴더로 이동한 뒤 다음 명령을 한 줄씩 실행합니다. cd 뒤의 예시 경로는 실제 proof 폴더 경로로 바꿉니다. 공백이 있는 경로도 따옴표 안에 넣습니다.

cd "proof 폴더의 실제 경로"
node --version
npm link
proof --help

Node.js는 22 이상이 필요합니다. npm link는 이 컴퓨터에서 proof라는 이름으로 실행할 수 있게 등록합니다. 마지막 명령에 사용법이 나오면 준비된 것입니다. 이 명령들은 일반 터미널에 입력합니다. Claude Code의 대화창에 입력하는 요청과 구분하십시오.

dist/가 없는 개발용 소스를 받았다면 proof 폴더에서 npm install --include=dev와 npm run build를 순서대로 실행한 뒤 등록합니다. 완성된 배포 폴더에는 이 빌드 단계가 필요하지 않습니다.

막힌 곳	확인할 것
node 또는 npm을 찾지 못함	Node.js 설치를 확인하고 터미널을 새로 엽니다.
npm link 권한 오류	오류 메시지와 Node.js 설치 위치를 확인합니다. 무조건 관리자 권한으로 다시 실행하지 말고 막힌 곳 게시판에 메시지를 남깁니다.
proof를 찾지 못함	터미널을 다시 열고 확인합니다. 등록이 어려우면 node "proof 폴더의 실제 경로/bin/proof" --help로 실행 여부를 확인할 수 있습니다.
Claude에서 스킬이 안 보임	아래 --plugin-dir 경로가 skills/가 아니라 proof 폴더 자체를 가리키는지 확인합니다.

2. 예제 원고의 복사본을 엽니다

proof의 examples/demo-manuscript/ 폴더를 문서함에 복사하고 복사본 이름을 proof-practice로 바꿉니다. 다음 레슨들은 이 복사본에서 이어서 진행합니다. 원본 예제의 오류는 그대로 보관합니다.

일반 터미널에서 복사본 폴더로 이동합니다.

cd "proof-practice 폴더의 실제 경로"
proof init manuscript.md --guideline CONSORT --journal icmje
proof status
claude --plugin-dir "proof 폴더의 실제 경로"

proof init은 원고를 등록하고 .proof/ 설정 폴더를 만듭니다. 외부 참고문헌 조회는 기본적으로 꺼져 있습니다. --plugin-dir은 방금 복사한 실습 원고 폴더가 아니라 플러그인을 보관한 proof 폴더를 가리킵니다.

Claude Code가 시작되면 /help의 사용자 정의 명령에서 proof의 스킬을 확인합니다. 플러그인 스킬 이름은 /proof:references처럼 proof:가 앞에 붙습니다. 지금은 다음 요청으로 위치만 확인합니다.

현재 작업 폴더와 manuscript.md의 제목을 확인해 주세요.
원고는 수정하지 말고, 사용할 수 있는 proof 스킬 이름을 알려 주세요.
아직 점검이나 외부 조회는 실행하지 마세요.

첫 점검은 다음 모듈의 AI 사용 계획을 작성한 뒤 시작합니다.

원고와 제안은 다른 파일입니다

보고서는 일반 텍스트 편집기나 Obsidian에서 읽을 수 있습니다. .proof처럼 점으로 시작하는 폴더는 파일 탐색기에서 숨겨질 수 있습니다. 실행 기록은 나중에 proof log show로도 볼 수 있습니다.

Claude Code의 proof 훅은 등록된 원고에 대한 Write·Edit 등의 직접 편집 호출을 막습니다. 모든 경로의 쓰기를 차단하는 운영체제 수준의 보호는 아닙니다. Codex에서는 같은 원고 보호 규칙을 스킬 지시로 따르며 이 Claude Code 훅이 작동하지 않습니다. 어느 쪽이든 실습 복사본을 사용하고 실제 변경 내역을 확인합니다.

Codex를 이미 쓰고 계시다면

Codex CLI 안내에 따라 설치하고 로그인합니다. proof 명령 등록과 예제 초기화는 위와 같습니다. 현재 Codex 스킬 문서에 맞춰 proof의 skills/ 안에 있는 각 스킬 폴더를 사용자 홈의 .agents/skills/ 아래에 복사합니다. 예를 들면 .agents/skills/references/SKILL.md가 됩니다. 스킬 파일 하나만 복사하지 말고 스킬 폴더를 복사하십시오.

실습 원고 폴더에서 codex를 실행합니다. /skills로 목록을 열거나 요청에 $references처럼 스킬을 지정합니다. 표시되지 않으면 Codex를 다시 시작하고 확인합니다. CLI가 실제 점검을 수행하므로 proof --help도 실행되어야 합니다.

하려는 일	Claude Code 대화창	Codex 대화창
사용 범위 정하기	/proof:ai-use-plan	$ai-use-plan
참고문헌 확인	/proof:references	$references
표 확인	/proof:tables	$tables
기계적인 표현 점검	/proof:polish	$polish
보고 지침 대응	/proof:checklist CONSORT	$checklist CONSORT
준비 상태 확인	/proof:readiness	$readiness
사용 공개문 생성	/proof:disclose	$disclose

직접 해 보기약 20분

공개 저장소에서 proof를 내려받아 예제 복사본을 만들고 초기화한 뒤, 에이전트가 원고 제목을 제대로 읽는지 확인하십시오. 아직 설치하지 않은 분은 준비되지 않은 칸에 ‘설치 전’이라고 적으시면 됩니다.

확인 항목	결과	남은 일

1행

확인 항목

결과

남은 일

2행

확인 항목

결과

남은 일

3행

확인 항목

결과

남은 일

4행

확인 항목

결과

남은 일

복사하기내려받기지우기이 브라우저에만 저장됩니다. 서버로 보내지 않습니다.

작성란을 내려받아 보관합니다. 설치 문제를 나눌 때에는 필요한 오류 문구만 적고 계정 정보는 제외하십시오.

커뮤니티에 결과를 남겨 보세요

연구에 적용하면

준비가 끝났다는 기준은 원고 폴더, proof 명령, 에이전트의 스킬 목록을 각각 확인했다는 것입니다. 작업 지시와 AI 사용 계획에서 허용 범위를 먼저 기록하고 점검을 시작합니다.