catopt-query-category-theoretic-composit/AGENTS.md

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.