Claude Code로 참고문헌 검증기 기획부터 프로토타입까지
2026.10.01

소개
AI가 제시한 참고문헌이 실제로 있는지, 그 논문이 인용된 주장을 정말 뒷받침하는지 한 번에 확인해 주는 웹 서비스 '참고문헌 검증기'를 기획했습니다. Claude Code와 gatekit 플러그인으로 문제 발굴, 기획서(PRD), 화면 명세, 아키텍처를 쓰고, 클릭해 볼 수 있는 프로토타입까지 하루 저녁에 만들었습니다.
보통 논문 요약은 직접 만든 Claude 스킬로 해결하고, 이렇게 만든 요약은 Obsidian에 저장하고, 논문 PDF는 Zotero와 Obsidian 폴더에 함께 두었습니다. 문제는 AI에게 추천받은 논문과 내용을 확인하는 데 있었습니다.
AI가 준 참고문헌을 Google Scholar, WoS, RISS에서 하나씩 검색해 실제로 있는지, 저자·연도·학술지가 맞는지 확인하는 데 많은 시간이 걸렸습니다.
여러 AI에게 같은 질문을 던져 교차 확인하기도 했습니다. 모든 AI가 똑같이 답한 것은 확인해 보니 맞았습니다.
더 위험한 경우도 있었습니다. 어떤 논문이 A를 길게 다루다가 결국 "A보다 B가 낫다"고 결론 냈는데, AI는 이 논문을 "A를 쓴 이유"의 근거로 제시했습니다. 참고문헌이 존재하는지뿐 아니라 그 내용이 인용한 주장과 맞는지도 확인하는 것이 중요하다는 걸 이때 알았습니다.
앞으로 생성형 AI를 더 많이 쓰게 될 텐데, 시간보다 품질이 걱정이었습니다. 심사위원 입장이라면 지어낸 참고문헌, 틀린 서지 정보, 주장과 맞지 않는 인용을 모두 지적할 수 있기 때문입니다. 그래서 이 확인 작업을 도구로 만들어 보기로 했습니다.
진행 방법
사용한 도구: Claude Code(터미널, WSL Ubuntu)와 gatekit 플러그인을 썼습니다. gatekit은 "무엇을 만들지"부터 "다 만들었는지"까지 단계를 나눠 주는 플러그인입니다. 단계마다 spec/ 폴더에 문서를 남기고, 완료 기준을 승인받기 전에는 코드 작성을 막습니다.
# Claude Code 안에서 플러그인 설치
/plugin marketplace add https://github.com/LovelyPaul/gatekit
/plugin install gatekit@gatekit
# 설치 점검 → 문제 발굴 → 기획 인터뷰 → 화면 명세 순서로 진행
/gatekit:doctor
/gatekit:discover
/gatekit:interview
/gatekit:mockup단계 | 한 일 | 만들어진 문서 |
|---|---|---|
1. 점검 |
| — |
2. 문제 발굴 | 불편 4가지를 꺼내고 그중 하나를 고름 |
|
3. 기획 인터뷰 | 기능 10개, 공개 범위, 비용 부담 방식 결정 |
|
4. 화면 명세 | Figma 템플릿 캡처로 분위기를 정하고 화면 상태 설계 |
|
5. 프로토타입 | 예시 데이터로 움직이는 HTML 한 장 |
|
1) 문제 발굴: 하고 싶은 것을 한 문장으로 던지기
처음 입력한 프롬프트는 이것 하나였습니다.
/gatekit:discover 논문 작성의 각 단계에서 실질적인 도움을 줄 수 있는 서비스를 만들어 보고 싶어.Claude가 객관식으로 질문하면 번호로 답하고, 필요할 때만 자세히 설명했습니다. 실제로 보낸 답 몇 가지입니다.
옵시디언에 요약본을 작성해두기도 했고, 논문 목록이나 pdf파일은 zotero에 저장해두기도 했어.
지금도 쓰고는 있지. 그런데 시간이 왜 중요해? 나는 quality가 중요할 것 같은데
참고문헌을 하나씩 Google Scholar, WoS나 RISS에 검색해서 실제로 있는지, 저자·연도·학술지가 맞는지 일일이 다 확인했었어
예를 들면, 논문에서 A얘기가 많이 나왔지만 결국 A보다는 B가 낫다는 결론이었는데 A를 사용한 이유에 대한 참고문헌으로 이 논문을 제시했었어. 참고문헌 자체가 있는지도 중요하고 그 내용이 맞는지도 중요해"시간이 왜 중요해? 나는 품질이 중요해"라고 되물은 답이 방향을 바꿨습니다. 그 뒤로 Claude는 "몇 분 줄이기"가 아니라 "심사위원에게 지적받을 오류 잡기"를 목표로 잡았습니다. 불편 후보 4개 중 참고문헌 존재·내용 검증을 골랐고, 나머지(선행연구 절 쓰기, 핵심 논문 고르기)는 다음 발굴로 미뤘습니다.
2) 기획 인터뷰: 범위와 일정 정하기
/gatekit:interview는 질문을 하나씩 던지고 결정한 내용을 PRD에 적어 갑니다. 제가 직접 범위를 바꾼 프롬프트입니다.
오늘 니가 에이전트는 만들어주는거고, 내가 직접 시연하는 시간이 4주라는 거지? 그럼 1주일
나도 사용하지만 다른 사람들에게도 공개하고 싶어. 1과 2 둘다 선택해도 돼?
본문에 인용이 있는데 목록에 없는 경우 니가 찾아주고 (존재 여부, 서지 정보, 주장 뒷받침)을 해줄수는 없나?
결과를 나는 옵시디언을 사용하지만 다른 사람들은 다른 걸 사용할 수 있을 것 같아. 그것도 반영할 수 있어?
KCI 키를 신청하려고 하는데 신청IP를 넣어야해. 그럼 내 IP를 넣으면 다른 사람은 못 사용하는 거 아니야?이렇게 정해진 기능은 10개입니다.
기능 | 내용 |
|---|---|
F1 | 본문 인용 (저자, 연도)·[1]과 참고문헌 목록 짝짓기 |
F2 | 존재 여부 확인 (Crossref·OpenAlex·KCI, DOI 대조) |
F3 | 서지 정보 대조 ("틀림"과 "표기 차이"를 구분) |
F4 | 주장 뒷받침 판단 (근거 문장 인용, 3번 판단이 일치할 때만 확정) |
F5 | PDF 올리기 (선택, 초록 대신 본문으로 판단) |
F6 | 목록에 없는 인용은 후보 논문을 찾아 제시 |
F7 | 사용자 본인 Claude API 키 설정 (브라우저에만 저장) |
F8 | 찾지 못하면 Google Scholar·RISS 링크 제공, 실패한 카드만 다시 시도 |
F9 | 결과 내려받기 (.md, .docx, .csv, .ris, .bib) |
F10 | 같은 확인을 Obsidian 노트에 바로 돌리는 Claude 스킬 |
3) 화면 명세: Figma 템플릿 캡처로 분위기 맞추기
처음에는 Figma 링크를 그대로 줬습니다. 하지만 Figma를 읽는 도구가 연결되어 있지 않아 Claude가 짐작해서 만들지 않겠다고 했고, 대신 화면 캡처를 붙여 넣었습니다. Figma Community 템플릿 두 개(Modern Product Launch, Money Transfers Made Simple)에서 흰 바탕, 세이지 초록 면, 짙은 올리브 버튼, 라임 강조색을 가져왔습니다.
https://www.figma.com/site/zR5HFJHhRmHWM54dCRpyYQ/Modern-Product-Launch--Community-?node-id=0-1 이건 어때? 이용할 수 있어?
니가 제시한 것처럼 글자체도 바꿔주고 색도 바꿔줘. 니 추천대로
제목도 둥근 글자로 바꿔줘4) 프로토타입: 예시 데이터로 상태를 모두 보여 주기
화면 명세의 상태(비어 있음, 로딩, 정상, 오류)를 버튼 하나로 바꿔 볼 수 있는 HTML 프로토타입이 나왔습니다. 실제 조회는 하지 않고, 존재하는 논문, 지어낸 논문, 반대 결론으로 인용된 논문이 섞인 예시 글로 동작합니다.




