Current state of the art

Author: saulshanabrook

AGENTS.md

@@ -19,6 +19,9 @@
 
 - Use the Context7 MCP server for egglog documentation instead of copying external doc summaries into this file.
 - Keep general workflows in the how-to guides, and keep Python-specific runtime/reference examples in `docs/reference/python-integration.md`.
+- Before changing Python-facing `egglog` APIs or expression-inspection patterns, read `docs/reference/python-integration.md`.
+- Before changing how egglog concepts map into Python declarations, relations, actions, or sort/function definitions, read `docs/reference/egglog-translation.md`.
+- If a change touches both local Python ergonomics and egglog-language mapping, read `docs/reference/python-integration.md` first, then `docs/reference/egglog-translation.md`.
 - If a PR adds or updates a changelog entry in `docs/changelog.md`, keep it aligned with the final code changes.
 - For a clean docs rebuild, clear `docs/_build/`; the MyST-NB execution cache lives in `docs/_build/.jupyter_cache`.