English | 한국어 | 日本語 | 简体中文 | 繁體中文
From seed to system — cultivate a production-ready design system from any codebase.
design-farmer is a skill for coding agents that analyzes your repository, extracts existing design patterns, and grows them into a structured, accessible, OKLCH-native design system with tokens, components, tests, and documentation.
When vibe-coding with AI agents, design consistency is the first thing that breaks. Colors drift, spacing becomes arbitrary, and dark mode is an afterthought. Giving agents explicit design constraints produces dramatically more consistent UI — but building those constraints by hand defeats the purpose.
Design Farmer automates that entire process. It reads your codebase, understands what you already have, and builds (or upgrades) a production-grade design system around it. No manual token files, no copy-pasted color palettes, no guessing.
Design Farmer works in phases, adapting to your project's current state:
| Starting point | What happens | Result |
|---|---|---|
| No design system | Discovers colors/spacing in code, converts to OKLCH, creates token hierarchy | Primitive + semantic tokens, contrast-validated color scales |
| Partial system | Audits existing tokens, identifies gaps (states, roles, themes) | Complete semantic coverage without breaking existing references |
| Missing interactive components | Builds accessible Button, Input, Select, Dialog with keyboard/focus behavior | Consistent a11y components with interaction tests |
| Light-only theme | Generates dark theme via OKLCH lightness/chroma adjustments | Dual-theme system from a single semantic contract |
| "Production-ready" claim | Runs multi-reviewer verification, finds drift and token misuse | Evidence-backed completion status with remediation notes |
The full pipeline covers: preflight detection, discovery interview, repository analysis, pattern extraction with OKLCH conversion, visual preview, architecture design, theme system, DESIGN.md generation, token implementation, component library, Storybook integration, multi-reviewer verification, live visual QA, documentation, app integration, and release readiness.
- OKLCH color system — perceptually uniform scales with automatic contrast validation
- Token hierarchy — primitives, semantics, and component-level tokens in a consistent structure
- Accessible components — keyboard navigation, focus management, ARIA states built in
- Dual-theme support — light and dark from the same token contract
- DESIGN.md — machine-readable design decisions as a persistent source of truth
- Verification evidence — multi-angle review with explicit pass/fail criteria, not "looks good" approvals
The screenshot above was built from a greenfield project — no existing tokens, components, or design decisions. When your repository already has partial implementations (some components, color variables, a style guide, etc.), Design Farmer picks up where you left off and produces significantly more refined results.
Tip
Want even better results? Drop a DESIGN.md into your project root before running Design Farmer.
- Generate one with Stitch, or
- Grab a pre-built one from awesome-design-md — 58+ design systems extracted from real sites (Vercel, Linear, Stripe, etc.)
Install directly from the Claude Code Marketplace and let Claude Code manage the plugin lifecycle:
- Open Claude Code settings and go to Plugins → Marketplace.
- Search for design-farmer and click Install.
If you prefer Claude Code's command interface, register this repository as a marketplace and install the plugin directly:
/plugin marketplace add ohprettyhak/design-farmer
/plugin install design-farmer@design-farmerThe marketplace add step registers the marketplace catalog. After that, install pulls the design-farmer plugin from the registered marketplace, and Claude Code keeps future updates in its normal plugin refresh flow.
curl -fsSL https://raw.githubusercontent.com/ohprettyhak/design-farmer/main/install.sh | bashDetects and installs into Claude Code, Codex CLI, Amp, Gemini CLI, and OpenCode.
See INSTALLATION.md for the full Marketplace UI and CLI flows, migration guidance between Marketplace and curl installs, selective install flags (--tool, --interactive, --dry-run), manual setup, troubleshooting, and optional removal.
- Installation guide — canonical install lifecycle reference, including manual setup, troubleshooting, and optional removal.
- Canonical skill spec — runtime instruction file.
For maintainers and contributors:
- Internal project contracts — repository implementation contracts and planning records.
- Phase index — compact execution map for maintainers.
- Quality gates — verification and release-readiness criteria.
- Maintenance guide — anti-drift and update workflow.
- Examples gallery — scenario-based before/after outcomes and phase mapping.