ARIS Agent Guide

ARIS Agent Guide

**For AI agents reading this repo.** If you are a human, see [README.md](README.md).

ARIS is a research harness: composable Markdown skills that orchestrate the ML research lifecycle through cross-model adversarial collaboration.

How to Invoke Skills

**Claude Code / Cursor / Trae:**

/skill-name "arguments" — key: value, key2: value2

**Codex CLI:**

/skill-name "arguments" — key: value

Codex skills are in `skills/skills-codex/`.

Common Parameters

Every skill accepts:

— effort: lite | balanced | max | beast      # work intensity (default: balanced)
— human checkpoint: true | false             # pause for approval (default: false)
— AUTO_PROCEED: true | false                 # auto-continue at gates (default: true)

Workflow-specific:

— difficulty: medium | hard | nightmare      # reviewer adversarial level
— venue: ICLR | NeurIPS | ICML | ...        # target venue
— sources: web, zotero, deepxiv, ...        # literature sources
— gpu: local | remote | vast | modal         # GPU backend

Parameters pass through workflow chains automatically.

Workflow Index

Full Pipeline

/research-pipeline "direction" → W1 → W1.5 → W2 → W3

Individual Workflows

Workflow	Invoke	Input	Output	When to use
W1: Idea Discovery	/idea-discovery "direction"	research direction	IDEA_REPORT.md, EXPERIMENT_PLAN.md	Starting new research
W1.5: Experiment Bridge	/experiment-bridge	EXPERIMENT_PLAN.md	running code, EXPERIMENT_LOG.md	Have a plan, need to implement
W2: Auto Review	/auto-review-loop "scope"	paper + results	improved paper	Iterative improvement
W3: Paper Writing	/paper-writing "NARRATIVE_REPORT.md"	narrative report	paper/main.pdf	Ready to write
W4: Rebuttal	/rebuttal "paper/ + reviews"	paper + reviews	PASTE_READY.txt	Reviews received

Standalone Skills

Skill	Invoke	What it does
/research-lit "topic"	Literature survey	Finds papers, builds landscape
/idea-creator "direction"	Idea generation	Brainstorms and ranks ideas
/novelty-check "idea"	Novelty verification	Checks against existing work
/research-review "draft"	External review	GPT-5.4 xhigh deep critique
/experiment-audit	Integrity check	Cross-model audit of eval code
/result-to-claim	Verdict judgment	Codex judges if claims are supported
/paper-plan "topic"	Outline creation	Structured outline + claims matrix
/paper-figure "plan"	Figure generation	Plots from experiment data
/paper-write "plan"	LaTeX drafting	Section-by-section with citation check
/paper-compile "paper/"	PDF compilation	Multi-pass with auto-repair
/research-wiki init	Knowledge base	Persistent project memory
/meta-optimize	Self-improvement	Analyze usage, propose skill edits
`/a