Ztx14 Isometric Theme Iconography Depth System

---
name: ztx14-isometric-theme-iconography-depth-system
description: Apply a focused implementation and verification workflow for icon depth system in Isometric, React, responsive motion, or interactive UI work.
---

# Icon Depth System

## Activation
Use this skill when the task includes **icon depth system**, a related review, a bug report, or a regression test. Load the Isometric master skill first for site-specific installation and source conventions, then only other specialists that are directly relevant.

## Scope and implementation contract
Align icon keylines, raised faces, and pressed states with the same depth contract as controls.

Treat the project’s approved brand and semantic tokens as authoritative. Keep stroke, face shade, focus, and depth coherent in light/dark/forced-colors modes; scope overrides to Isometric rather than changing the entire site.

## Execution sequence
1. **Inspect evidence.** Identify the real component, event/state path, installed source, app conventions, and available test commands. Record uncertain assumptions instead of silently filling gaps.
2. **Define the behavior.** Write down the expected initial, active, interrupted, cancelled, and resting states for this specific task. Name the property or state owner before editing.
3. **Implement narrowly.** Apply the smallest safe change that achieves the focus above. Reuse local utilities, tokens, and existing engine behavior before adding a dependency. Preserve unrelated files and styles.
4. **Cover input variants.** Exercise pointer/mouse where applicable, touch or coarse pointer, keyboard/focus, and an equivalent non-hover path. Check reduced-motion behavior and both light/dark themes when relevant.
5. **Measure and verify.** Run the applicable test, type check, and production build. Capture a deterministic screenshot or repeatable interaction trace for visible behavior. If a browser/device is unavailable, mark that check `NOT_TESTED`.

## Acceptance gates
- The behavior is implemented in real source code, not merely described in prose.
- Target selection and visible state match after repeated, rapid, interrupted, and cancelled interactions.
- The responsive layout remains usable at 320, 390, 768, and 1280 CSS px or the project’s actual breakpoints.
- Reduced motion keeps the same information and task outcome without unnecessary continuous movement.
- No new console error, hydration mismatch, stale event listener, idle animation loop, or accidental layout shift is introduced.
- The report names changed files, commands actually run, evidence captured, unresolved issues, and any limitation.

## Failure patterns to avoid
Do not import unrelated brand themes wholesale or use hue as the only state indicator.
- Avoid changing an unrelated theme, route, dependency, or interaction simply to make the local example easier.
- Do not claim success based solely on a source edit; distinguish code inspection, automated tests, and real-browser validation.

## References
- https://tailwindcss.com/docs/theme
- https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/oklch
- https://isometric.buildlab.in/llms.txt