0.11 — the doctor, one command for icons, and a meta audit

A site built from the template is a copy, and it does not move when the template moves. Before this version that had an unpleasant consequence: the manual improved while sites built yesterday kept yesterday’s defects, and nobody knew which ones.

The changelog became executable

A site now records three things at its root: the skill version, the template version, and the commit the snapshot came from. The doctor command reads that, takes everything newer out of the changelog, and applies each entry in order. Every entry from 0.4.0 on carries a block written as instructions rather than as description.

The report at the end is a table, and against each item stands one of three words: fixed, already correct, needs the client. The third is a boundary rather than an excuse — changing the tone of every heading at once, or replacing a section, is the site owner’s decision and cannot be made quietly.

Icons

One command draws all seven files from a single SVG. Not one drawing at seven sizes: the tab icons are the mark alone on transparency, because a coloured tile there fights the browser’s own chrome; the home-screen icons sit on the brand colour, because iOS composites transparency onto black.

The ink on the tile is measured rather than picked: the script reads the brand colour out of the stylesheet and computes the contrast, the same way the label on a CTA is computed. White on a mid blue is right, white on an orange is unreadable, and the eye is no help here.

The meta audit

The script that walks every route and takes its title for the social cards had been fetching canonicals, descriptions, hreflang sets and JSON-LD all along, and throwing them away. It now checks them and refuses to write on a duplicate title, a duplicate or missing description, a canonical pointing elsewhere, or an image belonging to another route.

The reasoning is short: a card is worth exactly as much as the page it names. Two routes with one description are two routes competing with each other in the results.

What to apply to your own site

Run the doctor. If the site predates the version file, the mode writes one itself and walks the whole changelog — most items come back already satisfied, and it takes minutes.