agentic-experiments

When your agent runs ML experiments, make it run them like a scientist.

Quick Start • How It Works • Why It's Different • Features • Architecture • Docs

---

**agentic-experiments** (import name `aexp`) is an opinionated research harness for ML experimentation done *with* an AI agent — typically [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It forces a **Hypothesis → Experiment → Finding** chain on every run, ties that chain to git commits, and validates citation integrity at every turn.

What this looks like in practice

• Your agent optionally captures forward-looking research directions as threads (T###) — concerns broader than a single hypothesis, with their own lifecycle (PROPOSED → EXPLORING → PROMOTED | CLOSED) — and promotes them into hypotheses when concrete claims emerge (`aexp ne