design-system
Design System — a system kept in local files
A design system is a folder, <root>, that keeps its content in ITS OWN FILES under <root>/project/; icons and
images are files under project/assets/ or uploads (<root>/_blobs/) named by the index. The page (served by
open-artifact open, The command line) reads those files and saves the user's edits back into them; a file you write
shows on the page within a second.
Write only under <root>/project/: a file elsewhere never shows. <root>/_blobs/ (uploads), <root>/_agent/
(requests from the page) and <root>/.artifact.json belong to the local server: never write inside them. (A file
you draft only to upload it sits in <root>/src/: Creating, step 2.)
open-artifact below stands for node <this skill's folder>/scripts/cli.mjs (Node 22 or later).
A system kept in files
Its index is project/design-system.json, nothing else, holding a createdOnFiles or
convertedFrom object, the marker (read it first; no project/design-system.json: an empty
system, see Creating; for a clean-up, stop and say so):
{"v":3, "layout":"files", "createdOnFiles":{"v":1,"at":"2026-09-14T18:20:00Z"}, "title":"Acme", "namespace":"Acme", "libraries":[{"name":"react","version":"18.3.1","global":"React"},{"name":"react-dom","version":"18.3.1","global":"ReactDOM"}], "sections":{}, "groups":["Logos","Icons"], "assetGroups":{"Logos":{"name":"Logos","tile":"l","order":[],"files":{}}}, "blobs":{}, "docs":{"readme":"project/README.md","sections":[]}}.