{"adoption": {"forks": 2285, "observed_at": "2026-08-28T04:11:47.796878+00:00", "stars": 27525}, "canonical_url": "https://ross.abutalabs.com/products/designmd", "card": {"archived": false, "artifact_type": "library", "description": "A format specification for describing a visual identity to coding agents. DESIGN.md gives agents a persistent, structured understanding of a design system.", "domain": ["web-development", "frontend", "web-design", "developer-tools", "artificial-intelligence", "documentation"], "enriched": true, "function": ["documentation", "linter", "developer-tools", "cli", "accessibility"], "health_score": 97, "homepage": "https://stitch.withgoogle.com/docs/design-md/specification", "language": "TypeScript", "license": "Apache-2.0", "license_family": "permissive", "maturity": "active", "member_repos": ["google-labs-code/design.md"], "name": "google-labs-code/design.md", "platform": ["cli", "cross-platform"], "pushed_at": "2026-07-27T21:15:07+00:00", "repo": "google-labs-code/design.md", "stars": 27525, "tags": ["design-systems", "design-tokens", "coding-agents", "ai-coding", "specification", "wcag", "yaml-front-matter", "visual-identity", "nodejs"], "topics": [], "urls": [], "use_cases": ["give coding agents a persistent understanding of my design system", "lint a design tokens file for broken references and contrast issues", "check WCAG color contrast ratios in a design spec", "diff two versions of a design system for regressions", "document design tokens and rationale in one file", "make AI-generated UI match my brand guidelines"], "what_it_is": "DESIGN.md is a format specification for describing a visual identity and design system to coding agents, combining YAML design tokens with markdown design rationale. It ships with an npm CLI that lints DESIGN.md files, checks WCAG contrast ratios, and diffs two versions for token or prose regressions.", "when_to_avoid": ["you need a full design token build pipeline or theme compilation to CSS", "your project has no AI-assisted development workflow", "you need runtime theming rather than a static specification"], "when_to_choose": ["you use AI coding agents and want them to consistently follow your visual identity", "you need a machine-readable plus human-readable design system file", "you want automated validation of design tokens and accessibility contrast"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/designmd", "repo": "google-labs-code/design.md", "role": "main", "score": 78}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:11:47.796878+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T07:20:52.944354+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "052b7975dce055b3e6c365223cc338c844f6c0177820963ce1f35f57b9869d74", "fetched_at": "2026-08-28T04:11:47.796878+00:00", "kind": "readme", "missing": false, "url": "https://github.com/google-labs-code/design.md"}, {"content_hash": "a4fb11296e65ec741f019c856a53bbfbbca35d42ddea5404bb9eef7d7e71c9d5", "fetched_at": "2026-08-29T07:51:53.564188+00:00", "kind": "homepage", "missing": false, "url": "https://stitch.withgoogle.com/docs/design-md/specification"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 94, "longevity": 10, "rhythm": 95}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["young"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 145, "days_push": 37, "days_rel": 37, "gap_med": 27.0, "n_releases_24m": 5}, "score": 78, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}