# Trace game ## What this builds A tiny original game whose walls and entities are drawn as copper traces and footprints on a board. A scripted demo produces golden frames (a wireframe or a rendered view) and a `.kicad_pcb` snapshot whose traces and footprints match a documented mapping. ERC on that snapshot is clean enough for the stated single-net or few-net demo (waivers listed). Art is original or permissively licensed; no copyrighted commercial IWAD is used. No board house is required. Read `spekkr.inputs.json` first. `width`, `height`, and `trace` size the copper playfield. `view` is top-down or a simple first-person. `silk` and `frame` add chrome. The demo is scripted. ## Out of scope - A board house, a fabricator, or a real walk around a panel. - A copyrighted commercial game's data. - A live multiplayer board. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Mapping and frames - A documented mapping turns game tiles or walls into traces or footprints. The snapshot's copper, at the demo's first frame, matches the fixture mapping in `design.md` (a netlist of trace segments or a hashed board). - A scripted demo of N frames (for example 8) writes goldens for frame 0 and frame N, within the file's tolerance. - A rights scan fails if a known copyrighted IWAD or commercial asset name is present. Accept when: the mapping hash or segment list matches, the two goldens match, and the rights scan is clean. ### R2. ERC and files - ERC on the snapshot is clean except for the documented waiver class (for example a single playfield net that is intentional, listed in the file). - Renders: the board, frame 0, frame N, and a view that shows ERC clean or waived as listed. - One command runs the demo, writes the board, checks ERC, and writes the renders. No board house. Accept when: the ERC result matches the file, the command passes, and a deliberate missing-wall fixture fails the mapping or a golden. ### R3. Inputs - Inputs are read from `spekkr.inputs.json`. Values outside the ranges or choices in `design.md` are refused before a netlist, a board or a testbench is built. - Options turn the optional circuits, ports or features in the Inputs table on or off. Accept when: an illegal input is refused by name, and the default input set produces the measurements in `design.md`. ### R4. Checks and report - One command runs the simulation or the testbench, writes the plots or dumps, and compares them to the numbers in `design.md`. - The command works without a physical board, a lab instrument or a network. Accept when: the command passes at the defaults, and fails if a documented value in the netlist or the ROM is corrupted on purpose. ## Verification A scripted demo produces golden frames and a .kicad_pcb snapshot whose traces and footprints match a documented mapping. ERC is clean enough for the stated few-net demo, with waivers listed. A rights scan fails if a copyrighted commercial IWAD is present. No board house is required. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to run the demo, how ERC waivers are listed, and that a fabrication is optional.