designagent-cli 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# designagent
+
+**The design brain Claude Code needs — web, mobile, any canvas, any framework.**
+
+```bash
+npx designagent init
+```
+
+Right now, Claude Code opens knowing nothing about your design — no system, no tokens, no taste. `designagent` fixes that in 60 seconds. One command drops three files into your project and Claude Code suddenly understands your design system the way a senior design engineer would on day one.
+
+## What it generates
+
+| File | The question it answers | Owned by |
+|---|---|---|
+| `DESIGN.md` | **What** are the exact values? | [`@google/design.md`](https://github.com/google-labs-code/design.md) open spec — machine-readable, linted tokens |
+| `CLAUDE.md` | **How** do we build? | designagent — craft principles, framework conventions, a11y rules, agent instructions |
+| `DECISIONS.md` | **Why** is it this way? | designagent — a living log of design decisions |
+
+> `DESIGN.md` = the what · `CLAUDE.md` = the how · `DECISIONS.md` = the why.
+
+## The init flow
+
+`designagent init` asks three questions:
+
+1. **Canvas** — Figma · Pencil · OpenPencil · None
+2. **Design system** — Tailwind · shadcn/ui · Custom
+3. **Framework(s)** — React · Vue · Svelte · React Native · SwiftUI · Jetpack Compose *(multi-select for monorepos)*
+
+Then it generates all three files, lints `DESIGN.md` with `@google/design.md`, wires up `.mcp.json` for your canvas, and installs skills to `~/.designagent/skills/`.
+
+## Why it's different
+
+- **Web + native mobile from day one** — the only design-agent setup that covers SwiftUI and Jetpack Compose, not just web.
+- **Canvas-agnostic** — sits *above* Figma, Pencil, and OpenPencil. Figma MCP gives Claude access; designagent gives Claude intelligence.
+- **Built on Google's open token spec** — `DESIGN.md` is a real, linted, diffable, exportable standard, not a bespoke format.
+- **Skills are just `.md` files** — framework-aware, community-contributable. Like dotfiles for design agents.
+
+## Tokens, everywhere
+
+`DESIGN.md` exports to real targets via the Google CLI:
+
+```bash
+npx @google/design.md export --format css-tailwind DESIGN.md   # Tailwind v4 @theme
+npx @google/design.md export --format dtcg DESIGN.md           # W3C Design Tokens
+npx @google/design.md lint DESIGN.md                           # validate
+```
+
+For SwiftUI and Jetpack Compose, the `design-to-code` skill generates the token bridge (`DesignTokens.swift` / `Theme.kt`) directly from `DESIGN.md`.
+
+## License
+
+MIT · Built by Sherizan Sheikh · [designagent.dev](https://designagent.dev)