From 38e9846d448ae43bb3bde75c179fdea945300e21 Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Sun, 29 Mar 2026 22:54:41 -0700 Subject: [PATCH] feat: integrate /design-html into design skill pipeline - design-shotgun: Step 6 option B now chains to /design-html - design-consultation: suggests /design-html after shipping DESIGN.md (conditional on screen-level output, not tokens-only) - plan-design-review: expanded chaining to include /design-shotgun and /design-html alongside review skills Co-Authored-By: Claude Opus 4.6 (1M context) --- design-consultation/SKILL.md | 4 ++++ design-consultation/SKILL.md.tmpl | 4 ++++ design-shotgun/SKILL.md | 2 +- design-shotgun/SKILL.md.tmpl | 2 +- plan-design-review/SKILL.md | 10 +++++++++- plan-design-review/SKILL.md.tmpl | 10 +++++++++- 6 files changed, 28 insertions(+), 4 deletions(-) diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md index dc5c9ec7..37a232a3 100644 --- a/design-consultation/SKILL.md +++ b/design-consultation/SKILL.md @@ -957,6 +957,10 @@ List all decisions. Flag any that used agent defaults without explicit user conf - B) I want to change something (specify what) - C) Start over +After shipping DESIGN.md, if the session produced screen-level mockups or page layouts +(not just system-level tokens), suggest: +"Want to see this design system as working Pretext-native HTML? Run /design-html." + --- ## Important Rules diff --git a/design-consultation/SKILL.md.tmpl b/design-consultation/SKILL.md.tmpl index 2ce7c1d3..b9834829 100644 --- a/design-consultation/SKILL.md.tmpl +++ b/design-consultation/SKILL.md.tmpl @@ -413,6 +413,10 @@ List all decisions. Flag any that used agent defaults without explicit user conf - B) I want to change something (specify what) - C) Start over +After shipping DESIGN.md, if the session produced screen-level mockups or page layouts +(not just system-level tokens), suggest: +"Want to see this design system as working Pretext-native HTML? Run /design-html." + --- ## Important Rules diff --git a/design-shotgun/SKILL.md b/design-shotgun/SKILL.md index e1e4d02d..f272a21f 100644 --- a/design-shotgun/SKILL.md +++ b/design-shotgun/SKILL.md @@ -723,7 +723,7 @@ If standalone, offer next steps via AskUserQuestion: > "Design direction locked in. What's next? > A) Iterate more — refine the approved variant with specific feedback -> B) Implement — start building from this design +> B) Finalize — generate production Pretext-native HTML/CSS with /design-html > C) Save to plan — add this as an approved mockup reference in the current plan > D) Done — I'll use this later" diff --git a/design-shotgun/SKILL.md.tmpl b/design-shotgun/SKILL.md.tmpl index 436c8bc6..7ab82655 100644 --- a/design-shotgun/SKILL.md.tmpl +++ b/design-shotgun/SKILL.md.tmpl @@ -283,7 +283,7 @@ If standalone, offer next steps via AskUserQuestion: > "Design direction locked in. What's next? > A) Iterate more — refine the approved variant with specific feedback -> B) Implement — start building from this design +> B) Finalize — generate production Pretext-native HTML/CSS with /design-html > C) Save to plan — add this as an approved mockup reference in the current plan > D) Done — I'll use this later" diff --git a/plan-design-review/SKILL.md b/plan-design-review/SKILL.md index a6be9782..7eaeb336 100644 --- a/plan-design-review/SKILL.md +++ b/plan-design-review/SKILL.md @@ -1223,10 +1223,18 @@ After displaying the Review Readiness Dashboard, recommend the next review(s) ba **If both are needed, recommend eng review first** (required gate). +**Recommend design exploration skills when appropriate** — /design-shotgun and /design-html +produce design artifacts (mockups, HTML previews), not application code. They belong in +plan mode alongside reviews. If this design review found visual issues that would benefit +from exploring new directions, recommend /design-shotgun. If approved mockups exist and +need to be turned into working HTML, recommend /design-html. + Use AskUserQuestion to present the next step. Include only applicable options: - **A)** Run /plan-eng-review next (required gate) - **B)** Run /plan-ceo-review (only if fundamental product gaps found) -- **C)** Skip — I'll handle reviews manually +- **C)** Run /design-shotgun — explore visual design variants for issues found +- **D)** Run /design-html — generate Pretext-native HTML from approved mockups +- **E)** Skip — I'll handle next steps manually ## Formatting Rules * NUMBER issues (1, 2, 3...) and LETTERS for options (A, B, C...). diff --git a/plan-design-review/SKILL.md.tmpl b/plan-design-review/SKILL.md.tmpl index cfafa6e6..68c89e26 100644 --- a/plan-design-review/SKILL.md.tmpl +++ b/plan-design-review/SKILL.md.tmpl @@ -441,10 +441,18 @@ After displaying the Review Readiness Dashboard, recommend the next review(s) ba **If both are needed, recommend eng review first** (required gate). +**Recommend design exploration skills when appropriate** — /design-shotgun and /design-html +produce design artifacts (mockups, HTML previews), not application code. They belong in +plan mode alongside reviews. If this design review found visual issues that would benefit +from exploring new directions, recommend /design-shotgun. If approved mockups exist and +need to be turned into working HTML, recommend /design-html. + Use AskUserQuestion to present the next step. Include only applicable options: - **A)** Run /plan-eng-review next (required gate) - **B)** Run /plan-ceo-review (only if fundamental product gaps found) -- **C)** Skip — I'll handle reviews manually +- **C)** Run /design-shotgun — explore visual design variants for issues found +- **D)** Run /design-html — generate Pretext-native HTML from approved mockups +- **E)** Skip — I'll handle next steps manually ## Formatting Rules * NUMBER issues (1, 2, 3...) and LETTERS for options (A, B, C...).