# imbad0202/academic-research-skills-codex architecture

> Architecture diagram of the GitHub repository imbad0202/academic-research-skills-codex, 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/imbad0202/academic-research-skills-codex
- Repository: https://github.com/imbad0202/academic-research-skills-codex

## Overview

ARS-Codex packages a Codex-native academic research skill. Users invoke the suite and the router selects deep research, paper production, manuscript review, or an end-to-end research-to-paper workflow; outputs include research artifacts, manuscripts, reviews, and submission materials. The tree shows substantial discovery, citation, and claim-audit tooling, while the sampled audit module confirms retrieval and judging are injected dependencies. Workflow internals are largely unsampled, so only README-documented routing and workflow scope are connected.

Main entry points: [`skills/academic-research-suite/SKILL.md`](https://github.com/imbad0202/academic-research-skills-codex/blob/main/skills/academic-research-suite/SKILL.md) (ARS suite router), [`skills/academic-research-suite/ars/academic-pipeline`](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-pipeline) (Research pipeline), [`skills/academic-research-suite/ars/deep-research`](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/deep-research) (Deep research), [`skills/academic-research-suite/ars/academic-paper`](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-paper) (Academic paper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Codex entry"]
  node_suite["ARS suite router<br/>[SKILL.md]"]
end

subgraph group_workflows["Research workflows"]
  node_deep_research["Deep research"]
  node_paper["Academic paper"]
  node_reviewer["Paper reviewer"]
  node_pipeline["Research pipeline"]
end

subgraph group_research_tools["Research evidence"]
  node_discovery_clients["Literature clients"]
  node_source_adapters["Library adapters"]
  node_claim_audit["Claim audit"]
  node_citation_checks["Citation checks"]
end

subgraph group_paper_tools["Writing and review"]
  node_draft_revision["Draft revision"]
  node_submission["Submission validation"]
end

node_researcher(("Researcher"))
node_scholarly_services(("Scholarly services"))
node_source_libraries[("Research libraries")]

node_researcher -->|"invokes"| node_suite
node_suite -->|"routes request"| node_deep_research
node_suite -->|"routes request"| node_paper
node_suite -->|"routes request"| node_reviewer
node_suite -->|"routes request"| node_pipeline
node_pipeline -->|"covers research"| node_deep_research
node_pipeline -->|"covers writing"| node_paper
node_pipeline -->|"covers review"| node_reviewer
node_discovery_clients -.->|"queries"| node_scholarly_services
node_source_adapters -.->|"reads sources"| node_source_libraries

click node_suite "https://github.com/imbad0202/academic-research-skills-codex/blob/main/skills/academic-research-suite/SKILL.md"
click node_deep_research "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/deep-research"
click node_paper "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-paper"
click node_reviewer "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-paper-reviewer"
click node_pipeline "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-pipeline"
click node_discovery_clients "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts"
click node_source_adapters "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts/adapters"
click node_claim_audit "https://github.com/imbad0202/academic-research-skills-codex/blob/main/skills/academic-research-suite/ars/scripts/claim_audit_pipeline.py"
click node_citation_checks "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts"
click node_draft_revision "https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts"
click node_submission "https://github.com/imbad0202/academic-research-skills-codex/blob/main/skills/academic-research-suite/ars/scripts/verify_submission_package.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_suite toneBlue
class node_deep_research,node_paper,node_reviewer,node_pipeline,node_source_libraries toneAmber
class node_discovery_clients,node_source_adapters,node_claim_audit,node_citation_checks toneMint
class node_draft_revision,node_submission toneRose
class node_researcher,node_scholarly_services toneIndigo
```

## Components

### Codex entry

- [ARS suite router](https://github.com/imbad0202/academic-research-skills-codex/blob/main/skills/academic-research-suite/SKILL.md): `skills/academic-research-suite/SKILL.md`

### Research workflows

- [Deep research](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/deep-research): `skills/academic-research-suite/ars/deep-research`
- [Academic paper](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-paper): `skills/academic-research-suite/ars/academic-paper`
- [Paper reviewer](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-paper-reviewer): `skills/academic-research-suite/ars/academic-paper-reviewer`
- [Research pipeline](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/academic-pipeline): `skills/academic-research-suite/ars/academic-pipeline`

### Research evidence

- [Literature clients](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts): `skills/academic-research-suite/ars/scripts`
- [Library adapters](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts/adapters): `skills/academic-research-suite/ars/scripts/adapters`
- [Claim audit](https://github.com/imbad0202/academic-research-skills-codex/blob/main/skills/academic-research-suite/ars/scripts/claim_audit_pipeline.py): `skills/academic-research-suite/ars/scripts/claim_audit_pipeline.py`
- [Citation checks](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts): `skills/academic-research-suite/ars/scripts`

### Writing and review

- [Draft revision](https://github.com/imbad0202/academic-research-skills-codex/tree/main/skills/academic-research-suite/ars/scripts): `skills/academic-research-suite/ars/scripts`
- [Submission validation](https://github.com/imbad0202/academic-research-skills-codex/blob/main/skills/academic-research-suite/ars/scripts/verify_submission_package.py): `skills/academic-research-suite/ars/scripts/verify_submission_package.py`

### Other components

- **Researcher**
- **Scholarly services**
- **Research libraries**

## Connections

- Researcher → ARS suite router: invokes
- ARS suite router → Deep research: routes request
- ARS suite router → Academic paper: routes request
- ARS suite router → Paper reviewer: routes request
- ARS suite router → Research pipeline: routes request
- Research pipeline → Deep research: covers research
- Research pipeline → Academic paper: covers writing
- Research pipeline → Paper reviewer: covers review
- Literature clients → Scholarly services: queries
- Library adapters → Research libraries: reads sources