# Repository agent instructions

This repository is a PyMC-Marketing 1.x case study and a worked example of the bundled `pymc-marketing-sweep` package.

1. Read `README.md` and `BLOG.md` before changing modelling code.
2. For sweep behaviour, read `pymc-marketing-sweep/AGENTS.md` and `.agents/skills/pymc-marketing-sweep/SKILL.md`.
3. Start any custom-model adaptation with `pmm-sweep inspect <model>` rather than guessing posterior variables or dimensions.
4. Keep PyMC-Marketing 1.x and Python 3.12+ as the supported baseline.
5. Do not use a clearly non-converged posterior as the reference for PSIS reweighting.
6. Prefer changing sweep YAML and model prior configuration over modifying the sweep engine.
7. Keep EDA, convergence diagnostics and business interpretation together when changing the article or example.
8. Clearly distinguish deterministic story fixtures from genuine MCMC results.
9. Do not commit user model `.nc` files, credentials, caches, local absolute paths or private data.
