Skip to content

feat(design-md): mirror 71-brand catalog + /design-md command (v6.49.0)#193

Merged
sergei-aronsen merged 2 commits into
mainfrom
feature/design-md-mirror
May 20, 2026
Merged

feat(design-md): mirror 71-brand catalog + /design-md command (v6.49.0)#193
sergei-aronsen merged 2 commits into
mainfrom
feature/design-md-mirror

Conversation

@sergei-aronsen
Copy link
Copy Markdown
Owner

Summary

  • Mirror VoltAgent/awesome-design-md at upstream 3883984baf05226208a5dae15730a3593548b808 — 71 brand DESIGN.md files under templates/design-md/<brand>/DESIGN.md (2.1 MB total).
  • New /design-md [brand] slash command resolves a brand from a local toolkit clone or from the toolkit's raw GitHub pin (never from upstream directly) and writes <project-root>/DESIGN.md.
  • Vendor pin manifest.json:vendor_pins.awesome-design-md for drift tracking via /vendor-changelog.
  • Lint exclusion for templates/design-md/ — same precedent as templates/skills-marketplace/: vendored upstream content stays as upstream wrote it.
  • Version bump 6.48.1 → 6.49.0.

Why

Coding agents default to generic UI aesthetics. A single DESIGN.md at the project root with structured tokens (colors, typography, spacing, radii, motion) fixes this with zero infrastructure. This is the lightweight companion to the existing components/open-design.md integration (which solves the heavier artifact-rendering problem with a localhost web app + 149 brands).

Files

  • New: templates/design-md/<71 brands>/DESIGN.md
  • New: templates/design-md/INDEX.json — single source of truth for the picker
  • New: commands/design-md.md
  • New: components/design-md-guide.md
  • Updated: manifest.json, CHANGELOG.md, .markdownlintignore

Test plan

  • make check — all gates pass (shellcheck, markdownlint, validate, version-align, translation-drift, conflicts_with schema, commands schema, integrations-catalog, markdownlint config alignment, skills Desktop-safety audit, cell-parity)
  • python3 -c "import json; json.load(open('manifest.json'))" — JSON valid
  • vendor_pin entry follows existing schema (repo, tag, commit, pinned_at + optional mirror_path/mirror_subset)
  • 71 DESIGN.md files downloaded, no zero-byte files, smallest 4.3 KB / largest 44 KB
  • INDEX.json reflects all 71 brand directories
  • CI on GitHub Actions
  • /design-md vercel smoke test inside a clean project after merge + /update-toolkit
  • /vendor-changelog next run picks up the new pin

🤖 Generated with Claude Code

involvenodev and others added 2 commits May 20, 2026 13:49
Adds VoltAgent/awesome-design-md as a vendored catalog so coding agents
can drop a brand-inspired DESIGN.md into any project. Solves the generic-
AI-aesthetics problem with one Markdown file at the project root — no
Docker, no daemon, no extra tooling (complementary to the heavier
open-design.md integration).

- Mirror: templates/design-md/<71 brands>/DESIGN.md (2.1 MB total),
  pinned to upstream 3883984baf05226208a5dae15730a3593548b808.
- Catalog: templates/design-md/INDEX.json — single source of truth for
  the picker.
- Command: commands/design-md.md — /design-md [brand], local clone or
  toolkit-pinned raw GitHub fetch (never moving upstream).
- Doc: components/design-md-guide.md — when to use vs the existing
  open-design.md integration.
- Pin: manifest.json:vendor_pins.awesome-design-md for drift tracking
  via /vendor-changelog.
- Lint: templates/design-md/ added to .markdownlintignore alongside
  templates/skills-marketplace/ — vendored content stays as upstream
  wrote it.
- Version: 6.48.1 -> 6.49.0.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
CI exposed two regressions in PR #193:

1. .markdownlint-cli2.jsonc was missing the templates/design-md/**
   ignore entry. The Makefile's `make mdlint` uses the older
   markdownlint (cli v1) which reads .markdownlintignore (already
   updated). CI uses markdownlint-cli2-action which reads the cli2
   config — added the same ignore there.

2. scripts/tests/test-toolkit-ref-pinned.sh (REL-03) enforces that
   every installer's TK_TOOLKIT_REF default matches manifest.version.
   The version bump 6.48.1 → 6.49.0 was missed in 9 scripts:
   init-claude.sh, install-statusline.sh, install.sh,
   migrate-to-complement.sh, setup-council.sh,
   setup-prompt-engineer.sh, setup-security.sh, uninstall.sh,
   update-claude.sh.

`make check` re-runs clean.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@sergei-aronsen sergei-aronsen merged commit 17a642e into main May 20, 2026
10 checks passed
@sergei-aronsen sergei-aronsen deleted the feature/design-md-mirror branch May 20, 2026 12:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants