design-decide

To turn user review evidence into concrete design decisions, you provide cluster context and reconciled verdicts to generate one reusable DesignPrinciple and one surface-specific DesignDecision with before/after changes.

A DesignPrinciple is a reusable guideline generated per evidence cluster to guide future product design across multiple surfaces. It is traceable to specific review IDs and reconciled heuristics for downstream auditability.

To ensure design traceability for UX audit governance, link your generated DesignDecision artifacts directly to specific member review IDs, reconciled heuristics, and PriorityScores that ground the outputs in evidence.

To generate auditable design actions from verdicts, you need cluster context, member review IDs, top-ranked heuristics from the reconciled verdict, and the PriorityScore to ground the outputs in evidence and impact.

You cannot process multiple clusters at once; the design decision process applies to one evidence cluster at a time within the Auditable Design pipeline to ensure focused principle and decision generation.

The best way to document before and after design changes for an audit is to generate a DesignDecision artifact per cluster, which details the concrete before/after snapshots and the specific heuristics it resolves.