First Run Checklist

Use this checklist when a new session starts working on the repo.

1. Read docs

• docs/README.md
• docs/open-dataset-workflow.md
• docs/session-handoff.md

2. Verify repo health

git status --short
/usr/local/miniconda3/bin/python scripts/status_snapshot.py

3. Verify open-dataset tooling

/usr/local/miniconda3/bin/python -m py_compile src/data/external_adapters.py src/data/manifest_tools.py train.py run_demo.py evaluate.py

4. Verify drop zones

• data/raw/fma_small_audio/
• data/raw/mtg_jamendo_audio/

5. If real local audio exists, run smoke

/usr/local/miniconda3/bin/python src/data/external_adapters.py smoke-local fma data/raw/fma_small_audio --output-root data/external_smoke --eval-ratio 0.2 --query-duration 8.0 --train-epochs 1 --batch-size 2

6. If real local audio does not exist

• continue using synthetic stand-ins
• or continue improving ingestion/benchmark/documentation paths