Files
tts-workshop/docs/overview.md
T
hypercross addfc03ab6 docs: add free interaction design to bgm specs
Add the command/dialog split to the state-model and interactions docs, declare role dialog and zone facing in the format spec, and let setups declare which dialogs power open interactions.
2026-08-16 12:59:03 +08:00

1.5 KiB

Docs

The documentation is split into the living specs, which describe how the system works today, and the status/plans, which track development iterations and go stale as work lands.

Specs — how the system works

Doc Covers
architecture.md System architecture and the package dependency graph
decisions.md Key design decisions and the rationale behind them
bgm/format.md The board game manifest (bgm) format spec
bgm/engine.md The bgm message layer: queue, triggers, orchestrators
bgm/commands.md bgm command execution: lifecycle, run contexts, tap interaction
bgm/tabletop.md The r3f tabletop component library
bgm/state-model.md The format's state model: components vs setup, facing, anchoring scope
bgm/interactions.md Free interaction: the operation set, the rule seam, and the deck pick-up dialog

Status & plans (dev logs)

Doc Covers
status/implementation-plan.md Original build plan
status/bgm-loader.md bgm loader — what's built, works, missing
status/bgm-tabletop.md bgm tabletop — implementation plan / status
status/full-setup-view.md Full-setup view plan