Changelog

​

uSpec V1.4

​

Consolidated extraction script

• A single figma_execute call (Step 4b) replaces the previous multi-step flow (token extraction + separate boolean enrichment + separate axis classification), handling everything in one pass
• The script walks the component tree, resolves color variable bindings, classifies variant axes by token fingerprint, detects boolean-gated elements, and discovers mode-controlled collections

​

Sub-component tagging

• Nested instances are now tagged with their parent component set name, producing richer and more descriptive element labels in the output tables

​

Nested boolean enablement

• Live preview instances now show all optional elements (icons, prefix/suffix, clear button, hints) by recursively enabling boolean properties on nested instances, so the artwork matches the documented tokens

​

Updated AI interpretation layer

• Step 4c strategy selection logic is clearer — the two-gate model (variant count and token similarity) now has explicit thresholds and reasoning guidance for choosing Strategy A vs Strategy B

​

uSpec V1.3

​

More detailed screen reader output

• Focus stop discovery uses deep traversal (findOne) instead of shallow children lookup — correctly resolves nested elements like a clear button inside an Input child instance
• Focus Order artwork now maximizes element visibility: boolean properties are force-enabled and the richest state variant is selected automatically, so all documented focus stops appear in the preview even when the default variant hides some of them
• booleanDefs extracted alongside variantAxes in the component scan, giving the rendering step full knowledge of toggleable sub-elements

​

Fewer tokens via state grouping

• States with identical accessibility semantics (same focus stops, roles, labels, and announcements) are collapsed into a single entry with a combined title — e.g., “Text field Enabled / Pressed / Active” instead of three separate sections
• Cuts redundant output for components like Text field that have many visual-only state differences but identical screen reader behavior
• Guidance added to both the skill workflow and the agent instruction file, with a new validation checklist row and common-mistake entry

​

Housekeeping

• Added FONT_FAMILY placeholder to the rendering template for consistent font resolution across specs

​

uSpec V1.2

​

Smarter measurement annotations

• Padding and spacing now use Figma’s native measurement display instead of custom text labels — cleaner output with no mislabeled annotations
• Min/max constraints show actual node values (e.g., min 32, max 200)

​

Template-driven previews

• Preview layout is defined by the template; the script no longer overrides direction or spacing
• Section template hidden by default, eliminating an extra manual step

​

Clearer agent instructions

• Removed ambiguous language that caused layout direction changes
• Updated validation rules for new measurement behavior

​

Deterministic vs AI split (~60/40)

• ~60% deterministic scripts handle extraction, cross-variant comparison, and rendering
• ~40% AI reasoning handles section planning, design-intent notes, and anomaly detection
• Output is highly consistent across runs

​

uSpec V1.1.0

​

Multi-platform support

• Claude Code CLI and Codex CLI are now supported as agent hosts alongside Cursor
• New firstrun skill handles environment setup — run /firstrun in Claude Code or $firstrun in Codex to get started
• Skills are deployed to the chosen platform on demand, keeping each environment clean
• CLAUDE.md and AGENTS.md provide platform-specific project instructions

​

Improved layer detection

• Anatomy and Property skills now handle complex component structures with better layer detection and classification
• More accurate marker placement for deeply nested or auto-layout-heavy components

​

Infrastructure

• sync-skills.sh supports --target flag for platform-specific skill deployment
• uspecs.config.json now stores the active environment alongside template keys
• .gitignore updated to keep generated skill copies out of version control

​

uSpec V1

​

Spec types

• Anatomy: numbered markers and attribute tables for component structure, with AI-driven element classification, per-child sections, and property-aware unhide
• Properties: variant axes, boolean toggles, variable mode exhibits, and child component chapters with live instance previews
• API: property tables with values, defaults, required status, sub-component tables, and configuration examples
• Color Annotation: design token mapping for fills, strokes, and shadows across states and variants, with automatic strategy selection
• Structure: dimensions, spacing, and padding across density, size, and shape variants with token references
• Screen Reader: VoiceOver (iOS), TalkBack (Android), and ARIA (Web) accessibility specs with focus order and merge analysis
• Motion: animation timeline bars and easing detail tables from After Effects keyframe data, with pre-computed segments and color-coded easing visualization

​

Infrastructure

• Agent skills architecture running in Cursor via .cursor/skills/
• Figma Console MCP integration for real-time component data extraction
• Template library system with one-time @firstrun configuration
• Documentation site at docs.uspec.design