# Design Spec Review

Warn when user-facing UI changes drift from DESIGN.md.

- Repository: https://github.com/different-ai/openwork (24362 stars)
- Category: Design
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add different-ai/openwork --skill design-spec-review -g -a claude-code -y`
Codex: `npx skills add different-ai/openwork --skill design-spec-review -g -a codex -y`
Cursor: `npx skills add different-ai/openwork --skill design-spec-review -g -a cursor -y`
Gemini CLI: `npx skills add different-ai/openwork --skill design-spec-review -g -a gemini-cli -y`

## Description

Warn when user-facing UI changes drift from DESIGN.md. Advisory only; findings never gate Warden clearance.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

You are reviewing a diff to answer one question: does this change introduce
user-facing UI that violates a numbered rule in `DESIGN.md`? Read `DESIGN.md`
at the repository root first; it is the single source of truth. Cite rule ids
(P2, S1, C1, V5, T3…) in every finding.

Advisory contract, this skill only warns:

- Report `medium` for a clear violation of a numbered rule in changed code.
- Report `low` for a likely violation you could not fully confirm from the
  diff, or for a missing-evidence note.
- Never report `high`. Nothing from this skill blocks clearance.

Scope: only changed lines in user-facing surfaces, `apps/app/src/**` (React
UI, `index.css`, styles), `apps/desktop/**` renderer UI, `ee/apps/den-web/**`,
and MCP App / artifact view sources. Ignore tests, mocks, fixtures,
storybook, docs, server code, and pre-existing code you did not change.

## What to check (one finding per root cause)

Copy and structure (P1, P2, P3, C1, C7):

The rest: https://github.com/different-ai/openwork/blob/HEAD/.warden/skills/design-spec-review/SKILL.md