flonat/claude-research

겸손한 박사 과정 학생이 만들었습니다. 연구자를 위한 완전한 Claude Code 인프라 — 학술적 워크플로우 (workflows)를 위한 기술 (skills), 에이전트 (agents), 훅 (hooks), 그리고 규칙 (rules)을 제공합니다. LaTeX로 논문을 작성하고, 참고문헌 (bibliographies)을 관리하며, 실험을 수행하고, 학술적 관례를 이해하는 AI 지원을 원하는 연구자들을 위해 구축되었습니다.

macOS, Linux, 그리고 Windows에서 작동합니다. 터미널 CLI, VS Code, JetBrains IDEs, 웹, 또는 데스크톱 앱에서 Claude Code를 사용하세요 — 이 모든 환경은 동일한 기술 (skills), 에이전트 (agents), 그리고 규칙 (rules)을 공유합니다.

npx flonat-research

이 명령은 패키지를 다운로드하고 설정 스크립트를 실행하며, 기술 (skills), 에이전트 (agents), 훅 (hooks), 그리고 규칙 (rules)을 ~/.claude/에 심볼릭 링크 (symlinks)로 연결합니다.

git clone https://github.com/flonat/claude-research.git
cd claude-research
./scripts/setup.sh

git clone https://github.com/flonat/claude-research.git
cd claude-research
.\scripts\setup.ps1

git clone을 통해 완전히 커스터마이징할 수 있는 로컬 복사본을 가질 수 있습니다 — .context/profile.md, CLAUDE.md, 그리고 워크플로우 (workflows)를 귀하의 연구에 맞게 편집하세요.

# macOS/Linux: 최신 버전을 가져온 후, 설정을 덮어쓰지 않고 다시 링크
git pull && ./scripts/setup.sh --update
# Windows (PowerShell):
...

그런 다음 .context/profile.md, .context/current-focus.md, 그리고 CLAUDE.md를 귀하의 세부 정보로 커스터마이징하세요. 전체 가이드(Windows 전용 설정, Python 설치 및 문제 해결 포함)는 docs/getting-started.md를 참조하세요.

패키지 (Package)	설치 (Install)	설명 (Description)
llm-council	pip install llm-council	OpenRouter API를 통한 멀티 모델 의회 (Multi-model council)
cli-council	pip install cli-council	로컬 CLI 도구를 통한 멀티 모델 의회 (Multi-model council)

구성 요소	개수	설명
Skills (기술)	50	일반적인 작업을 위한 슬래시 명령어 (/proofread, /latex-autofix, /literature 등)
Agents (에이전트)	15	전문 리뷰어 (동료 검토 (peer review), referee 2, 논문 비평가 (paper critic), 도메인 리뷰, 수정가 (fixer))
Hooks (훅)	9	자동화된 가드레일 (파괴적인 git 보호, 컨텍스트 모니터링 등)
Rules (규칙)	18	상시 적용되는 정책 (구현 전 계획 수립, 범위 준수 등)
Context library (컨텍스트 라이브러리)	—	세션 전반에 걸쳐 Claude에게 지속적인 메모리 (persistent memory)를 제공하는 구조화된 파일들
Notion integration (Notion 연동)	—	작업 관리 및 연구 파이프라인 추적 — 설정 가이드
Bibliography MCP (서지 MCP)	—	다중 소스 학술 검색 (OpenAlex + Scopus + WoS) — 설정 가이드
Council mode (의회 모드)	—	멀티 모델 심의 (3명의 리뷰어 + 종합) — 설정 가이드
CLI tools (CLI 도구)	—	터미널에서 Notion 작업 관리 — 문서

┌──────────────────────────────────────────────────────────────┐
│ Claude Code (터미널) │ Claude Desktop (GUI) │
│ │ │
...

MCP 서버의 load-context 도구는 Claude Desktop이 컨텍스트 라이브러리와 MEMORY.md에 접근할 수 있게 해줍니다. 이는 Claude Code가 자동으로 읽는 것과 동일한 파일들입니다.

Context Library (컨텍스트 라이브러리) (.context/) — Claude에게 사용자, 프로젝트, 그리고 워크플로우에 대한 지속적인 메모리 (persistent memory)를 제공하는 마크다운 (Markdown) 파일들입니다. 매 세션마다 연구 내용을 다시 설명할 필요 없이, Claude가 이 파일들을 자동으로 읽습니다.

Skills (기술) (skills/) — /<skill-name> 또는 자연어로 호출되는 슬래시 명령어입니다.

50개의 기술을 사용할 수 있습니다. 주요 예시: /proofread, /literature, /bib-validate, /init-project-research, /pre-submission-report 등이 있습니다.

전체 목록은 docs/skills.md를 참조하세요.

Agents (에이전트) (.claude/agents/) — 복잡한 검토 작업을 위한 전문화된 페르소나 (persona)로, 병렬 작업을 위해 하위 에이전트 (sub-agents)를 생성합니다.

