Skip to main content

ADR-0001: Bridge-first architecture

  • Status: Accepted
  • Date: 2026-04-04

Contextโ€‹

Consumers wanted one linting workflow and one diagnostics channel in CI/editor.

Decisionโ€‹

Adopt a bridge-first model where stylelint2/stylelint surfaces Stylelint diagnostics inside ESLint execution.

Consequencesโ€‹

Positiveโ€‹

  • Unified lint command surface
  • Centralized CI checks
  • Consistent editor diagnostics flow

Trade-offsโ€‹

  • Requires careful option/config alignment between Stylelint and ESLint contexts
  • Some teams may still need dedicated Stylelint CLI jobs for formatter-specific reporting