@design-ai/cli 4.55.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/.claude-plugin/plugin.json +164 -0
  2. package/AGENTS.ko.md +126 -0
  3. package/AGENTS.md +182 -0
  4. package/CHANGELOG.md +6883 -0
  5. package/CLAUDE.md +39 -0
  6. package/LICENSE +21 -0
  7. package/README.ko.md +245 -0
  8. package/README.md +277 -0
  9. package/agents/README.md +14 -0
  10. package/agents/a11y-reviewer.md +121 -0
  11. package/agents/component-architect.md +57 -0
  12. package/agents/design-critic.md +46 -0
  13. package/agents/token-extractor.md +63 -0
  14. package/cli/bin/design-ai-mcp.mjs +6 -0
  15. package/cli/bin/design-ai.mjs +40 -0
  16. package/cli/commands/audit.mjs +111 -0
  17. package/cli/commands/check.mjs +226 -0
  18. package/cli/commands/doctor.mjs +141 -0
  19. package/cli/commands/examples.mjs +58 -0
  20. package/cli/commands/help.mjs +271 -0
  21. package/cli/commands/install.mjs +161 -0
  22. package/cli/commands/learn.mjs +1871 -0
  23. package/cli/commands/list.mjs +143 -0
  24. package/cli/commands/mcp.mjs +27 -0
  25. package/cli/commands/pack.mjs +211 -0
  26. package/cli/commands/prompt.mjs +199 -0
  27. package/cli/commands/route.mjs +247 -0
  28. package/cli/commands/search.mjs +60 -0
  29. package/cli/commands/show.mjs +52 -0
  30. package/cli/commands/site.mjs +558 -0
  31. package/cli/commands/status.mjs +161 -0
  32. package/cli/commands/uninstall.mjs +119 -0
  33. package/cli/commands/update.mjs +184 -0
  34. package/cli/commands/version.mjs +94 -0
  35. package/cli/commands/workspace.mjs +176 -0
  36. package/cli/lib/brief.mjs +52 -0
  37. package/cli/lib/check.mjs +642 -0
  38. package/cli/lib/dispatch.mjs +109 -0
  39. package/cli/lib/doctor.mjs +505 -0
  40. package/cli/lib/examples.mjs +258 -0
  41. package/cli/lib/exec.mjs +63 -0
  42. package/cli/lib/help-flags.mjs +5 -0
  43. package/cli/lib/learn.mjs +3694 -0
  44. package/cli/lib/log.mjs +47 -0
  45. package/cli/lib/mcp-server.mjs +426 -0
  46. package/cli/lib/output.mjs +101 -0
  47. package/cli/lib/pack.mjs +599 -0
  48. package/cli/lib/paths.mjs +63 -0
  49. package/cli/lib/prompt.mjs +603 -0
  50. package/cli/lib/route.mjs +740 -0
  51. package/cli/lib/search.mjs +158 -0
  52. package/cli/lib/show.mjs +161 -0
  53. package/cli/lib/signals.mjs +2337 -0
  54. package/cli/lib/site.mjs +6617 -0
  55. package/cli/lib/skill-proposals.mjs +2046 -0
  56. package/cli/lib/suggest.mjs +66 -0
  57. package/cli/lib/workspace.mjs +1056 -0
  58. package/commands/README.md +25 -0
  59. package/commands/component-spec.md +34 -0
  60. package/commands/conversational.md +44 -0
  61. package/commands/design-from-brief.md +141 -0
  62. package/commands/design-review.md +62 -0
  63. package/commands/document-from-brief.md +47 -0
  64. package/commands/extract-tokens.md +38 -0
  65. package/commands/game-ui.md +40 -0
  66. package/commands/illustration.md +37 -0
  67. package/commands/iterate.md +167 -0
  68. package/commands/motion-design.md +54 -0
  69. package/commands/palette-from-brand.md +50 -0
  70. package/commands/print.md +49 -0
  71. package/commands/slide-deck.md +46 -0
  72. package/commands/spatial.md +47 -0
  73. package/commands/stability-review.md +74 -0
  74. package/commands/video.md +42 -0
  75. package/commands/website-improvement.md +77 -0
  76. package/docs/AGENT-DEVELOPMENT.md +658 -0
  77. package/docs/AI-LEARNING.md +429 -0
  78. package/docs/AIDER-INTEGRATION.md +224 -0
  79. package/docs/ARCHITECTURE.ko.md +183 -0
  80. package/docs/ARCHITECTURE.md +105 -0
  81. package/docs/CODEX-INTEGRATION.md +311 -0
  82. package/docs/COMPANY-WEBSITE-DOGFOOD.ko.md +144 -0
  83. package/docs/COMPANY-WEBSITE-DOGFOOD.md +150 -0
  84. package/docs/COMPANY-WEBSITE-INTAKE-TEMPLATE.ko.md +153 -0
  85. package/docs/COMPANY-WEBSITE-INTAKE-TEMPLATE.md +154 -0
  86. package/docs/CONTRIBUTING.ko.md +203 -0
  87. package/docs/CONTRIBUTING.md +242 -0
  88. package/docs/CURSOR-INTEGRATION.md +220 -0
  89. package/docs/DISTRIBUTION.ko.md +248 -0
  90. package/docs/DISTRIBUTION.md +253 -0
  91. package/docs/DOGFOOD-FINDINGS.md +180 -0
  92. package/docs/DOGFOOD-V4-FINDINGS.md +139 -0
  93. package/docs/DOGFOOD-V4-MKDOCS-FINDINGS.md +233 -0
  94. package/docs/DOGFOOD-V4-NPM-FINDINGS.md +157 -0
  95. package/docs/DOGFOOD-V4-VSCODE-FINDINGS.md +135 -0
  96. package/docs/FIGMA-INTEGRATION.md +222 -0
  97. package/docs/MCP-INTEGRATION.md +243 -0
  98. package/docs/MIGRATION-v4.md +121 -0
  99. package/docs/PLUGIN-PACKAGING.md +240 -0
  100. package/docs/PRODUCT-READINESS.md +66 -0
  101. package/docs/QUICKSTART.ko.md +178 -0
  102. package/docs/QUICKSTART.md +179 -0
  103. package/docs/RELEASE-CHECKLIST.md +292 -0
  104. package/docs/ROADMAP.md +19495 -0
  105. package/docs/SESSION-LOG.md +940 -0
  106. package/docs/TOKEN-SYNC.md +237 -0
  107. package/docs/USING.ko.md +206 -0
  108. package/docs/USING.md +218 -0
  109. package/docs/WEBSITE-IMPROVEMENT.ko.md +75 -0
  110. package/docs/WEBSITE-IMPROVEMENT.md +89 -0
  111. package/docs/announcements/README.md +56 -0
  112. package/docs/announcements/dev-to-korea.md +206 -0
  113. package/docs/announcements/hashnode-post.ko.md +232 -0
  114. package/docs/announcements/okky-post.ko.md +158 -0
  115. package/docs/announcements/press-kit.md +101 -0
  116. package/docs/announcements/reddit-r-korea.md +196 -0
  117. package/docs/announcements/show-hn.md +114 -0
  118. package/docs/announcements/twitter-thread.md +255 -0
  119. package/docs/external-status.md +34 -0
  120. package/docs/integrations/aider-walkthrough.ko.md +275 -0
  121. package/docs/integrations/aider-walkthrough.md +274 -0
  122. package/docs/integrations/codex-walkthrough.ko.md +297 -0
  123. package/docs/integrations/codex-walkthrough.md +297 -0
  124. package/docs/integrations/cursor-walkthrough.ko.md +281 -0
  125. package/docs/integrations/cursor-walkthrough.md +284 -0
  126. package/docs/integrations/design-ai-mcp-server.md +169 -0
  127. package/docs/integrations/figma-mcp.md +149 -0
  128. package/docs/integrations/github-mcp.md +178 -0
  129. package/docs/integrations/linear-mcp.md +215 -0
  130. package/docs/integrations/notion-mcp.md +174 -0
  131. package/docs/integrations/sdk-walkthrough.ko.md +375 -0
  132. package/docs/integrations/sdk-walkthrough.md +375 -0
  133. package/docs/integrations/slack-mcp.md +208 -0
  134. package/docs/integrations/vscode-walkthrough.ko.md +202 -0
  135. package/docs/integrations/vscode-walkthrough.md +205 -0
  136. package/docs/requirements.txt +16 -0
  137. package/docs/site-overrides/extra.css +83 -0
  138. package/docs/site-overrides/favicon.svg +4 -0
  139. package/docs/site-overrides/logo.svg +10 -0
  140. package/docs/site-overrides/main.html +18 -0
  141. package/docs/website-console/app.js +2540 -0
  142. package/docs/website-console/index.html +24 -0
  143. package/docs/website-console/styles.css +975 -0
  144. package/examples/README.md +252 -0
  145. package/examples/cases/dogfood-v4-korean-hr-onboarding.md +356 -0
  146. package/examples/component-accordion-actions.md +153 -0
  147. package/examples/component-accordion-details.md +147 -0
  148. package/examples/component-accordion-summary.md +180 -0
  149. package/examples/component-accordion.md +229 -0
  150. package/examples/component-account-card.md +284 -0
  151. package/examples/component-address-input.md +260 -0
  152. package/examples/component-affix.md +190 -0
  153. package/examples/component-alert-dialog.md +210 -0
  154. package/examples/component-alert-title.md +77 -0
  155. package/examples/component-alert.md +192 -0
  156. package/examples/component-amount-input.md +278 -0
  157. package/examples/component-anchor.md +198 -0
  158. package/examples/component-app-bar.md +249 -0
  159. package/examples/component-aspect-ratio.md +156 -0
  160. package/examples/component-auto-complete.md +199 -0
  161. package/examples/component-avatar-group.md +170 -0
  162. package/examples/component-avatar.md +191 -0
  163. package/examples/component-back-top.md +123 -0
  164. package/examples/component-backdrop.md +148 -0
  165. package/examples/component-badge.md +181 -0
  166. package/examples/component-banner.md +237 -0
  167. package/examples/component-biometric-gate.md +281 -0
  168. package/examples/component-blockquote.md +153 -0
  169. package/examples/component-border-beam.md +207 -0
  170. package/examples/component-bottom-navigation.md +226 -0
  171. package/examples/component-box.md +112 -0
  172. package/examples/component-breadcrumb.md +222 -0
  173. package/examples/component-button-base.md +190 -0
  174. package/examples/component-button-group.md +117 -0
  175. package/examples/component-button.md +213 -0
  176. package/examples/component-calendar.md +280 -0
  177. package/examples/component-callout.md +131 -0
  178. package/examples/component-card-actions.md +101 -0
  179. package/examples/component-card-content.md +90 -0
  180. package/examples/component-card-header.md +122 -0
  181. package/examples/component-card-media.md +79 -0
  182. package/examples/component-card.md +233 -0
  183. package/examples/component-carousel.md +266 -0
  184. package/examples/component-cascader.md +135 -0
  185. package/examples/component-category-picker.md +271 -0
  186. package/examples/component-chart.md +237 -0
  187. package/examples/component-chat-interface.md +399 -0
  188. package/examples/component-checkbox.md +149 -0
  189. package/examples/component-click-away-listener.md +87 -0
  190. package/examples/component-code.md +213 -0
  191. package/examples/component-collapsible.md +219 -0
  192. package/examples/component-color-picker.md +110 -0
  193. package/examples/component-combobox.md +267 -0
  194. package/examples/component-command.md +299 -0
  195. package/examples/component-config-provider.md +190 -0
  196. package/examples/component-context-menu.md +179 -0
  197. package/examples/component-css-baseline.md +148 -0
  198. package/examples/component-date-picker.md +249 -0
  199. package/examples/component-descriptions.md +242 -0
  200. package/examples/component-dialog-actions.md +111 -0
  201. package/examples/component-dialog-content-text.md +76 -0
  202. package/examples/component-dialog-content.md +105 -0
  203. package/examples/component-dialog-title.md +104 -0
  204. package/examples/component-dialog.md +176 -0
  205. package/examples/component-divider.md +182 -0
  206. package/examples/component-doc-page.md +217 -0
  207. package/examples/component-drawer.md +257 -0
  208. package/examples/component-dropdown.md +220 -0
  209. package/examples/component-email-layout.md +253 -0
  210. package/examples/component-empty-state.md +269 -0
  211. package/examples/component-empty.md +172 -0
  212. package/examples/component-fade.md +87 -0
  213. package/examples/component-feature-grid.md +201 -0
  214. package/examples/component-field.md +266 -0
  215. package/examples/component-filled-input.md +114 -0
  216. package/examples/component-flex.md +117 -0
  217. package/examples/component-float-button.md +214 -0
  218. package/examples/component-form-control-label.md +134 -0
  219. package/examples/component-form-control.md +113 -0
  220. package/examples/component-form-controls.md +251 -0
  221. package/examples/component-form-group.md +86 -0
  222. package/examples/component-form-helper-text.md +95 -0
  223. package/examples/component-form-label.md +98 -0
  224. package/examples/component-form.md +291 -0
  225. package/examples/component-game-hud.md +362 -0
  226. package/examples/component-game-menu.md +327 -0
  227. package/examples/component-grid.md +140 -0
  228. package/examples/component-grow.md +79 -0
  229. package/examples/component-hero-block.md +252 -0
  230. package/examples/component-hover-card.md +211 -0
  231. package/examples/component-icon-button.md +142 -0
  232. package/examples/component-icon.md +102 -0
  233. package/examples/component-illustration.md +280 -0
  234. package/examples/component-image-list.md +107 -0
  235. package/examples/component-image.md +282 -0
  236. package/examples/component-input-adornment.md +101 -0
  237. package/examples/component-input-base.md +134 -0
  238. package/examples/component-input-number.md +141 -0
  239. package/examples/component-input-otp.md +271 -0
  240. package/examples/component-input.md +213 -0
  241. package/examples/component-item.md +243 -0
  242. package/examples/component-kbd.md +197 -0
  243. package/examples/component-krw-amount.md +219 -0
  244. package/examples/component-label.md +118 -0
  245. package/examples/component-layout.md +217 -0
  246. package/examples/component-link.md +223 -0
  247. package/examples/component-list-item-avatar.md +72 -0
  248. package/examples/component-list-item-button.md +139 -0
  249. package/examples/component-list-item-icon.md +82 -0
  250. package/examples/component-list-item-text.md +98 -0
  251. package/examples/component-list-item.md +116 -0
  252. package/examples/component-list-subheader.md +70 -0
  253. package/examples/component-list.md +198 -0
  254. package/examples/component-loading-button.md +125 -0
  255. package/examples/component-loading-sequence.md +254 -0
  256. package/examples/component-lottie-player.md +279 -0
  257. package/examples/component-masonry.md +191 -0
  258. package/examples/component-mentions.md +189 -0
  259. package/examples/component-menu-item.md +102 -0
  260. package/examples/component-menu-list.md +98 -0
  261. package/examples/component-menu.md +139 -0
  262. package/examples/component-menubar.md +259 -0
  263. package/examples/component-message.md +162 -0
  264. package/examples/component-mobile-stepper.md +155 -0
  265. package/examples/component-modal.md +220 -0
  266. package/examples/component-navigation-menu.md +295 -0
  267. package/examples/component-notification.md +166 -0
  268. package/examples/component-otp-countdown.md +245 -0
  269. package/examples/component-outlined-input.md +145 -0
  270. package/examples/component-page-transition.md +281 -0
  271. package/examples/component-pagination.md +226 -0
  272. package/examples/component-paper.md +199 -0
  273. package/examples/component-pass-auth.md +265 -0
  274. package/examples/component-payment-brand-button.md +253 -0
  275. package/examples/component-payment-method-selector.md +272 -0
  276. package/examples/component-payment-receipt.md +277 -0
  277. package/examples/component-popconfirm.md +144 -0
  278. package/examples/component-popover.md +239 -0
  279. package/examples/component-popper.md +129 -0
  280. package/examples/component-pricing-cards.md +247 -0
  281. package/examples/component-progress.md +195 -0
  282. package/examples/component-qr-code.md +201 -0
  283. package/examples/component-radio.md +167 -0
  284. package/examples/component-rate.md +202 -0
  285. package/examples/component-resizable.md +163 -0
  286. package/examples/component-result.md +270 -0
  287. package/examples/component-scroll-area.md +199 -0
  288. package/examples/component-scroll-reveal.md +320 -0
  289. package/examples/component-segmented.md +178 -0
  290. package/examples/component-select.md +258 -0
  291. package/examples/component-separator.md +177 -0
  292. package/examples/component-sheet.md +277 -0
  293. package/examples/component-sidebar.md +257 -0
  294. package/examples/component-skeleton.md +178 -0
  295. package/examples/component-slide.md +89 -0
  296. package/examples/component-slider.md +208 -0
  297. package/examples/component-snackbar-content.md +92 -0
  298. package/examples/component-snackbar.md +121 -0
  299. package/examples/component-sonner.md +165 -0
  300. package/examples/component-space.md +125 -0
  301. package/examples/component-spatial-locomotion.md +373 -0
  302. package/examples/component-spatial-panel.md +330 -0
  303. package/examples/component-speed-dial-action.md +78 -0
  304. package/examples/component-speed-dial.md +177 -0
  305. package/examples/component-spin.md +173 -0
  306. package/examples/component-spinner.md +204 -0
  307. package/examples/component-splitter.md +210 -0
  308. package/examples/component-stack.md +130 -0
  309. package/examples/component-statistic.md +282 -0
  310. package/examples/component-step-button.md +157 -0
  311. package/examples/component-step-connector.md +157 -0
  312. package/examples/component-step-content.md +121 -0
  313. package/examples/component-step-icon.md +115 -0
  314. package/examples/component-step-label.md +101 -0
  315. package/examples/component-step.md +84 -0
  316. package/examples/component-steps.md +264 -0
  317. package/examples/component-stock-chart.md +251 -0
  318. package/examples/component-swipeable-drawer.md +149 -0
  319. package/examples/component-switch.md +99 -0
  320. package/examples/component-tab-scroll-button.md +180 -0
  321. package/examples/component-tab.md +120 -0
  322. package/examples/component-table-body.md +82 -0
  323. package/examples/component-table-cell.md +118 -0
  324. package/examples/component-table-container.md +75 -0
  325. package/examples/component-table-footer.md +72 -0
  326. package/examples/component-table-head.md +78 -0
  327. package/examples/component-table-pagination.md +137 -0
  328. package/examples/component-table-row.md +113 -0
  329. package/examples/component-table-sort-label.md +109 -0
  330. package/examples/component-table.md +202 -0
  331. package/examples/component-tabs.md +184 -0
  332. package/examples/component-tag-badge.md +309 -0
  333. package/examples/component-tag.md +102 -0
  334. package/examples/component-testimonial-carousel.md +218 -0
  335. package/examples/component-textarea-autosize.md +114 -0
  336. package/examples/component-textarea.md +173 -0
  337. package/examples/component-time-picker.md +205 -0
  338. package/examples/component-timeline.md +170 -0
  339. package/examples/component-toast.md +224 -0
  340. package/examples/component-toggle-button.md +129 -0
  341. package/examples/component-toggle.md +220 -0
  342. package/examples/component-toolbar.md +104 -0
  343. package/examples/component-tooltip.md +178 -0
  344. package/examples/component-tour.md +176 -0
  345. package/examples/component-transaction-list-item.md +243 -0
  346. package/examples/component-transfer.md +156 -0
  347. package/examples/component-tree-select.md +202 -0
  348. package/examples/component-tree.md +297 -0
  349. package/examples/component-typography.md +215 -0
  350. package/examples/component-upload.md +295 -0
  351. package/examples/component-video-hero.md +409 -0
  352. package/examples/component-video-player.md +340 -0
  353. package/examples/component-voice-input.md +408 -0
  354. package/examples/component-watermark.md +217 -0
  355. package/examples/component-zoom.md +92 -0
  356. package/examples/doc-explanation-example.md +196 -0
  357. package/examples/doc-how-to-example.md +205 -0
  358. package/examples/doc-tutorial-example.md +162 -0
  359. package/examples/dogfood-korean-fintech-system.md +433 -0
  360. package/examples/email-transactional-example.md +259 -0
  361. package/examples/palette-saas-violet.md +235 -0
  362. package/examples/print-business-card-spec.md +205 -0
  363. package/examples/print-packaging-spec.md +285 -0
  364. package/examples/report-example.md +228 -0
  365. package/examples/slide-deck-example.md +237 -0
  366. package/examples/website-improvement-report.md +128 -0
  367. package/examples/website-improvement-workspace.json +126 -0
  368. package/install.sh +189 -0
  369. package/knowledge/COVERAGE.md +740 -0
  370. package/knowledge/PRINCIPLES.md +108 -0
  371. package/knowledge/a11y/contrast.md +70 -0
  372. package/knowledge/a11y/keyboard-and-focus.md +108 -0
  373. package/knowledge/colors/color-theory.md +90 -0
  374. package/knowledge/colors/mui-palette-structure.md +105 -0
  375. package/knowledge/colors/palettes-by-product-type.md +876 -0
  376. package/knowledge/components/INDEX.md +231 -0
  377. package/knowledge/components/index.json +1470 -0
  378. package/knowledge/components/shadcn-registry.md +159 -0
  379. package/knowledge/conversational/ai-chat-interfaces.md +323 -0
  380. package/knowledge/conversational/chatbot-design.md +312 -0
  381. package/knowledge/conversational/conversational-ui-fundamentals.md +299 -0
  382. package/knowledge/conversational/korean-voice-conventions.md +281 -0
  383. package/knowledge/conversational/voice-ui-patterns.md +297 -0
  384. package/knowledge/design-tokens/ant-design.md +124 -0
  385. package/knowledge/design-tokens/material-3.md +235 -0
  386. package/knowledge/design-tokens/polaris-and-carbon.md +231 -0
  387. package/knowledge/design-tokens/tailwind-v4.md +284 -0
  388. package/knowledge/game-ui/game-accessibility.md +317 -0
  389. package/knowledge/game-ui/game-ui-fundamentals.md +281 -0
  390. package/knowledge/game-ui/hud-design.md +324 -0
  391. package/knowledge/game-ui/korean-gaming-conventions.md +312 -0
  392. package/knowledge/game-ui/menu-systems.md +388 -0
  393. package/knowledge/i18n/korean-app-store-visual.md +223 -0
  394. package/knowledge/i18n/korean-document-style.md +301 -0
  395. package/knowledge/i18n/korean-payments.md +211 -0
  396. package/knowledge/i18n/korean-product-conventions.md +96 -0
  397. package/knowledge/i18n/korean-publishing.md +139 -0
  398. package/knowledge/i18n/korean-typography.md +123 -0
  399. package/knowledge/icons/curated-sets.md +225 -0
  400. package/knowledge/illustration/hero-illustrations.md +234 -0
  401. package/knowledge/illustration/illustration-systems.md +221 -0
  402. package/knowledge/illustration/mascot-design.md +208 -0
  403. package/knowledge/illustration/spot-illustrations.md +246 -0
  404. package/knowledge/illustration/svg-optimization.md +308 -0
  405. package/knowledge/layout/spacing-and-grid.md +119 -0
  406. package/knowledge/motion/app-loading-sequences.md +277 -0
  407. package/knowledge/motion/choreography-depth.md +297 -0
  408. package/knowledge/motion/marketing-motion.md +223 -0
  409. package/knowledge/motion/micro-interactions.md +266 -0
  410. package/knowledge/motion/motion-tools.md +281 -0
  411. package/knowledge/motion/principles.md +126 -0
  412. package/knowledge/patterns/auth-flow-design.md +316 -0
  413. package/knowledge/patterns/b2b-onboarding-flows.md +182 -0
  414. package/knowledge/patterns/brand-identity.md +238 -0
  415. package/knowledge/patterns/brand-references.md +97 -0
  416. package/knowledge/patterns/chart-color-encoding.md +269 -0
  417. package/knowledge/patterns/chart-types.md +344 -0
  418. package/knowledge/patterns/dashboard-composition.md +299 -0
  419. package/knowledge/patterns/design-system-qa.md +356 -0
  420. package/knowledge/patterns/document-typography.md +248 -0
  421. package/knowledge/patterns/email-design.md +338 -0
  422. package/knowledge/patterns/empty-states.md +263 -0
  423. package/knowledge/patterns/error-states.md +318 -0
  424. package/knowledge/patterns/form-design.md +237 -0
  425. package/knowledge/patterns/information-architecture.md +341 -0
  426. package/knowledge/patterns/landing-hero-design.md +283 -0
  427. package/knowledge/patterns/landing-page-patterns.md +681 -0
  428. package/knowledge/patterns/list-and-feed.md +371 -0
  429. package/knowledge/patterns/mobile-navigation.md +278 -0
  430. package/knowledge/patterns/money-and-amount.md +301 -0
  431. package/knowledge/patterns/onboarding.md +300 -0
  432. package/knowledge/patterns/pricing-page-design.md +261 -0
  433. package/knowledge/patterns/realtime-data.md +280 -0
  434. package/knowledge/patterns/report-design.md +330 -0
  435. package/knowledge/patterns/search-ux.md +373 -0
  436. package/knowledge/patterns/settings-page.md +325 -0
  437. package/knowledge/patterns/slide-deck-design.md +316 -0
  438. package/knowledge/patterns/styles-catalog.md +2599 -0
  439. package/knowledge/patterns/technical-writing.md +306 -0
  440. package/knowledge/patterns/ui-reasoning.md +1853 -0
  441. package/knowledge/patterns/ux-guidelines.md +1454 -0
  442. package/knowledge/platforms/react-native.md +395 -0
  443. package/knowledge/print/brochures-and-flyers.md +276 -0
  444. package/knowledge/print/korean-print-conventions.md +284 -0
  445. package/knowledge/print/packaging.md +321 -0
  446. package/knowledge/print/print-fundamentals.md +238 -0
  447. package/knowledge/print/signage-and-posters.md +235 -0
  448. package/knowledge/print/stationery.md +262 -0
  449. package/knowledge/spatial/ar-patterns.md +253 -0
  450. package/knowledge/spatial/comfort-and-accessibility.md +245 -0
  451. package/knowledge/spatial/spatial-design-fundamentals.md +346 -0
  452. package/knowledge/spatial/spatial-ui-elements.md +343 -0
  453. package/knowledge/spatial/vr-patterns.md +302 -0
  454. package/knowledge/typography/font-pairings.md +332 -0
  455. package/knowledge/typography/mui-type-scale.md +57 -0
  456. package/knowledge/typography/type-scale-fundamentals.md +105 -0
  457. package/knowledge/video/in-product-video.md +277 -0
  458. package/knowledge/video/korean-video-conventions.md +247 -0
  459. package/knowledge/video/marketing-video.md +258 -0
  460. package/knowledge/video/social-and-short-form.md +257 -0
  461. package/knowledge/video/video-fundamentals.md +296 -0
  462. package/package.json +106 -0
  463. package/skills/README.md +39 -0
  464. package/skills/color-palette/PLAYBOOK.md +175 -0
  465. package/skills/color-palette/SKILL.md +6 -0
  466. package/skills/color-palette/TEMPLATE.md +103 -0
  467. package/skills/component-spec-writer/PLAYBOOK.md +169 -0
  468. package/skills/component-spec-writer/SKILL.md +6 -0
  469. package/skills/component-spec-writer/TEMPLATE.md +115 -0
  470. package/skills/conversational-ui-designer/PLAYBOOK.md +231 -0
  471. package/skills/conversational-ui-designer/SKILL.md +6 -0
  472. package/skills/design-broadcast/PLAYBOOK.md +146 -0
  473. package/skills/design-broadcast/SKILL.md +6 -0
  474. package/skills/design-critique/PLAYBOOK.md +137 -0
  475. package/skills/design-critique/SKILL.md +6 -0
  476. package/skills/design-pr-review/PLAYBOOK.md +171 -0
  477. package/skills/design-pr-review/SKILL.md +6 -0
  478. package/skills/design-system-builder/PLAYBOOK.md +218 -0
  479. package/skills/design-system-builder/SKILL.md +6 -0
  480. package/skills/design-system-qa/PLAYBOOK.md +163 -0
  481. package/skills/design-system-qa/SKILL.md +6 -0
  482. package/skills/document-author/PLAYBOOK.md +167 -0
  483. package/skills/document-author/SKILL.md +6 -0
  484. package/skills/figma-token-sync/PLAYBOOK.md +149 -0
  485. package/skills/figma-token-sync/SKILL.md +6 -0
  486. package/skills/game-ui-designer/PLAYBOOK.md +209 -0
  487. package/skills/game-ui-designer/SKILL.md +6 -0
  488. package/skills/handoff-spec/PLAYBOOK.md +170 -0
  489. package/skills/handoff-spec/SKILL.md +6 -0
  490. package/skills/illustration-designer/PLAYBOOK.md +166 -0
  491. package/skills/illustration-designer/SKILL.md +6 -0
  492. package/skills/motion-designer/PLAYBOOK.md +223 -0
  493. package/skills/motion-designer/SKILL.md +6 -0
  494. package/skills/print-designer/PLAYBOOK.md +209 -0
  495. package/skills/print-designer/SKILL.md +6 -0
  496. package/skills/slide-deck-author/PLAYBOOK.md +198 -0
  497. package/skills/slide-deck-author/SKILL.md +6 -0
  498. package/skills/spatial-designer/PLAYBOOK.md +238 -0
  499. package/skills/spatial-designer/SKILL.md +6 -0
  500. package/skills/ux-audit/PLAYBOOK.md +142 -0
  501. package/skills/ux-audit/SKILL.md +6 -0
  502. package/skills/video-designer/PLAYBOOK.md +240 -0
  503. package/skills/video-designer/SKILL.md +6 -0
  504. package/skills/website-improvement/PLAYBOOK.md +118 -0
  505. package/skills/website-improvement/SKILL.md +6 -0
  506. package/skills/website-improvement/TEMPLATE.md +103 -0
  507. package/tools/audit/changelog-generate.py +176 -0
  508. package/tools/audit/check-coverage.py +483 -0
  509. package/tools/audit/doctor_assertions.py +256 -0
  510. package/tools/audit/example-qa.py +108 -0
  511. package/tools/audit/frontmatter-check.py +199 -0
  512. package/tools/audit/integration-check.py +95 -0
  513. package/tools/audit/korean-copy-check.py +161 -0
  514. package/tools/audit/link-check.py +146 -0
  515. package/tools/audit/local-ci.py +558 -0
  516. package/tools/audit/package-contents.py +723 -0
  517. package/tools/audit/package-smoke.py +22443 -0
  518. package/tools/audit/raw-hex-check.py +252 -0
  519. package/tools/audit/registry-smoke.py +8188 -0
  520. package/tools/audit/release-metadata.py +9832 -0
  521. package/tools/audit/run-all.py +351 -0
  522. package/tools/audit/smoke_assertions.py +12742 -0
  523. package/tools/audit/stability-review.py +332 -0
  524. package/tools/audit/stale-check.py +156 -0
  525. package/tools/migrations/add-version-frontmatter.py +132 -0
  526. package/tools/migrations/bump-last-updated.py +131 -0
  527. package/tools/migrations/promote-stability.py +172 -0
  528. package/tools/preview/README.md +58 -0
  529. package/tools/preview/render-tokens.py +454 -0
@@ -0,0 +1,166 @@
1
+ # illustration-designer — playbook
2
+
3
+ Design and spec an illustration system, OR a single illustration within an existing system. Output is a markdown spec a designer / illustrator can produce against, OR direct SVG output for simple cases.
4
+
5
+ ## When to use
6
+
7
+ - "We need an illustration system for our SaaS landing page."
8
+ - "Spec the empty state illustrations for our product."
9
+ - "Design a mascot for our Korean fintech app."
10
+ - "Should we use Lottie or SVG for the hero?"
11
+ - "Optimize this SVG."
12
+
13
+ ## Inputs (ask if missing)
14
+
15
+ 1. **Scope** — full system, OR single illustration.
16
+ 2. **Surface** — empty state / hero / onboarding / spot / mascot.
17
+ 3. **Brand voice** — 3-5 adjectives (e.g., calm, gentle, money-warm; or sharp, futuristic, controlled).
18
+ 4. **Existing system?** — if yes, follow its style. If no, this skill defines one.
19
+ 5. **Color tokens** — which brand tokens are available.
20
+ 6. **Format constraint** — SVG / Lottie / PNG / WebP / mixed.
21
+ 7. **Korean market?** — affects mascot vs minimal-geometric default.
22
+ 8. **Production budget** — solo designer, agency, AI-assisted, none yet.
23
+
24
+ ## Steps
25
+
26
+ ### 1. Classify the work
27
+
28
+ | Task | Approach |
29
+ | --- | --- |
30
+ | Define a new system | Start with [`illustration-systems.md`](../../knowledge/illustration/illustration-systems.md), then apply the surface-specific illustration references |
31
+ | Add to existing system | Follow style guide; don't redefine |
32
+ | Single spot illustration | [`spot-illustrations.md`](../../knowledge/illustration/spot-illustrations.md) |
33
+ | Hero illustration | [`hero-illustrations.md`](../../knowledge/illustration/hero-illustrations.md) |
34
+ | Mascot work | [`mascot-design.md`](../../knowledge/illustration/mascot-design.md) |
35
+ | SVG technical / optimization | [`svg-optimization.md`](../../knowledge/illustration/svg-optimization.md) |
36
+
37
+ ### 2. If defining a system — set the style
38
+
39
+ From [`illustration-systems.md`](../../knowledge/illustration/illustration-systems.md):
40
+
41
+ - **Geometric vs organic** — pick one.
42
+ - **Line weight rule** — stroke-only / fill-only / mixed; one stroke width.
43
+ - **Color treatment** — monochromatic / brand-palette / limited-extended.
44
+ - **Geometry rules** — grid, corner radius, stroke caps.
45
+ - **Perspective** — flat / isometric / front-view.
46
+ - **Voice** — 3-5 adjectives.
47
+
48
+ State each choice with reasoning.
49
+
50
+ ### 3. Pick the format
51
+
52
+ | Format | Use |
53
+ | --- | --- |
54
+ | SVG | Default; vector, themeable |
55
+ | Lottie | Animated illustration |
56
+ | PNG / WebP | Heavy shading, painterly, photo-realistic |
57
+ | AVIF | Highest compression for raster |
58
+
59
+ For most: SVG. Lottie when motion is the point. Raster only when SVG can't represent the visual.
60
+
61
+ ### 4. Per-illustration spec
62
+
63
+ For each illustration:
64
+
65
+ ```
66
+ Name: <kebab-case, prefixed by category>
67
+ e.g., illo-empty-search.svg, illo-hero-onboarding-01.svg
68
+ Surface: <empty-state | error-state | onboarding-step-2 | hero-section-3>
69
+ Subject: <one sentence — what's depicted>
70
+ Voice: <encouraging | calm | celebratory | apologetic>
71
+ Size: <display dimensions>
72
+ Format: <SVG | Lottie | PNG>
73
+ Tokens used: <list of CSS variables / brand colors>
74
+ Animation? <static | subtle loop | one-shot>
75
+ Accessibility: <decorative | meaningful + alt text>
76
+ Production hours: <estimate>
77
+ ```
78
+
79
+ ### 5. Apply Korean conventions (if applicable)
80
+
81
+ - Heavy mascot use? See [`mascot-design.md`](../../knowledge/illustration/mascot-design.md).
82
+ - Soft, rounded, warm geometry preferred for B2C.
83
+ - Hero illustrations: less abstract, more concrete (real character / real action).
84
+ - See [`knowledge/i18n/korean-app-store-visual.md`](../../knowledge/i18n/korean-app-store-visual.md).
85
+
86
+ ### 6. Optimize the SVG
87
+
88
+ For each shipped SVG:
89
+
90
+ - [ ] Run SVGO with config from [`svg-optimization.md`](../../knowledge/illustration/svg-optimization.md)
91
+ - [ ] Replace brand color hex with `currentColor` or CSS variable
92
+ - [ ] Verify viewBox preserved
93
+ - [ ] Verify no embedded raster
94
+ - [ ] Verify no editor metadata
95
+ - [ ] Verify size targets: < 1kB icon, < 10kB spot, < 50kB hero
96
+ - [ ] Test at 1×, 2×, 3×
97
+ - [ ] Test in light + dark modes
98
+
99
+ ### 7. Accessibility
100
+
101
+ - Decorative: `aria-hidden="true"` on illustration.
102
+ - Meaningful: `role="img"` + `aria-label`.
103
+ - Animated: respect `prefers-reduced-motion`.
104
+
105
+ ### 8. Output
106
+
107
+ Use this structure:
108
+
109
+ ```markdown
110
+ # Illustration spec: <system or piece name>
111
+
112
+ > Scope: <system | single piece>
113
+ > Style: <flat geometric | soft 3D | hand-drawn | mascot-driven | editorial | generative>
114
+ > Voice: <3-5 adjectives>
115
+ > Format: <SVG | Lottie | mixed>
116
+
117
+ ## Style rules
118
+ <line weight, color treatment, geometry, perspective>
119
+
120
+ ## Color tokens
121
+ <list of brand tokens permitted>
122
+
123
+ ## Asset list
124
+ | Name | Surface | Size | Format | Tokens | Anim? |
125
+
126
+ ## Production checklist
127
+ <checklist per illustration>
128
+
129
+ ## Don't
130
+ <2-3 specific misuses>
131
+ ```
132
+
133
+ ## Source files this skill reads
134
+
135
+ - [`knowledge/illustration/illustration-systems.md`](../../knowledge/illustration/illustration-systems.md) — system foundation
136
+ - [`knowledge/illustration/spot-illustrations.md`](../../knowledge/illustration/spot-illustrations.md) — small purposeful
137
+ - [`knowledge/illustration/hero-illustrations.md`](../../knowledge/illustration/hero-illustrations.md) — large brand-led
138
+ - [`knowledge/illustration/mascot-design.md`](../../knowledge/illustration/mascot-design.md) — character work
139
+ - [`knowledge/illustration/svg-optimization.md`](../../knowledge/illustration/svg-optimization.md) — SVG production
140
+ - [`knowledge/patterns/brand-identity.md`](../../knowledge/patterns/brand-identity.md) — brand foundation
141
+ - [`knowledge/motion/motion-tools.md`](../../knowledge/motion/motion-tools.md) — Lottie when animated
142
+ - [`knowledge/i18n/korean-app-store-visual.md`](../../knowledge/i18n/korean-app-store-visual.md) — Korean market visual
143
+ - [`examples/component-empty-state.md`](../../examples/component-empty-state.md) — empty state spec
144
+ - [`examples/component-illustration.md`](../../examples/component-illustration.md) — generic display
145
+
146
+ ## Verification phase (run before declaring done)
147
+
148
+ - [ ] If defining a system: are style + voice + color rules all explicit?
149
+ - [ ] Is the format chosen consciously (SVG default; Lottie / PNG only with reason)?
150
+ - [ ] Are color tokens listed (no raw hex in the spec body)?
151
+ - [ ] Are illustrations sized per category (1kB icon / 10kB spot / 50kB hero)?
152
+ - [ ] Is accessibility specified (decorative vs meaningful + alt text)?
153
+ - [ ] If animated: is reduced-motion fallback specified?
154
+ - [ ] If Korean B2C: are mascot conventions or Toss-style restraint applied?
155
+ - [ ] If shipping SVG: is SVGO + currentColor + viewBox checklist passed?
156
+ - [ ] Does the "Don't" section catch 2-3 specific misuses?
157
+
158
+ ## Done when
159
+
160
+ - One markdown spec.
161
+ - Style + voice + format choices explicit and reasoned.
162
+ - Color tokens listed.
163
+ - Asset list with sizes, formats, accessibility.
164
+ - Production checklist.
165
+ - "Don't" section.
166
+ - Verification passes.
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: illustration-designer
3
+ description: Design and spec an illustration system or a single illustration — pick style, voice, color treatment, format (SVG / Lottie / PNG), and delivery. Covers spot illustrations, hero illustrations, mascots, and SVG production.
4
+ ---
5
+
6
+ See [PLAYBOOK.md](PLAYBOOK.md).
@@ -0,0 +1,223 @@
1
+ # motion-designer — playbook
2
+
3
+ Design and spec motion for a screen, component, or page. Output is a **motion spec**: a markdown document a developer can implement against without follow-ups, with the right tool chosen, durations and easings derived from tokens, and reduced-motion handled.
4
+
5
+ ## When to use
6
+
7
+ - "Design the entrance for our landing page hero."
8
+ - "Spec the loading sequence for our app cold launch."
9
+ - "We want the success state to feel celebratory — design it."
10
+ - "Add motion to the modal open/close."
11
+ - "Pick a tool: should we use Framer Motion or GSAP?"
12
+
13
+ ## Inputs (ask if missing)
14
+
15
+ 1. **Surface** — landing page / app screen / component / route transition.
16
+ 2. **Intent** — what motion should accomplish (stop scroll, confirm action, smooth navigation, brand moment).
17
+ 3. **Trigger** — page load / scroll / tap / state change / hover.
18
+ 4. **Audience + platform** — web / mobile web / native / hybrid; Korean / global.
19
+ 5. **Performance budget** — bundle target, target devices.
20
+ 6. **Existing motion language** — does the brand have one (rubber-band? snappy? gentle?). If not, this skill helps define it.
21
+
22
+ ## Steps
23
+
24
+ ### 1. Classify the moment
25
+
26
+ Pick the category. The category determines the rules:
27
+
28
+ | Category | Goal | Reference |
29
+ | --- | --- | --- |
30
+ | Micro-interaction | Confirm input within 100ms | [`knowledge/motion/micro-interactions.md`](../../knowledge/motion/micro-interactions.md) |
31
+ | Marketing motion | Stop scroll / reveal value / anchor brand | [`knowledge/motion/marketing-motion.md`](../../knowledge/motion/marketing-motion.md) |
32
+ | App loading | Hide load latency; feel intentional | [`knowledge/motion/app-loading-sequences.md`](../../knowledge/motion/app-loading-sequences.md) |
33
+ | Choreography | Coordinate multi-element reveal | [`knowledge/motion/choreography-depth.md`](../../knowledge/motion/choreography-depth.md) |
34
+ | State transition | Show change in product UI | [`knowledge/motion/principles.md`](../../knowledge/motion/principles.md) |
35
+
36
+ Get this wrong and the rules don't apply. A marketing reveal is NOT a micro-interaction; a button press is NOT a choreographed sequence.
37
+
38
+ ### 2. Pick duration tier
39
+
40
+ From [`knowledge/motion/principles.md`](../../knowledge/motion/principles.md):
41
+
42
+ | Tier | Range | Use |
43
+ | --- | --- | --- |
44
+ | Instant | 0–80ms | Press feedback, focus rings |
45
+ | Fast | 100–200ms | Hover, micro-interactions, route fades |
46
+ | Medium | 200–300ms | Modal / drawer / panel open |
47
+ | Slow | 300–500ms | Hero entrance, page transition |
48
+ | Long | 500ms–1.5s | Marketing storytelling, choreographed reveals |
49
+ | Beyond | > 1.5s | Almost never. Justify or cut. |
50
+
51
+ State the chosen tier explicitly. Map to token: `--motion-fast`, `--motion-medium`, etc.
52
+
53
+ ### 3. Pick easing
54
+
55
+ | Easing | Curve | Use |
56
+ | --- | --- | --- |
57
+ | `ease-out` | Decelerate to stop | Default for entrances ("arrive and settle") |
58
+ | `ease-in` | Accelerate from rest | Exits ("leave the screen") |
59
+ | `ease-in-out` | Both | Position-to-position movement |
60
+ | `cubic-bezier(0.34, 1.56, 0.64, 1)` | Slight overshoot | Confirm / playful (rubber-band) |
61
+ | `linear` | Constant | Loading bars, infinite spinners |
62
+
63
+ Map to token: `--ease-out`, `--ease-in`, etc. Don't ship raw cubic-beziers in components — promote them to tokens first.
64
+
65
+ ### 4. Pick tool
66
+
67
+ Use [`knowledge/motion/motion-tools.md`](../../knowledge/motion/motion-tools.md) decision tree.
68
+
69
+ Bias rules:
70
+ - **CSS first**. Hover / press / focus / simple entrances. ~80% of motion needs this and only this.
71
+ - **Framer Motion** for React-side state-driven animation (modals, route transitions, layout animations).
72
+ - **GSAP** for marketing timelines / scroll-triggered choreography longer than 600ms.
73
+ - **Lottie** when designer brings After Effects animation.
74
+ - **Rive** when motion needs state machines and interactivity.
75
+ - **react-spring** only when you need physics (drag, swipe).
76
+
77
+ Don't load 4 motion libraries. Pick 1–2 max. Justify each.
78
+
79
+ ### 5. Spec the motion
80
+
81
+ For each motion event, write:
82
+
83
+ ```
84
+ Trigger: <what causes this>
85
+ Duration: <ms>, tier <tier>, token <var>
86
+ Easing: <name>, token <var>
87
+ Properties: <opacity | transform | filter — animate ONLY these>
88
+ Initial: <starting value>
89
+ Final: <end value>
90
+ Stagger (if multiple): <ms between siblings>
91
+ ```
92
+
93
+ Animate only `opacity`, `transform`, and (sparingly) `filter`. Never `width`/`height`/`top`/`left` — they trigger layout.
94
+
95
+ ### 6. Choreograph (if multi-element)
96
+
97
+ For sequences with > 1 element, use stagger formula from [`knowledge/motion/choreography-depth.md`](../../knowledge/motion/choreography-depth.md):
98
+
99
+ ```
100
+ total budget = parent duration + (children − 1) × stagger
101
+ ```
102
+
103
+ Cap stagger at 80ms; cap total at 800ms for entrance, 300ms for in-app transitions.
104
+
105
+ Provide a timing diagram:
106
+
107
+ ```
108
+ 0ms ┃■■■■■ ┃ headline (200ms fade)
109
+ 50ms┃ ■■■■■ ┃ sub (200ms fade)
110
+ 100ms┃ ■■■■■■ ┃ CTA (250ms fade-up)
111
+ 200ms┃ ■■■■■■■■ ┃ visual (300ms scale-in)
112
+ ```
113
+
114
+ ### 7. Reduced motion
115
+
116
+ Always specify behavior when `prefers-reduced-motion: reduce`:
117
+
118
+ | Original | Reduced fallback |
119
+ | --- | --- |
120
+ | Fade + translate | Pure fade |
121
+ | Slide-in | Pure fade or instant |
122
+ | Scale-in | Pure fade |
123
+ | Parallax | Disable |
124
+ | Auto-loop | Pause; show static frame |
125
+ | Hero / shared element | Instant layout swap |
126
+
127
+ Reduced motion ≠ no motion. Opacity-only is usually OK; large translations / scales are not.
128
+
129
+ ### 8. Performance check
130
+
131
+ For every motion spec, verify:
132
+
133
+ - [ ] Animates only `opacity` / `transform` / (sparingly) `filter`
134
+ - [ ] Total page-level animation count under 10 simultaneously
135
+ - [ ] If above-the-fold: doesn't block LCP
136
+ - [ ] If using JS lib: bundle cost stated and justified
137
+ - [ ] If looping: pauses when offscreen / tab hidden
138
+ - [ ] If `filter: blur()`: only on small areas, not large lists
139
+ - [ ] No `setInterval` driving animation (use `requestAnimationFrame` or CSS / library)
140
+
141
+ ### 9. Korean market check (if relevant)
142
+
143
+ | Question | Default for Korean B2C |
144
+ | --- | --- |
145
+ | How much motion? | Restrained, fast, smooth (Toss-style) |
146
+ | Brand mascot motion? | Yes if Kakao-adjacent, no otherwise |
147
+ | Auto-play video? | No — bandwidth + battery |
148
+ | Korean-language label? | All motion control labels in Korean |
149
+
150
+ Heavy motion reads as foreign / over-designed in Korean B2C. Lean restrained.
151
+
152
+ ### 10. Output
153
+
154
+ Use this structure:
155
+
156
+ ```markdown
157
+ # Motion spec: <surface name>
158
+
159
+ > Surface: <landing page hero | settings drawer | etc>
160
+ > Intent: <one sentence>
161
+ > Trigger: <what fires it>
162
+ > Tool: <CSS | Framer Motion | GSAP | Lottie | Rive | react-spring>
163
+
164
+ ## Tokens used
165
+ <list>
166
+
167
+ ## Sequence
168
+ <step-by-step with durations, easings, properties>
169
+
170
+ ## Timing diagram
171
+ <gantt-style ASCII>
172
+
173
+ ## Reduced motion
174
+ <fallback per element>
175
+
176
+ ## Performance budget
177
+ <bundle delta, animation count, LCP impact>
178
+
179
+ ## Code stub
180
+ <minimal CSS / React snippet>
181
+
182
+ ## Don't
183
+ <2-3 specific misuses>
184
+ ```
185
+
186
+ ## Source files this skill reads
187
+
188
+ - [`knowledge/motion/principles.md`](../../knowledge/motion/principles.md) — durations / easings / fundamentals
189
+ - [`knowledge/motion/micro-interactions.md`](../../knowledge/motion/micro-interactions.md) — < 200ms moments
190
+ - [`knowledge/motion/marketing-motion.md`](../../knowledge/motion/marketing-motion.md) — landing / hero / scroll
191
+ - [`knowledge/motion/app-loading-sequences.md`](../../knowledge/motion/app-loading-sequences.md) — splash / route / progressive
192
+ - [`knowledge/motion/choreography-depth.md`](../../knowledge/motion/choreography-depth.md) — multi-element coordination
193
+ - [`knowledge/motion/motion-tools.md`](../../knowledge/motion/motion-tools.md) — tool decision tree
194
+ - [`examples/component-loading-sequence.md`](../../examples/component-loading-sequence.md) — reference spec
195
+ - [`examples/component-page-transition.md`](../../examples/component-page-transition.md) — reference spec
196
+ - [`examples/component-lottie-player.md`](../../examples/component-lottie-player.md) — Lottie integration
197
+ - [`examples/component-scroll-reveal.md`](../../examples/component-scroll-reveal.md) — scroll-triggered
198
+
199
+ ## Verification phase (run before declaring done)
200
+
201
+ - [ ] Was the moment classified into one of the 5 categories?
202
+ - [ ] Is the duration tier explicit (not just "200ms" — "fast tier")?
203
+ - [ ] Is the easing named AND mapped to a token?
204
+ - [ ] Is the tool choice justified ("CSS because it's a < 100ms hover" — not just "Framer Motion")?
205
+ - [ ] Are only `opacity` / `transform` / `filter` animated?
206
+ - [ ] If multi-element: is stagger ≤ 80ms and total ≤ 800ms (entrance) / 300ms (in-app)?
207
+ - [ ] Is `prefers-reduced-motion` behavior specified for every element?
208
+ - [ ] Is bundle cost stated if a library is used?
209
+ - [ ] Does the "Don't" section catch 2–3 specific misuses?
210
+ - [ ] If Korean B2C: is the restraint check applied?
211
+
212
+ ## Done when
213
+
214
+ - One markdown spec, < 400 lines.
215
+ - Surface, intent, trigger, tool stated up top.
216
+ - Tokens listed (no raw values in body — reference tokens).
217
+ - Sequence with durations + easings + properties.
218
+ - Timing diagram (if multi-element).
219
+ - Reduced-motion fallback for every element.
220
+ - Performance budget stated.
221
+ - Code stub developer can paste in.
222
+ - "Don't" section.
223
+ - Verification phase passes.
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: motion-designer
3
+ description: Design and spec motion for a screen, component, or page — pick the right duration, easing, and tool (CSS / Framer Motion / GSAP / Lottie / Rive); deliver a motion spec a developer can implement against. Reduced-motion-safe by default.
4
+ ---
5
+
6
+ See [PLAYBOOK.md](PLAYBOOK.md).
@@ -0,0 +1,209 @@
1
+ # print-designer — playbook
2
+
3
+ Design and spec a print piece. Output is a print-ready spec a designer can deliver to a printer with confidence — sizes, paper, finish, color, bleed, regulatory content, file delivery format.
4
+
5
+ ## When to use
6
+
7
+ - "Spec a business card for our Korean fintech."
8
+ - "Design a tri-fold brochure for the new product."
9
+ - "Build a folding carton for our cosmetics line."
10
+ - "Create a subway poster spec."
11
+ - "What paper / finish should we choose?"
12
+
13
+ ## Inputs (ask if missing)
14
+
15
+ 1. **Piece type** — business card / letterhead / envelope / flyer / brochure / poster / packaging / signage.
16
+ 2. **Audience** — Korean primary / international primary / mixed.
17
+ 3. **Tier** — basic / mid / premium / luxury.
18
+ 4. **Quantity** — affects MOQ + cost.
19
+ 5. **Budget**.
20
+ 6. **Special requirements** — regulatory (food / cosmetics), sustainability, brand-critical color (Pantone match).
21
+ 7. **Existing brand assets** — logo, colors, fonts.
22
+ 8. **Distribution / use** — retail / mailing / hand-out / OOH.
23
+
24
+ ## Steps
25
+
26
+ ### 1. Pick the right piece
27
+
28
+ Use the type to select primary knowledge:
29
+
30
+ | Piece | Read |
31
+ | --- | --- |
32
+ | Business card / letterhead / envelope | [`stationery.md`](../../knowledge/print/stationery.md) |
33
+ | Flyer / leaflet / brochure / booklet | [`brochures-and-flyers.md`](../../knowledge/print/brochures-and-flyers.md) |
34
+ | Poster / banner / signage / OOH | [`signage-and-posters.md`](../../knowledge/print/signage-and-posters.md) |
35
+ | Box / carton / label / mailer | [`packaging.md`](../../knowledge/print/packaging.md) |
36
+
37
+ Always also read [`print-fundamentals.md`](../../knowledge/print/print-fundamentals.md). For Korean: [`korean-print-conventions.md`](../../knowledge/print/korean-print-conventions.md).
38
+
39
+ ### 2. Spec dimensions
40
+
41
+ | Piece | Korean default | International default |
42
+ | --- | --- | --- |
43
+ | Business card | 90×50mm | 85×55mm |
44
+ | Flyer / leaflet | A5 (148×210) | Letter (216×279) |
45
+ | Brochure | A4 / A4 tri-fold | Letter |
46
+ | Poster | A2 / A1 / A0 | Tabloid / Arch |
47
+ | Box | per dieline | per dieline |
48
+
49
+ Always include bleed: **3mm minimum**. State trim AND bleed dimensions.
50
+
51
+ ### 3. Pick paper / material
52
+
53
+ For each paper choice, consider:
54
+ - **Weight (gsm)** — sets perceived premium.
55
+ - **Finish** — matte / glossy / uncoated / soft-touch / linen.
56
+ - **Coating** — uncoated / aqueous / UV / lamination.
57
+ - **Color** — white / off-white / kraft / colored stock.
58
+ - **Sustainability** — FSC / recycled content.
59
+
60
+ Defaults:
61
+ - Business card: 300-350gsm matte coated or uncoated.
62
+ - Brochure: 150-200gsm coated.
63
+ - Folding carton: 350gsm SBS.
64
+ - Mailer: 120-200gsm corrugated E-flute.
65
+ - Poster: 150-200gsm coated for indoor; vinyl for outdoor.
66
+
67
+ ### 4. Pick color system
68
+
69
+ | Need | Use |
70
+ | --- | --- |
71
+ | Standard 4-color | CMYK |
72
+ | Brand-critical accent | CMYK + 1-2 Pantone spots |
73
+ | Single-color (1-color) | 1 Pantone or 100K |
74
+ | Premium metallic | Foil stamp (gold/silver/copper/holo) |
75
+ | Neon / day-glo | Pantone special inks |
76
+
77
+ State Pantone numbers + CMYK fallback. Don't trust silent conversion.
78
+
79
+ ### 5. Pick finish + special effects
80
+
81
+ Common combinations:
82
+ - **Matte + spot UV on logo** — premium tactile contrast.
83
+ - **Soft-touch lamination + emboss / deboss** — luxury feel.
84
+ - **Glossy + foil stamp** — vibrant + metallic.
85
+ - **Uncoated + letterpress** — artisanal / wedding.
86
+
87
+ Each special effect adds 20-100% cost. Cap at 1-2 per piece for restraint.
88
+
89
+ ### 6. Typography
90
+
91
+ Pick fonts that:
92
+ - Print clearly (test small sizes).
93
+ - Have weights that suit each role (display, body, caption).
94
+ - Support all required scripts (KR + EN if bilingual).
95
+ - Are licensed for print use (verify, not just web).
96
+
97
+ Korean default: **Pretendard** for sans (free, modern, multi-lingual). 본명조 for serif. Adobe paid families if budget permits.
98
+
99
+ Sizing:
100
+ - Body 9-11pt; smaller for Korean than Latin.
101
+ - Headlines 18-72pt depending on piece.
102
+ - Captions 6.5-8pt.
103
+
104
+ ### 7. Regulatory content (if applicable)
105
+
106
+ - **Food**: KFDA — ingredients, allergens, nutrition, manufacturer, country of origin.
107
+ - **Cosmetics**: KFDA — ingredients (Korean INCI), manufacturer, manufacturing license, expiry.
108
+ - **Health-functional foods**: KFDA — strict format, approved claims only.
109
+ - **Drugs**: KFDA — pre-approved copy, regulated formats.
110
+ - **Recycling marks (분리배출 표시)**: required on most consumer packaging.
111
+
112
+ See [`korean-print-conventions.md`](../../knowledge/print/korean-print-conventions.md) for details.
113
+
114
+ ### 8. File delivery
115
+
116
+ Required:
117
+ - **PDF/X-1a** export (or PDF/X-4 if printer accepts).
118
+ - **3mm bleed** + crop marks + bleed marks.
119
+ - **Fonts outlined** (or licensed for embedding).
120
+ - **All images embedded** (no linked external).
121
+ - **CMYK** color mode + Pantone spots defined.
122
+ - **ICC profile** matching printer (Japan Color 2001 Coated for KR).
123
+ - **Total ink coverage ≤ 300%** (some printers say 280%).
124
+
125
+ Optional:
126
+ - Source AI / INDD files.
127
+ - Spec sheet with paper + finish + special-effect details.
128
+ - Sign-off press proof.
129
+
130
+ ### 9. Output
131
+
132
+ Use this structure:
133
+
134
+ ```markdown
135
+ # Print spec: <piece name>
136
+
137
+ > Brand: <...>
138
+ > Audience: <KR / international / mixed>
139
+ > Tier: <basic / mid / premium / luxury>
140
+ > Quantity: <...>
141
+
142
+ ## Specs
143
+ | Spec | Value |
144
+ ... dimensions, paper, finish, color, file format
145
+
146
+ ## Color tokens
147
+ <CMYK + Pantone>
148
+
149
+ ## Typography
150
+ <fonts, sizes, weights>
151
+
152
+ ## Layout
153
+ <panel-by-panel for multi-panel pieces>
154
+
155
+ ## Regulatory checklist (if applicable)
156
+
157
+ ## Cost estimate
158
+
159
+ ## File delivery
160
+
161
+ ## Pre-press checklist
162
+
163
+ ## Press proof approval
164
+
165
+ ## Don't
166
+ ```
167
+
168
+ ## Source files this skill reads
169
+
170
+ - [`knowledge/print/print-fundamentals.md`](../../knowledge/print/print-fundamentals.md) — CMYK, bleed, DPI
171
+ - [`knowledge/print/stationery.md`](../../knowledge/print/stationery.md) — business cards, letterhead
172
+ - [`knowledge/print/brochures-and-flyers.md`](../../knowledge/print/brochures-and-flyers.md) — multi-page
173
+ - [`knowledge/print/signage-and-posters.md`](../../knowledge/print/signage-and-posters.md) — large format
174
+ - [`knowledge/print/packaging.md`](../../knowledge/print/packaging.md) — boxes, dielines
175
+ - [`knowledge/print/korean-print-conventions.md`](../../knowledge/print/korean-print-conventions.md) — KR conventions
176
+ - [`knowledge/typography/font-pairings.md`](../../knowledge/typography/font-pairings.md) — Pretendard pairings
177
+ - [`knowledge/patterns/brand-identity.md`](../../knowledge/patterns/brand-identity.md) — brand foundation
178
+ - [`knowledge/i18n/korean-document-style.md`](../../knowledge/i18n/korean-document-style.md) — Korean voice
179
+ - [`examples/print-business-card-spec.md`](../../examples/print-business-card-spec.md) — reference spec
180
+ - [`examples/print-packaging-spec.md`](../../examples/print-packaging-spec.md) — reference spec
181
+
182
+ ## Verification phase (run before declaring done)
183
+
184
+ - [ ] Are dimensions stated AND bleed (3mm min) included?
185
+ - [ ] Is color mode CMYK + Pantone explicitly defined (not silent)?
186
+ - [ ] Is paper weight + finish specified?
187
+ - [ ] Are fonts named with sizes + weights for each role?
188
+ - [ ] If regulatory (food / cosmetics): is the regulatory checklist applied?
189
+ - [ ] If Korean piece: is 명함 90×50 used (vs international 85×55)?
190
+ - [ ] Are recycling marks specified for KR packaging?
191
+ - [ ] Is total ink coverage ≤ 300% noted?
192
+ - [ ] Is press proof step included for brand-critical color?
193
+ - [ ] Does the "Don't" section catch 2-3 specific misuses?
194
+
195
+ ## Done when
196
+
197
+ - One markdown spec.
198
+ - Dimensions + bleed + safe area.
199
+ - Paper + finish + special effects.
200
+ - Color (CMYK + Pantone).
201
+ - Typography.
202
+ - Layout (per panel for multi-panel pieces).
203
+ - Regulatory checklist if applicable.
204
+ - Cost estimate.
205
+ - File delivery format.
206
+ - Pre-press checklist.
207
+ - Press proof step.
208
+ - "Don't" section.
209
+ - Verification passes.
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: print-designer
3
+ description: Design and spec a print piece — business card, brochure, poster, packaging, or full stationery system. Picks size, paper, finish, color (CMYK + Pantone), bleed, regulatory content; produces a print-ready spec. Korean print conventions baked in.
4
+ ---
5
+
6
+ See [PLAYBOOK.md](PLAYBOOK.md).