From 7e7c4a60208f0f9b2ea7864194fc8d04ba9cf31a Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Fri, 18 Sep 2026 23:25:15 +0200 Subject: [PATCH] Document D10 sheet agent workflow and staged tasks --- AGENTS.md | 34 ++++++++++++++++++++++++++++++++++ TASKS.md | 14 ++++++++++++++ 2 files changed, 48 insertions(+) create mode 100644 AGENTS.md create mode 100644 TASKS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..9081466 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,34 @@ +# D10 Roll20 sheet agent guide + +## Scope and sources + +Build the base fantasy D10 and cyberpunk Roll20 sheets only. The tracked base +sheet is the compatibility reference; `origin/cyberpunk-latest` supplies the +cyberpunk layout and skill catalogue. Check `origin/cyberpunk` when a latest +branch detail is ambiguous. `model_ravenous_roll20/` is an untracked reference +provided by the user: borrow its build discipline, not its game mechanics. +Do not edit, commit, or import that directory as part of this project. + +## Source of truth + +Keep skills in YAML and sheet structure in explicit model data. HTML/CSS/JSON +under build/ are generated and must not be hand edited. Preserve existing +Roll20 attribute names and repeating section identifiers when feasible; +record any deliberate incompatibility. Keep theme changes visual, with no +change to rolls or stored attributes. Escape data inserted into HTML and +validate YAML and model references before writing output. + +## Workflow + +Work through TASKS.md in order and update it as each task finishes. Make a +focused commit after each completed stage. Each commit must leave the generator +and its applicable tests passing. Document commands, output files, variant +behavior, and migration caveats in README.md. Avoid changing old source files +unless necessary for compatibility. + +For each behavior change, test the generated artifact, including attribute +references and roll expressions. Check both variants and every theme. Use a +local worker or calculation test when behavior can be simulated; structural +string checks alone do not establish Roll20 correctness. Record any interaction +that still requires the Roll20 Custom Sheet Sandbox. Do not claim a live +Roll20 test unless it was actually done. diff --git a/TASKS.md b/TASKS.md new file mode 100644 index 0000000..dd3c21a --- /dev/null +++ b/TASKS.md @@ -0,0 +1,14 @@ +# D10 sheet work + +- [x] Inventory base, cyberpunk, and Ravenous model; set scope and agent rules. +- [ ] Define variant models, skill YAML, and stable identifiers; document source mapping. +- [ ] Build a deterministic generator for Roll20 HTML, CSS, and sheet.json. +- [ ] Add base and cyberpunk themes without altering stored fields or rules. +- [ ] Test validation, generated fields, references, and both variant builds. +- [ ] Document build, use, variant differences, and Roll20 sandbox checks. + +## Live Roll20 checks after local verification + +- [ ] Load each generated variant in Custom Sheet Sandbox; inspect tabs and repeating rows. +- [ ] Roll characteristic, skill, and combat buttons and compare results to the base rules. +- [ ] Edit and reopen a character to verify stored values remain attached to their fields.