Files
skills/public/ledger.md

1.4 KiB

Visual Parity Ledger

Use one row per independently actionable issue.

Field Meaning
ID Stable identifier such as VP-001
Class PARITY, EXEMPT, SHARED-BUG, UNMEASURED, ABSENCE
Region Shell, Header, Typography, Primitive, Page, Data, Responsive, etc.
Severity P0 systemic, P1 major, P2 local, P3 polish
State Route + UI state + breakpoint
Reference evidence Measured or observed reference behavior
Target evidence Measured or observed target behavior
Delta Concrete geometric/style/structural difference
Root cause Highest plausible shared cause
Fix location Token, primitive, component, layout, route, fixture
Validation How completion will be verified
Status open, blocked, fixed, exempted

Severity

  • P0: ancestor/system defect that invalidates downstream measurements, such as container model, base type scale, root spacing mechanism.
  • P1: major primitive/region mismatch visible across a page or many states.
  • P2: local component or state mismatch.
  • P3: final polish with small visual impact.

Rules

  • Fix P0 before trusting descendant geometry.
  • Re-measure descendants after ancestor fixes.
  • Do not close UNMEASURED by assumption.
  • Put user-approved differences in the divergence registry and reference the exemption ID.
  • Reclassify shared defects out of parity instead of forcing both implementations to remain wrong.