Science Simulation Author

Core promise

Generate one self-contained index.html that runs offline, renders a STEM simulation on a 2D canvas, exposes model parameters as sliders, plots a time series, and includes an inquiry worksheet.

Inputs

Accept a SimSpec in YAML or JSON with:

• - id, title, INLINECODE3
• INLINECODE4, params, initial, equations, INLINECODE8
• optional level, dt, worksheet, INLINECODE12

Validate against templates/simspec_schema.json before generating anything.

Output contract

• - Produce exactly one file named index.html.
• Keep all CSS in <style> and all JS in <script>.
• Do not use bundlers, package managers, CDNs, external fonts, or runtime network access.
• Include these DOM ids: simCanvas, plotCanvas, runToggle, stepBtn, resetBtn, dtSlider, paramControls, readouts, statusBanner, worksheet, copyJsonBtn, downloadCsvBtn.
• Include controls, readouts, one time-series plot, local JSON snapshot export, local CSV download, and a non-empty worksheet.

Workflow

1. 1. Validate the incoming SimSpec against templates/simspec_schema.json.
2. Normalize the spec:

- If dt is missing, use default=0.01, min=0.001, max=0.05. - If a parameter omits step, derive step=(max-min)/100 with sensible rounding. - Normalize derivative aliases such as dx, dy, dvx, dvy, dq, dvc to canonical d<stateName> keys before generating JS. - Default readouts to t plus every state variable in state order.

1. 3. Choose the renderer:

- mechanics + state includes x and y -> trajectory2d - mechanics + state includes x and v -> oscillator1d - electromagnetism + state includes q or vc -> circuit_rc - Otherwise stop and ask the user for a clearer SimSpec instead of guessing.

1. 4. Populate templates/simsinglefilehtmltemplate.html with pre-normalized values.
2. Run rubrics/validationchecklist.md before returning the final index.html.

Template placeholders

Populate these mustache variables:

• - sim_id, sim_title, domain, level, INLINECODE59
• INLINECODE60, params_json, initial_json, equations_json, INLINECODE64
• INLINECODE65, success_criteria_json, INLINECODE67
• INLINECODE68, dt_min, INLINECODE70
• INLINECODE71, scene_draw_js, INLINECODE73

Expectations:

• - JSON placeholders must be serialized before insertion.
• String placeholders used in data attributes should be plain strings.
• INLINECODE74 must return a derivative object without using eval or Function.
• INLINECODE77 and readout_map_js may be no-ops; use return []; for an empty readout override.

Rendering and model rules

• - Use the shared RK4 and Euler integrators already present in the template.
• Keep physics fixed-step and rendering on requestAnimationFrame.
• Auto-pause if any state becomes NaN or Infinity.
• Cap trail history and plot history.
• Prefer one clear plot target from outputs; if multiple plots are supplied, use the first one for the visible plot and keep the rest only as metadata.

Worksheet rules

• - If the SimSpec provides a worksheet, keep it unless it is incomplete.
• If any worksheet category is missing, synthesize it using rubrics/pedagogyinquiry_prompts.md.
• Always return:

- 3 Predict prompts - 2 Test prompts - 2 Explain prompts - 2 Misconceptions prompts

Safety rules

Apply rubrics/security_notes.md strictly.

• - Do not tell the user to run shell commands.
• Do not request secrets or API keys.
• Do not fetch remote assets or scripts.
• Do not add hidden telemetry or analytics.
• Do not produce multiple files.

Templates and references

• - Template: templates/simsinglefilehtmltemplate.html
• Schema: templates/simspecschema.json
• Validation checklist: rubrics/validationchecklist.md
• Pedagogy prompts: rubrics/pedagogyinquiryprompts.md
• Security notes: rubrics/security_notes.md

Examples

• - examples/projectiledrag.yml
• examples/springmass.yml
• examples/rc_circuit.yml