docs: move CHANGELOG into specs/

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: andre-salvati

.github/workflows/onpush.yml

@@ -9,9 +9,8 @@ on:
     paths-ignore:
       - 'README.md'
       - 'CLAUDE.md'
-      - 'CHANGELOG.md'
       - 'docs/**'
-      - 'specs/**'
+      - 'specs/**'   # includes specs/CHANGELOG.md
   # Manual trigger for re-running CI without a new commit (e.g. after a transient
   # GitHub Actions hiccup that silently drops a push event):
   #   gh workflow run "CI pipeline" --ref <branch>

CLAUDE.md

@@ -85,7 +85,7 @@ The detailed specs live in [`specs/`](specs/) — read the relevant one **before
 Favor solutions with less code, fewer classes, and fewer abstractions. When two approaches both solve the problem, prefer the one with fewer moving parts — even if the "cleaner" architecture feels more elegant. Extend existing classes before creating new ones. Add a parameter before adding a new task key. Branch on a flag before splitting into subclasses.
 
 - Don't ship changes to the CLI surface (`main.py:arg_parser`), runtime env vars, catalog/schema model, or production guardrails without updating `README.md`, the relevant doc under `specs/`, and this file (`CLAUDE.md`) in the same commit. Stale docs are worse than no docs — they mislead future contributors and future sessions.
-- Don't merge a PR without adding an entry to `CHANGELOG.md` describing what changed and why.
+- Don't merge a PR without adding an entry to `specs/CHANGELOG.md` describing what changed and why.
 - Don't reintroduce `--user`, `--debug`, or `--schema` CLI args. They were removed deliberately — see PR #21.
 - Don't add `funcy` (or any decorator-based timing utility) to the dependencies. Use the structured logger.
 - Don't add `CREATE CATALOG` or `CREATE SCHEMA` calls outside the `args.env == "dev"` branch in `config.py`. Staging/prod catalogs and schemas are owned by `make init`; runtime jobs run without those privileges.

CHANGELOG.md specs/CHANGELOG.mdCHANGELOG.md renamed to specs/CHANGELOG.md

@@ -4,7 +4,7 @@
 
 ## [#40](https://github.com/andre-salvati/databricks-template/pull/40) · 2026-06-11 · docs: reorganize specs into specs/ folder, slim README and CLAUDE.md
 
-Extracted the deep technical documentation out of `README.md` and `CLAUDE.md` into a dedicated `specs/` folder (`architecture.md`, `data-model.md`, `test-plan.md` + an index), leaving the README a landing page and `CLAUDE.md` working rules plus load-bearing invariants and pointers.
+Extracted the deep technical documentation out of `README.md` and `CLAUDE.md` into a dedicated `specs/` folder (`architecture.md`, `data-model.md`, `test-plan.md`, an index, and `CHANGELOG.md` itself), leaving the README a landing page and `CLAUDE.md` working rules plus load-bearing invariants and pointers.
 Converted the medallion and CI/CD diagrams to inline Mermaid (GitHub-rendered, diffable) and deleted the now-superseded `docs/medallion_data_flow.png`, `docs/ci_cd.png`, and `docs/ci_cd.drawio`; real UI screenshots stay as PNGs.
 Added `specs/**` to the `onpush.yml` `paths-ignore` so docs-only changes don't trigger a CI run.
 

specs/README.md

@@ -10,6 +10,7 @@ relevant spec before working in that area.
 | [architecture.md](architecture.md) | the wheel/CLI surface, jobs DAG, job generation, CI/CD, job-level params, deploy-time env vars, logging, or production guardrails. |
 | [data-model.md](data-model.md) | the catalog/schema model, medallion flow, table schemas, the price-freeze semantics, liquid clustering, DQX/quarantine, or lineage. |
 | [test-plan.md](test-plan.md) | unit, integration, or load tests. |
+| [CHANGELOG.md](CHANGELOG.md) | the per-PR change history (add an entry before every merge). |
 
 Diagrams are inline Mermaid (rendered by GitHub) — edit the fenced block, not an image. The
 remaining PNGs in `../docs/` are real UI screenshots.