Galaxy-Dawn/claude-scholar

학술 연구 및 소프트웨어 개발, 특히 컴퓨터 과학 (Computer Science) 및 AI 연구자를 위한 반자동 연구 보조 도구입니다. 문헌 검토 (Literature Review), 코딩 (Coding), 실험 (Experiments), 보고 (Reporting), 작성 (Writing) 및 프로젝트 지식 관리 (Project Knowledge Management) 전반에 걸쳐 Claude Code, Codex CLI, OpenCode를 지원합니다.

브랜치 참고: main 브랜치는 Claude Code 워크플로우입니다. Codex CLI를 사용하는 경우 codex 브랜치를 참조하십시오. OpenCode를 사용하는 경우 opencode 브랜치를 참조하십시오.

2026-05-14:
expression-skill을 커뮤니케이션 코어로 만들고, planning-with-files를 기본 영속성 계층 (Persistence Layer)으로 복구하였으며, Nature 작성 스택 (Nature writing stack)을 확장했습니다: expression-skill은 보고, 계획, 파일 작업 및 다단계 기술 작업을 위한 명시적인 결론 우선 (Conclusion-first) 규율을 제공합니다; planning-with-files를 복잡한 작업을 위한 기본 온디스크 (On-disk) 계획 및 진행 상황 추적 워크플로우로 재도입했습니다; 섹션 초안 작성 및 논거 구축을 위해 nature-writing을 도입했습니다; 최신 업스트림 기사 패턴 릴리스에 맞춰 nature-polishing을 새로고침했습니다; 저널 작성 스택 (Journal-writing stack)에는 nature-response와 nature-data를 유지했습니다.

2026-05-13:
증거 기반 연구 워크플로우 (Evidence-gated research workflow) 및 — 공유된 Sources/Papers를 추가했습니다. 증거 기록 (Evidence Records), 주장 강도 (Claim strength), 그리고 주장 승격 게이트 (Claim Promotion Gates)를 위해 research-contract.md의 라우팅을 강화했습니다; 연구 아이디어 구상 (Ideation), Zotero 수집 (Ingestion), 문헌 합성 (Literature synthesis), 결과 보고, 작성 및 반박 (Rebuttal) 워크플로우를 해당 계약에 연결했습니다; 승격된 주장 (Promoted claims)이 Knowledge 또는 Writing으로 이동하기 전에는 프로젝트 논문 노트가 Sources/Papers 아래에 존재함을 명확히 했습니다.

2026-04-24: 프로젝트 범위의 Obsidian 지식 베이스 (KB) 워크플로우 통합— Obsidian 프로젝트 지식 관리 (Knowledge Management)를 볼트 우선 (vault-first) 워크플로우로 재구축하였으며, 기존의 중복되던 메모리 기술 (memory skills)들을 네 가지 집중 기술로 통합했습니다. 저장소 로컬 프로젝트 바인딩 메타데이터 (repo-local project binding metadata)를 런타임 레이어 (runtime layer)로 유지하였고, 프로젝트 탐색을 기계적 레지스트리 덤프 (machine registry dump)가 아닌 인간 중심 (human-first) 방식으로 개선했습니다.

2026-04-22: 경량화된 코어, 기본 에이전트 정리, 더 안전한 설치 라이프사이클, 그리고 더 깔끔한 논문 탐색— 대규모의 상시 활성화된 CLAUDE.md 및 AGENTS.md 파일을 컴팩트한 핵심 지침 (core instructions)으로 교체하였고, 기본 에이전트 세트를 유지된 핵심 에이전트들로 정리했습니다. 안전한 설치 상태 기반의 삭제 (uninstall) 지원을 추가하였으며, daily-paper-generator를 arXiv 및 bioRxiv를 지원하는 더 넓은 주제로 일반화하고, Top 10 -> Top 3 -> Top 1 선택 흐름을 고정했습니다.

2026-04-15: pubfig 및 pubtab 도입— 출판 수준의 과학적 도표를 위한 Python 패키지인 pubfig와, 출판 준비가 된 표 및 Excel↔LaTeX 워크플로우를 위한 Python 패키지인 pubtab을 도입했습니다. 이들은 논문 도표, 벤치마크 표, 내보내기 제어 (export control), 그리고 최종 결과물 품질 보증 (artifact QA)을 위한 더 깔끔한 프로덕션 스택을 제공합니다.

이전 변경 이력 보기

• 2026-04-15: publication-chart-skill을 래핑(wrapped)하여 Claude Scholar에 통합했습니다. pubfig와 pubtab을 publication-chart-skill에 통합하고 해당 기술을 저장소에 추가했으며, 이를 Claude Scholar의 분석 및 작성 경계 (analysis and writing boundaries)에 연결했습니다. 이를 통해 출판 수준의 도표/표 작업이 일반적인 분석이나 산문 기술과 섞이지 않고 명시적인 핸드오프 경로 (handoff route)를 갖게 되었습니다.

