# wanshuiyin/auto-claude-code-research-in-sleep architecture

> Architecture diagram of the GitHub repository wanshuiyin/auto-claude-code-research-in-sleep, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wanshuiyin/auto-claude-code-research-in-sleep
- Repository: https://github.com/wanshuiyin/auto-claude-code-research-in-sleep
- Video tour (about a minute): https://gitdiagram.com/wanshuiyin/auto-claude-code-research-in-sleep/video

## Overview

ARIS is a skill-based research workflow rather than a single runtime platform. Its documented loop has an executor drive research and experiments while an independent model reviews; the broader workflow supports literature research, experiment management, review, and paper/figure production. The tree and excerpts also show a separate read-only session monitor. Several skill and integration branches are documented but unsampled, so their internal links are omitted; dashed, evidence-free edges indicate only documented or unverified high-level workflow relationships.

Main entry points: [`skills`](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/skills) (Research skills), [`skills/paper-poster-html/scripts/_posterly/measure.py`](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/measure.py) (Poster measurement), [`skills/paper-poster-html/scripts/render_preview.py`](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/render_preview.py) (Poster preview), [`skills/paper-poster-html/scripts/style_check.py`](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/style_check.py) (Poster style checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research workflow"]
  node_research_skills["Research skills"]
  node_wiki[("Research wiki<br/>[research_wiki.py]")]
  node_experiment_queue[("Experiment queue<br/>[queue_manager.py]")]
  node_literature_tools["Literature retrieval"]
  node_executor["Research executor<br/>[server.py]"]
end

subgraph group_review["Review and evidence"]
  node_review_skills["Review skills"]
  node_review_gate["Review transitions<br/>[review_gate.py]"]
  node_copilot_evidence["Copilot evidence"]
  node_citation_check["Citation crosscheck<br/>[cx_verify.py]"]
end

subgraph group_artifacts["Paper production"]
  node_poster_renderer["Poster rendering<br/>[render.py]"]
  node_poster_canvas["Poster canvas<br/>[canvas.py]"]
  node_poster_measure["Poster measurement<br/>[measure.py]"]
  node_poster_text["Poster text utilities<br/>[textutil.py]"]
  node_poster_preview["Poster preview<br/>[render_preview.py]"]
  node_poster_style["Poster style checks<br/>[style_check.py]"]
  node_figure_spec["Figure specification<br/>[figure_renderer.py]"]
  node_illustration["Image illustration"]
end

subgraph group_integrations["Model integrations"]
  node_review_backends["Reviewer backends"]
end

subgraph group_monitor["Session monitor"]
  node_monitor_scanner["Session scanner<br/>[scanner.py]"]
  node_monitor_widget["Floating widget<br/>[widget.py]"]
  node_monitor_ticker["Terminal ticker<br/>[ticker.py]"]
  node_monitor_focus["Terminal focus<br/>[focus.py]"]
end

node_researcher(("Researcher"))

node_researcher -.->|"starts research"| node_research_skills
node_research_skills -.->|"directs"| node_executor
node_executor -.->|"runs experiments"| node_experiment_queue
node_research_skills -->|"delegates ingest"| node_wiki
node_research_skills -.->|"retrieves literature"| node_literature_tools
node_executor -.->|"submits for review"| node_review_backends
node_review_skills -.->|"evaluates round"| node_review_gate
node_review_gate -->|"loads evidence"| node_copilot_evidence
node_review_skills -.->|"checks citations"| node_citation_check
node_poster_preview -->|"uses rendering"| node_poster_renderer
node_poster_preview -->|"resolves canvas"| node_poster_canvas
node_poster_preview -->|"uses utilities"| node_poster_text
node_poster_measure -->|"resolves canvas"| node_poster_canvas
node_poster_measure -->|"uses rendering"| node_poster_renderer
node_poster_measure -->|"uses utilities"| node_poster_text
node_poster_style -->|"uses utilities"| node_poster_canvas
node_poster_style -->|"uses rendering"| node_poster_renderer
node_poster_style -->|"uses utilities"| node_poster_text
node_researcher -.->|"views session status"| node_monitor_widget
node_monitor_widget -->|"scans sessions"| node_monitor_scanner
node_monitor_widget -->|"raises terminal"| node_monitor_focus
node_monitor_ticker -->|"scans sessions"| node_monitor_scanner

click node_research_skills "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/skills"
click node_wiki "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/tools/research_wiki.py"
click node_experiment_queue "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/experiment-queue/scripts/queue_manager.py"
click node_literature_tools "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/tools"
click node_executor "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/mcp-servers/codex-exec/server.py"
click node_review_skills "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/skills"
click node_review_gate "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/tools/review_gate.py"
click node_copilot_evidence "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/tools/copilot_native_evidence.py"
click node_review_backends "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/mcp-servers"
click node_citation_check "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/citation-crosscheck/scripts/cx_verify.py"
click node_poster_renderer "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/render.py"
click node_poster_canvas "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/canvas.py"
click node_poster_measure "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/measure.py"
click node_poster_text "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/textutil.py"
click node_poster_preview "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/render_preview.py"
click node_poster_style "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/style_check.py"
click node_figure_spec "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/figure-spec/scripts/figure_renderer.py"
click node_illustration "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-illustration-image2/scripts/paper_illustration_image2.py"
click node_monitor_scanner "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/scanner.py"
click node_monitor_widget "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/widget.py"
click node_monitor_ticker "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/ticker.py"
click node_monitor_focus "https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/focus.py"

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_skills,node_wiki,node_experiment_queue,node_literature_tools,node_executor toneBlue
class node_review_skills,node_review_gate,node_copilot_evidence,node_citation_check toneAmber
class node_poster_renderer,node_poster_canvas,node_poster_measure,node_poster_text,node_poster_preview,node_poster_style,node_figure_spec,node_illustration toneMint
class node_review_backends toneRose
class node_monitor_scanner,node_monitor_widget,node_monitor_ticker,node_monitor_focus,node_researcher toneIndigo
```

## Components

### Research workflow

- [Research skills](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/skills): `skills`
- [Research wiki](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/tools/research_wiki.py): `tools/research_wiki.py`
- [Experiment queue](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/experiment-queue/scripts/queue_manager.py): `skills/experiment-queue/scripts/queue_manager.py`
- [Literature retrieval](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/tools): `tools`
- [Research executor](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/mcp-servers/codex-exec/server.py): `mcp-servers/codex-exec/server.py`

### Review and evidence

- [Review skills](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/skills): `skills`
- [Review transitions](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/tools/review_gate.py): `tools/review_gate.py`
- [Copilot evidence](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/tools/copilot_native_evidence.py): `tools/copilot_native_evidence.py`
- [Citation crosscheck](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/citation-crosscheck/scripts/cx_verify.py): `skills/citation-crosscheck/scripts/cx_verify.py`

### Paper production

- [Poster rendering](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/render.py): `skills/paper-poster-html/scripts/_posterly/render.py`
- [Poster canvas](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/canvas.py): `skills/paper-poster-html/scripts/_posterly/canvas.py`
- [Poster measurement](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/measure.py): `skills/paper-poster-html/scripts/_posterly/measure.py`
- [Poster text utilities](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/_posterly/textutil.py): `skills/paper-poster-html/scripts/_posterly/textutil.py`
- [Poster preview](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/render_preview.py): `skills/paper-poster-html/scripts/render_preview.py`
- [Poster style checks](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-poster-html/scripts/style_check.py): `skills/paper-poster-html/scripts/style_check.py`
- [Figure specification](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/figure-spec/scripts/figure_renderer.py): `skills/figure-spec/scripts/figure_renderer.py`
- [Image illustration](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/skills/paper-illustration-image2/scripts/paper_illustration_image2.py): `skills/paper-illustration-image2/scripts/paper_illustration_image2.py`

### Model integrations

- [Reviewer backends](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/tree/main/mcp-servers): `mcp-servers`

### Session monitor

- [Session scanner](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/scanner.py): `aris-monitor/scanner.py`
- [Floating widget](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/widget.py): `aris-monitor/widget.py`
- [Terminal ticker](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/ticker.py): `aris-monitor/ticker.py`
- [Terminal focus](https://github.com/wanshuiyin/auto-claude-code-research-in-sleep/blob/main/aris-monitor/focus.py): `aris-monitor/focus.py`

### Other components

- **Researcher**

## Connections

- Researcher → Research skills: starts research
- Research skills → Research executor: directs (evidence: `README.md`)
- Research executor → Experiment queue: runs experiments
- Research skills → Research wiki: delegates ingest (evidence: `tools/research_wiki.py`)
- Research skills → Literature retrieval: retrieves literature
- Research executor → Reviewer backends: submits for review (evidence: `README.md`)
- Review skills → Review transitions: evaluates round
- Review transitions → Copilot evidence: loads evidence (evidence: `tools/review_gate.py`)
- Review skills → Citation crosscheck: checks citations
- Poster preview → Poster rendering: uses rendering (evidence: `skills/paper-poster-html/scripts/render_preview.py`)
- Poster preview → Poster canvas: resolves canvas (evidence: `skills/paper-poster-html/scripts/render_preview.py`)
- Poster preview → Poster text utilities: uses utilities (evidence: `skills/paper-poster-html/scripts/render_preview.py`)
- Poster measurement → Poster canvas: resolves canvas (evidence: `skills/paper-poster-html/scripts/_posterly/measure.py`)
- Poster measurement → Poster rendering: uses rendering (evidence: `skills/paper-poster-html/scripts/_posterly/measure.py`)
- Poster measurement → Poster text utilities: uses utilities (evidence: `skills/paper-poster-html/scripts/_posterly/measure.py`)
- Poster style checks → Poster canvas: uses utilities (evidence: `skills/paper-poster-html/scripts/style_check.py`)
- Poster style checks → Poster rendering: uses rendering (evidence: `skills/paper-poster-html/scripts/style_check.py`)
- Poster style checks → Poster text utilities: uses utilities (evidence: `skills/paper-poster-html/scripts/style_check.py`)
- Researcher → Floating widget: views session status (evidence: `README.md`)
- Floating widget → Session scanner: scans sessions (evidence: `aris-monitor/widget.py`)
- Floating widget → Terminal focus: raises terminal (evidence: `aris-monitor/widget.py`)
- Terminal ticker → Session scanner: scans sessions (evidence: `aris-monitor/ticker.py`)
