DESIGN.md is agent-read markdown (design) from different-ai/openwork.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# DESIGN.md
How OpenWork UI is designed. Agents read this before building or reviewing any
user-facing surface (`apps/app`, `apps/desktop`, `ee/apps/den-web`, MCP Apps,
generated artifact views). The optional `.warden/skills/design-spec-review` skill
can review the numbered rules below locally. Automated Warden reviews focus on
security and confidentiality.
## Who we design for
Non-technical knowledge workers doing real work with agents on their own
files and connected services. Chat is the home surface; everything else
(tool activity, apps, panels, settings) supports the conversation. The user is
usually a *perpetual intermediate*: make the common path fast and obvious, keep
advanced options discoverable but quiet.
## Principles
- **P1 · Show state, don't explain the UI.** A surface reports what is true
("Verified 2 min ago", "Blocked by your team", "Not posted") instead of
describing itself. Count the sentences in the first viewport; if a sentence
explains the interface rather than reporting state, delete it.
- **P2 · Title *or* description, never both.** Pages, cards, rows, dialogs,
settings groups get one or the other. Detail lives in a tooltip, an
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_qhuon5qraabixvi2
GET https://markdownregistry.com/api/v1/resolve?ref=different-ai/openwork/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/6ebf922900eca9ea730240e160d84c3ef9c48b2d45c29e359a9a6f3908e2ee99
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
different-ai/openwork · .opencode/skills/browser-automation/SKILL.md · Local OpenWork Electron browser automation with CDP. Use when driving a local Electron dev app, browser_list…
different-ai/openwork · .opencode/skills/create-plugin/SKILL.md · Create an OpenCode plugin for OpenWork. Scaffolds the plugin file with the correct API shape, tool definitions, and…
different-ai/openwork · .opencode/skills/daytona-seeded-cloud-demo/SKILL.md · Daytona seeded cloud demo, demo credentials, Acme Robotics seed. Use when the user asks to spin up, keep running, seed…
different-ai/openwork · .opencode/skills/daytona-windows-cert/SKILL.md · test on Windows, enterprise CA, corporate certificate, GPO cert, TLS fetch failed, Windows sandbox, daytona windows…
different-ai/openwork · .opencode/skills/diagnose-a-red-run/SKILL.md · Test is red, typecheck failed, CI job failed, flaky, timed out, was this already broken. Use to classify any failing…
different-ai/openwork · .opencode/skills/get-env-var/SKILL.md · get an env var, fetch a secret, missing env var, missing token/API key, load secrets from Infisical, infisical. Fetch…
different-ai/openwork · .opencode/skills/hunt-a-prod-error/SKILL.md · A user saw internal_error, "Unexpected server error", a 500, or an opaque failure in a shipped OpenWork build. Find the…
different-ai/openwork · .opencode/skills/open-a-pr/SKILL.md · Open a PR, write or rewrite a PR description, "the PR body is too long", or check whether a PR description is readable…
different-ai/openwork · .opencode/skills/openwork-models/SKILL.md · Manage OpenWork inference model aliases, openwork model overlays, discounts, validation, and automated base model…
pbakaus/impeccable · DESIGN.md · Neo kinpaku system. Two brand anchors, kinpaku gold and verdigris patina, sit on dark warm-black lacquer. Restraint in…
amruthpillai/reactive-resume · DESIGN.md · A monochrome, content-first design system for a free and open-source resume builder. Dark-by-default with light mode…
reactive-resume/app · DESIGN.md · A monochrome, content-first design system for a free and open-source resume builder. Dark-by-default with light mode…