• 2026-03-31: Zotero 스마트 임포트 (smart-import) 워크플로우 문서 정렬— 최신 zotero-mcp 공개 인터페이스에 맞춰 Claude Scholar의 연구용 문서를 업데이트했습니다. zotero_add_items_by_identifier가 이제 기본 논문 임포트 경로이며, zotero_reconcile_collection_duplicates...

is 임포트 후 표준 정리 단계이며, 소스 인식 PDF 캐스케이드 (cascade) 동작이 더 정확하게 문서화되었고, 공개 진단 (public diagnostics)과 내부 진단 (internal diagnostics)이 이제 명확하게 분리되었습니다. -
2026-03-31: README 온보딩 (onboarding) 갱신— Claude Scholar가 특히 컴퓨터 과학 및 AI 연구자들에게 매우 적합하다는 점을 명확히 했으며, 설치 후 실질적인 시작 시나리오를 추가하고, 필수 요구 사항 및 브랜치 (branch) 안내를 개선하였으며, "기존 로컬 md 파일은 수동으로 병합해야 한다"는 기대 사항을 훨씬 더 명시적으로 작성했습니다. -
2026-03-31: 설치 프로그램 및 훅 (hook) 동작 강화— 설치 프로그램은 이제 기존 로컬 CLAUDE.md를 보존하면서, 저장소 관리 버전을 CLAUDE.scholar.md로 설치합니다. 또한, 더 안전한 쓰기 보호 (write-guard) 동작을 유지하면서 노이즈가 되는 임시 파일 / 커밋되지 않은 파일 출력을 줄이기 위해 기본 훅 요약 (hook summaries)을 축소했습니다. -
2026-03-31: 일본어 문서 추가— 메인 README를 비롯하여 AGENTS, MCP_SETUP, OBSIDIAN_SETUP에 대한 일본어 문서를 추가하여, 이제 OpenCode 브랜치가 더욱 완전한 다국어 문서 지원 범위를 갖추게 되었습니다. -
2026-02-25: Codex CLI 지원 — config.toml, 40개의 기술 (skills), 14개의 에이전트 (agents), 그리고 샌드박스 (sandbox) 보안을 갖춘 OpenAI Codex CLI를 지원하는 codex 브랜치를 추가했습니다. -
2026-02-23: setup.sh 설치 프로그램 추가 — 기존 ~/.opencode에 대한 백업 인식 증분 업데이트, opencode.jsonc 자동 백업, 그리고 agent/mcp/permission/plugin의 가산적 (additive) 병합을 지원합니다. -
2026-02-21: OpenCode 지원 — Claude Scholar가 이제 대안 CLI로서 OpenCode를 지원합니다. OpenCode 호환 설정을 사용하려면 opencode 브랜치로 전환하십시오. -
2026-02-20: 이중 언어 문서 — 더 넓은 가독성을 위해 영어 및 중국어 입문 문서를 유지했습니다. -
2026-02-15: Zotero MCP 통합 — /zotero-review 및 /zotero-notes 명령어를 추가하고, Zotero 통합 가이드와 함께 research-ideation 기술을 업데이트했으며, literature-reviewer를 강화했습니다.

자동화된 논문 가져오기, 컬렉션 관리, 전문(full-text) 읽기 및 인용 내보내기를 위해 Zotero MCP를 지원하는 에이전트 -
2026-02-14: Hooks 최적화 — security-guard를 2단계 시스템(차단 + 확인)으로 재구조화했습니다. skill-forced-eval은 이제 기술을 6개 카테고리로 그룹화하며 silent scan 모드를 지원합니다. session-start는 표시를 상위 5개로 제한합니다. session-summary는 30일 로그 자동 정리 기능을 추가했습니다. stop-summary는 추가/수정/삭제된 개수를 별도로 표시합니다. 지원 중단된 셸 스크립트(lib/common.sh, lib/platform.sh)를 제거했습니다. -
2026-02-11: 주요 업데이트 — 10개의 새로운 기술(research-ideation, results-analysis, citation-verification, review-response, paper-self-review, post-acceptance, daily-coding, frontend-design, ui-ux-pro-max, web-design-reviewer), 7개의 새로운 에이전트, 8개의 연구 워크플로우 명령, 2개의 새로운 규칙(security, experiment-reproducibility)을 추가했습니다. 메인 설정 문서를 재구조화했습니다. 89개의 파일이 변경되었습니다. -
2026-01-26: 모든 Hooks를 크로스 플랫폼 Node.js로 다시 작성했습니다. README를 완전히 새로 작성했습니다. ML 논문 작성 지식 베이스를 확장했습니다. PR #1(크로스 플랫폼 지원)을 병합했습니다. -
2026-01-25: 프로젝트를 오픈 소스로 공개하였으며, 25개의 기술(architecture-design, bug-detective, git-workflow, kaggle-learner, scientific-writing 등), 2개의 에이전트(paper-miner, kaggle-miner), 30개 이상의 명령(SuperClaude 제품군 포함), 5개의 Shell Hooks, 2개의 규칙(coding-style, agents)과 함께 v1.0.0을 출시했습니다.

