catopt-query-category-theor.../AGENTS.md

21 lines
952 B
Markdown

# 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.