# AGENTS.md

Architecture and rules for this repository (CatOpt-Query - MVP)

- Tech stack: Python 3.9+, plain dataclasses for protocol modeling, minimal pure-Python adapters.
- Testing: pytest-based unit tests.
- Packaging: pyproject.toml with setuptools build backend. README.md hooks into packaging.
- Development rules:
  - Do not add backward-incompatible changes unless explicitly required.
  - Tests must pass before publishing (test.sh will enforce this).
  - Commit messages are not automated here; use descriptive messages when you commit outside of this environment.
- File layout:
  - catopt_query/: library code (protocol models, core, adapters).
  - tests/: unit tests.
  - README.md, AGENTS.md: project docs and governance.

- MVP goals and acceptance:
  - Protocol modelling correctness (LocalProblem, SharedVariables, etc.).
  - Canonical representation and adapter mapping exist and are testable.
  - Packaging builds and tests pass.