git404hub

what is design-os fr?

jaysu66/design-os — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · vibe coderComplexity · 2/5LicenseSetup · easy

tl;dr

A set of plain text rules and workflows that trains AI coding agents to design interfaces with real judgment instead of defaulting to a generic templated look.

vibe map

vibe map loading… check back in a sec.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Give an AI coding agent a reference-first workflow so it stops producing generic templated UI.

VIBE 2

Build a personal library of design standards and 'AI look' warning signs the agent checks before finishing work.

VIBE 3

Let an agent automatically track your design preferences across projects as you give feedback.

VIBE 4

Install a shared design checklist across multiple AI coding tools like Claude Code and Codex.

what's the stack?

MarkdownHTML

how it stacks up fr

jaysu66/design-os100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Requires manually editing a path placeholder in the skill file and installing it into your agent's skills directory.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice. Note that fonts and design assets referenced separately are not covered by this license.

in plain english

design-os is a personal design system meant for AI coding agents like Claude or Codex, not for humans writing code by hand. It exists to fix a common problem: when an AI agent builds a user interface without any reference, it tends to produce a generic look, a centered hero section, a gradient headline, three cards, and a few emoji, the kind of page that feels like nobody in particular made it. The project addresses this with plain text files that any agent able to read local files can load. The system is organized into four working parts plus optional extras. First, a judgment section lists concrete standards for what counts as good design and what counts as an obvious AI look, along with a checklist the agent runs before calling work finished. Second, a techniques section offers layered recipes and cards describing specific interaction patterns. Third, a references section holds an engine that requires the agent to gather quality reference examples before writing any code, and it can connect to a personal style library the user builds themselves. Fourth, a workflow section defines a fixed collaboration process and a preferences file the agent updates automatically each time the user corrects or approves its work, so the system gradually learns that person's taste. A fifth, optional section contains material meant for humans who want to train their own design eye. Setup involves cloning the repository, installing a short skill file into the agent's skills folder with a path placeholder filled in, then simply asking the agent to start a project using design-os. It is not a component library or CSS framework and is not tied to any particular tech stack. The project itself ships no third-party design assets such as fonts or screenshots, since those carry their own licensing, users are expected to build their own optional reference library separately. The methodology, protocols, and research notes are released under the MIT license.

prompts (copy fr)

prompt 1
Use design-os to start a new landing page for my project, and show me 3 reference options before you build anything.
prompt 2
Run the design-os preflight checklist on this UI before you say it's done.
prompt 3
Load design-os and tell me which parts of this interface look like generic AI output.
prompt 4
Set up design-os in my coding agent's skills folder and confirm the path placeholder is filled in correctly.
prompt 5
Using design-os's feedback protocol, record that I prefer more whitespace and fewer gradient backgrounds.

Frequently asked questions

what is design-os fr?

A set of plain text rules and workflows that trains AI coding agents to design interfaces with real judgment instead of defaulting to a generic templated look.

What language is design-os written in?

Mainly HTML. The stack also includes Markdown, HTML.

What license does design-os use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice. Note that fonts and design assets referenced separately are not covered by this license.

How hard is design-os to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is design-os for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.