Files
calctext/_bmad/wds/workflows/6-asset-generation/workflow-stitch.md
2026-03-16 19:54:53 -04:00

3.9 KiB

name, description, web_bundle
name description web_bundle
stitch-generation AI-assisted UI design using Google Stitch from specifications and sketches true

Stitch UI Generation

Goal: Generate production-quality UI designs using Google Stitch AI

Your Role: Guide the user through preparing inputs and creating a Stitch generation dialog


INITIALIZATION

Design Log

Read {output_folder}/_progress/00-design-log.md. Check Current and Backlog for context.

OVERVIEW

Google Stitch transforms text prompts, sketches, and reference images into responsive interfaces.

Input Formula:

Visual Reference + Sketch + Specification = Stitch Generation

Output: UI designs exportable to Figma or HTML/CSS


WHEN TO USE

Use Stitch when:

  • New page with detailed specification ready
  • Have a visual reference (existing design or screenshot)
  • Have a sketch showing layout structure
  • Want rapid visual design iteration

Skip when:

  • Building design system components (use tokens instead)
  • Minor updates to existing designs
  • No specification exists yet (write spec first)

PREREQUISITES

  1. Specification exists for the screen(s) to generate
  2. Visual reference available (screenshot or approved design)
  3. Sketch available showing layout structure

WORKFLOW

Step 1: Create Generation Log

Create a Stitch generation log in the agent experiences folder.

Location: {output_folder}/_progress/agent-experiences/{YYYY-MM-DD}-stitch-{feature}.md

Step 2: Pre-Generation Questions

For each potential screen, decide:

Question Columns
Generate in Stitch? Screen, Has Code?, Has Sketch?, Generate?, Why
What reference? Screen, Reference, Source

Step 3: Gather Inputs

Input Action
Visual Reference Take screenshot OR locate existing design
Sketch Locate in spec's Sketches/ folder
Prompt Prepare using template below

Step 3a: Prepare the Prompt

DO NOT paste raw specifications into Stitch. Use the prompt template instead.

Template: templates/stitch-prompt.template.md

Include: Project Context, Design System, Component Styles, Screen Content (ONE language, no Object IDs), Current State Notes.

Step 4: Generate in Stitch

  1. Go to stitch.withgoogle.com
  2. Upload visual reference and sketch images
  3. Paste prepared prompt
  4. Generate 2-3 variants
  5. Select best result

Settings: Standard Mode (quick) or Pro Mode (higher fidelity). Viewport: Mobile 390px or Desktop 1440px.

Step 5: Review Against Spec

Check Pass?
Content/copy matches spec
Layout follows sketch
Visual style matches reference
All key elements present

If issues: Re-prompt with specific corrections or edit in Stitch.

Step 6: Export & Store

Format When Destination
Figma Team collaboration Figma project
HTML/CSS Code reference {spec-folder}/Visual-Design/
Screenshot Documentation {spec-folder}/Visual-Design/

Naming: {screen-name}-stitch-v{#}.{ext}

Step 7: Update Specification

Add Visual Design section to specification referencing the Stitch output.


STITCH CAPABILITIES & LIMITS

Does well: Single screen generation, style matching, responsive layouts, clean HTML/CSS export, Figma-compatible output.

Limitations: Best with 2-3 screens at a time, layouts can be generic, no built-in design system awareness, free tier limits (350 standard + 200 pro/month).


PROMPT TIPS

Effective prompts include: App type, Context, Visual direction, Key elements, Actual content/text, Mood/tone, Viewport.

Template: See templates/stitch-prompt.template.md for complete structure and example.


AFTER COMPLETION

  1. Update design log
  2. Suggest next action (implementation or further iteration)