섹션	도움을 주는 내용
Why Claude Scholar	프로젝트의 포지셔닝과 대상 사용 사례를 이해합니다.
...

Claude Scholar는 연구자를 대체하려고 시도하는 엔드 투 엔드(end-to-end) 자율 연구 시스템이 아닙니다.

핵심 아이디어는 간단합니다:

인간의 의사결정이 중심에 머물며, 어시스턴트는 그 주변의 워크플로우를 가속화합니다.

이는 Claude Scholar가 문헌 정리, 노트 작성, 실험 분석, 보고 및 집필 지원과 같이 연구의 무겁고 반복적이며 구조에 민감한 부분들을 돕도록 설계되었음을 의미합니다. 동시에 다음과 같은 핵심적인 판단은 여전히 인간의 손에 남겨둡니다:

• 어떤 문제를 추구할 가치가 있는가,
• 어떤 논문이 실제로 중요한가,
• 어떤 가설을 테스트할 가치가 있는가,
• 어떤 결과가 설득력이 있는가,
• 그리고 무엇을 작성하고, 제출하거나, 포기해야 하는가.

다시 말해, Claude Scholar는 "완전 자동화된 과학자"가 아니라 **반자동 연구 어시스턴트 (semi-automated research assistant)**입니다.

Claude Scholar는 특히 다음과 같은 경우에 매우 적합합니다:

• 문헌 검토, 코딩, 실험, 논문 작성을 오가는 컴퓨터 과학 연구자 (computer science researchers),
• 아이디어 구상, 구현, 분석, 보고 및 반박 (rebuttal)을 아우르는 단일 어시스턴트 워크플로우가 필요한 AI / ML 연구자 (AI / ML researchers),
• 인간의 판단을 포기하지 않으면서 더 강력한 워크플로우 구조를 원하는 연구 엔지니어 및 대학원생 (research engineers and graduate students),
• Zotero, Obsidian, CLI 자동화 및 재현 가능한 프로젝트 메모리 (reproducible project memory)의 이점을 얻을 수 있는 소프트웨어 중심의 학술 프로젝트 (software-heavy academic projects).

다른 연구 환경에서도 도움을 줄 수 있지만, 현재의 워크플로우 설계는 컴퓨터 과학, AI 및 인접한 계산 연구 (computational research) 분야에 가장 잘 부합합니다.

Claude Scholar는 연구 작업을 추적 가능한 경로를 통해 안내합니다:
질문 (question) -> 증거 (evidence) -> 실험 (experiment) -> 분석 (analysis) -> 주장 (claim) -> 집필 (writing)

각 단계는 알려진 사실, 불확실한 사실, 그리고 다음에 어떤 결정이 내려져야 하는지를 보존해야 합니다.

아이디어 구상 (Ideation): 모호한 주제를 구체적인 질문, 연구 공백 (research gaps), 그리고 초기 계획으로 전환합니다.
문헌 (Literature): Zotero 컬렉션을 통해 논문을 검색, 가져오기, 정리 및 읽습니다.
논문 노트 (Paper notes): 논문을 구조화된 독서 노트와 재사용 가능한 주장 (claims)으로 변환합니다.
지식 베이스 (Knowledge base): 지속적인 지식을 Sources / Knowledge / Experiments / Results / Results/Reports / Writing / Daily / Maps에 걸쳐 Obsidian으로 전달합니다.

.Experiments (실험): 가설, 실험 라인, 실행 이력, 결과 및 다음 조치 사항을 추적합니다. Analysis (분석): results-analysis를 사용하여 엄격한 통계, 실제 과학적 수치 및 분석 결과물 (artifacts)을 생성합니다.

.Reporting (보고): results-report를 사용하여 실험 후의 완전한 보고서를 생성한 다음, 이를 Obsidian에 다시 기록합니다.

.Writing and publication (작성 및 출판): 안정적인 연구 결과 (findings)를 문헌 검토 (literature reviews), 논문 (papers), 반박문 (rebuttals), 슬라이드 (slides), 포스터 (posters) 및 홍보 자료로 연결합니다.