결과 카드 하나는 아래 같은 데이터로 그립니다. 프로토타입 코드에서 "반대 결론" 예시를 그대로 옮겼습니다.
{k:'bad', n:7,
ref:'Zhang, Y., Liu, M., & Zhao, Q. (2024). Automation and metacognition in AI-assisted learning. Educational Technology Research and Development, 72(2), 455–478.',
ex:['b-ok','있음'], diff:[['ok','저자·연도·학술지·제목 모두 일치']],
cite:'반면 과도한 자동화는 학습자의 메타인지 전략 사용을 감소시킨다(Zhang et al., 2024).',
sup:['b-bad','반대 결론임'], basis:'초록 기준 · 3번 판단 모두 일치',
quote:'“Contrary to concerns, students in the high-automation condition did not show reduced use of metacognitive strategies.”',
supNote:'논문은 자동화가 메타인지 전략 사용을 줄이지 않았다고 결론 내렸습니다.'}결과와 배운 점
하루 저녁 동안 설계 문서 5개와 클릭해 볼 수 있는 프로토타입 1개를 만들었습니다. 실제 조회를 하는 웹 서비스는 아직 없고, 1주일 동안 만들어 직접 써 보는 것이 목표입니다.
배운 점과 나만의 꿀팁을 알려주세요.
바로 만들지 말고 먼저 물어보게 하기. "논문 쓰기를 돕는 서비스"로 시작했는데, 질문에 답하다 보니 내 진짜 문제는 "참고문헌을 믿어도 되는가"로 좁혀졌습니다.
AI의 전제에 반박하기. Claude는 처음에 "시간 줄이기"를 기준으로 봤습니다. "나는 품질이 중요해"라고 한 줄 답한 뒤로 기능 우선순위가 바뀌었습니다.
구체적인 실패 사례를 하나 들기. "A보다 B가 낫다는 논문을 A의 근거로 제시했다"는 예시 하나가 "반대 결론임" 판정과 근거 문장 인용 기능으로 이어졌습니다.
디자인은 링크 대신 캡처로 주기. Figma 링크만으로는 읽지 못했고, 캡처 두 장을 붙여 넣자 색·글꼴·배치가 바로 반영됐습니다.
가정을 문서에 남기게 하기. gatekit은 제가 정하지 않은 내용을 "⚠️ 가정 12"처럼 표시합니다. 나중에 무엇을 확인해야 하는지 한눈에 보입니다.
과정 중에 어떤 시행착오를 겪었나요?
격은 일 | 해결 |
|---|---|
플러그인 설치 후 로그인을 다시 하고, 플러그인을 꺼두었다 켜는 일이 있었음 |
|
"4주"를 개발 기간으로 오해함 | 만드는 건 오늘, 직접 써 보는 기간은 1주로 다시 정함 |
기본 디자인 프리셋의 글꼴에 한글이 없음 | 제목은 Nunito + 고운돋움, 본문은 Pretendard로 바꿈 |
Figma 링크를 읽을 도구가 연결되지 않음 | 화면 캡처를 붙여 넣음 |
한국어 논문 조회에 필요한 KCI 키 신청에 서버 IP를 적어야 함 | 키는 운영자 서버에서만 쓰도록 설계하고, 키가 없으면 "불확실" + RISS 링크로 표시 |
완료 기준( | 의도한 안전장치라 다음 단계에서 기준을 승인하고 진행 |
앞으로의 계획이 있다면 들려주세요.
/gatekit:gate로 완료 기준 정하고 승인하기/gatekit:tasks→/gatekit:build로 웹 페이지(F1~F9) 만들기, 2026년 10월 7일까지내 논문 초고로 1주 동안 직접 써 보고 판정 정확도 확인하기
Obsidian에서 바로 돌리는 Claude 스킬(F10) 만들기
다음
/gatekit:discover에서 "요약을 모아 선행연구 절 쓰기"와 "핵심 선행연구 고르기" 다루기
도움 받은 글 (옵션)
gatekit 플러그인 (GitHub): 문제 발굴부터 검증까지 단계별 스킬
Modern Product Launch (Figma Community): 화면 분위기 참고
24기 클코서비스 스터디장 로미오님 강의와 유인물
로그인하고 댓글을 남겨 주세요
Aha님, “시간 단축”이 아니라 인용의 품질 검증으로 문제를 다시 정의하신 지점이 특히 선명했어요.
존재 여부·서지 정보·주장 뒷받침을 나눠 두고, 반대 결론 사례까지 결과 카드에 넣으신 덕분에 실제 심사 상황을 잘 다루는 프로토타입이 됐네요.
Figma 링크 대신 캡처를 전달하고, KCI 키가 없을 때는 “불확실”로 남기는 시행착오도 다음 구현에서 큰 기준이 될 것 같아요.
1주 사용 검증에서 어떤 판정이 가장 자주 흔들리는지도 궁금해요. 고롱고롱… 꼼꼼한 검증 도구의 다음 단계도 응원할게요 ✨




Aha 님 예전에 졸업하기 전에 논문 쓴 기억이 새록새록 떠오르네요 😀 😀
빠르게 프로토타입까지 만드셨다니 대단합니다
쓰신 논문 판정 정확도 검증까지 화이팅입니다😆 😆 😆