@hegemonart/get-design-done 1.42.0 → 1.44.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 (430) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +1126 -1038
  4. package/README.md +159 -155
  5. package/SKILL.md +42 -42
  6. package/agents/README.md +53 -53
  7. package/agents/a11y-mapper.md +3 -3
  8. package/agents/component-benchmark-harvester.md +8 -8
  9. package/agents/component-benchmark-synthesizer.md +11 -11
  10. package/agents/component-taxonomy-mapper.md +5 -5
  11. package/agents/compose-executor.md +25 -25
  12. package/agents/conflict-resolver.md +8 -8
  13. package/agents/cost-forecaster.md +12 -12
  14. package/agents/decision-journal-exporter.md +5 -5
  15. package/agents/design-advisor.md +19 -19
  16. package/agents/design-assumptions-analyzer.md +16 -16
  17. package/agents/design-auditor.md +39 -39
  18. package/agents/design-authority-watcher.md +28 -28
  19. package/agents/design-component-generator.md +27 -27
  20. package/agents/design-context-builder.md +66 -66
  21. package/agents/design-context-checker-gate.md +5 -5
  22. package/agents/design-context-checker.md +20 -20
  23. package/agents/design-discussant.md +23 -23
  24. package/agents/design-doc-writer.md +12 -12
  25. package/agents/design-executor.md +38 -38
  26. package/agents/design-figma-writer.md +31 -31
  27. package/agents/design-fixer.md +27 -27
  28. package/agents/design-integration-checker-gate.md +5 -5
  29. package/agents/design-integration-checker.md +29 -29
  30. package/agents/design-paper-writer.md +14 -14
  31. package/agents/design-pattern-mapper.md +9 -9
  32. package/agents/design-pencil-writer.md +12 -12
  33. package/agents/design-phase-researcher.md +14 -14
  34. package/agents/design-plan-checker.md +13 -13
  35. package/agents/design-planner.md +24 -24
  36. package/agents/design-reflector.md +48 -48
  37. package/agents/design-research-synthesizer.md +21 -21
  38. package/agents/design-start-writer.md +7 -7
  39. package/agents/design-update-checker.md +8 -8
  40. package/agents/design-verifier-gate.md +5 -5
  41. package/agents/design-verifier.md +80 -80
  42. package/agents/ds-generator.md +14 -14
  43. package/agents/ds-migration-planner.md +12 -12
  44. package/agents/email-executor.md +26 -26
  45. package/agents/experiment-result-ingester.md +10 -10
  46. package/agents/flutter-executor.md +28 -28
  47. package/agents/gdd-graph-refresh.md +10 -10
  48. package/agents/gdd-intel-updater.md +11 -11
  49. package/agents/gdd-learnings-extractor.md +2 -2
  50. package/agents/motion-mapper.md +8 -8
  51. package/agents/motion-verifier.md +16 -16
  52. package/agents/pdf-executor.md +27 -27
  53. package/agents/perf-analyzer.md +20 -20
  54. package/agents/pr-commenter.md +24 -24
  55. package/agents/prototype-gate.md +29 -29
  56. package/agents/quality-gate-runner.md +21 -21
  57. package/agents/rollout-coordinator.md +8 -8
  58. package/agents/swift-executor.md +41 -41
  59. package/agents/ticket-sync-agent.md +19 -19
  60. package/agents/token-mapper.md +6 -6
  61. package/agents/user-research-synthesizer.md +13 -13
  62. package/agents/visual-hierarchy-mapper.md +2 -2
  63. package/dist/claude-code/.claude/skills/add-backlog/SKILL.md +3 -3
  64. package/dist/claude-code/.claude/skills/analyze-dependencies/SKILL.md +10 -10
  65. package/dist/claude-code/.claude/skills/apply-reflections/SKILL.md +13 -13
  66. package/dist/claude-code/.claude/skills/apply-reflections/apply-reflections-procedure.md +20 -20
  67. package/dist/claude-code/.claude/skills/audit/SKILL.md +7 -7
  68. package/dist/claude-code/.claude/skills/bandit-status/SKILL.md +7 -7
  69. package/dist/claude-code/.claude/skills/benchmark/SKILL.md +7 -7
  70. package/dist/claude-code/.claude/skills/bootstrap-ds/SKILL.md +10 -10
  71. package/dist/claude-code/.claude/skills/brief/SKILL.md +20 -20
  72. package/dist/claude-code/.claude/skills/budget/SKILL.md +4 -4
  73. package/dist/claude-code/.claude/skills/cache-manager/SKILL.md +6 -6
  74. package/dist/claude-code/.claude/skills/cache-manager/cache-policy.md +5 -5
  75. package/dist/claude-code/.claude/skills/check-update/SKILL.md +5 -5
  76. package/dist/claude-code/.claude/skills/compare/SKILL.md +15 -15
  77. package/dist/claude-code/.claude/skills/compare/compare-rubric.md +17 -17
  78. package/dist/claude-code/.claude/skills/complete-cycle/SKILL.md +5 -5
  79. package/dist/claude-code/.claude/skills/connections/SKILL.md +11 -11
  80. package/dist/claude-code/.claude/skills/connections/connections-onboarding.md +76 -76
  81. package/dist/claude-code/.claude/skills/continue/SKILL.md +2 -2
  82. package/dist/claude-code/.claude/skills/darkmode/SKILL.md +17 -17
  83. package/dist/claude-code/.claude/skills/darkmode/darkmode-audit-procedure.md +7 -7
  84. package/dist/claude-code/.claude/skills/debug/SKILL.md +3 -3
  85. package/dist/claude-code/.claude/skills/debug/debug-feedback-loops.md +12 -12
  86. package/dist/claude-code/.claude/skills/design/SKILL.md +12 -12
  87. package/dist/claude-code/.claude/skills/design/design-procedure.md +23 -23
  88. package/dist/claude-code/.claude/skills/discover/SKILL.md +7 -7
  89. package/dist/claude-code/.claude/skills/discover/discover-procedure.md +18 -18
  90. package/dist/claude-code/.claude/skills/discuss/SKILL.md +12 -12
  91. package/dist/claude-code/.claude/skills/do/SKILL.md +1 -1
  92. package/dist/claude-code/.claude/skills/explore/SKILL.md +21 -21
  93. package/dist/claude-code/.claude/skills/explore/explore-procedure.md +48 -48
  94. package/dist/claude-code/.claude/skills/export/SKILL.md +9 -9
  95. package/dist/claude-code/.claude/skills/extract-learnings/SKILL.md +5 -5
  96. package/dist/claude-code/.claude/skills/fast/SKILL.md +7 -7
  97. package/dist/claude-code/.claude/skills/figma-extract/SKILL.md +11 -11
  98. package/dist/claude-code/.claude/skills/figma-write/SKILL.md +6 -6
  99. package/dist/claude-code/.claude/skills/graphify/SKILL.md +4 -4
  100. package/dist/claude-code/.claude/skills/health/SKILL.md +16 -16
  101. package/dist/claude-code/.claude/skills/health/health-mcp-detection.md +3 -3
  102. package/dist/claude-code/.claude/skills/health/health-skill-length-report.md +6 -6
  103. package/dist/claude-code/.claude/skills/help/SKILL.md +1 -1
  104. package/dist/claude-code/.claude/skills/list-assumptions/SKILL.md +4 -4
  105. package/dist/claude-code/.claude/skills/map/SKILL.md +12 -12
  106. package/dist/claude-code/.claude/skills/migrate/SKILL.md +5 -5
  107. package/dist/claude-code/.claude/skills/new-cycle/SKILL.md +2 -2
  108. package/dist/claude-code/.claude/skills/new-cycle/milestone-completeness-rubric.md +16 -16
  109. package/dist/claude-code/.claude/skills/new-project/SKILL.md +1 -1
  110. package/dist/claude-code/.claude/skills/next/SKILL.md +5 -5
  111. package/dist/claude-code/.claude/skills/note/SKILL.md +1 -1
  112. package/dist/claude-code/.claude/skills/openrouter-status/SKILL.md +4 -4
  113. package/dist/claude-code/.claude/skills/optimize/SKILL.md +15 -15
  114. package/dist/claude-code/.claude/skills/pause/SKILL.md +5 -5
  115. package/dist/claude-code/.claude/skills/peer-cli-add/SKILL.md +11 -11
  116. package/dist/claude-code/.claude/skills/peer-cli-add/peer-cli-protocol.md +39 -39
  117. package/dist/claude-code/.claude/skills/peer-cli-customize/SKILL.md +14 -14
  118. package/dist/claude-code/.claude/skills/peers/SKILL.md +4 -4
  119. package/dist/claude-code/.claude/skills/plan/SKILL.md +13 -13
  120. package/dist/claude-code/.claude/skills/plan/plan-procedure.md +24 -24
  121. package/dist/claude-code/.claude/skills/plant-seed/SKILL.md +4 -4
  122. package/dist/claude-code/.claude/skills/pr-branch/SKILL.md +2 -2
  123. package/dist/claude-code/.claude/skills/progress/SKILL.md +15 -15
  124. package/dist/claude-code/.claude/skills/quality-gate/SKILL.md +22 -22
  125. package/dist/claude-code/.claude/skills/quality-gate/threat-modeling.md +19 -19
  126. package/dist/claude-code/.claude/skills/quick/SKILL.md +5 -5
  127. package/dist/claude-code/.claude/skills/reapply-patches/SKILL.md +7 -7
  128. package/dist/claude-code/.claude/skills/reflect/SKILL.md +3 -3
  129. package/dist/claude-code/.claude/skills/reflect/procedures/capability-gap-scan.md +11 -11
  130. package/dist/claude-code/.claude/skills/report-issue/SKILL.md +5 -5
  131. package/dist/claude-code/.claude/skills/report-issue/report-issue-procedure.md +27 -27
  132. package/dist/claude-code/.claude/skills/resume/SKILL.md +9 -9
  133. package/dist/claude-code/.claude/skills/review-backlog/SKILL.md +3 -3
  134. package/dist/claude-code/.claude/skills/review-decisions/SKILL.md +3 -3
  135. package/dist/claude-code/.claude/skills/roi/SKILL.md +5 -5
  136. package/dist/claude-code/.claude/skills/rollout-status/SKILL.md +4 -4
  137. package/dist/claude-code/.claude/skills/router/SKILL.md +11 -11
  138. package/dist/claude-code/.claude/skills/router/capability-gap-emitter.md +6 -6
  139. package/dist/claude-code/.claude/skills/router/router-pick-emitter.md +9 -9
  140. package/dist/claude-code/.claude/skills/router/router-rules.md +7 -7
  141. package/dist/claude-code/.claude/skills/scan/SKILL.md +16 -16
  142. package/dist/claude-code/.claude/skills/scan/scan-procedure.md +42 -42
  143. package/dist/claude-code/.claude/skills/settings/SKILL.md +2 -2
  144. package/dist/claude-code/.claude/skills/ship/SKILL.md +7 -7
  145. package/dist/claude-code/.claude/skills/sketch/SKILL.md +10 -10
  146. package/dist/claude-code/.claude/skills/sketch-wrap-up/SKILL.md +12 -12
  147. package/dist/claude-code/.claude/skills/skill-manifest/SKILL.md +5 -5
  148. package/dist/claude-code/.claude/skills/spike/SKILL.md +7 -7
  149. package/dist/claude-code/.claude/skills/spike-wrap-up/SKILL.md +13 -13
  150. package/dist/claude-code/.claude/skills/start/SKILL.md +8 -8
  151. package/dist/claude-code/.claude/skills/start/start-procedure.md +9 -9
  152. package/dist/claude-code/.claude/skills/stats/SKILL.md +5 -5
  153. package/dist/claude-code/.claude/skills/style/SKILL.md +12 -12
  154. package/dist/claude-code/.claude/skills/style/style-doc-procedure.md +12 -12
  155. package/dist/claude-code/.claude/skills/synthesize/SKILL.md +10 -10
  156. package/dist/claude-code/.claude/skills/timeline/SKILL.md +4 -4
  157. package/dist/claude-code/.claude/skills/todo/SKILL.md +3 -3
  158. package/dist/claude-code/.claude/skills/turn-closeout/SKILL.md +10 -10
  159. package/dist/claude-code/.claude/skills/unlock-decision/SKILL.md +3 -3
  160. package/dist/claude-code/.claude/skills/update/SKILL.md +9 -9
  161. package/dist/claude-code/.claude/skills/using-gdd/SKILL.md +17 -17
  162. package/dist/claude-code/.claude/skills/verify/SKILL.md +13 -13
  163. package/dist/claude-code/.claude/skills/verify/verify-procedure.md +34 -34
  164. package/dist/claude-code/.claude/skills/warm-cache/SKILL.md +8 -8
  165. package/dist/claude-code/.claude/skills/watch-authorities/SKILL.md +9 -9
  166. package/dist/claude-code/.claude/skills/zoom-out/SKILL.md +4 -4
  167. package/package.json +9 -2
  168. package/reference/DEPRECATIONS.md +10 -10
  169. package/reference/STATE-TEMPLATE.md +26 -26
  170. package/reference/accessibility.md +13 -13
  171. package/reference/adr-format.md +13 -13
  172. package/reference/ai-native-tool-interface.md +5 -5
  173. package/reference/anti-patterns.md +9 -9
  174. package/reference/architecture-vocabulary.md +31 -31
  175. package/reference/audit-scoring.md +13 -13
  176. package/reference/authority-feeds.md +36 -36
  177. package/reference/bandit-integration.md +25 -25
  178. package/reference/brand-voice.md +36 -36
  179. package/reference/capability-gap-stage-gate.md +20 -20
  180. package/reference/checklists.md +26 -26
  181. package/reference/cli-localization.md +13 -13
  182. package/reference/codex-tools.md +2 -2
  183. package/reference/color-theory.md +28 -28
  184. package/reference/component-authoring.md +4 -4
  185. package/reference/components/README.md +13 -13
  186. package/reference/components/TEMPLATE.md +13 -13
  187. package/reference/components/accordion.md +15 -15
  188. package/reference/components/alert.md +25 -25
  189. package/reference/components/badge.md +18 -18
  190. package/reference/components/breadcrumbs.md +24 -24
  191. package/reference/components/button.md +21 -21
  192. package/reference/components/card.md +13 -13
  193. package/reference/components/checkbox.md +20 -20
  194. package/reference/components/chip.md +20 -20
  195. package/reference/components/command-palette.md +15 -15
  196. package/reference/components/date-picker.md +22 -22
  197. package/reference/components/drawer.md +13 -13
  198. package/reference/components/file-upload.md +22 -22
  199. package/reference/components/input.md +18 -18
  200. package/reference/components/label.md +25 -25
  201. package/reference/components/link.md +19 -19
  202. package/reference/components/list.md +17 -17
  203. package/reference/components/menu.md +19 -19
  204. package/reference/components/modal-dialog.md +16 -16
  205. package/reference/components/navbar.md +19 -19
  206. package/reference/components/pagination.md +18 -18
  207. package/reference/components/popover.md +12 -12
  208. package/reference/components/progress.md +18 -18
  209. package/reference/components/radio.md +17 -17
  210. package/reference/components/rich-text-editor.md +24 -24
  211. package/reference/components/select-combobox.md +16 -16
  212. package/reference/components/sidebar.md +15 -15
  213. package/reference/components/skeleton.md +20 -20
  214. package/reference/components/slider.md +20 -20
  215. package/reference/components/stepper.md +24 -24
  216. package/reference/components/switch.md +19 -19
  217. package/reference/components/table.md +21 -21
  218. package/reference/components/tabs.md +11 -11
  219. package/reference/components/toast.md +19 -19
  220. package/reference/components/tooltip.md +19 -19
  221. package/reference/components/tree.md +17 -17
  222. package/reference/composition.md +38 -38
  223. package/reference/config-schema.md +37 -37
  224. package/reference/context-md-format.md +9 -9
  225. package/reference/contrast-advanced.md +29 -29
  226. package/reference/conversational-ui.md +17 -17
  227. package/reference/cost-governance.md +14 -14
  228. package/reference/css-grid-layout.md +8 -8
  229. package/reference/cycle-handoff-preamble.md +3 -3
  230. package/reference/data-visualization.md +67 -67
  231. package/reference/debugger-philosophy.md +5 -5
  232. package/reference/design-system-guidance.md +21 -21
  233. package/reference/design-systems-catalog.md +20 -20
  234. package/reference/design-variants.md +11 -11
  235. package/reference/domains/civic-patterns.md +10 -10
  236. package/reference/domains/finance-patterns.md +9 -9
  237. package/reference/domains/gaming-patterns.md +9 -9
  238. package/reference/domains/healthcare-patterns.md +11 -11
  239. package/reference/ds-bootstrap-rubric.md +13 -13
  240. package/reference/email-design.md +22 -22
  241. package/reference/emotional-design.md +10 -10
  242. package/reference/error-recovery.md +11 -11
  243. package/reference/export-formats.md +7 -7
  244. package/reference/figma-sandbox.md +6 -6
  245. package/reference/first-principles.md +10 -10
  246. package/reference/form-patterns.md +26 -26
  247. package/reference/framer-motion-patterns.md +49 -49
  248. package/reference/gdd-runtime-audit.md +17 -17
  249. package/reference/gdd-threat-model.md +44 -44
  250. package/reference/gemini-tools.md +3 -3
  251. package/reference/gestalt.md +24 -24
  252. package/reference/heuristics.md +32 -32
  253. package/reference/i18n.md +44 -44
  254. package/reference/iconography.md +24 -24
  255. package/reference/image-optimization.md +14 -14
  256. package/reference/information-architecture.md +47 -47
  257. package/reference/intel-schema.md +1 -1
  258. package/reference/known-failure-modes.md +37 -37
  259. package/reference/meta-rules.md +5 -5
  260. package/reference/migrations/material-3-to-4.md +17 -17
  261. package/reference/migrations/mui-v6.md +16 -16
  262. package/reference/migrations/shadcn-v2.md +25 -25
  263. package/reference/migrations/tailwind-v4.md +21 -21
  264. package/reference/model-prices.md +3 -3
  265. package/reference/model-tiers.md +40 -40
  266. package/reference/motion-advanced.md +21 -21
  267. package/reference/motion-easings.md +29 -29
  268. package/reference/motion-interpolate.md +1 -1
  269. package/reference/motion-spring.md +13 -13
  270. package/reference/motion-transition-taxonomy.md +34 -34
  271. package/reference/motion.md +31 -31
  272. package/reference/multi-author-model.md +13 -13
  273. package/reference/native-platforms.md +28 -28
  274. package/reference/notification-routing.md +6 -6
  275. package/reference/onboarding-progressive-disclosure.md +32 -32
  276. package/reference/openrouter-tier-mapping.md +8 -8
  277. package/reference/palette-catalog.md +37 -37
  278. package/reference/parallelism-rules.md +20 -20
  279. package/reference/peer-cli-capabilities.md +14 -14
  280. package/reference/peer-protocols.md +21 -21
  281. package/reference/perf-budget.md +21 -21
  282. package/reference/performance.md +22 -22
  283. package/reference/platforms.md +51 -51
  284. package/reference/pr-review-integration.md +7 -7
  285. package/reference/prices/antigravity.md +3 -3
  286. package/reference/prices/augment.md +3 -3
  287. package/reference/prices/claude.md +2 -2
  288. package/reference/prices/cline.md +4 -4
  289. package/reference/prices/codebuddy.md +3 -3
  290. package/reference/prices/codex.md +2 -2
  291. package/reference/prices/copilot.md +3 -3
  292. package/reference/prices/cursor.md +3 -3
  293. package/reference/prices/gemini.md +2 -2
  294. package/reference/prices/kilo.md +3 -3
  295. package/reference/prices/opencode.md +4 -4
  296. package/reference/prices/qwen.md +2 -2
  297. package/reference/prices/trae.md +3 -3
  298. package/reference/prices/windsurf.md +3 -3
  299. package/reference/prices.openrouter.md +5 -5
  300. package/reference/print-design.md +36 -36
  301. package/reference/priority-matrix.md +2 -2
  302. package/reference/project-skills-guide.md +3 -3
  303. package/reference/proportion-systems.md +23 -23
  304. package/reference/pseudonymization-rules.md +30 -30
  305. package/reference/retrieval-contract.md +14 -14
  306. package/reference/review-format.md +7 -7
  307. package/reference/rollout-coordination.md +10 -10
  308. package/reference/rtl-cjk-cultural.md +39 -39
  309. package/reference/runtime-models.md +28 -28
  310. package/reference/shared-preamble.md +26 -26
  311. package/reference/skill-authoring-contract.md +16 -16
  312. package/reference/skill-placeholders.md +3 -3
  313. package/reference/start-interview.md +10 -10
  314. package/reference/style-vocabulary.md +25 -25
  315. package/reference/surfaces.md +4 -4
  316. package/reference/ticket-sync.md +9 -9
  317. package/reference/typography.md +64 -64
  318. package/reference/user-research.md +54 -54
  319. package/reference/variable-fonts-loading.md +15 -15
  320. package/reference/visual-hierarchy-layout.md +41 -41
  321. package/scripts/lib/harness-freshness.cjs +59 -0
  322. package/scripts/lib/health-mirror/index.cjs +27 -0
  323. package/scripts/lib/manifest/harnesses.json +280 -14
  324. package/scripts/lib/manifest/prose-denylist.json +1 -1
  325. package/scripts/lib/manifest/schemas/harnesses.schema.json +32 -0
  326. package/sdk/mcp/gdd-mcp/server.js +125 -0
  327. package/skills/add-backlog/SKILL.md +3 -3
  328. package/skills/analyze-dependencies/SKILL.md +10 -10
  329. package/skills/apply-reflections/SKILL.md +13 -13
  330. package/skills/apply-reflections/apply-reflections-procedure.md +20 -20
  331. package/skills/audit/SKILL.md +7 -7
  332. package/skills/bandit-status/SKILL.md +7 -7
  333. package/skills/benchmark/SKILL.md +7 -7
  334. package/skills/bootstrap-ds/SKILL.md +10 -10
  335. package/skills/brief/SKILL.md +20 -20
  336. package/skills/budget/SKILL.md +4 -4
  337. package/skills/cache-manager/SKILL.md +6 -6
  338. package/skills/cache-manager/cache-policy.md +5 -5
  339. package/skills/check-update/SKILL.md +5 -5
  340. package/skills/compare/SKILL.md +15 -15
  341. package/skills/compare/compare-rubric.md +17 -17
  342. package/skills/complete-cycle/SKILL.md +5 -5
  343. package/skills/connections/SKILL.md +11 -11
  344. package/skills/connections/connections-onboarding.md +76 -76
  345. package/skills/continue/SKILL.md +2 -2
  346. package/skills/darkmode/SKILL.md +17 -17
  347. package/skills/darkmode/darkmode-audit-procedure.md +7 -7
  348. package/skills/debug/SKILL.md +3 -3
  349. package/skills/debug/debug-feedback-loops.md +12 -12
  350. package/skills/design/SKILL.md +12 -12
  351. package/skills/design/design-procedure.md +23 -23
  352. package/skills/discover/SKILL.md +7 -7
  353. package/skills/discover/discover-procedure.md +18 -18
  354. package/skills/discuss/SKILL.md +12 -12
  355. package/skills/do/SKILL.md +1 -1
  356. package/skills/explore/SKILL.md +21 -21
  357. package/skills/explore/explore-procedure.md +48 -48
  358. package/skills/export/SKILL.md +9 -9
  359. package/skills/extract-learnings/SKILL.md +5 -5
  360. package/skills/fast/SKILL.md +7 -7
  361. package/skills/figma-extract/SKILL.md +11 -11
  362. package/skills/figma-write/SKILL.md +6 -6
  363. package/skills/graphify/SKILL.md +4 -4
  364. package/skills/health/SKILL.md +16 -16
  365. package/skills/health/health-mcp-detection.md +3 -3
  366. package/skills/health/health-skill-length-report.md +6 -6
  367. package/skills/help/SKILL.md +1 -1
  368. package/skills/list-assumptions/SKILL.md +4 -4
  369. package/skills/map/SKILL.md +12 -12
  370. package/skills/migrate/SKILL.md +5 -5
  371. package/skills/new-cycle/SKILL.md +2 -2
  372. package/skills/new-cycle/milestone-completeness-rubric.md +16 -16
  373. package/skills/new-project/SKILL.md +1 -1
  374. package/skills/next/SKILL.md +5 -5
  375. package/skills/note/SKILL.md +1 -1
  376. package/skills/openrouter-status/SKILL.md +4 -4
  377. package/skills/optimize/SKILL.md +15 -15
  378. package/skills/pause/SKILL.md +5 -5
  379. package/skills/peer-cli-add/SKILL.md +11 -11
  380. package/skills/peer-cli-add/peer-cli-protocol.md +39 -39
  381. package/skills/peer-cli-customize/SKILL.md +14 -14
  382. package/skills/peers/SKILL.md +4 -4
  383. package/skills/plan/SKILL.md +13 -13
  384. package/skills/plan/plan-procedure.md +24 -24
  385. package/skills/plant-seed/SKILL.md +4 -4
  386. package/skills/pr-branch/SKILL.md +2 -2
  387. package/skills/progress/SKILL.md +15 -15
  388. package/skills/quality-gate/SKILL.md +22 -22
  389. package/skills/quality-gate/threat-modeling.md +19 -19
  390. package/skills/quick/SKILL.md +5 -5
  391. package/skills/reapply-patches/SKILL.md +7 -7
  392. package/skills/reflect/SKILL.md +3 -3
  393. package/skills/reflect/procedures/capability-gap-scan.md +11 -11
  394. package/skills/report-issue/SKILL.md +5 -5
  395. package/skills/report-issue/report-issue-procedure.md +27 -27
  396. package/skills/resume/SKILL.md +9 -9
  397. package/skills/review-backlog/SKILL.md +3 -3
  398. package/skills/review-decisions/SKILL.md +3 -3
  399. package/skills/roi/SKILL.md +5 -5
  400. package/skills/rollout-status/SKILL.md +4 -4
  401. package/skills/router/SKILL.md +11 -11
  402. package/skills/router/capability-gap-emitter.md +6 -6
  403. package/skills/router/router-pick-emitter.md +9 -9
  404. package/skills/router/router-rules.md +7 -7
  405. package/skills/scan/SKILL.md +16 -16
  406. package/skills/scan/scan-procedure.md +42 -42
  407. package/skills/settings/SKILL.md +2 -2
  408. package/skills/ship/SKILL.md +7 -7
  409. package/skills/sketch/SKILL.md +10 -10
  410. package/skills/sketch-wrap-up/SKILL.md +12 -12
  411. package/skills/skill-manifest/SKILL.md +5 -5
  412. package/skills/spike/SKILL.md +7 -7
  413. package/skills/spike-wrap-up/SKILL.md +13 -13
  414. package/skills/start/SKILL.md +8 -8
  415. package/skills/start/start-procedure.md +9 -9
  416. package/skills/stats/SKILL.md +5 -5
  417. package/skills/style/SKILL.md +12 -12
  418. package/skills/style/style-doc-procedure.md +12 -12
  419. package/skills/synthesize/SKILL.md +10 -10
  420. package/skills/timeline/SKILL.md +4 -4
  421. package/skills/todo/SKILL.md +3 -3
  422. package/skills/turn-closeout/SKILL.md +10 -10
  423. package/skills/unlock-decision/SKILL.md +3 -3
  424. package/skills/update/SKILL.md +9 -9
  425. package/skills/using-gdd/SKILL.md +17 -17
  426. package/skills/verify/SKILL.md +13 -13
  427. package/skills/verify/verify-procedure.md +34 -34
  428. package/skills/warm-cache/SKILL.md +8 -8
  429. package/skills/watch-authorities/SKILL.md +9 -9
  430. package/skills/zoom-out/SKILL.md +4 -4
@@ -7,27 +7,27 @@ tags: [connections, onboarding, probes, mcp, wizard, procedure, extracted]
7
7
  last_updated: 2026-05-18
8
8
  ---
9
9
 
10
- Source: extracted from `skills/connections/SKILL.md` (Phase 28.5 rework D-10 extract-then-link).
11
- The skill's load-bearing routing + invocation-mode dispatch stays in `../skills/connections/SKILL.md`;
10
+ Source: extracted from `skills/connections/SKILL.md` (Phase 28.5 rework - D-10 extract-then-link).
11
+ The skill's essential routing + invocation-mode dispatch stays in `../skills/connections/SKILL.md`;
12
12
  this file holds the 33 probe scripts, bucket categorization, per-connection setup screen,
13
13
  auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts.
14
14
 
15
15
  # Connections Onboarding Procedure
16
16
 
17
- Detailed procedure for the `/gdd:connections` interactive wizard companion to
17
+ Detailed procedure for the `/gdd:connections` interactive wizard - companion to
18
18
  `../skills/connections/SKILL.md`. Read this file when executing a specific probe, deciding
19
19
  auto-run vs manual, writing config.json, or merging STATE.md `<connections>`. The SKILL.md
20
- keeps the load-bearing top-level flow + AskUserQuestion routing; this file holds the deep
20
+ keeps the essential top-level flow + AskUserQuestion routing; this file holds the deep
21
21
  methodology + per-connection detail.
22
22
 
23
23
  For the cross-skill probe pattern + connection handshake (ToolSearch → live call → STATE.md
24
24
  write), see `./shared-preamble.md#connection-handshake-summary`. The canonical per-connection
25
- specs (setup commands, OAuth flows, capability matrix) live in `../connections/<name>.md`
25
+ specs (setup commands, OAuth flows, capability matrix) live in `../connections/<name>.md` -
26
26
  this file does NOT duplicate them; it points at them by name.
27
27
 
28
28
  ---
29
29
 
30
- ## Step 1 Probe all 33 connections
30
+ ## Step 1 - Probe all 33 connections
31
31
 
32
32
  Run every probe below in order. MCP probes call `ToolSearch` first (deferred tools fail silently without it). Write every result to `STATE.md <connections>` when done.
33
33
 
@@ -86,49 +86,49 @@ ToolSearch({ query: "mcp__magic_patterns", max_results: 5 })
86
86
  → Non-empty → magic_patterns: available
87
87
  ```
88
88
 
89
- **lazyweb:** (discover Tier 1 free, tried first; D-01)
89
+ **lazyweb:** (discover Tier 1 - free, tried first; D-01)
90
90
  ```
91
91
  ToolSearch({ query: "lazyweb", max_results: 5 })
92
92
  → Empty → lazyweb: not_configured
93
93
  → Non-empty → lazyweb: available
94
94
  ```
95
95
 
96
- **mobbin:** (discover Tier 2 paid, mobile/flow-level; D-01)
96
+ **mobbin:** (discover Tier 2 - paid, mobile/flow-level; D-01)
97
97
  ```
98
98
  ToolSearch({ query: "mobbin", max_results: 5 })
99
99
  → Empty → mobbin: not_configured
100
100
  → Non-empty → mobbin: available
101
101
  ```
102
102
 
103
- **slack:** (notify Team Surfaces, env-based)
103
+ **slack:** (notify - Team Surfaces, env-based)
104
104
  ```
105
105
  Bash: test -n "$SLACK_WEBHOOK_URL" (and GDD_DISABLE_SLACK != 1)
106
106
  → empty / disabled → slack: not_configured
107
107
  → non-empty → slack: available
108
108
  ```
109
109
 
110
- **discord:** (notify parity, env-based)
110
+ **discord:** (notify - parity, env-based)
111
111
  ```
112
112
  Bash: test -n "$DISCORD_WEBHOOK_URL" (and GDD_DISABLE_DISCORD != 1)
113
113
  → empty / disabled → discord: not_configured
114
114
  → non-empty → discord: available
115
115
  ```
116
116
 
117
- **linear:** (ticket-sync MCP)
117
+ **linear:** (ticket-sync - MCP)
118
118
  ```
119
119
  ToolSearch({ query: "linear", max_results: 5 })
120
120
  → Empty / GDD_DISABLE_LINEAR=1 → linear: not_configured
121
121
  → Non-empty → linear: available
122
122
  ```
123
123
 
124
- **jira:** (ticket-sync Atlassian MCP)
124
+ **jira:** (ticket-sync - Atlassian MCP)
125
125
  ```
126
126
  ToolSearch({ query: "atlassian jira", max_results: 5 })
127
127
  → Empty / GDD_DISABLE_JIRA=1 → jira: not_configured
128
128
  → Non-empty → jira: available
129
129
  ```
130
130
 
131
- **notion:** (export write-path MCP)
131
+ **notion:** (export write-path - MCP)
132
132
  ```
133
133
  ToolSearch({ query: "notion", max_results: 5 })
134
134
  → Empty / GDD_DISABLE_NOTION=1 → notion: not_configured
@@ -171,7 +171,7 @@ Bash: find . -name "*.pen" -not -path "*/node_modules/*" -not -path "*/.git/*" 2
171
171
  → Non-empty → pencil_dev: available
172
172
  ```
173
173
 
174
- **claude-design** (file probe handoff bundle):
174
+ **claude-design** (file probe - handoff bundle):
175
175
  ```
176
176
  Bash: ls .design/handoff/ 2>/dev/null || find . -maxdepth 3 \
