webgradients: Instructions file for Codex

AGENTS.md

Guidance for AI coding agents (Claude, Cursor, Copilot, etc.) working with this repo. This is a static data repository — 180 curated gradients, no build step, no dependencies.

Files and what they're for

Fixed: two gradients used to share the name/class Deep Blue (now resolved)

webgradients.css used to define .deep_blue{} twice — index 016 (#e0c3fc→#8ec5fc) and index 039 (#6a11cb→#2575fc) — both commented /*NNN Deep Blue*/. In CSS the later rule wins, so .deep_blue always rendered index 039's colors; index 016's gradient was unreachable through that class name. gradients-parsed.json originally called index 039 "Blue Velvet" — a leftover from before it was renamed to Deep Blue in the CSS without updating this file, which is what caused it to look like a missing/orphaned entry.

Resolved by keeping the class that was actually live (.deep_blue / index 039, so nothing that already depended on that class name changes) and giving the previously-unreachable index 016 a new, unique name: Lilac Sky / .lilac_sky. Applied consistently across webgradients.css, gradients.json, and gradients-parsed.json. Blue Velvet is retired — index 039 is Deep Blue in all three files now.

Why gradients.json only had 11 entries until now

It was an abandoned 2019 prototype (see git log -- gradients.json) — the real data work happened in gradients-parsed.json instead, which itself topped out at 174/180 because 6 gradients (Coup de Grace, Loon Crest, Sharp Glass, Chemic Aqua, Slick Carbon, Earl Gray) use layered background-blend-mode effects that don't reduce to a single {deg, gradient} pair, so the original pipeline silently dropped them. gradients.json is now regenerated directly from webgradients.css (the canonical, complete source) to close that gap: