RCA-2026-03-24-001: Analysis

Root Cause

5 Whys Analysis

Why # Question and Answer

1

Why did badges have wrong color?
Because: CSS used gray (rgba(0,0,0,0.6)) instead of cyan (#0077b6).

2

Why was gray used instead of cyan?
Because: Color was approximated from memory, not extracted from source.

3

Why wasn’t the source consulted?
Because: Assumption that "close enough" styling would suffice.

4

Why was "close enough" acceptable?
Because: Initial goal was functionality (copy button works), not pixel-perfect UI.

5

Why wasn’t pixel-perfect UI a requirement?
Because: Requirements weren’t explicitly documented; UI parity was implicit.

Root Cause Statement

CSS styling was written without referencing the actual domus-antora-ui source files. Colors, borders, and interactive element properties were approximated rather than copied from the authoritative source, resulting in visual drift from brand identity.

Contributing Factors

Factor Description Preventable?

No design tokens reference

The adoc script has no import of domus-antora-ui variables

Yes

Visual testing gap

Side-by-side comparison wasn’t done during development

Yes

Incremental drift

Each styling iteration moved further from source

Yes

awk/shell limitations

Embedding complex CSS in shell makes maintenance harder

Partially