Engineering & Design

Twelve product design principles

Principles are how a team scales judgement. These twelve govern every screen, interaction and copy decision at ADmetric AI. They are reviewed quarterly and changes are logged in the decision register.

01

The number is the product

Charts decorate; numbers decide. Every screen leads with the figure a controller would write in a memo, not the visualization.

02

Density beats decoration

A finance operator wants twelve relevant numbers on one screen, not three numbers in a hero card. We optimise for the second look, not the screenshot.

03

Never hide the source

Every metric carries a tooltip with its formula, source ledger and last-refreshed timestamp. If we cannot show the source, we do not show the metric.

04

Defaults are decisions

Defaults are written down, reviewed quarterly and changeable per workspace. We do not ship 'opinionated' defaults without documenting the opinion.

05

Destructive actions earn friction

Anything that moves money, deletes data or changes a policy requires an explicit confirmation that names what will change and who will be notified.

06

Latency is a UX, not an engineering, problem

Any interaction that exceeds 200ms shows progress. Any that exceeds two seconds is cancelable. Slow is acceptable; opaque is not.

07

Empty states teach

Every empty state explains what would appear, where the data would come from and how to populate it. Zero placeholder illustrations of cartoons holding clipboards.

08

Errors name the human action

We never surface a stack trace. Every error message names the action the operator can take and the support reference they can quote.

09

Keyboard before mouse

Every workflow has a keyboard path. The command palette (⌘K) is the canonical surface for navigation, not a feature.

10

Audit trails are first-class

Every screen that changes state shows who changed it last, when and why. Audit is rendered inline, not relegated to a separate page.

11

Print matters

Every report screen has a printable view. CFOs still print board packs. We respect that.

12

No dark patterns. Ever.

No countdown timers on pricing. No pre-checked upsells. No fake scarcity. If we cannot earn the click honestly, we do not earn it.

When principles collide

Density (02) sometimes loses to teaching (07). Friction (05) sometimes loses to keyboard speed (09). When two principles conflict, the customer's ability to defend the number in front of an auditor wins.