tensology/decisionsai/decisions-open-design

Global interface source

Before using this skill for interface work, read the current global ui-ux-system skill (~/.agents/skills/ui-ux-system/SKILL.md), especially its Paul's rules, settled taste rules, and Definition of Done - UI. Those rules are authoritative and override conflicting guidance here. Aesthetic recipes are opt-in: use them only when the brief explicitly calls for them and they earn their place. This skill adds only its specialized guidance.

Decisions + Open Design

I am using Open Design when the deliverable is a design artifact (screen, deck, motion clip) — not a Mermaid technical chart.

Open Design is the open-source Claude Design alternative: local-first desktop app, 150+ DESIGN.md systems, skills, plugins, and an MCP server for coding agents.

When to use Open Design vs Mermaid

Reference clone

../reference/open-design — nexu-io/open-design

Do not vendor the full monorepo into DecisionsAI; run the app or CLI from the reference clone.

Setup (one-time)

1. Desktop app (recommended): Download release or build from ../reference/open-design (Node 24 + pnpm — see QUICKSTART.md).
2. MCP for Cursor / Codex / Claude Code (with Open Design daemon running):

``bash cd ../reference/open-design pnpm install # first time od mcp install cursor # or codex, claude, copilot, … ``

1. Recalibrate Decisions harness MCP after install: bin/setup.py (merges catalog entries).

Open Design MCP proxies project tools to the local daemon — it is not a cloud npx server. The app must be running.

Workflow in Decisions tickets

1. Clarify artifact type (prototype vs deck vs diagram).
2. If technical structure only → stay in Decisions Mermaid viewer.
3. If UI/product artifact → open Open Design, pick design system + skill, brief in Studio.
4. Export HTML/PDF/PPTX/MP4 from Open Design; link paths in the ticket result packet.

Diagram skills inside Open Design

The reference repo ships diagram-category skills (hand-drawn-diagrams, d3-visualization, frame-flowchart-sticky, …). Use those for visual diagrams; use Decisions Mermaid for text-native diagrams the agent can edit in chat and reopen from History.

Pairing