What problem does it solve?
It prevents research results from being hard to summarize by automatically converting an experiment plan plus produced artifacts into a single, evidence-grounded report.
Core Features & Use Cases
- Plan-to-evidence scoring: Extracts objective, success criteria, and hypotheses from the session plan, then matches them to shipped and session-local analysis outputs.
- Artifact-aware interpretation: Discovers what actually ran from resolved configs and on-disk artifacts, including session-local methods and analyses, and records plan-vs-reality gaps.
- Optional paper comparison: When replication context is present, compares key metrics against the paper’s reported findings and annotates discrepancy categories.
- Figure embedding and structured output: Copies/symlinks curated figures into the session result folder and writes a consistent
result/REPORT.md, while logging issues separately.
Quick Start
Run the experiment with /run-experiment, then invoke interpret-experiment (or let it auto-run) to generate ${SESSION_DIR}/result/REPORT.md from the plan and artifacts.