antigravity-ipa-workflow/skills/ipa-bd/SKILL.md

name: ipa-bd description: Generate UI_SPEC.md only from an existing SRD. Use when you need granular control over basic design generation, want to regenerate only the UI specification without touching the SRD, or are working on UI-only updates. Trigger phrases: "generate UI spec", "create basic design", "generate ui_spec only".

TIP: Use ipa-spec instead to generate both SRD.md + UI_SPEC.md in one step.

This skill is for granular control when you only need UI_SPEC.md.

Prerequisite: docs/SRD.md must exist.

Overview

Generate Basic Design documentation following IPA standard, with Customer Journey Experience (CJX), design reference support, and platform-specific UX patterns.

Output: docs/UI_SPEC.md

When to Use

• SRD already exists and only UI spec is needed
• Regenerating UI spec after SRD changes
• Iterating on design system without touching requirements

Don't Use When

• SRD does not yet exist (run ipa-spec first)
• You need both SRD and UI_SPEC generated together (use ipa-spec)

Project Type Handling

Project Type	UX Spec Focus
Web App	Screens, components, responsive
Desktop App	Windows, dialogs, menus
CLI Tool	Commands, output, prompts
MCP Server	Tool descriptions, prompts
Chatbot/RAG	Conversation flows, responses
Library/SDK	API docs, examples

User Research Integration

If docs/USER_RESEARCH.md exists:

1. Read personas and journey maps
2. Map journey stages to screens
3. Add design rationale to each screen
4. Apply emotional design (CJX)

Workflow

With Reference URL

1. Fetch reference URL
2. Extract design system (colors, fonts, spacing)
3. Analyze screenshots if needed
4. Generate UI_SPEC with extracted values

Without Reference

1. Ask user for color preference or use neutral palette
2. Generate default design system
3. Generate UI_SPEC

Output Structure

# UI Specification (Basic Design)

## 1. Customer Journey Experience (CJX)
### User Personas
### Customer Journey Map

## 2. Design System
### Color Palette
### Typography

## 3. Screen Specifications
### S-01: [Screen Name]
**Refs:** FR-xx (SRD), CJX Stage: [stage]
**Layout:** [ASCII diagram]
**Components:** [table]

After Generation

1. Save to docs/UI_SPEC.md
2. Ask user to review design system
3. Next step: run ipa-design to generate HTML mockups, or ipa-detail for API/DB design