design.v1 — 1.2.0

Reference tooling ships, and a five-lens adversarial audit (47 findings, all fixed) hardens the spec, schema, examples, and scripts.

Reference tooling

• scripts/export_design.py — emits the exports.* artifacts from any .design file: CSS custom properties with mode strategies (media query / data-theme attribute / both, explicit toggle beats OS preference), Tailwind v4 @theme, DTCG JSON, and a shadcn registry:theme item installable in any project.
• scripts/diff_design.py — SPEC §18 made real: added / removed / modified per token group, component/variant/locked changes, a regression flag, and --fail-on-regression for CI.
• Both smoke-tested in CI alongside the schema-validating linter.

Audit fixes (highlights)

• One canonical agent.instructions template — SPEC §8, docs, converter, and every shipped .design file now carry the identical self-teaching block (themes duty, figma rule, §18 verify format, NEVER section); the patch tool re-stamps all files idempotently.
• Spec correctness: the §15.1.1 example was invalid YAML against the spec's own schema ("transition: all" now quoted); version now validates as real SemVer; write-safety duties are testable and consistent (§3/§23); heading hierarchy and field docs cleaned up.
• Schema hardening: malformed catalog entries (variants/when as strings) no longer validate through the property-bag branch; nested zIndex; open sources[].type.
• Safe tooling: the example converter no longer deletes all examples before discovering its inputs are missing on a fresh clone — it aborts with instructions; the linter survives malformed files and reports them instead of crashing; depth checks, omitted parent-path suppression, and {components.*} reference resolution fixed.
• Example hygiene: descriptions readable (no \uXXXX escapes, no mid-word truncation, refs rewritten, uniform independent-analysis framing); dangling private-pipeline references scrubbed from one upstream analysis.
• Docs: shadcn diagrams render their line breaks; contradictory claims reconciled; PHILOSOPHY matches the required-agent.instructions reality.

Full details: CHANGELOG.

🤖 Generated with Claude Code

design.v1 — 1.1.0

The .design contract grows a voice, a committed aesthetic, and full current-ecosystem interop — plus CI-enforced validation and an annotated starter template.

New in the format

• voice — the UI copy contract: register, casing, terminology map, action-name continuity, error style. Applied with the same force as tokens (SPEC §13C).
• Committed intent — intent.direction (named aesthetic), intent.signature (the one element where boldness concentrates), intent.treatment (utilitarian | editorial) with per-surface patterns.<name>.treatment overrides.
• Nested token groups (depth ≤ 20) with full dot-path refs, token→token reference chains (depth ≤ 10), tokens.background atmosphere group, motion/spring tokens, typography font stacks + fallbacks.
• policy.color.accent_cycle, generalized decisions.* (token-role rules like decisions.typography), themes.single, designed-not-inverted mode rule, CSS mode-emission strategy.
• Reading tiers for large files; targets object form with environment constraints (external_assets: false, single_file).

Interop

• shadcn/ui, current model — styles (vega…sera, new-york legacy), primitive base (base | radix | react-aria), icon_library, presets, namespaced/private registries (never-guess rule), MCP, full variable set (chart-1…5, sidebar-*), css_vars.theme, Tailwind v4 @theme inline, and exports.shadcn_registry — ship your brand as an installable registry:theme item.
• Google DESIGN.md — lossless import verified against 0.4.0: nesting, version-field semantics, radius export units, omitted namespaces, CLI interop table.

Quality

• Schema hardened: flat component property bags validate, variants ⇒ when/when_not enforced, typed token groups.
• scripts/lint_design.py in CI: schema validation of every example, WCAG contrast checks, alias-collision detection, reference resolution, instruction-duty coverage — plus a leak guard.
• Massively expanded craft bar in the portable skill (typography/color-scale numbers, iconography, gestures, performance, information architecture, default-looks-to-avoid catalogue) and a plan → critique → confirm → write bootstrap.
• templates/starter.design — annotated kitchen-sink contract: copy as .design, replace values, go.

Full details: CHANGELOG.

🤖 Generated with Claude Code

design.v1 — Living Visual Contract

.design v1.0.0

First stable release of the AgentsORG design.v1 format.

Highlights

• Self-contained files — required agent.instructions so drag-drop / @-mention works without installing the skill
• Portable skill — npx skills add AgentsORG/DESIGN --skill design (procedure + CRAFT bar)
• DESIGN.md parity — tokens, component property bags, full rationale sections
• Integrations — shadcn/ui theme vars, Figma sync hints, themes, exports (DTCG/CSS/Tailwind)
• Examples — Vercel, Stripe, Notion, Apple, Linear, Supabase (independent analyses; see NOTICE.md)

Docs

• https://github.com/AgentsORG/DESIGN/blob/main/docs/INDEX.md
• Spec: https://github.com/AgentsORG/DESIGN/blob/main/SPEC.md

Install

npx skills add AgentsORG/DESIGN --skill design
cp examples/vercel.design ./.design