177
177
  \( -name "*.claude-design.html" -o -name "*.claude-design.zip" \
@@ -180,7 +180,7 @@ Bash: ls .design/handoff/ 2>/dev/null || find . -maxdepth 3 \
180
180
  → Non-empty → claude_design: available
181
181
  ```
182
182
 
183
- **lottie** (file probe Lottie JSON motion export):
183
+ **lottie** (file probe - Lottie JSON motion export):
184
184
  ```
185
185
  Bash: find . -name "*.json" -not -path "*/node_modules/*" 2>/dev/null | head (confirm the Lottie signature: top-level v / fr / layers)
186
186
  grep -lE '"lottie-web"|@lottiefiles|lottie-react' package.json 2>/dev/null
@@ -188,7 +188,7 @@ Bash: find . -name "*.json" -not -path "*/node_modules/*" 2>/dev/null | head (
188
188
  → none → lottie: not_configured
189
189
  ```
190
190
 
191
- **rive** (file probe Rive .riv motion export):
191
+ **rive** (file probe - Rive .riv motion export):
192
192
  ```
193
193
  Bash: find . -name "*.riv" -not -path "*/node_modules/*" 2>/dev/null | head
194
194
  grep -E '@rive-app|rive-react' package.json 2>/dev/null
@@ -196,84 +196,84 @@ Bash: find . -name "*.riv" -not -path "*/node_modules/*" 2>/dev/null | head
196
196
  → none → rive: not_configured
197
197
  ```
198
198
 
199
- **framer:** (AI-native Wave 2 canvas; MCP or API token)
199
+ **framer:** (AI-native Wave 2 - canvas; MCP or API token)
200
200
  ```
201
201
  ToolSearch({ query: "framer", max_results: 5 })
202
202
  → Empty → framer: not_configured
203
203
  → Non-empty → framer: available
204
204
  ```
205
205
 
206
- **penpot:** (AI-native Wave 2 canvas; self-hosted URL/token or cloud)
206
+ **penpot:** (AI-native Wave 2 - canvas; self-hosted URL/token or cloud)
207
207
  ```
208
208
  ToolSearch({ query: "penpot", max_results: 5 })
209
209
  → Empty → penpot: not_configured
210
210
  → Non-empty → penpot: available
211
211
  ```
212
212
 
213
- **webflow:** (AI-native Wave 2 generator; MCP or WEBFLOW token)
213
+ **webflow:** (AI-native Wave 2 - generator; MCP or WEBFLOW token)
214
214
  ```
215
215
  ToolSearch({ query: "webflow", max_results: 5 })
216
216
  → Empty → webflow: not_configured
217
217
  → Non-empty → webflow: available
218
218
  ```
219
219
 
220
- **v0-dev:** (AI-native Wave 2 generator; MCP-first, else V0_API_KEY)
220
+ **v0-dev:** (AI-native Wave 2 - generator; MCP-first, else V0_API_KEY)
221
221
  ```
222
222
  ToolSearch({ query: "v0", max_results: 5 })
223
223
  → Empty → v0-dev: not_configured
224
224
  → Non-empty → v0-dev: available
225
225
  ```
226
226
 
227
- **plasmic:** (AI-native Wave 2 generator+canvas; MCP or token)
227
+ **plasmic:** (AI-native Wave 2 - generator+canvas; MCP or token)
228
228
  ```
229
229
  ToolSearch({ query: "plasmic", max_results: 5 })
230
230
  → Empty → plasmic: not_configured
231
231
  → Non-empty → plasmic: available
232
232
  ```
233
233
 
234
- **builder-io:** (AI-native Wave 2 generator; MCP-first, else BUILDER_API_KEY)
234
+ **builder-io:** (AI-native Wave 2 - generator; MCP-first, else BUILDER_API_KEY)
235
235
  ```
236
236
  ToolSearch({ query: "builder", max_results: 5 })
237
237
  → Empty → builder-io: not_configured
238
238
  → Non-empty → builder-io: available
239
239
  ```
240
240
 
241
- **launchdarkly:** (Outcome experiment-source; read-only A/B)
241
+ **launchdarkly:** (Outcome - experiment-source; read-only A/B)
242
242
  ```
243
243
  ToolSearch({ query: "launchdarkly", max_results: 5 }) (else check the platform API-key env)
244
244
  → Empty / GDD_DISABLE_LAUNCHDARKLY=1 → launchdarkly: not_configured
245
245
  → Non-empty / key set → launchdarkly: available
246
246
  ```
247
247
 
248
- **statsig:** (Outcome experiment-source; read-only)
248
+ **statsig:** (Outcome - experiment-source; read-only)
249
249
  ```
250
250
  ToolSearch({ query: "statsig", max_results: 5 }) (else check the platform API-key env)
251
251
  → Empty / GDD_DISABLE_STATSIG=1 → statsig: not_configured
252
252
  → Non-empty / key set → statsig: available
253
253
  ```
254
254
 
255
- **growthbook:** (Outcome experiment-source; self-host/cloud)
255
+ **growthbook:** (Outcome - experiment-source; self-host/cloud)
256
256
  ```
257
257
  ToolSearch({ query: "growthbook", max_results: 5 }) (else check the platform API-key env)
258
258
  → Empty / GDD_DISABLE_GROWTHBOOK=1 → growthbook: not_configured
259
259
  → Non-empty / key set → growthbook: available
260
260
  ```
261
261
 
262
- **usertesting:** (Outcome user-research; pseudonymize-first)
262
+ **usertesting:** (Outcome - user-research; pseudonymize-first)
263
263
  ```
264
264
  ToolSearch({ query: "usertesting", max_results: 5 }) (else check the platform API-key env)
265
265
  → Empty / GDD_DISABLE_USERTESTING=1 → usertesting: not_configured
266
266
  → Non-empty / key set → usertesting: available
267
267
  ```
268
268
 
269
- **maze:** (Outcome user-research; pseudonymize-first)
269
+ **maze:** (Outcome - user-research; pseudonymize-first)
270
270
  ```
271
271
  ToolSearch({ query: "maze", max_results: 5 }) (else check the platform API-key env)
272
272
  → Empty / GDD_DISABLE_MAZE=1 → maze: not_configured
273
273
  → Non-empty / key set → maze: available
274
274
  ```
275
275
 
276
- **hotjar:** (Outcome user-research; indexed insights only)
276
+ **hotjar:** (Outcome - user-research; indexed insights only)
277
277
  ```
278
278
  ToolSearch({ query: "hotjar", max_results: 5 }) (else check the platform API-key env)
279
279
  → Empty / GDD_DISABLE_HOTJAR=1 → hotjar: not_configured
@@ -284,7 +284,7 @@ After all 33 probes complete, merge results into `STATE.md <connections>`. Prese
284
284
 
285
285
  ---
286
286
 
287
- ## Step 2 Bucket categorization
287
+ ## Step 2 - Bucket categorization
288
288
 
289
289
  ### Project-hint detection
290
290
 
@@ -306,7 +306,7 @@ HAS_FIGMA_HINT=$( grep -r "figma\.com/file" -l . --include="*.md" 2>/dev/null |
306
306
  | **recommended** | probe returned `not_configured` AND matches a project hint below |
307
307
  | **optional** | probe returned `not_configured` AND no project hint match |
308
308
  | **skipped** | name appears in `config.json connections.skip[]` |
309
- | **unavailable** | probe returned `unavailable` (configured but broken needs attention) |
309
+ | **unavailable** | probe returned `unavailable` (configured but broken - needs attention) |
310
310
 
311
311
  ### Recommendation mapping
312
312
 
@@ -316,11 +316,11 @@ HAS_FIGMA_HINT=$( grep -r "figma\.com/file" -l . --include="*.md" 2>/dev/null |
316
316
  | `HAS_STORYBOOK_DIR` or storybook available | storybook, chromatic |
317
317
  | `HAS_PEN_FILES` | pencil-dev |
318
318
  | `HAS_REACT` | 21st-dev, magic-patterns |
319
- | Always | refero, preview, lazyweb (free cost-aware default, D-01) |
319
+ | Always | refero, preview, lazyweb (free - cost-aware default, D-01) |
320
320
 
321
321
  ---
322
322
 
323
- ## Step 3 Summary table
323
+ ## Step 3 - Summary table
324
324
 
325
325
  ```
326
326
  ┌── Connections ──────────────────────────
@@ -361,31 +361,31 @@ One-line value props (use verbatim):
361
361
  | pencil-dev | `.pen` spec files as canonical design source |
362
362
  | 21st-dev | AI component generator (marketplace search) |
363
363
  | magic-patterns | AI component generator (DS-aware) |
364
- | lazyweb | free design reference search (pricing/onboarding/redesign) discover Tier 1 |
365
- | mobbin | curated mobile + flow-level references (paid) discover Tier 2 |
366
- | slack | notify route verify-fail/audit-pass/ship to a Slack channel (redacted) |
367
- | discord | notify route pipeline events to a Discord channel (redacted) |
368
- | linear | ticket-sync link a cycle to a Linear issue; read comments + transition on completion |
369
- | jira | ticket-sync parity with Linear via the Atlassian MCP |
370
- | notion | export `/gdd:export --format notion` writes a stakeholder page (degrade-to-HTML) |
371
- | lottie | verify Lottie JSON motion check (frame-rate / duration / bloat / perf-budget), WARN-never-block |
372
- | rive | verify Rive `.riv` motion check (size + state-machine reachability via the opt-in runtime), WARN-never-block |
373
- | framer | design read Framer frames + write proposals (canvas, Wave 2) |
374
- | penpot | design open-source Figma alt; read boards (self-hosted or cloud) |
375
- | webflow | design read site structure as an adaptation source (Wave 2) |
376
- | v0-dev | generator Vercel v0 prompt→component (MCP-first → REST + V0_API_KEY) |
377
- | plasmic | generator + canvas emit code + read the Plasmic canvas |
378
- | builder-io | generator Builder.io Visual Copilot (pull-only this phase) |
379
- | launchdarkly | outcome read A/B results → design_arms posterior (experiment-source) |
380
- | statsig | outcome read experiment/pulse results → design_arms (experiment-source) |
381
- | growthbook | outcome read experiment results → design_arms (experiment-source; OSS) |
382
- | usertesting | outcome read test reports → brief findings (user-research; pseudonymized) |
383
- | maze | outcome read usability metrics → brief findings (user-research; pseudonymized) |
384
- | hotjar | outcome read indexed insights → brief findings (user-research; pseudonymized) |
364
+ | lazyweb | free design reference search (pricing/onboarding/redesign) - discover Tier 1 |
365
+ | mobbin | curated mobile + flow-level references (paid) - discover Tier 2 |
366
+ | slack | notify - route verify-fail/audit-pass/ship to a Slack channel (redacted) |
367
+ | discord | notify - route pipeline events to a Discord channel (redacted) |
368
+ | linear | ticket-sync - link a cycle to a Linear issue; read comments + transition on completion |
369
+ | jira | ticket-sync - parity with Linear via the Atlassian MCP |
370
+ | notion | export - `/gdd:export --format notion` writes a stakeholder page (degrade-to-HTML) |
371
+ | lottie | verify - Lottie JSON motion check (frame-rate / duration / bloat / perf-budget), WARN-never-block |
372
+ | rive | verify - Rive `.riv` motion check (size + state-machine reachability via the opt-in runtime), WARN-never-block |
373
+ | framer | design - read Framer frames + write proposals (canvas, Wave 2) |
374
+ | penpot | design - open-source Figma alt; read boards (self-hosted or cloud) |
375
+ | webflow | design - read site structure as an adaptation source (Wave 2) |
376
+ | v0-dev | generator - Vercel v0 prompt→component (MCP-first → REST + V0_API_KEY) |
377
+ | plasmic | generator + canvas - emit code + read the Plasmic canvas |
378
+ | builder-io | generator - Builder.io Visual Copilot (pull-only this phase) |
379
+ | launchdarkly | outcome - read A/B results → design_arms posterior (experiment-source) |
380
+ | statsig | outcome - read experiment/pulse results → design_arms (experiment-source) |
381
+ | growthbook | outcome - read experiment results → design_arms (experiment-source; OSS) |
382
+ | usertesting | outcome - read test reports → brief findings (user-research; pseudonymized) |
383
+ | maze | outcome - read usability metrics → brief findings (user-research; pseudonymized) |
384
+ | hotjar | outcome - read indexed insights → brief findings (user-research; pseudonymized) |
385
385
 
386
386
  ---
387
387
 
388
- ## Step 4 Route by mode
388
+ ## Step 4 - Route by mode
389
389
 
390
390
  ### Mode: `list` or `--auto`
391
391
 
@@ -413,7 +413,7 @@ If recommended bucket is empty, swap that option for "Show all 33 and pick."
413
413
 
414
414
  ---
415
415
 
416
- ## Step 5 Per-connection setup screen
416
+ ## Step 5 - Per-connection setup screen
417
417
 
418
418
  ### 5.1 Read the spec
419
419
 
@@ -455,26 +455,26 @@ options:
455
455
  | Connection | Install kind | Auto-run? | Rationale |
456
456
  |---|---|---|---|
457
457
  | figma | `claude mcp add` (remote MCP) | ✓ yes | Reversible via `claude mcp remove` |
458
- | preview | built-in, no install | | Already present or not no command to run |
458
+ | preview | built-in, no install | - | Already present or not - no command to run |
459
459
  | paper-design | `claude mcp add` | ✓ yes | Reversible |
460
460
  | magic-patterns | `claude mcp add` | ✓ yes | Reversible |
461
461
  | pinterest | `npx -y @smithery/cli install` | ✓ yes | Smithery CLI manages entry |
462
- | refero | vendor-specific install | ✗ no | Vendor doesn't document a stable CLI print link only |
463
- | storybook | `npx storybook init` | ✗ no | Mutates repo files force manual |
464
- | chromatic | `npm install --save-dev chromatic` + env var | ✗ no | Writes package.json + needs `CHROMATIC_PROJECT_TOKEN` force manual |
465
- | graphify | `pip install` + `gsd-tools config-set` | ✗ no | Python install + cross-tool config force manual |
466
- | 21st-dev | `npx @21st-dev/magic init` + env var | ✗ no | Env var required force manual |
467
- | pencil-dev | VS Code extension | ✗ no | IDE-level install force manual |
468
- | claude-design | handoff bundle drop | ✗ no | User-driven file drop force manual |
462
+ | refero | vendor-specific install | ✗ no | Vendor doesn't document a stable CLI - print link only |
463
+ | storybook | `npx storybook init` | ✗ no | Mutates repo files - force manual |
464
+ | chromatic | `npm install --save-dev chromatic` + env var | ✗ no | Writes package.json + needs `CHROMATIC_PROJECT_TOKEN` - force manual |
465
+ | graphify | `pip install` + `gsd-tools config-set` | ✗ no | Python install + cross-tool config - force manual |
466
+ | 21st-dev | `npx @21st-dev/magic init` + env var | ✗ no | Env var required - force manual |
467
+ | pencil-dev | VS Code extension | ✗ no | IDE-level install - force manual |
468
+ | claude-design | handoff bundle drop | ✗ no | User-driven file drop - force manual |
469
469
  | mobbin | `claude mcp add mobbin --transport http https://api.mobbin.com/mcp` | ✓ yes | Reversible MCP add; no credential filesystem-write (OAuth on first call) |
470
- | lazyweb | `claude plugin install lazyweb@lazyweb` (after token write to `~/.lazyweb/`) | ✗ no | Writes a bearer token to disk force manual (user-consent step) |
471
- | slack | set `SLACK_WEBHOOK_URL` env (Slack Incoming Webhook URL) | ✗ no | Env credential user sets it; no install command (degrade-to-noop when unset) |
472
- | discord | set `DISCORD_WEBHOOK_URL` env (Discord channel Webhook URL) | ✗ no | Env credential user sets it; no install command (degrade-to-noop when unset) |
470
+ | lazyweb | `claude plugin install lazyweb@lazyweb` (after token write to `~/.lazyweb/`) | ✗ no | Writes a bearer token to disk - force manual (user-consent step) |
471
+ | slack | set `SLACK_WEBHOOK_URL` env (Slack Incoming Webhook URL) | ✗ no | Env credential - user sets it; no install command (degrade-to-noop when unset) |
472
+ | discord | set `DISCORD_WEBHOOK_URL` env (Discord channel Webhook URL) | ✗ no | Env credential - user sets it; no install command (degrade-to-noop when unset) |
473
473
  | linear | `claude mcp add linear ...` (Linear MCP) | ✓ yes | Reversible MCP add; OAuth on first call, no credential filesystem-write |
474
474
  | jira | `claude mcp add atlassian ...` (Atlassian MCP) | ✓ yes | Reversible MCP add; OAuth on first call |
475
475
  | notion | `claude mcp add notion ...` (Notion MCP) | ✓ yes | Reversible MCP add; OAuth on first call |
476
- | lottie | (file-based no install; drop a Lottie `.json` export in the repo) | n/a | Detected from Lottie exports / a `lottie-web` dep; live player opt-in |
477
- | rive | (file-based no install; add a `.riv` export / `@rive-app` dep) | n/a | Detected from `.riv` files / a `@rive-app` dep; Rive runtime opt-in |
476
+ | lottie | (file-based - no install; drop a Lottie `.json` export in the repo) | n/a | Detected from Lottie exports / a `lottie-web` dep; live player opt-in |
477
+ | rive | (file-based - no install; add a `.riv` export / `@rive-app` dep) | n/a | Detected from `.riv` files / a `@rive-app` dep; Rive runtime opt-in |
478
478
  | framer | `claude mcp add framer ...` (or API token) | ✓ yes | Reversible MCP add; canvas-category |
479
479
  | penpot | `claude mcp add penpot ...` (self-hosted URL or cloud + token) | ✓ yes | Reversible; self-host vs cloud |
480
480
  | webflow | `claude mcp add webflow ...` (or WEBFLOW token) | ✓ yes | Reversible; reads structure, not CMS authoring |
@@ -490,21 +490,21 @@ options:
490
490
 
491
491
  For non-auto-run connections, hide the "Run install command now" option entirely in 5.3.
492
492
 
493
- ### 5.4a Auto-run path
493
+ ### 5.4a - Auto-run path
494
494
 
495
495
  Bash the install command. On success: print stdout, print `"Installed. Session restart required before <name> is usable."`, append `<name>` to `.design/config.json > connections_onboarding.pending_verification[]`.
496
496
 
497
497
  On failure: print stderr, print `"Install failed. Copy the command and run it manually, then rerun /gdd:connections <name> to verify."` Do not record pending_verification.
498
498
 
499
- ### 5.4b Manual path
499
+ ### 5.4b - Manual path
500
500
 
501
501
  Print the install command inside a fenced code block for easy copy. Print: `"After installing, restart the session and run /gdd:connections <name> to verify."` Append `<name>` to `connections_onboarding.pending_verification[]`.
502
502
 
503
- ### 5.4c Skip for now
503
+ ### 5.4c - Skip for now
504
504
 
505
505
  No config change. Continue loop.
506
506
 
507
- ### 5.4d Never ask again
507
+ ### 5.4d - Never ask again
508
508
 
509
509
  Read `.design/config.json`. Ensure `connections.skip` is an array. Append `<name>` if not present. Write back.
510
510
 
@@ -514,7 +514,7 @@ If mode is `<connection-name>` (single-target invocation), skip straight to Step
514
514
 
515
515
  ---
516
516
 
517
- ## Step 6 Verification pass
517
+ ## Step 6 - Verification pass
518
518
 
519
519
  Re-probe every connection whose name appears in `connections_onboarding.pending_verification[]`. For each:
520
520
 
@@ -546,7 +546,7 @@ If `.design/config.json > connections_onboarding.pending_verification[]` is non-
546
546
 
547
547
  1. Print: `"Resuming — <N> connections pending verification: <list>"`
548
548
  2. Run Step 6 (verification pass) immediately.
549
- 3. If resumption completes cleanly (empty pending list), emit `## CONNECTIONS COMPLETE` and exit do not re-enter the wizard.
549
+ 3. If resumption completes cleanly (empty pending list), emit `## CONNECTIONS COMPLETE` and exit - do not re-enter the wizard.
550
550
  4. Otherwise, fall through to Step 3 (summary) with the still-pending connections visible as `unavailable`.
551
551
 
552
552
  ---
@@ -582,7 +582,7 @@ Deleted automatically when empty after a verification pass:
582
582
 
583
583
  ### `STATE.md <connections>` write
584
584
 
585
- Always merge, never replace other stages may have written entries this skill did not probe.
585
+ Always merge, never replace - other stages may have written entries this skill did not probe.
586
586
 
587
587
  Key normalization:
588
588
  - `21st-dev` → `twenty_first` in STATE.md (no leading digit in XML-ish key).
@@ -605,4 +605,4 @@ Key normalization:
605
605
 
606
606
  ---
607
607
 
608
- *Imported by: `../skills/connections/SKILL.md`. Maintained as part of Phase 28.5 (Bucket 2 rework D-10).*
608
+ *Imported by: `../skills/connections/SKILL.md`. Maintained as part of Phase 28.5 (Bucket 2 rework - D-10).*
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gdd-continue
3
- description: "Alias for /gdd:resume restore session context from the most recent checkpoint."
3
+ description: "Alias for /gdd:resume - restore session context from the most recent checkpoint."
4
4
  argument-hint: "[<checkpoint-N>]"
5
5
  tools: Read, Write, Bash, Glob
6
6
  disable-model-invocation: true
@@ -12,7 +12,7 @@ disable-model-invocation: true
12
12
 
13
13
  Alias for `/gdd:resume`. Delegates immediately to the resume skill with the same argument.
14
14
 
15
- This alias exists for discoverability users familiar with `git continue` or similar conventions find `/gdd:continue` more intuitive than `/gdd:resume` after a pause.
15
+ This alias exists for discoverability - users familiar with `git continue` or similar conventions find `/gdd:continue` more intuitive than `/gdd:resume` after a pause.
16
16
 
17
17
  ## Steps
18
18
 
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  name: gdd-darkmode
3
- description: "Audit a project's dark mode implementation detects architecture (CSS custom props, Tailwind `dark:` prefix, or JS class toggle), runs architecture-specific contrast / token-override / anti-pattern / meta-property checks, and writes a prioritized fix list to `.design/DARKMODE-AUDIT.md`. Use when the user wants to verify dark mode quality without re-running the full design pipeline. Read-only no score writeback to `DESIGN.md`."
3
+ description: "Audit a project's dark mode implementation - detects architecture (CSS custom props, Tailwind `dark:` prefix, or JS class toggle), runs architecture-specific contrast / token-override / anti-pattern / meta-property checks, and writes a prioritized fix list to `.design/DARKMODE-AUDIT.md`. Use when the user wants to verify dark mode quality without re-running the full design pipeline. Read-only - no score writeback to `DESIGN.md`."
4
4
  argument-hint: ""
5
5
  user-invocable: true
6
6
  ---
7
7
 
8
- # gdd-darkmode Dark Mode Audit
8
+ # gdd-darkmode - Dark Mode Audit
9
9
 
10
10
  Standalone dark mode audit. Detects the project's dark mode architecture, runs architecture-specific checks across contrast, token completeness, anti-patterns, and meta properties, then writes a prioritized fix list to `.design/DARKMODE-AUDIT.md`.
11
11
 
@@ -15,13 +15,13 @@ For the full step-by-step methodology (architecture-detection greps, WCAG contra
15
15
 
16
16
  ## Scope
17
17
 
18
- This command is a **standalone audit** not a pipeline stage:
18
+ This command is a **standalone audit** - not a pipeline stage:
19
19
 
20
- - Does NOT update `DESIGN.md` scores (V2-05 deferred two-sources-of-truth risk).
21
- - Does NOT invoke `design-auditor` (Pitfall 4 darkmode runs its own inline audit, separate from the `DESIGN-AUDIT.md` pipeline).
20
+ - Does NOT update `DESIGN.md` scores (V2-05 deferred - two-sources-of-truth risk).
21
+ - Does NOT invoke `design-auditor` (Pitfall 4 - darkmode runs its own inline audit, separate from the `DESIGN-AUDIT.md` pipeline).
22
22
  - Does NOT write to `.design/STATE.md`, `DESIGN-CONTEXT.md`, `DESIGN-PLAN.md`, `DESIGN-SUMMARY.md`, or `DESIGN-VERIFICATION.md`.
23
23
  - Writes exactly ONE artifact: `.design/DARKMODE-AUDIT.md`.
24
- - Does NOT execute fixes audit-only per V2-07 deferral (fixes belong in the design pipeline's color task).
24
+ - Does NOT execute fixes - audit-only per V2-07 deferral (fixes belong in the design pipeline's color task).
25
25
 
26
26
  Output artifact prefix `DARKMODE-AUDIT` is distinct from the pipeline namespace (`DESIGN-*.md`). No naming conflict.
27
27
 
@@ -39,13 +39,13 @@ Probe `preview` connection per `../../reference/shared-preamble.md#connection-ha
39
39
 
40
40
  ## Workflow
41
41
 
42
- 1. **Architecture Detection (DARK-02)** run three greps (CSS custom props / Tailwind `dark:` / JS class toggle), classify primary architecture or `Hybrid` or `None`. If `None`, abort. Detail: `./darkmode-audit-procedure.md#step-1-architecture-detection-dark-02`.
43
- 2. **Contrast Audit (DARK-03)** extract dark-context token pairs for the detected architecture, compute WCAG 2.1 ratios, flag failures at 4.5:1 (body) / 3:1 (large text + UI boundaries). Cross-check with APCA from `../../reference/contrast-advanced.md` for thin / large / colored text. Detail: `./darkmode-audit-procedure.md#step-2-contrast-audit-dark-03`.
44
- 3. **Token Override Completeness (DARK-04)** every light-mode color token must have a dark-mode override. Flag missing overrides → P1. Detail: `./darkmode-audit-procedure.md#step-3-token-override-completeness-dark-04`.
45
- 4. **Dark-Specific Anti-Patterns (DARK-05)** Images/SVGs without dark variant (P2), pure-black backgrounds in dark context = BAN-05 (P1), missing `@media (forced-colors)` (P2). Detail: `./darkmode-audit-procedure.md#step-4-dark-specific-anti-patterns-dark-05`.
46
- 5. **Meta Property Check (DARK-06)** `color-scheme` property + `prefers-color-scheme` query. Each absent → P2. Detail: `./darkmode-audit-procedure.md#step-5-meta-property-check-dark-06`.
47
- 6. **Visual Rendering (preview: available only)** capture light/dark screenshot pair to `.design/screenshots/darkmode/{light,dark}.png`. Detail: `./darkmode-audit-procedure.md#step-5b-dark-mode-rendering-screenshots-when-preview-available`.
48
- 7. **Write `.design/DARKMODE-AUDIT.md`** group flagged issues by priority (P0 → P1 → P2 → P3). Full template at `./darkmode-audit-procedure.md#step-6-darkmode-auditmd-template`.
42
+ 1. **Architecture Detection (DARK-02)** - run three greps (CSS custom props / Tailwind `dark:` / JS class toggle), classify primary architecture or `Hybrid` or `None`. If `None`, abort. Detail: `./darkmode-audit-procedure.md#step-1-architecture-detection-dark-02`.
43
+ 2. **Contrast Audit (DARK-03)** - extract dark-context token pairs for the detected architecture, compute WCAG 2.1 ratios, flag failures at 4.5:1 (body) / 3:1 (large text + UI boundaries). Cross-check with APCA from `../../reference/contrast-advanced.md` for thin / large / colored text. Detail: `./darkmode-audit-procedure.md#step-2-contrast-audit-dark-03`.
44
+ 3. **Token Override Completeness (DARK-04)** - every light-mode color token must have a dark-mode override. Flag missing overrides → P1. Detail: `./darkmode-audit-procedure.md#step-3-token-override-completeness-dark-04`.
45
+ 4. **Dark-Specific Anti-Patterns (DARK-05)** - Images/SVGs without dark variant (P2), pure-black backgrounds in dark context = BAN-05 (P1), missing `@media (forced-colors)` (P2). Detail: `./darkmode-audit-procedure.md#step-4-dark-specific-anti-patterns-dark-05`.
46
+ 5. **Meta Property Check (DARK-06)** - `color-scheme` property + `prefers-color-scheme` query. Each absent → P2. Detail: `./darkmode-audit-procedure.md#step-5-meta-property-check-dark-06`.
47
+ 6. **Visual Rendering (preview: available only)** - capture light/dark screenshot pair to `.design/screenshots/darkmode/{light,dark}.png`. Detail: `./darkmode-audit-procedure.md#step-5b-dark-mode-rendering-screenshots-when-preview-available`.
48
+ 7. **Write `.design/DARKMODE-AUDIT.md`** - group flagged issues by priority (P0 → P1 → P2 → P3). Full template at `./darkmode-audit-procedure.md#step-6-darkmode-auditmd-template`.
49
49
 
50
50
  ---
51
51
 
@@ -54,9 +54,9 @@ Probe `preview` connection per `../../reference/shared-preamble.md#connection-ha
54
54
  This command MUST NOT (per `../../reference/shared-preamble.md#output-contract-reminders`):
55
55
 
56
56
  - Write to `DESIGN.md`, `DESIGN-SUMMARY.md`, `DESIGN-VERIFICATION.md`, `DESIGN-CONTEXT.md`, or `.design/STATE.md`.
57
- - Invoke `design-auditor` (Pitfall 4 this is a separate audit with its own inline checks).
58
- - Execute any fixes audit-only (V2-07 deferred).
59
- - Write scores back to `DESIGN.md` (V2-05 deferred two-sources-of-truth risk).
57
+ - Invoke `design-auditor` (Pitfall 4 - this is a separate audit with its own inline checks).
58
+ - Execute any fixes - audit-only (V2-07 deferred).
59
+ - Write scores back to `DESIGN.md` (V2-05 deferred - two-sources-of-truth risk).
60
60
  - Add rows to `DESIGN.md` or append to pipeline-owned artifacts.
61
61
 
62
62
  MUST write exactly one output file: `.design/DARKMODE-AUDIT.md`.
@@ -71,6 +71,6 @@ After writing the audit, print:
71
71
  Dark mode audit complete. Architecture: <X>. Fixes: P0=<N>, P1=<M>, P2=<K>, P3=<J>. See .design/DARKMODE-AUDIT.md.
72
72
  ```
73
73
 
74
- Do not summarize individual issues in the completion message the file contains the full detail.
74
+ Do not summarize individual issues in the completion message - the file contains the full detail.
75
75
 
76
76
  ## DARKMODE AUDIT COMPLETE
@@ -7,17 +7,17 @@ tags: [darkmode, dark-mode, contrast, audit, procedure, extracted]
7
7
  last_updated: 2026-05-18
8
8
  ---
9
9
 
10
- Source: extracted from `skills/darkmode/SKILL.md` (Phase 28.5 rework D-10 extract-then-link).
11
- The skill's load-bearing routing + decision tree stays in `../skills/darkmode/SKILL.md`; this
10
+ Source: extracted from `skills/darkmode/SKILL.md` (Phase 28.5 rework - D-10 extract-then-link).
11
+ The skill's essential routing + decision tree stays in `../skills/darkmode/SKILL.md`; this
12
12
  file holds the architecture-detection greps, contrast computation, anti-pattern grep
13
13
  snippets, and the `DARKMODE-AUDIT.md` report template.
14
14
 
15
15
  # Dark Mode Audit Procedure
16
16
 
17
- Detailed procedure for the `gdd-darkmode` standalone audit companion to
17
+ Detailed procedure for the `gdd-darkmode` standalone audit - companion to
18
18
  `../skills/darkmode/SKILL.md`. Read this file when executing a specific audit step
19
19
  (architecture detection, contrast computation, anti-pattern grep, report layout). The
20
- SKILL.md keeps the load-bearing pre-flight + step routing; this file holds the deep
20
+ SKILL.md keeps the essential pre-flight + step routing; this file holds the deep
21
21
  methodology.
22
22
 
23
23
  For the perceptual layer (APCA / WCAG 3 draft) sitting on top of the WCAG 2.1 ratios used
@@ -50,7 +50,7 @@ arch3_count=$(grep -rEn "classList.*dark|setAttribute.*dark|document\.documentEl
50
50
 
51
51
  | Condition | Classification |
52
52
  |-----------|---------------|
53
- | All three counts < 3 | No dark mode abort: "No dark mode implementation detected nothing to audit." |
53
+ | All three counts < 3 | No dark mode - abort: "No dark mode implementation detected - nothing to audit." |
54
54
  | Exactly one count ≥ 3 | Primary architecture = that one |
55
55
  | Two or more counts ≥ 5 | Hybrid (list all detected architectures) |
56
56
  | One count ≥ 3, others < 5 | Primary = highest count |
@@ -87,7 +87,7 @@ grep -rEn "\.dark[[:space:]]*\{" "$SRC_ROOT" \
87
87
 
88
88
  **WCAG contrast computation:**
89
89
 
90
- Use the linearized-sRGB formula from `agents/design-executor.md` Type: accessibility (pre-calibrated do not re-derive):
90
+ Use the linearized-sRGB formula from `agents/design-executor.md` Type: accessibility (pre-calibrated - do not re-derive):
91
91
 
92
92
  1. Convert each hex channel to linear light: `c_lin = (c/255 ≤ 0.04045) ? c/255/12.92 : ((c/255 + 0.055)/1.055)^2.4`
93
93
  2. Relative luminance: `L = 0.2126 * R_lin + 0.7152 * G_lin + 0.0722 * B_lin`
@@ -255,4 +255,4 @@ If a priority bucket has no issues, omit that section or write "None."
255
255
 
256
256
  ---
257
257
 
258
- *Imported by: `../skills/darkmode/SKILL.md`. Maintained as part of Phase 28.5 (Bucket 2 rework D-10).*
258
+ *Imported by: `../skills/darkmode/SKILL.md`. Maintained as part of Phase 28.5 (Bucket 2 rework - D-10).*
@@ -12,12 +12,12 @@ Systematic, checkpoint-driven design debugger. Loads framing from `./../referenc
12
12
  ## Steps
13
13
 
14
14
  1. **Load philosophy + feedback-loop catalog**: Read `reference/debugger-philosophy.md` (five principles) and `./debug-feedback-loops.md` (10 construction paths; iterate-on-loop discipline). Keep both in mind for the entire session.
15
- 2. **Symptom**: If no symptom argument was passed, ask (AskUserQuestion): "What design symptom are you investigating? (observable only 'cards look crowded', not 'padding is wrong')"
15
+ 2. **Symptom**: If no symptom argument was passed, ask (AskUserQuestion): "What design symptom are you investigating? (observable only - 'cards look crowded', not 'padding is wrong')"
16
16
  3. **Resume check**: Read `.design/DEBUG.md` if it exists. If there is an open session with no `### Fix Proposal` block, ask: "Resume existing session '<symptom>' or start a new one?"
17
17
  4. **Ground truth load**: Read `.design/DESIGN-PLAN.md` (goals), `.design/STATE.md` `<decisions>` block (D-XX items), and any source files pointed at by the symptom.
18
- 5. **Phase 1 Build a feedback loop**: Before ANY hypothesizing, build a deterministic, fast, agent-runnable pass/fail signal that reproduces the symptom. See `./debug-feedback-loops.md` for the 10 construction paths in priority order (failing test > curl > CLI fixture > headless browser > trace replay > throwaway harness > fuzz > bisect > differential > HITL bash). Iterate on the loop itself (cache setup, narrow scope, pin time, seed RNG, isolate filesystem, freeze network) before iterating on the bug. For non-deterministic bugs: raise reproduction rate to at least 30%, not clean repro. **Do not proceed to Phase 2 (hypothesis generation) until you have a loop you believe in.**
18
+ 5. **Phase 1 - Build a feedback loop**: Before ANY hypothesizing, build a deterministic, fast, agent-runnable pass/fail signal that reproduces the symptom. See `./debug-feedback-loops.md` for the 10 construction paths in priority order (failing test > curl > CLI fixture > headless browser > trace replay > throwaway harness > fuzz > bisect > differential > HITL bash). Iterate on the loop itself (cache setup, narrow scope, pin time, seed RNG, isolate filesystem, freeze network) before iterating on the bug. For non-deterministic bugs: raise reproduction rate to at least 30%, not clean repro. **Do not proceed to Phase 2 (hypothesis generation) until you have a loop you believe in.**
19
19
  6. **Optional rendered-output check**: Use ToolSearch to see if Playwright/Preview MCP tools are available. If yes, capture rendered state. If no, fall back to code-only analysis.
20
- 7. **Phase 2 Investigation loop** (one hypothesis at a time) for each step:
20
+ 7. **Phase 2 - Investigation loop** (one hypothesis at a time) - for each step:
21
21
  - Form one hypothesis (one variable).
22
22
  - Investigate (read files, grep, measure). Re-run the Phase 1 feedback loop to confirm the hypothesis pinpoints the symptom.
23
23
  - Append to `.design/DEBUG.md`: