ravenous_roll20/effects_web/AGENTS.md

1010 B

Agent guide: Ravenous Effects Library

This folder builds a dependency-free static helper for browsing Ravenous alterations, assembling reusable effect libraries, and exporting them for the Roll20 sheet. The pinned ravenous_typst/data/src/glossaries/alterations.yaml file is authoritative. Do not hand-edit generated files in build/.

The site is generated with Python 3.11+, uses no runtime services or CDN, and stores private sets and custom effects only in browser local storage. Render imported/user text with DOM text APIs. Keep the ravenous-roll20-effects v1 contract backward compatible and target repeating_sharedeffects, not active repeating_modifiers rows.

Build and verify with:

uv run python effects_web/tools/build.py
uv run python -m unittest discover -s effects_web/tests -v
uv run python effects_web/tools/build.py --check

Reuse the sheet's theme parser, Typst translator, and conservative reminder inference. Unknown durations remain manual; never invent a game rule.