aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
blob: ab4df97cfcc5ab12f44fb6c362cf6bb430ca98df (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
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.