ARS-Codex workflows for research, academic writing, manuscript review, research-to-paper pipelines, and experiment planning. Use when the user asks for deep research, literature review, systematic review, meta-analysis, research question refinement, academic paper drafting, paper revision, citation

ARS Codex This is a Codex adapter for the ARS suite. The vendored ARS content lives under ars/ ; keep it as source material and route through this file first. Versioning This Codex package is version 0.1.28 . The repo root VERSION , this SKILL.md metadata version, and manifest.json adapter version must match. Vendored ARS suite versions are tracked separately by source repository commit in manifest.json . First Rule Do not load the whole suite by default. Select one workflow, read that workflow's WORKFLOW.md , then load only the agent, reference, template, or shared files needed for the user's current stage. The internal workflow entry files are named WORKFLOW.md , not SKILL.md , so Codex registers only this root router skill instead of exposing every vendored upstream workflow as a separate skill. Workflow Router Choose the workflow by intent: User intent Read first Deep research, literature review, systematic review, meta analysis, fact checking, research question refinement ars/deep research/WORKFLOW.md Academic paper writing, paper outline, abstract, revision, citation formatting, AI disclosure, LaTeX/DOCX/PDF formatting guidance ars/academic paper/WORKFLOW.md Paper review, peer review simulation, editorial decision, reviewer calibration, re review after revision ars/academic paper reviewer/WORKFLOW.md End to end research to paper pipeline, integrity gate, staged review/revision/finalization workflow ars/academic pipeline/WORKFLOW.md Experiment planning, code experiment execution plan, human study protocol, statistical interpretation, reproducibility validation ars/experiment agent/WORKFLOW.md If the request spans multiple workflows, start with ars/academic pipeline/WORKFLOW.md unless the user clearly asked for a single phase. Paper Topic Scoping Override Apply this override before the general paper/pipeline routing rule and before the Claude Style Alias Router below. The override applies regardless of whether the user invokes ARS via natural language or via an ars alias. If the user says they want to write a paper, thesis, proposal, article, journal article, or manuscript, but they only provide a broad topic, tentative title, research interest, or "題目/主題/方向" and do not provide a clear, answerable research question, route to ars/deep research/WORKFLOW.md in socratic mode first. This matches the upstream ARS experience where vague paper topic requests start with SCR/Socratic narrowing instead of immediate outline or drafting. Treat these as Socratic triggers even when the wording contains paper writing intent: "I want to write a paper on ..." "I have a paper topic/title ..." "我想做一篇論文，題目是..." "我有一個研究方向/主題，但還不確定問題" "幫我想論文題目/收斂研究問題" "논문을 쓰고 싶은데 연구 질문이 아직 명확하지 않아" "논문 주제/연구 방향은 있지만 무엇을 연구할지 모르겠어" First response in this path: 1. State that the request is being routed to deep research socratic mode because the research question is not yet precise. 2. Ask 3 5 Socratic narrowing questions using socratic mentor agent and research question agent guidance. 3. Do not produce an outline, draft, literature review, or full pipeline dashboard until the user has converged on at least one candidate RQ. Route directly to ars/academic paper/WORKFLOW.md only when the user already has a clear RQ, approved study frame, data/results, literature matrix, draft, or explicitly asks to skip scoping and proceed to outline/drafting. Route to ars/academic pipeline/WORKFLOW.md only when the user explicitly asks for the full research to paper pipeline or says to continue after Socratic scoping. Claude Style Alias Router Codex does not install Claude slash commands, but this package emulates their intent. If the user's request starts with a slash alias ( /ars plan ) or a plain alias ( ars plan ), treat it as a mode shortcut, strip the alias token from the task text, read the matching ars/commands/ars .md prompt recipe, then route to the workflow WORKFLOW.md below. The model: field in command frontmatter is a Claude routing hint only. Codex uses the current model unless the user explicitly requests another model. Alias Read command recipe Then route to /ars plan , ars plan ars/commands/ars plan.md ars/academic paper/WORKFLOW.md in plan mode /ars outline , ars outline ars/commands/ars outline.md ars/academic paper/WORKFLOW.md in outline only mode /ars abstract , ars abstract ars/commands/ars abstract.md ars/academic paper/WORKFLOW.md in abstract only mode /ars lit review , ars lit review ars/commands/ars lit review.md ars/academic paper/WORKFLOW.md in lit review mode; if the user wants source discovery and synthesis instead, route to ars/deep research/WORKFLOW.md in lit review mode /ars 3w , ars 3w ars/commands/ars 3w.md ars/deep research/WORKFLOW.md in three way scan mode /ars citation check , ars citation check ars/commands/ars citation check.md ars/academic paper/WORKFLOW.md in citation check mode /ars disclosure , ars disclosure ars/commands/ars disclosure.md ars/academic paper/WORKFLOW.md in disclosure mode /ars format convert , ars format convert ars/commands/ars format convert.md ars/academic paper/WORKFLOW.md in format convert mode /ars revision coach , ars revision coach ars/commands/ars revision coach.md ars/academic paper/WORKFLOW.md in revision coach mode /ars revision , ars revision ars/commands/ars revision.md ars/academic paper/WORKFLOW.md in revision mode /ars rebuttal audit , ars rebuttal audit ars/commands/ars rebuttal audit.md ars/academic paper/WORKFLOW.md in rebuttal audit mode; requires both reviewer comments and an existing response draft /ars reviewer , ars reviewer ars/commands/ars reviewer.md ars/academic paper reviewer/WORKFLOW.md in full mode unless another reviewer mode is explicit /ars mark read , ars mark read ars/commands/ars mark read.md Record a user attested read declaration against the active Material Passport; every new mark requires a user owned read scope , with locators allowed only for sections scope /ars unmark read , ars unmark read ars/commands/ars unmark read.md Rescind a prior human read mark against the active Material Passport /ars cache invalidate , ars cache invalidate ars/commands/ars cache invalidate.md Invalidate cached verification entries for one citation key /ars full , ars full ars/commands/ars full.md ars/academic pipeline/WORKFLOW.md If the request body after the alias is a vague topic, tentative title, research direction, or "題目/主題/方向" without a clear research question, defer to the Paper Topic Scoping Override above before routing to the alias's target mode. This applies to ars plan , ars outline , ars abstract , ars lit review , and ars full . If the Codex client reserves slash prefixed input before it reaches the model, tell the user to use the plain alias form, for example ars plan my topic . Codex Runtime Mapping The upstream ARS files were written for Claude Code. Apply these mappings when using them in Codex: Upstream wording Codex behavior Agent Team, agent, dispatch, handoff Read the referenced agents/ .md file as a role or phase prompt and perform that phase inline. Agent tool, Task tool, subagent Do not spawn agents automatically. Only use Codex subagents when the user explicitly asks for delegation or parallel agents. If the optional full runtime profile is enabled, use codex/full runtime manifest.json and codex/agents/ .md as the adapter contract. AskUserQuestion Ask concise clarification questions, or use Codex's structured user input tool when available in the active mode. WebSearch Use Codex web browsing for current facts, source verification, citation checks, and external evidence. Provide source links. Bash, Write, Edit Treat as capability descriptions, not required tool names. Follow Codex safety rules and the user's filesystem constraints. Agent frontmatter tools: Read, Write, Edit, Grep, Glob Preserve this as a least privilege role boundary. The three protected top level agent roles do not receive Bash or network transport when dispatched separately; inline execution must not use those roles to widen the current task's authority. Claude, Claude Code, model specific wording Interpret as "the current Codex agent" unless the text is part of a disclosure template or historical example. ARS MODEL TIERING=economy quality boost Unset remains the default and preserves current model behavior. The upstream relative Opus/Sonnet tier names are not hard mapped to Codex model ids. Apply tiering only when the active Codex runtime supports an explicit per dispatch model override; otherwise announce a one line no op and keep every role on the active model. Use ars/shared/model tiering.md and ars/scripts/model tiering manifest.json as the classification contract. ARS CROSS MODEL , ARS CROSS MODEL REASONING EFFORT , ARS OPENAI COMPAT BASE URL , ARS OPENAI COMPAT API KEY Treat upstream secondary model dispatch instructions as no op unless the user explicitly asks for cross model review. When explicitly enabled in this Codex package, follow ars/shared/cross model verification.md : identify the provider/model/id status/content class, obtain explicit user consent before any external upload, preserve risk stratified sampling and blind disagreement checkpoint rules, and call only the configured provider API. A dispatched owner emits the canonical [CROSS MODEL HANDOFF v1] envelope; the dispatching Codex context validates it, sends only the payload, applies the mechanical result routing, and returns judgment work to the owner. In reviewer full mode, the consented cross model track swaps the existing Reviewer 2 seat rather than adding a reviewer; re review runs the independent Priority 1 judge pass and records the Judge Record. Disclose single family or fallback execution and never simulate either track through the active Codex model. ARS CROSS MODEL TRANSPORT=codex , scripts/cross model codex transport.py This explicit selector is limited to contained, one reference citation checks at Stage 2.5 / 4.5 through a ChatGPT subscription Codex app server. Require Codex CLI 0.147.0 or newer, ARS CROSS MODEL , the exact Logged in using ChatGPT attestation on stdout or stderr, and the normal provider/content/cost consent gate; do not accept caller authored prompts or paths, widen the selector to reviewer/DA/calibration/re review/handoff calls, or fall back automatically to an API. The provider schema omits unsupported uniqueItems , but local validation still rejects duplicate sources. Keep code mode disabled while allowing the bounded search host required by the standalone search tool; the closed event allowlist remains authoritative. A result is accepted only after turn/completed , clean process exit, and stdout/stderr EOF; late forbidden or malformed events, drain timeout, nonzero exit, reader failure, or stderr overflow fail visibly. S2 API KEY , OPENALEX API KEY , OPENALEX POLITE EMAIL , CROSSREF POLITE EMAIL These are optional upstream bibliographic lookup settings. Use them only when the user explicitly runs contamination signal migration or programmatic reference verification; normal Codex routing does not require them. Never log credential bearing query strings, and do not use browser retrieval to bypass API rate limits. ARS VERIFICATION CACHE PATH , ARS CACHE STALE ADVISORY DAYS , ARS CACHE REVALIDATE These configure the local SQLite citation verification cache, the advisory only stale row threshold (default 30 days; 0 disables), and opt in live re validation. Preserve cached by default behavior when the

academic-research-suite