에이전트 (Agent)	사용 사례 (Use case)
artifact-coherence-auditor	논문의 산문 (prose)과 재현 결과물 사이의 일관성을 감사합니다 — 환각된 결과, 누락된 스크립트, 불일치하는 숫자, 검증 불가능한 주장을 포착합니다
blindspot	경험적 결과물 (empirical output)에 대한 주변 시야 감사
claim-verify	논문에 인용된 주장들이 실제 소스 논문에서 말하는 바를 정확하게 나타내는지 검증합니다
code-paper-auditor	코드와 논문의 일관성을 검증해야 할 때 이 에이전트를 사용합니다 — 논문의 모든 정량적 주장을 소스 코드 및 출력 파일과 매핑합니다
code-review	R, Python, Julia 또는 Stata 연구 스크립트의 적대적 검토 (adversarial review)를 위한 멀티 페르소나 오케스트레이터 (multi-persona orchestrator)
codex-research	헤드리스 모드 (headless mode)에서 OpenAI Codex CLI에 작업을 위임하는 코드 검토 및 연구 에이전트
domain-reviewer	연구 중심의 실질적 정확성 (substantive correctness) 에이전트
fatal-error-check	LaTeX 논문의 치명적 오류에 대한 빠른 사전 검토
fixer	모든 비판 보고서에 대한 범용 수정 구현기
gemini-research	헤드리스 모드 (headless mode)에서 Gemini CLI에 작업을 위임하는 웹 연구 에이전트
paper-critic	LaTeX 논문을 위한 적대적 감사자
peer-reviewer	타인의 논문을 검토해야 할 때 이 에이전트를 사용합니다 — 동료 검토자 (peer reviewer), 토론자 (discussant), 또는 읽기 그룹 (reading group) 준비용
proposal-reviewer	연구 제안서, 확장 초록 (extended abstract), 컨퍼런스 제출 개요, 또는 논문 작성 전 계획(본인 또는 타인의 것)을 검토해야 할 때 이 에이전트를 사용합니다
referee2-reviewer	사용자가 자신의 작업(논문, 원고, 연구 설계, 코드 또는 논거 포함)에 대해 엄격하고 적대적인 학술적 검토를 원할 때 이 에이전트를 사용합니다
reproducibility-auditor	재현성 격차(reproducibility gaps)를 확인하기 위해 연구 워크플로우를 검토합니다 — 숨겨진 의존성, 절대 경로, 문서화되지 않은 전제 조건, 환경 가정 및 출력 추적 가능성

상세한 설명은 docs/agents.md를 참조하세요.

Hooks (hooks/) — 세션의 특정 시점에서 실행되는 자동화된 가드레일 (guardrails).

Hook	트리거 (Trigger)	기능
block-destructive-git.sh	Bash 실행 전 (Before Bash)	위험한 git/shell 명령어를 포착함
context-monitor.py	도구 사용 후 (After tool use)	컨텍스트 사용량의 휴리스틱 (heuristic)으로서 도구 호출 횟수를 추적함
handoff-read.sh	세션 시작 (SessionStart)	현재 작업 디렉토리(cwd)에 handoff.md가 존재하면, 이를 additionalContext로 읽어들임
postcompact-restore.py	압축 후 (After compact)	컨텍스트 압축 (context compression) 후 상태를 복구함
precompact-autosave.py	압축 전 (Before compact)	컨텍스트 압축 (context compression) 전 상태를 저장함
promise-checker.sh	세션 종료 (Session stop)	"수행적 순응 (performative compliance)"을 포착함: Claude가 기억했다/노트했다/저장했다고 말하는 경우
protect-source-files.sh	편집/쓰기 전 (Before edit/write)	외부 파일에 대해 확인 프롬프트를 띄움
resume-context-loader.sh	세션 재개 (Session resume)	현재 집중 사항 (focus)과 최신 세션 로그를 노출함
startup-context-loader.sh	세션 시작 (Session start)	프로젝트 문서를 자동 감지하여 노출함

전체 문서는 docs/hooks.md를 참조하세요.

Rules (.claude/rules/) — 올바른 연구 관행을 강제하는 상시 적용 정책 (Always-on policies). docs/rules.md를 참조하세요.

Research Vault — 작업, 파이프라인, 제출, 학술 대회 (venues), 인물 및 주제를 위한 Obsidian 스타일의 마크다운 볼트 (~/Research-Vault). taskflow MCP 서버를 통해 접근합니다.

Biblio MCP — 다중 소스 학술 검색 서버 (OpenAlex + 선택 사항인 Scopus 및 Web of Science). docs/bibliography-setup.md를 참조하세요.

Flonat-Papers MCP — Zotero 라이브러리 관리 서버 (검색, PDF 추출, 의미론적 검색 (semantic retrieval), BibTeX 내보내기). packages/flonat-papers/에 위치하며 bib-validate 및 bib-parse 기술이 포함되어 있습니다.

Council Mode — 3개의 LLM 제공업체를 통한 다중 모델 심의 (multi-model deliberation), 익명 교차 검토 (anonymised cross-review), 그리고 의장 합성 (chairman synthesis). docs/council-mode.md를 참조하세요.

명령 (Command)	실행 내용
"Plan my day"	컨텍스트를 읽고, 볼트를 쿼리하며, 질문을 던지고, Must Do / Should Do / Could Do 계획을 생성함
...

