Decision Log
Architecture decisions record choices that affect data interpretation or future modeling. They explain why a rule exists and which alternatives were rejected.
| Decision | Status | Summary |
|---|---|---|
| ADR-0001 | Accepted | Fetch direct NBA JSON and preserve raw bytes. |
| ADR-0002 | Accepted | Separate basketball possessions from fixed-lineup segments. |
| ADR-0003 | Accepted | Require exact invariant audits before modeling. |
| ADR-0004 | Accepted | Separate game build artifacts from curated season partitions. |
| ADR-0005 | Accepted | Index immutable model runs in MLflow without making it authoritative. |
| ADR-0006 | Accepted | Use Stats V3 as the primary historical game archive and retain liveData only as a legacy fallback. |
| ADR-0007 | Accepted | Use 1996-97 as the practical V3 play-by-play history boundary. |
New decisions should be added as numbered Markdown files. Existing decisions should be superseded by a new record rather than rewritten after their context has changed.