Reflection

Reflection is a CLI for evidence-backed rendered UI validation.

It answers three practical questions for frontend changes:

Does the UI still work?
Does it still match the design system contract?
Did anything visible change unexpectedly?

Current status: Reflection has the core local validation loop: config → optional setup hooks → browser route check → screenshot/visual/print evidence → report → review → explicit baseline update.

Documentation

• docs/getting-started.md — add Reflection to a new repo and run the local loop.
• docs/configuration.md — supported config shape, run modes, browser/design/component/print contracts.
• docs/browser-contract.md — rendered route expectations and screenshot evidence.
• docs/visual-contract.md — route/component baselines, review-only diffs, and baseline update policy.
• docs/artifacts-and-gc.md — report bundle layout, artifact roots, and safe garbage collection.
• docs/agent-workflows.md — agent completion loop and baseline-update rules.
• docs/validation-process.md — canonical operating guide for agents and CI.
• docs/ci.md — CI defaults and exit codes.
• docs/target-ir-and-adapters.md — internal target inventory and adapter seam.

Command surface

reflection run
reflection review
reflection update
reflection doctor

Install

pnpm add -D reflection-check

Use the package root helper in reflection.config.ts:

import { defineReflection } from 'reflection-check';

Local development

pnpm install
pnpm typecheck
pnpm test
pnpm build