aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..ab4df97
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,14 @@
+# AGENTS.md
+
+Guidance for agents working in this repository.
+
+Read the design (`docs/superpowers/specs/2026-11-09-deck-it-design.md`) and the
+implementation plan (`docs/superpowers/plans/2026-11-09-deck-it.md`) first. The
+plan is the authority for interfaces and test values.
+
+- Python 3.11+, standard library only except `websocket-client` for OBS.
+- Run the suite with `python3 -m unittest discover -s tests`.
+- Each module is `deckit/modules/<name>.py` exporting `make(cfg) -> Module`; the
+ registry discovers files lazily, so a new module is a new file.
+- The server listens only on a Unix socket; `adb reverse` exposes it.
+- UDT's palette is read, never restated.