각 세션은 이전 세션을 기반으로 구축됩니다:

current-focus.md — 세션 종료 시 진행 상황 및 다음 단계와 함께 업데이트됨
log/

— 타임스탬프가 찍힌 세션 로그
log/plans/

— 저장된 구현 계획
MEMORY.md

— 누적된
[LEARN]

태그 (표기법 (notation), 인용 (citation), 코드 (code), 방법 (method), 도메인 교정 (domain corrections))

복구 프로토콜 (recovery protocol)은 최신 계획, 세션 로그, 현재 포커스 (current focus)를 읽어 끊김 없이 재개합니다.

claude-research/
├── CLAUDE.md # 메인 지침 파일 (사용자 정의 가능)
├── README.md # 이 파일
...

Lazy prompting (게으른 프롬프팅)— 컨텍스트 파일이 반복적인 설명을 제거합니다
Hybrid local + cloud (하이브리드 로컬 + 클라우드)— Markdown (버전 관리됨) + Research Vault (동적)
Question-driven (질문 주도형)— AI가 목록을 쏟아내기 전에 질문을 던집니다
Read-only audits (읽기 전용 감사)— 교정, 검증, 검토 수행 — 소스 코드를 자동으로 편집하지 않습니다
Session continuity (세션 연속성)— 모든 세션은 다음 세션을 더 낫게 만듭니다
Permission governance (권한 거버넌스)— 글로벌 설정이 자동으로 전파됩니다

도구	필요한 이유	macOS	Linux	Windows
Claude Code	AI 엔진 — 기술 (skills), 에이전트 (agents), 훅 (hooks) 실행	`curl -fsSL https://claude.ai/install.sh	bash`	동일
Python 3.11+	훅 (Hooks) 및 MCP 서버	brew install python@3.12	apt install python3.12	winget install Python.Python.3.12
uv	빠른 Python 패키지 관리자 — 의존성 격리, pip 대체	brew install uv	`curl -LsSf https://astral.sh/uv/install.sh	sh`
Git	버전 관리 (version control)	포함됨	apt install git	winget install Git.Git
TeX Live	LaTeX 컴파일 (/proofread, /latex-autofix)	brew install --cask mactex	apt install texlive-full	설치 가이드

또한 VS Code 확장 프로그램, JetBrains 플러그인, 웹 앱 또는 데스크톱 앱으로도 사용할 수 있습니다.

Fedora/Arch 명령어, Windows 전용 설정, Python 버전 안내 및 문제 해결에 대해서는 docs/getting-started.md를 참조하세요.

이 인프라는 여러 오픈 소스 워크플로우의 디자인 패턴 (design patterns)을 활용합니다.

Scott Cunningham(MixtapeTools) — 세션 로그 (session logs), 수사학 중심 프레젠테이션 (rhetoric-driven presentations), 코드 감사를 위한 "health inspector" 모델, 교차 언어 복제 (cross-language replication), 저자/검토자 분리 (author/reviewer separation)
Pedro Sant'Anna — 전문 에이전트 (specialist agents), 계획 우선 프로토콜 (plan-first protocol), 품질 게이트 (quality gates), 비판-수정 루프 (critic-fixer loops), [LEARN] 태그
Jared Black — 인프라 변경을 위한 "break the glass" 프로토콜, 데이터 민감도 규칙, 재현 가능한 프로젝트 템플릿
Antonio Mele — 큐레이션된 경제학자를 위한 AI (AI-for-economists) 리소스, 프로그래밍 방식의 Claude Code 컨트롤러, 과학적 기술 참조
Hugo Sant'Anna(CLO-Author) — 응용 계량 경제학을 위한 오픈 소스 Claude Code 워크플로우, 에이전트, 29개의 슬래시 명령어
Chris Blattman — 학술적 AI 워크플로우 가이드, 비개발자 친화적인 기술 및 에이전트 패턴

Andrej Karpathy — 동료 검토 및 합성을 포함한 멀티 모델 위원회 (multi-model council) (우리의 포크: council-api, council-cli)
rtk-ai — CLI 출력에서 60~90%의 토큰 절약을 위한 RTK 재작성 훅 (rewrite hook)
NPC Worldwide(npcsh) — 지식 그래프 수면/꿈 주기 (knowledge graph sleep/dream cycles), 기억 공고화 기술 (memory consolidation skill)에 영감을 줌
Boris Cherny(ChernyCode) — AI 코딩 어시스턴트 구성 패턴
Jim Christian(aplaceforallmystuff) — 기술 사전 점검 (skill-preflight pre-flight checks), 사후 분석 회고 (postmortem retrospective), 생태계 건강 진단
blader(Claudeception) — 기술 설명 최적화, 매치 후 액션 테이블 (post-match action table), 기술 생성을 위한 솔루션 패턴, 학습 유도 훅 (learning nudge hook)
Anthropic — Claude Code 플랫폼, 8개의 채택된 기술 패턴 (docx, xlsx, pptx, pdf, frontend-design, mcp-builder, webapp-testing, skill-creator)

시스템 생성일: 2026년 1월.

MIT