Artifacts¶

Generated training and experiment outputs live under exports/.

The exports/ directory is ignored by git because it contains large and machine-specific outputs.

Export Roots¶

Most environments use this shape:

exports/<family>/<environment>/

Some environments include the number of agents:

exports/<family>/<environment>/<num_agents>/

Examples:

exports/matrix/chicken/
exports/gridworlds/pursuit/2/
exports/gridworlds/gathering/4/

Common Subdirectories¶

World-model artifacts:

wm/legal_joint_graph.pkl
wm/world_model.pt
wm/env_transition_graph.pkl

Opponent-model artifacts:

om/iop_stack.pt

Experiment outputs:

experiments/

Exact true-shield baseline artifacts:

true_shield/

Timings¶

The canonical timing sidecar is:

timings.json

It lives at the environment export root and is shared across world-model, opponent-model, and experiment notebooks.

The timing file records stage totals, per-run durations, and available RAM metadata.