Claude Code Plugin · For Clinical Researchers
아이디어에서 투고 준비까지,
한 명의 동료처럼.
ResearchFellow는 후향 연구의 어느 단계에서든 합류하는 Claude Code 플러그인입니다. PICO 구조화부터 프로토콜·분석·원고·리뷰 대응까지, 대화로 진행하며 매 단계를 함께 확인합니다.
한 줄
- PICO 구조화
- 문헌 조사
- 근거표
- 변수 정의
- 프로토콜
- 분석계획 SAP
- 표·그림 틀
- 모의 분석
승인 없이는 진행 불가
- 데이터 준비·QC
- 실제 분석
- 원고 작성
- 제출 패키지
- 리뷰 대응
원고
관문 승인과 단계 진행은 audit.jsonl에 추가만 되고, 연구 판단은 decisions.jsonl에 남습니다. 로컬 파일이며 변조 방지 저장소는 아닙니다.
실제 데이터가 없어도 동의를 받은 뒤 합성 데이터로 나머지 단계를 research/rehearsal/에서 미리 돌아볼 수 있습니다. 연습 산출물에는 워터마크가 있어 원고 결과로 쓸 수 없습니다.
데이터는 있는데,
연구가 앞으로 나아가지 않는다.
후향 연구의 현실
- 어떤 설계·통계가 맞는지 방법론이 막막하다
- 프로토콜과 SAP를 어디서부터 써야 할지 모른다
- 분석은 됐는데 논문화가 몇 달째 지연된다
- 리뷰어 코멘트에 어떻게 응답할지 감이 안 온다
- 과정이 기록되지 않아 재현·감사가 어렵다
ResearchFellow의 방식
- 대화로 진행 — 명령어가 아니라 연구 흐름을 따른다
- 매 단계 확인 — 다음 산출물을 함께 결정하고 넘어간다
- 13단계 아티팩트 DAG로 어디까지 왔는지 항상 명확
- hard gate가 근거 없는 진행을 물리적으로 막는다
- 관문 승인과 진행은 audit.jsonl에, 연구 판단은 decisions.jsonl에 남는다
한 흐름 안에 담긴 13단계.
어느 단계에서든 합류할 수 있습니다.
이미 진행 중인 연구라면 중간에 들어와도 됩니다. 실제 데이터로 넘어가려면 타당성·프로토콜·QC 세 관문을 통과해야 하고, 승인이 없으면 분석 스크립트가 실행되지 않습니다.
어디서 시작하시나요?
"몇 단계인지"를 먼저 묻지 않습니다. 지금 손에 든 것이 무엇이든, 그 지점을 시작점으로 삼습니다.
대화가 끝나면,
논문 한 편의 뼈대가 폴더로 남습니다.
각 단계의 결과가 폴더별로 차곡차곡 쌓입니다. 아이디어(PICO)에서 실제 문헌(PubMed·PMC·Europe PMC·medRxiv·OpenAlex·Crossref 6개 어댑터, 결과에 겹침 있음), 프로토콜·SAP, 데이터 QC와 분석을 거쳐 투고용 원고와 제출 패키지까지 — 전 과정이 로컬에 감사 가능한 형태로 남아, "이 결론이 어디서 나왔는지"를 폴더만 열어 되짚을 수 있습니다.
원고의 숫자와 인용은 근거표와 대조해, 출처가 없는 수치를 제출 전에 걸러 냅니다.
예시는 「지역사회획득 폐렴에서 병용 vs 단독 항생제와 30일 사망」 연구를 리허설한 것 — 문헌은 실제 PubMed, 코호트·수치는 검증용 합성(모의) 데이터입니다. 실제 연구에서는 이 자리에 여러분의 데이터가 들어갑니다.
연구 무결성은 기능이 아니라
전제입니다.
PHI는 로컬을 떠나지 않는다
환자 식별 정보는 자동 스크리닝을 거쳐 로컬에서만 처리됩니다. AI는 원본 데이터 파일을 직접 읽지 않고 집계 결과만 보며, 한 명으로 좁혀지는 결과는 출력되지 않습니다. 서버로는 비식별 파생물(PICO·스키마·집계·텍스트)만 전달됩니다.
hard gate는 스크립트가 물리 차단
feasibility·protocol·qc 세 관문은 조건이 충족되지 않으면 스크립트 수준에서 진행을 막습니다. 설득이 아니라 물리적 차단입니다. 결과를 본 뒤 주분석을 바꾸면 차단설명이 뜹니다.
append-only 감사 로그
관문 승인과 단계 진행은 audit.jsonl에 추가만 되고, 연구 판단은 decisions.jsonl에 남습니다. 로컬 파일이며 변조 방지 저장소는 아닙니다. 무결성 리포트의 서명은 발급 시점 이후 불변만 보증합니다.
합성 결과는 원고에 못 들어간다
드라이런에서 만든 합성 데이터 결과는 원고 삽입이 금지됩니다. 실분석 산출물만 논문으로 흐릅니다.
상태 파일은 사람이 읽는 JSON
연구 상태는 열어서 직접 읽고 검토할 수 있는 JSON입니다. 블랙박스가 아니라 당신이 확인하고 인계할 수 있는 기록입니다.
플러그인과 가드레일은 무료
플러그인과 무결성 가드레일은 무료입니다. Claude Code 구독 또는 API 비용은 별도입니다.
판단은 A·B·C로 나눕니다. A는 처리한 뒤 알리고, B는 추천과 이유·대안·영향을 보여 주며, C는 연구 질문이나 결과변수처럼 논문의 의미를 바꾸므로 확인 없이 잠그지 않습니다. 나중에 왜 이 환자, 이 시점, 이 모형인지 연구자가 답할 수 있게 하려는 장치입니다.
Get Started
두 줄이면,
오늘부터 함께 시작합니다.
/plugin marketplace add emergency-lee/researchfellow-plugin /plugin install researchfellow