# Generator guidelines

Generate an artifact that remains understandable when reviewed without its original runtime.

## Contract

- Produce one self-contained HTML file.
- Put required CSS inline.
- Do not depend on external scripts, stylesheets, fonts, images, or network resources for primary content.
- Keep primary content readable with scripts disabled. If animation normally hides content, include a `@media (scripting: none)` rule that restores visible, untransformed content.
- Use stable, meaningful headings and section boundaries so imported targets are understandable in review and handoff.
- Keep the document reasonably sized; avoid unnecessary generated markup and large embedded payloads.

## Reference

[`public/artifacts/demo-report.html`](../../public/artifacts/demo-report.html) is the reference artifact. It is a single file with inline CSS, semantic headings, compact sections, and stable `data-review-id` anchors.

**Consumer note:** stable structure improves target usefulness; it does not make arbitrary script-bearing HTML safe. Reviewable Artifacts treats imported artifacts as untrusted.