Release Notes: @google/design.md v0.1.0

We are excited to announce the initial open-source release of @google/design.md, an agent-first CLI and linter for the DESIGN.md format. This tool bridges the gap between design systems and code by providing a formal, machine-readable way to validate and compile design tokens documented in markdown.

🚀 Features

• Design System Linter: Validates DESIGN.md files against the formal spec, catching unresolved references, circular dependencies, and invalid token values.
• Spec Generator: Generates human-readable specification documentation from the core schema.
• Agent-First Design: Deterministic JSON output and silent execution modes optimized for AI agents performing design system maintenance.

🛠 Improvements & Fixes

• Clean JSON Output: Purged debug logging to ensure output is pure JSON and safe for piping to other tools or AI agents.
• Windows Shell Compatibility: Added designmd binary alias to prevent Windows from confusing the .md extension with a file association.
• Startup Reliability: Resolved module loading issues that could cause crashes on import.
• Self-Contained Package: Optimized the package to be self-contained, reducing install size and avoiding dependency conflicts.

📦 Installation

Install globally via npm or bun:

npm install -g @google/design.md
# or
bun add -g @google/design.md

Or run directly via npx:

npx @google/design.md lint DESIGN.md

(Windows users: use npx designmd if file extension associations cause issues).