From c525b774c1bac32494952dc4a4bc008500a8e691 Mon Sep 17 00:00:00 2001
From: jcrabtree <jsn.crabtree@gmail.com>
Date: Mon, 20 Apr 2026 12:38:18 -0400
Subject: [PATCH] docs: add CLAUDE.md

Add tailored CLAUDE.md for Claude Code navigation and codebase context.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CLAUDE.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..0e4f3fb
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,40 @@
+# pyDatalog — CLAUDE.md
+
+Magnon mirror of the pyDatalog library — Python logic programming.
+Part of MagnonOS Project-Aethra.
+
+## Purpose
+
+Magnon's private mirror of the unmaintained pyDatalog library. Used by Project-Aethra
+for Datalog-based policy evaluation and knowledge querying in the NeSy (neurosymbolic)
+pipeline. Note: upstream is unmaintained — consider IDP-Z3 for new features.
+
+Upstream: https://github.com/pcarbonn/pyDatalog (unmaintained)
+
+## Tech stack
+
+- Python (Datalog engine)
+- Note: unmaintained upstream — use only for existing integrations
+
+## Dev commands
+
+```bash
+pip install -e .
+python -c "from pyDatalog import pyDatalog; print('OK')"
+```
+
+## Key conventions
+
+- This is a **maintenance mirror only** — do not add new features or APIs.
+- New Datalog/logic programming needs should use IDP-Z3 instead.
+- Bug fixes are accepted; new feature development is not.
+
+## What NOT to do
+
+- Never add new features — only bug fixes and compatibility patches.
+- Never use `ubuntu-latest` CI runners — always `magnon-enterprise-runners`.
+- Do not use as a dependency for new services — prefer IDP-Z3.
+
+## CI
+
+All GitHub Actions workflow jobs use `runs-on: magnon-enterprise-runners`.