• Claude Code
• Git
• (선택 사항) Python 개발을 위한 Python + uv
• (선택 사항) 문헌 워크플로를 위한 Zotero + Galaxy-Dawn/zotero-mcp
• (선택 사항) 프로젝트 지식 베이스 (knowledge-base) 워크플로를 위한 Obsidian

git clone https://github.com/Galaxy-Dawn/claude-scholar.git /tmp/claude-scholar
bash /tmp/claude-scholar/scripts/setup.sh

Windows: 설치 프로그램을 실행하려면 Git Bash 또는 WSL을 사용해 주세요.

설치 프로그램은 백업을 인지하며 점진적 업데이트 (incremental-update)에 친화적입니다:

• 저장소에서 관리하는 skills/commands/agents/rules/hooks/scripts/CLAUDE*.md 파일을 업데이트합니다.
• 덮어쓰여진 파일은 ~/.claude/.claude-scholar-backups/<timestamp>/로 백업합니다.
• settings.json을 settings.json.bak로 백업합니다.
• 기존의 ~/.claude/CLAUDE.md를 보존하고, 저장소에서 관리하는 버전을 ~/.claude/CLAUDE.scholar.md로 설치합니다.
• 기존의 ~/.claude/CLAUDE.zh-CN.md를 보존하고, 저장소에서 관리하는 버전을 ~/.claude/CLAUDE.zh-CN.scholar.md로 설치합니다.
• 기존의 env, 모델/제공자 (model/provider) 설정, API 키, 권한 및 현재 mcpServers 값을 보존합니다.
• 전체 훅 (hook) 세트를 교체하는 대신 누락된 훅 항목을 추가합니다.

중요 CLAUDE 참고 사항: 이미 자체적으로 ~/.claude/CLAUDE.md 또는 ~/.claube/CLAUDE.zh-CN.md를 유지 관리하고 있다면, 설치 후 ~/.claude/CLAUDE.scholar.md 및 ~/.claude/CLAUDE.zh-CN.scholar.md를 검토하고 원하는 Claude Scholar 섹션을 수동으로 본인의 파일에 병합하십시오. 사이드카 (sidecar) 파일이 자동으로 적용된다고 가정하지 마십시오.

나중에 업데이트하려면:

cd /tmp/claude-scholar
git pull --ff-only
bash scripts/setup.sh

나중에 삭제하려면:

cd /tmp/claude-scholar
bash scripts/uninstall.sh

이제 설치 프로그램은 다음 파일들을 작성합니다:

~/.claude/.claude-scholar-manifest.txt

Claude Scholar에 의해 관리되는 정확한 파일 목록을 위해

~/.claude/.claude-scholar-install-state

안전한 삭제를 위해 사용되는 설치 소유권 메타데이터를 위해

삭제 프로그램은 해당 설치 상태 (install state)에 기록된 파일과 설정 항목만 제거합니다. 현재 리포지토리 체크아웃 (repo checkout) 상태로부터 소유권을 추측하지 않습니다.

연구 중심의 작은 서브셋 (subset)만 설치하려면:

git clone https://github.com/Galaxy-Dawn/claude-scholar.git /tmp/claude-scholar
mkdir -p ~/.claude/hooks ~/.claude/skills
cp /tmp/claude-scholar/hooks/*.js ~/.claude/hooks/
...

설치 후: 최소/수동 설치는 settings.json을 자동으로 병합하지 않습니다

; settings.json.template에서 원하는 훅 (hooks) 또는 MCP 항목만 복사하십시오.

이미 본인만의 ~/.claude/CLAUDE.md 또는 ~/.claude/CLAUDE.zh-CN.md 파일이 있다면, 무작정 덮어쓰는 대신 이 리포지토리의 Claude 파일에서 관련 섹션을 본인의 파일로 병합하십시오.

필요한 부분만 복사하십시오:

git clone https://github.com/Galaxy-Dawn/claude-scholar.git /tmp/claude-scholar
cd /tmp/claude-scholar
cp hooks/*.js ~/.claude/hooks/
...

설치 후: 선택적/수동 설치는 settings.json을 자동으로 병합하지 않습니다

; settings.json.template에서 실제로 원하는 훅 (hooks) 또는 MCP 항목만 복사하십시오.

이미 본인만의 ~/.claude/CLAUDE.md 또는 ~/.claude/CLAUDE.zh-CN.md 파일이 있다면, 무작정 덮어쓰는 대신 이 리포지토리의 Claude 파일에서 관련 섹션을 본인의 파일로 병합하십시오.

1단계: 플러그인 설치