AGENTS.md git:20261020.26fb742A

Immutable. This exact content never changes and is served at /api/v1/blob/8c67dd2dacea6b82.

# Decks: instructions for coding agents

This folder is Decks: HTML slide decks reviewed in the browser, where the
user comments under each slide and you edit the deck file and reply on the slide.

For any deck work ("process changes", "read my feedback", a pasted "Ask Claude" prompt
from a deck, a new deck, a PDF), read and follow
`.claude/skills/decks/SKILL.md`. It has the round procedure, the `sb` commands,
how a deck file is organized, and the slide style rules.

Every slide follows the method in that file: action titles, vertical and horizontal flow, the
five- and ten-second tests, and charts that prove the title.

If the user says "watch my deck", follow Watch mode in that file: `./sb watch <deck>` in the background, a round each
time it returns, then watch again.

Quick reference:

- Start the server if it isn't running: `python3 server.py` (port 8790 unless
  `config.json` or `SB_PORT` says otherwise).
- `./sb decks`, `./sb comments <deck>`, `./sb edits <deck>`: what to act on.
- `./sb reply <deck> <slide> done|question|skipped "<text>"`: answer on the slide.
- `./sb shot`, `./sb audit`, `./sb export`, `./sb round`, `./sb commit`: check and finish.

Working on Decks itself (not a deck):

- `server.py` and `sb` use only the Python standard library. Keep it that way.
- `tools/browser.mjs` needs `playwright-core` (`./setup.sh` installs it).
- Check a change by starting the server on a spare port with a scratch decks folder,
  `SB_PORT=8799 SB_DECKS_DIR=/tmp/sb-test python3 server.py`, then `sb new` a deck from
  each template and run `sb audit` and `sb export` on it.