create-mac-icon

Create Mac Icon

Design a macOS app icon that is native to the platform (correct era grammar), committed to one direction (ownable), and — the part most pipelines skip — materially rich in the shipped vector master, proven by scoring it against a raster reference rather than by eyeballing it.

The whole skill exists because of one repeated observation: hand-authored SVG masters win composition and 16px survival but lose material (volumetric shading, lighting, translucency) to diffusion rasters at equal audit scores. The fix is not "try harder" — it's a measured loop.

First, two quick exits. If the request is empty, ask in one line what the app is and what it does, then stop. If it is exactly one of structure, score, gate, check, render or iterate, it is a subcommand or a workflow name and not a brief — say which command you think they meant and confirm. But do not design an icon named "score": if what follows describes something an icon could be for — a cashflow tracker, an export tool, a pottery-studio booking app — it is a brief, so design it.

Running as a Gemini model? Read gemini.md in this directory first, then follow this file with the overrides it names. It converts the rubric's stated maxima — one soft light, two hue families, no baked corners — into a bound ledger read back off the emitted SVG, and refuses an audit.html score cell whose render nobody opened. Other models skip it.

Where a commission lands

Learn the anatomy before building it. Everything below sits in the commission directory you were given:

icon.svg                  the layered master that ships (glob-required name)
build_icon.py             the generator: geometry + material as named constants
icon-<engine>-<id>.svg    the Arrow take
icon-<engine>-<id>.png    the raster take (+ -masked.png)
audit.html                the contact sheet — a gated deliverable, not a note
audit-renders/            <take>-{1024,256,128,96,64,32}.png
  render-manifest.json    what was rendered, from what, as what kind
loop-runs/rNN/            score.json · residual-1024.png · edges-{candidate,reference}.png
                          candidate-1024.png · reference-1024.png · brief.md
                          gate.txt · review.html · review-feedback.json · _before/
                          panel/{bundle/, bundle-swapped/, verdict-*.json, panel.json}
loop-runs/last-accepted/  the gate's rollback point
loop-runs/best-promoted/  the best take a blind panel ever preferred — what ships