Initial commit: antigravity-ipa-workflow

skills/ipa-fast/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: ipa-fast
+description: Run the complete IPA workflow in one command with minimal prompts, skipping all validation gates. Use when experienced with IPA and project scope is well understood, for rapid prototyping with a known requirement, or when combining raw text, URL, and image references in one pass. Trigger phrases: "ipa fast mode", "full ipa in one command", "skip all gates and generate everything".
+---
+
+## Overview
+
+Fast mode runs the complete IPA pipeline — lean analysis, spec, design, detail — in one command, skipping all gate prompts. Supports three input types individually or combined.
+
+## When to Use
+
+- Experienced with IPA workflow and gates
+- Project scope is well understood and validated externally
+- Rapid prototyping where throwaway docs are acceptable
+- Combining multiple input references (text + URL + image)
+
+## Don't Use When
+
+- First time using IPA workflow
+- Complex enterprise projects or multi-stakeholder environments
+- User research is incomplete
+- You want gate checkpoints between phases
+
+## Input Types
+
+| Input | Prefix | Purpose |
+|-------|--------|---------|
+| Raw requirement | (none) | Text describing the feature/project |
+| URL reference | `@https://...` | Design inspiration from website |
+| Image reference | `@./path.png` | Design inspiration from screenshot |
+
+## Examples
+
+```
+# Raw requirement only
+ipa-fast "Build a task management app for remote teams"
+
+# Raw requirement + URL reference
+ipa-fast "Build a SaaS dashboard" @https://stripe.com/billing
+
+# Raw requirement + image reference
+ipa-fast "Build a dashboard" @./design-mockup.png
+
+# All 3 inputs combined
+ipa-fast "Build a FinOps dashboard" @https://stripe.com @./color-palette.png
+
+# URL only (requirement inferred)
+ipa-fast @https://linear.app
+```
+
+## Pipeline
+
+```
+ipa-fast "requirement" [@url] [@image]
+    ↓
+1. lean "requirement" --fast       (GATE 1 skipped)
+    ↓
+2. ipa-spec "requirement" @url @image --fast  (GATE 2 skipped)
+   → Design System extracted from references
+    ↓
+3. ipa-design --fast               (GATE 3 skipped)
+   → Prototypes generated from Design System
+    ↓
+4. ipa-detail
+    ↓
+Output: All IPA docs generated
+    ↓
+Final: "Review generated docs. Ready to plan?"
+```
+
+## Execution Steps
+
+### Step 1: Lean Analysis
+Run lean with fast flag — skip GATE 1. Log warning: "GATE 1 (Scope Validation) skipped".
+
+### Step 2: Spec Generation
+Run ipa-spec with fast flag — skip GATE 2. Log warning: "GATE 2 (Spec Validation) skipped".
+
+### Step 3: Design Generation
+Run ipa-design with fast flag — skip GATE 3. Log warning: "GATE 3 (Design Validation) skipped".
+
+### Step 4: Detail Design
+Run ipa-detail to generate API_SPEC.md and DB_DESIGN.md.
+
+### Step 5: Final Summary
+
+```
+IPA Fast Mode Complete
+
+Generated docs:
+- docs/SRD.md
+- docs/UI_SPEC.md
+- docs/API_SPEC.md
+- docs/DB_DESIGN.md
+- prototypes/html-mockups/
+
+Skipped gates: GATE 1, GATE 2, GATE 3
+
+Next steps:
+1. Review generated docs for accuracy
+2. Run ipa-validate to check traceability
+3. Plan with docs and prototypes as context
+```