# galaxy-dawn/claude-scholar architecture

> Architecture diagram of the GitHub repository galaxy-dawn/claude-scholar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/galaxy-dawn/claude-scholar
- Repository: https://github.com/galaxy-dawn/claude-scholar

## Overview

Claude Scholar is a semi-automated academic research and software-development assistant delivered as Claude Code commands, skills, agents, and hooks. A researcher can use its research workflows to find and ingest sources, synthesize literature, analyze results, report evidence, and draft or revise papers; project knowledge can be managed in an Obsidian vault. The README documents these capabilities and several workflow connections, while source excerpts chiefly verify hook behavior and Obsidian knowledge-management utilities, so other implementation-level links are omitted.

Main entry points: [`skills/nature-writing`](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/nature-writing) (Paper writing), [`skills/obsidian-literature-workflow`](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/obsidian-literature-workflow) (Literature workflow), [`hooks/hook-common.js`](https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/hook-common.js) (Hook utilities), [`skills/results-analysis`](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/results-analysis) (Results analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research workflows"]
  node_research_commands["Research commands"]
  node_research_ideation["Research ideation"]
  node_daily_papers["Paper discovery"]
  node_source_ingestion["Source ingestion"]
  node_zotero_bridge["Zotero bridge"]
  node_literature_workflow["Literature workflow"]
  node_literature_canvas["Literature canvas"]
  node_literature_graph["Literature graph"]
  node_results_analysis["Results analysis"]
end

subgraph group_knowledge["Project knowledge"]
  node_project_kb["Project KB<br/>[project_kb.py]"]
  node_kb_common["KB utilities<br/>[kb_common.py]"]
  node_kb_lint["KB linting<br/>[kb_lint.py]"]
end

subgraph group_writing["Writing and publication"]
  node_results_reporting["Results reporting"]
  node_paper_writing["Paper writing"]
  node_paper_polishing["Paper polishing"]
  node_rebuttal["Rebuttal workflow"]
  node_citation_verification["Citation verification"]
  node_publication_figures["Publication figures"]
end

subgraph group_runtime["Assistant runtime"]
  node_session_hooks["Session hooks<br/>[session-start.js]"]
  node_skill_evaluation["Skill evaluation"]
  node_security_guard["Security guard<br/>[security-guard.js]"]
  node_session_summary["Session summary<br/>[session-summary.js]"]
  node_stop_summary["Stop summary<br/>[stop-summary.js]"]
  node_hook_common["Hook utilities<br/>[hook-common.js]"]
end

node_researcher(("Researcher"))
node_vault[("Obsidian vault")]

node_researcher -.->|"starts research"| node_research_commands
node_researcher -.->|"develops ideas"| node_research_ideation
node_researcher -.->|"discovers papers"| node_daily_papers
node_daily_papers -.->|"finds sources"| node_source_ingestion
node_source_ingestion -.->|"feeds synthesis"| node_literature_workflow
node_zotero_bridge -.->|"supports synthesis"| node_literature_workflow
node_literature_workflow -->|"builds canvas"| node_literature_canvas
node_literature_workflow -.->|"builds graph"| node_literature_graph
node_researcher -.->|"analyzes results"| node_results_analysis
node_results_analysis -.->|"reports results"| node_results_reporting
node_results_reporting -.->|"informs writing"| node_paper_writing
node_paper_writing -.->|"refines prose"| node_paper_polishing
node_paper_writing -.->|"supports response"| node_rebuttal
node_paper_writing -.->|"checks citations"| node_citation_verification
node_results_analysis -.->|"supports figures"| node_publication_figures
node_researcher -.->|"manages knowledge"| node_project_kb
node_project_kb -->|"uses utilities"| node_kb_common
node_kb_lint -->|"uses utilities"| node_kb_common
node_project_kb -.->|"updates notes"| node_vault
node_session_hooks -->|"uses utilities"| node_hook_common
node_skill_evaluation -.->|"suggests skills"| node_researcher
node_security_guard -->|"uses utilities"| node_hook_common
node_session_summary -->|"uses utilities"| node_hook_common
node_stop_summary -->|"uses utilities"| node_hook_common
node_session_hooks -->|"shows project status"| node_researcher
node_session_summary -.->|"records project context"| node_vault
node_stop_summary -.->|"shows KB status"| node_vault

click node_research_commands "https://github.com/galaxy-dawn/claude-scholar/tree/main/commands"
click node_research_ideation "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/research-ideation"
click node_daily_papers "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/daily-paper-generator"
click node_source_ingestion "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/obsidian-source-ingestion"
click node_zotero_bridge "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/zotero-obsidian-bridge"
click node_literature_workflow "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/obsidian-literature-workflow"
click node_literature_canvas "https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-literature-workflow/scripts/build_literature_canvas.py"
click node_literature_graph "https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-literature-workflow/scripts/build_literature_graph.py"
click node_results_analysis "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/results-analysis"
click node_project_kb "https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-project-kb-core/scripts/project_kb.py"
click node_kb_common "https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-project-kb-core/scripts/kb_common.py"
click node_kb_lint "https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-project-kb-core/scripts/kb_lint.py"
click node_results_reporting "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/results-report"
click node_paper_writing "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/nature-writing"
click node_paper_polishing "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/nature-polishing"
click node_rebuttal "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/nature-response"
click node_citation_verification "https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/citation-verification/scripts/verify-citations.py"
click node_publication_figures "https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/publication-chart-skill"
click node_session_hooks "https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/session-start.js"
click node_skill_evaluation "https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/skill-forced-eval.js"
click node_security_guard "https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/security-guard.js"
click node_session_summary "https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/session-summary.js"
click node_stop_summary "https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/stop-summary.js"
click node_hook_common "https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/hook-common.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_research_commands,node_research_ideation,node_daily_papers,node_source_ingestion,node_zotero_bridge,node_literature_workflow,node_literature_canvas,node_literature_graph,node_results_analysis toneBlue
class node_project_kb,node_kb_common,node_kb_lint,node_vault toneAmber
class node_results_reporting,node_paper_writing,node_paper_polishing,node_rebuttal,node_citation_verification,node_publication_figures toneMint
class node_session_hooks,node_skill_evaluation,node_security_guard,node_session_summary,node_stop_summary,node_hook_common toneRose
class node_researcher toneIndigo
```

## Components

### Research workflows

- [Research commands](https://github.com/galaxy-dawn/claude-scholar/tree/main/commands): `commands`
- [Research ideation](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/research-ideation): `skills/research-ideation`
- [Paper discovery](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/daily-paper-generator): `skills/daily-paper-generator`
- [Source ingestion](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/obsidian-source-ingestion): `skills/obsidian-source-ingestion`
- [Zotero bridge](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/zotero-obsidian-bridge): `skills/zotero-obsidian-bridge`
- [Literature workflow](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/obsidian-literature-workflow): `skills/obsidian-literature-workflow`
- [Literature canvas](https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-literature-workflow/scripts/build_literature_canvas.py): `skills/obsidian-literature-workflow/scripts/build_literature_canvas.py`
- [Literature graph](https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-literature-workflow/scripts/build_literature_graph.py): `skills/obsidian-literature-workflow/scripts/build_literature_graph.py`
- [Results analysis](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/results-analysis): `skills/results-analysis`

### Project knowledge

- [Project KB](https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-project-kb-core/scripts/project_kb.py): `skills/obsidian-project-kb-core/scripts/project_kb.py`
- [KB utilities](https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-project-kb-core/scripts/kb_common.py): `skills/obsidian-project-kb-core/scripts/kb_common.py`
- [KB linting](https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/obsidian-project-kb-core/scripts/kb_lint.py): `skills/obsidian-project-kb-core/scripts/kb_lint.py`

### Writing and publication

- [Results reporting](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/results-report): `skills/results-report`
- [Paper writing](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/nature-writing): `skills/nature-writing`
- [Paper polishing](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/nature-polishing): `skills/nature-polishing`
- [Rebuttal workflow](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/nature-response): `skills/nature-response`
- [Citation verification](https://github.com/galaxy-dawn/claude-scholar/blob/main/skills/citation-verification/scripts/verify-citations.py): `skills/citation-verification/scripts/verify-citations.py`
- [Publication figures](https://github.com/galaxy-dawn/claude-scholar/tree/main/skills/publication-chart-skill): `skills/publication-chart-skill`

### Assistant runtime

- [Session hooks](https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/session-start.js): `hooks/session-start.js`
- [Skill evaluation](https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/skill-forced-eval.js): `hooks/skill-forced-eval.js`
- [Security guard](https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/security-guard.js): `hooks/security-guard.js`
- [Session summary](https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/session-summary.js): `hooks/session-summary.js`
- [Stop summary](https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/stop-summary.js): `hooks/stop-summary.js`
- [Hook utilities](https://github.com/galaxy-dawn/claude-scholar/blob/main/hooks/hook-common.js): `hooks/hook-common.js`

### Other components

- **Researcher**
- **Obsidian vault**

## Connections

- Researcher → Research commands: starts research (evidence: `README.md`)
- Researcher → Research ideation: develops ideas (evidence: `README.md`)
- Researcher → Paper discovery: discovers papers (evidence: `README.md`)
- Paper discovery → Source ingestion: finds sources (evidence: `README.md`)
- Source ingestion → Literature workflow: feeds synthesis (evidence: `README.md`)
- Zotero bridge → Literature workflow: supports synthesis (evidence: `README.md`)
- Literature workflow → Literature canvas: builds canvas (evidence: `skills/obsidian-literature-workflow/scripts/build_literature_canvas.py`)
- Literature workflow → Literature graph: builds graph (evidence: `README.md`)
- Researcher → Results analysis: analyzes results (evidence: `README.md`)
- Results analysis → Results reporting: reports results (evidence: `README.md`)
- Results reporting → Paper writing: informs writing (evidence: `README.md`)
- Paper writing → Paper polishing: refines prose (evidence: `README.md`)
- Paper writing → Rebuttal workflow: supports response (evidence: `README.md`)
- Paper writing → Citation verification: checks citations (evidence: `README.md`)
- Results analysis → Publication figures: supports figures (evidence: `README.md`)
- Researcher → Project KB: manages knowledge (evidence: `README.md`)
- Project KB → KB utilities: uses utilities (evidence: `skills/obsidian-project-kb-core/scripts/project_kb.py`)
- KB linting → KB utilities: uses utilities (evidence: `skills/obsidian-project-kb-core/scripts/kb_lint.py`)
- Project KB → Obsidian vault: updates notes (evidence: `README.md`)
- Session hooks → Hook utilities: uses utilities (evidence: `hooks/session-start.js`)
- Skill evaluation → Researcher: suggests skills (evidence: `README.md`)
- Security guard → Hook utilities: uses utilities (evidence: `hooks/security-guard.js`)
- Session summary → Hook utilities: uses utilities (evidence: `hooks/session-summary.js`)
- Stop summary → Hook utilities: uses utilities (evidence: `hooks/stop-summary.js`)
- Session hooks → Researcher: shows project status (evidence: `hooks/session-start.js`)
- Session summary → Obsidian vault: records project context (evidence: `hooks/session-summary.js`)
- Stop summary → Obsidian vault: shows KB status (evidence: `hooks/stop-summary.js`)
