Skip to content

Chore: Roadmap Consolidation Pass#167

Merged
jlukic merged 44 commits intomainfrom
chore/roadmap-consolidation
Apr 30, 2026
Merged

Chore: Roadmap Consolidation Pass#167
jlukic merged 44 commits intomainfrom
chore/roadmap-consolidation

Conversation

@jlukic
Copy link
Copy Markdown
Member

@jlukic jlukic commented Apr 29, 2026

Reviews and consolidates all plans for upcoming work to SUI.

Changes

Roadmap

  • Archives completed plans
  • Add follow-up iceboxed plans from workspace not accounted for.
  • Promote Release 0.18.0 to top of roadmap with concrete steps + session breakdown
  • Create icebox/ for plans not on roadmap

Research

  • Reorganizes icon research to be cogent, consolidates scripts for regenerating icons from corpus

Skills

  • Minor updates to mental-model, manage-roadmap and native-renderer skills

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 29, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
semantic-next Ready Ready Preview, Comment Apr 30, 2026 2:03pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
mcp Ignored Ignored Preview Apr 30, 2026 2:03pm

Request Review

jlukic added 5 commits April 29, 2026 10:59
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.
jlukic added 4 commits April 29, 2026 12:00
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.
@jlukic jlukic merged commit 6f9ea44 into main Apr 30, 2026
10 checks passed
@jlukic jlukic deleted the chore/roadmap-consolidation branch April 30, 2026 14:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Docs Modifies documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant