# callmerol/research-os-studio architecture

> Architecture diagram of the GitHub repository callmerol/research-os-studio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/callmerol/research-os-studio
- Repository: https://github.com/callmerol/research-os-studio

## Overview

Research OS Studio is a provider-neutral suite of Agent Skills for researcher-controlled research workflows, not a conventional application or service. A researcher invokes skills through an AI agent; the documented workflow moves through idea discovery, experimental or theoretical validation, and paper writing and review, stopping for researcher decisions between stages. The graph represents the README’s documented skill dispatches and major capabilities. Source sampling covered package metadata and a skill-check script, not the skill instructions, so undocumented runtime wiring is omitted.

Main entry points: [`skills/idea-cycle/idea-discovery/SKILL.md`](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-discovery/SKILL.md) (Idea discovery), [`skills/validation-cycle/experiment-bridge/SKILL.md`](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/experiment-bridge/SKILL.md) (Experiment workflow), [`skills/writing-cycle/paper-writing/SKILL.md`](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-writing/SKILL.md) (Paper writing), [`skills/general/setup-research-os/SKILL.md`](https://github.com/callmerol/research-os-studio/blob/main/skills/general/setup-research-os/SKILL.md) (Workspace setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_general["Workspace and routing"]
  node_setup["Workspace setup<br/>[SKILL.md]"]
  node_router["Skill router<br/>[SKILL.md]"]
end

subgraph group_idea["Idea cycle"]
  node_discovery["Idea discovery<br/>[SKILL.md]"]
  node_literature["Literature review<br/>[SKILL.md]"]
  node_generation["Idea generation<br/>[SKILL.md]"]
  node_creative["Creative thinking<br/>[SKILL.md]"]
  node_novelty["Novelty check<br/>[SKILL.md]"]
  node_idea_review["Idea review<br/>[SKILL.md]"]
  node_refinement["Idea refinement<br/>[SKILL.md]"]
end

subgraph group_validation["Validation cycle"]
  node_plan["Experiment planning<br/>[SKILL.md]"]
  node_bridge["Experiment workflow<br/>[SKILL.md]"]
  node_run["Experiment run<br/>[SKILL.md]"]
  node_monitor["Run monitoring<br/>[SKILL.md]"]
  node_health["Training health<br/>[SKILL.md]"]
  node_audit["Experiment audit<br/>[SKILL.md]"]
  node_claim["Result to claim<br/>[SKILL.md]"]
  node_derive["Formula derivation<br/>[SKILL.md]"]
  node_proof_writer["Proof writing<br/>[SKILL.md]"]
  node_proof_review["Proof review<br/>[SKILL.md]"]
  node_proof_repair["Proof repair<br/>[SKILL.md]"]
  node_proof_orchestrator["Proof orchestration<br/>[SKILL.md]"]
end

subgraph group_writing["Writing cycle"]
  node_paper["Paper writing<br/>[SKILL.md]"]
  node_ml_paper["ML paper writing<br/>[SKILL.md]"]
  node_systems_paper["Systems paper writing<br/>[SKILL.md]"]
  node_plotting["Academic plotting<br/>[SKILL.md]"]
  node_compile["Paper compilation<br/>[SKILL.md]"]
  node_compile_repair["Compile repair<br/>[SKILL.md]"]
  node_citation["Citation audit<br/>[SKILL.md]"]
  node_citation_fixes["Citation fixes<br/>[SKILL.md]"]
  node_claim_audit["Paper claim audit<br/>[SKILL.md]"]
  node_stress_test["Claim stress test<br/>[SKILL.md]"]
  node_rebuttal["Rebuttal<br/>[SKILL.md]"]
end

node_researcher(("Researcher"))
node_agent(("AI agent"))

node_researcher -->|"invokes skill"| node_agent
node_agent -->|"runs setup"| node_setup
node_agent -->|"requests guidance"| node_router
node_researcher -->|"starts idea cycle"| node_discovery
node_discovery -->|"calls"| node_literature
node_discovery -->|"calls"| node_generation
node_discovery -->|"calls as needed"| node_creative
node_discovery -->|"calls"| node_novelty
node_discovery -->|"calls"| node_idea_review
node_discovery -->|"calls"| node_refinement
node_researcher -->|"starts validation"| node_plan
node_researcher -->|"starts execution"| node_bridge
node_bridge -->|"runs experiments"| node_run
node_bridge -->|"monitors runs"| node_monitor
node_bridge -->|"checks training"| node_health
node_bridge -->|"audits evidence"| node_audit
node_researcher -->|"extracts claims"| node_claim
node_researcher -->|"starts theory path"| node_derive
node_researcher -->|"drafts proof"| node_proof_writer
node_researcher -->|"reviews proof"| node_proof_review
node_researcher -->|"repairs proof"| node_proof_repair
node_researcher -->|"orchestrates proof"| node_proof_orchestrator
node_researcher -->|"starts writing"| node_paper
node_researcher -->|"starts ML writing"| node_ml_paper
node_researcher -->|"starts systems writing"| node_systems_paper
node_paper -->|"includes plotting"| node_plotting
node_paper -->|"checks compilation"| node_compile
node_researcher -->|"requests repair"| node_compile_repair
node_researcher -->|"audits citations"| node_citation
node_researcher -->|"applies fixes"| node_citation_fixes
node_researcher -->|"audits claims"| node_claim_audit
node_researcher -->|"stress-tests claims"| node_stress_test
node_researcher -->|"prepares response"| node_rebuttal

click node_setup "https://github.com/callmerol/research-os-studio/blob/main/skills/general/setup-research-os/SKILL.md"
click node_router "https://github.com/callmerol/research-os-studio/blob/main/skills/general/ask-research-os/SKILL.md"
click node_discovery "https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-discovery/SKILL.md"
click node_literature "https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/research-lit/SKILL.md"
click node_generation "https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-generation/SKILL.md"
click node_creative "https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/creative-thinking-for-research/SKILL.md"
click node_novelty "https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/novelty-check/SKILL.md"
click node_idea_review "https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-review/SKILL.md"
click node_refinement "https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-refinement/SKILL.md"
click node_plan "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/experiment-plan/SKILL.md"
click node_bridge "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/experiment-bridge/SKILL.md"
click node_run "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/run-experiment/SKILL.md"
click node_monitor "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/monitor-experiment/SKILL.md"
click node_health "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/training-health-check/SKILL.md"
click node_audit "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/experiment-audit/SKILL.md"
click node_claim "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/result-to-claim/SKILL.md"
click node_derive "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/formula-derivation/SKILL.md"
click node_proof_writer "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-writer/SKILL.md"
click node_proof_review "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-review/SKILL.md"
click node_proof_repair "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-repair/SKILL.md"
click node_proof_orchestrator "https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-orchestrator/SKILL.md"
click node_paper "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-writing/SKILL.md"
click node_ml_paper "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/ml-paper-writing/SKILL.md"
click node_systems_paper "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/systems-paper-writing/SKILL.md"
click node_plotting "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/academic-plotting/SKILL.md"
click node_compile "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-compile/SKILL.md"
click node_compile_repair "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-compile-repair/SKILL.md"
click node_citation "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/citation-audit/SKILL.md"
click node_citation_fixes "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/apply-citation-fixes/SKILL.md"
click node_claim_audit "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-claim-audit/SKILL.md"
click node_stress_test "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/claim-stress-test/SKILL.md"
click node_rebuttal "https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/rebuttal/SKILL.md"

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_setup,node_router toneBlue
class node_discovery,node_literature,node_generation,node_creative,node_novelty,node_idea_review,node_refinement toneAmber
class node_plan,node_bridge,node_run,node_monitor,node_health,node_audit,node_claim,node_derive,node_proof_writer,node_proof_review,node_proof_repair,node_proof_orchestrator toneMint
class node_paper,node_ml_paper,node_systems_paper,node_plotting,node_compile,node_compile_repair,node_citation,node_citation_fixes,node_claim_audit,node_stress_test,node_rebuttal toneRose
class node_researcher,node_agent toneIndigo
```

## Components

### Workspace and routing

- [Workspace setup](https://github.com/callmerol/research-os-studio/blob/main/skills/general/setup-research-os/SKILL.md): `skills/general/setup-research-os/SKILL.md`
- [Skill router](https://github.com/callmerol/research-os-studio/blob/main/skills/general/ask-research-os/SKILL.md): `skills/general/ask-research-os/SKILL.md`

### Idea cycle

- [Idea discovery](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-discovery/SKILL.md): `skills/idea-cycle/idea-discovery/SKILL.md`
- [Literature review](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/research-lit/SKILL.md): `skills/idea-cycle/research-lit/SKILL.md`
- [Idea generation](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-generation/SKILL.md): `skills/idea-cycle/idea-generation/SKILL.md`
- [Creative thinking](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/creative-thinking-for-research/SKILL.md): `skills/idea-cycle/creative-thinking-for-research/SKILL.md`
- [Novelty check](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/novelty-check/SKILL.md): `skills/idea-cycle/novelty-check/SKILL.md`
- [Idea review](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-review/SKILL.md): `skills/idea-cycle/idea-review/SKILL.md`
- [Idea refinement](https://github.com/callmerol/research-os-studio/blob/main/skills/idea-cycle/idea-refinement/SKILL.md): `skills/idea-cycle/idea-refinement/SKILL.md`

### Validation cycle

- [Experiment planning](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/experiment-plan/SKILL.md): `skills/validation-cycle/experiment-plan/SKILL.md`
- [Experiment workflow](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/experiment-bridge/SKILL.md): `skills/validation-cycle/experiment-bridge/SKILL.md`
- [Experiment run](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/run-experiment/SKILL.md): `skills/validation-cycle/run-experiment/SKILL.md`
- [Run monitoring](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/monitor-experiment/SKILL.md): `skills/validation-cycle/monitor-experiment/SKILL.md`
- [Training health](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/training-health-check/SKILL.md): `skills/validation-cycle/training-health-check/SKILL.md`
- [Experiment audit](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/experiment-audit/SKILL.md): `skills/validation-cycle/experiment-audit/SKILL.md`
- [Result to claim](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/result-to-claim/SKILL.md): `skills/validation-cycle/result-to-claim/SKILL.md`
- [Formula derivation](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/formula-derivation/SKILL.md): `skills/validation-cycle/formula-derivation/SKILL.md`
- [Proof writing](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-writer/SKILL.md): `skills/validation-cycle/proof-writer/SKILL.md`
- [Proof review](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-review/SKILL.md): `skills/validation-cycle/proof-review/SKILL.md`
- [Proof repair](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-repair/SKILL.md): `skills/validation-cycle/proof-repair/SKILL.md`
- [Proof orchestration](https://github.com/callmerol/research-os-studio/blob/main/skills/validation-cycle/proof-orchestrator/SKILL.md): `skills/validation-cycle/proof-orchestrator/SKILL.md`

### Writing cycle

- [Paper writing](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-writing/SKILL.md): `skills/writing-cycle/paper-writing/SKILL.md`
- [ML paper writing](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/ml-paper-writing/SKILL.md): `skills/writing-cycle/ml-paper-writing/SKILL.md`
- [Systems paper writing](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/systems-paper-writing/SKILL.md): `skills/writing-cycle/systems-paper-writing/SKILL.md`
- [Academic plotting](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/academic-plotting/SKILL.md): `skills/writing-cycle/academic-plotting/SKILL.md`
- [Paper compilation](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-compile/SKILL.md): `skills/writing-cycle/paper-compile/SKILL.md`
- [Compile repair](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-compile-repair/SKILL.md): `skills/writing-cycle/paper-compile-repair/SKILL.md`
- [Citation audit](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/citation-audit/SKILL.md): `skills/writing-cycle/citation-audit/SKILL.md`
- [Citation fixes](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/apply-citation-fixes/SKILL.md): `skills/writing-cycle/apply-citation-fixes/SKILL.md`
- [Paper claim audit](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/paper-claim-audit/SKILL.md): `skills/writing-cycle/paper-claim-audit/SKILL.md`
- [Claim stress test](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/claim-stress-test/SKILL.md): `skills/writing-cycle/claim-stress-test/SKILL.md`
- [Rebuttal](https://github.com/callmerol/research-os-studio/blob/main/skills/writing-cycle/rebuttal/SKILL.md): `skills/writing-cycle/rebuttal/SKILL.md`

### Other components

- **Researcher**
- **AI agent**

## Connections

- Researcher → AI agent: invokes skill
- AI agent → Workspace setup: runs setup
- AI agent → Skill router: requests guidance
- Researcher → Idea discovery: starts idea cycle
- Idea discovery → Literature review: calls
- Idea discovery → Idea generation: calls
- Idea discovery → Creative thinking: calls as needed
- Idea discovery → Novelty check: calls
- Idea discovery → Idea review: calls
- Idea discovery → Idea refinement: calls
- Researcher → Experiment planning: starts validation
- Researcher → Experiment workflow: starts execution
- Experiment workflow → Experiment run: runs experiments
- Experiment workflow → Run monitoring: monitors runs
- Experiment workflow → Training health: checks training
- Experiment workflow → Experiment audit: audits evidence
- Researcher → Result to claim: extracts claims
- Researcher → Formula derivation: starts theory path
- Researcher → Proof writing: drafts proof
- Researcher → Proof review: reviews proof
- Researcher → Proof repair: repairs proof
- Researcher → Proof orchestration: orchestrates proof
- Researcher → Paper writing: starts writing
- Researcher → ML paper writing: starts ML writing
- Researcher → Systems paper writing: starts systems writing
- Paper writing → Academic plotting: includes plotting
- Paper writing → Paper compilation: checks compilation
- Researcher → Compile repair: requests repair
- Researcher → Citation audit: audits citations
- Researcher → Citation fixes: applies fixes
- Researcher → Paper claim audit: audits claims
- Researcher → Claim stress test: stress-tests claims
- Researcher → Rebuttal: prepares response