Document D10 sheet agent workflow and staged tasks

This commit is contained in:
Dandaedre 2026-09-18 23:25:15 +02:00
parent 3ed2c2ddde
commit 7e7c4a6020
Signed by: Dandaedre
GPG Key ID: 440C6592E8A26D99
2 changed files with 48 additions and 0 deletions

34
AGENTS.md Normal file
View File

@ -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.

14
TASKS.md Normal file
View File

@ -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.