Initial commit: antigravity-ipa-workflow

skills/ipa-bd/SKILL.md

@@ -0,0 +1,87 @@
+---
+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
+
+```markdown
+# 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