docs: add universal context capsule

2026-09-28 22:15:02 +08:00
parent 8ac22a4c52
commit 6588e128bd
7 changed files with 238 additions and 2 deletions
@@ -0,0 +1,22 @@
+# Hulumath AI Working Agreement
+
+Read `context/boot.md` and `context/capsule.json` before changing the product.
+Then select the smallest relevant product, architecture or deployment
+document under `docs/`.
+
+## Source Boundaries
+
+- Hulumath owns its Django application, mathematical content, product rules
+  and release documentation.
+- JLearn may link to Hulumath but does not own its users or runtime data.
+- JOps owns shared edge, deployment observation and platform authentication
+  facts.
+- Secrets, production databases, uploads and user data remain outside Git.
+
+## Change Protocol
+
+1. Preserve server-side authorization, scoring and anti-cheat checks.
+2. Keep API and WebSocket routes backward compatible or version them.
+3. Update product or deployment documentation with behavioral changes.
+4. Run `make context-check`, `make check` and `make test` before committing.
+5. Treat checked-in release notes as source history, not live runtime proof.