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