Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
generate-icon-css.js is the older sibling of build-icon-css.js. The build pipeline (icons:build-css) uses build-icon-css.js exclusively; generate-icon-css.js had no wireit binding and emitted an extra CSS-aliases section that the active script intentionally omits (alias resolution lives in icons.meta.js).
Drops files whose content is fully absorbed into mappings.js or
otherwise superseded:
- icon-descriptions.md — V1 prose snapshot; canonical V2 visual/usage
fields live in mappings.js
- audit-results.json — one-shot post-merge audit; the duplicate-key
finding it flagged was resolved
- pass2-{heroicons,material,phosphor,tabler}.json — bulk-merged form
of the underscore-prefixed per-batch fragments
- pass4-aliases-deduped.json — dedup checkpoint; mappings.js aliases
are the deduped truth
Also drops the literal final count from selection-process.md — the
process narrative is what the doc records, not a count that drifts
as the dictionary is maintained.
Rebuild scripts were originally written for a single run. Parameterizes
them so future maintenance (Lucide updates, library renames, library
additions) doesn't require editing the scripts:
- merge-mappings.mjs (renamed from _merge-mappings.mjs): targets the
shipped mappings.js path, adds --library to filter to one library
and --update to overwrite existing values when an upstream rename
has made them stale
- apply-promotions.mjs: takes the promotions JSON path as an arg,
defaults to pass5-promotions.json next to the script
Also corrects two stale references in the methodology docs: the
description pipeline pointed at a workspace artifact that doesn't
exist, and the rebuild plan named the per-library fragments
_pass2-{library}-{A-E}.json when they shipped as _{library}-{A-E}.json.
Two skills capturing how the canonical icon vocabulary in mappings.js was decided and how to maintain it: - skills/research/icon-vocabulary.md describes the descriptivist principle (canonical is what users reach for; artifact names are promoted to aliases), the dictionary-vs-build-vs-generation split, and what each artifact in ai/research/icons/ records - skills/workflows/research/maintain-icon-vocabulary.md walks the four maintenance scenarios (Lucide update, library rename, adding a library, promotion) with concrete commands Both follow ai-author-context conventions for frontmatter, header shape, and Related-skill cross-references.
Filenames were leftover from the historical execution path (pass numbers,
intermediate counts, the past-tense 'rebuild' framing). Renames each
file to reflect its enduring role:
- final-list.txt → canonical-roster.txt
- pass-1-exhaustive-827.txt → selection-exhaustive.txt
- pass-1-editorial-341.txt → selection-editorial.txt
- expansion-review.md → inclusion-rationale.md
- reconciliation-audit.md → roster-audit.md
- icon-mappings/ → pipeline/
- pipeline/rebuild-plan.md → pipeline/methodology.md
- pipeline/pass5-promotions.json → pipeline/promotions.json
- pipeline/pass5b-promotions.json → pipeline/promotions-followup.json
Per-library cross-mapping data was split A-E for subagent throughput
during the historical run. Merges them into one file per library:
- pipeline/_{lucide,phosphor,tabler,material,heroicons}-{A..E}.json
→ pipeline/{lucide,phosphor,tabler,material,heroicons}.json
- pipeline/pass1-{A..E}.json → pipeline/classification.json
- pipeline/pass3-aliases-{1..5}.json → pipeline/aliases.json
merge-mappings.mjs and apply-promotions.mjs updated to read the new
filenames. methodology.md rewritten to describe the pipeline as it
stands rather than as a historical rebuild plan. The icon-vocabulary
and maintain-icon-vocabulary skills point at the new paths.
Orienting index for ai/research/icons/. Names the layout, points readers at the icon-vocabulary skill (for understanding the dictionary) and maintain-icon-vocabulary workflow (for changing it), and lists where new judgments belong when mappings.js is updated.
This was referenced May 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Reviews and consolidates all plans for upcoming work to SUI.
Changes
Roadmap
icebox/for plans not on roadmapResearch
Skills
mental-model,manage-roadmapandnative-rendererskills