anchi-kit 1.2.1 → 1.2.2

package/.antigravity/skills/frontend-design/references/asset-generation.md

@@ -1,337 +0,0 @@
-# Asset Generation Workflow
-
-Complete workflow for generating design-aligned visual assets using `ai-multimodal` skill.
-
-## Generation Workflow
-
-### Step 1: Define Design Context
-
-Before generating, extract from the design brief:
-- **Aesthetic direction**: Minimalist? Maximalist? Brutalist? Organic?
-- **Color palette**: Primary colors, accent colors, mood
-- **Typography character**: Modern sans-serif? Elegant serif? Bold display?
-- **Visual tone**: Professional? Playful? Luxury? Raw?
-- **User context**: Who sees this? What problem does it solve?
-
-### Step 2: Craft Contextual Prompts
-
-Translate design thinking into generation prompts.
-
-**Generic (❌ Avoid)**:
-```
-"Modern website hero image"
-```
-
-**Design-Driven (✓ Use)**:
-```
-"Brutalist architectural photograph, stark concrete textures,
-dramatic shadows, high contrast black and white, raw unpolished
-surfaces, geometric shapes, monumental scale, inspired by
-1960s Bauhaus, 16:9 aspect ratio"
-```
-
-**Prompt Components**:
-1. **Style/Movement**: "Neo-brutalism", "Art Deco", "Organic modernism"
-2. **Visual Elements**: Textures, shapes, composition style
-3. **Color Direction**: "Muted earth tones", "Vibrant neon accents", "Monochromatic"
-4. **Mood/Atmosphere**: "Serene", "Energetic", "Mysterious"
-5. **Technical Specs**: Aspect ratio, composition focus
-6. **References**: "Inspired by [artist/movement]"
-
-### Step 3: Generate with Appropriate Model
-
-Use `ai-multimodal` skill's image generation capabilities:
-
-```bash
-# Standard quality (most cases)
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[your design-driven prompt]" \
-  --output docs/assets/hero-image \
-  --model imagen-4.0-generate-001 \
-  --aspect-ratio 16:9
-
-# Ultra quality (production hero images, marketing)
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[your design-driven prompt]" \
-  --output docs/assets/hero-ultra \
-  --model imagen-4.0-ultra-generate-001 \
-  --size 2K
-
-# Fast iteration (exploring concepts)
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[your design-driven prompt]" \
-  --output docs/assets/concept \
-  --model imagen-4.0-fast-generate-001
-```
-
-**Model Selection**:
-- **imagen-4.0-generate-001**: Default choice, balanced quality/speed
-- **imagen-4.0-ultra-generate-001**: Final production assets, marketing materials
-- **imagen-4.0-fast-generate-001**: Rapid prototyping, multiple variations
-
-**Aspect Ratios**:
-- **16:9**: Hero sections, wide banners
-- **9:16**: Mobile-first, vertical content
-- **1:1**: Square cards, social media
-- **4:3**: Classic layouts, presentations
-- **3:4**: Portrait orientations, mobile screens
-
-### Step 4: Evaluate Against Design Standards
-
-Use `ai-multimodal` to analyze the generated asset (see `visual-analysis.md` for complete workflow):
-
-```bash
-python scripts/gemini_batch_process.py \
-  --files docs/assets/hero-image.png \
-  --task analyze \
-  --prompt "Evaluate this image for:
-1. Visual coherence with [aesthetic direction]
-2. Color harmony and contrast
-3. Composition and balance
-4. Suitability for overlaying text
-5. Professional quality (rate 1-10)
-6. Specific weaknesses or improvements needed" \
-  --output docs/assets/hero-evaluation.md \
-  --model gemini-2.5-flash
-```
-
-### Step 5: Iterate or Integrate
-
-**If evaluation score < 7/10 or doesn't meet standards**:
-1. Identify specific issues (color, composition, mood, technical)
-2. Refine prompt with improvements
-3. Regenerate with adjusted parameters
-4. Consider using `media-processing` skill for post-generation adjustments
-
-**If meets standards**:
-1. Optimize for web (compress, format conversion)
-2. Create responsive variants if needed
-3. Document asset usage guidelines
-4. Integrate into frontend implementation
-
-## Design Pattern Examples
-
-### Pattern 1: Minimalist Background Texture
-
-**Design Context**: Clean, refined interface with generous white space
-
-**Prompt Strategy**:
-```
-"Subtle paper texture, off-white color (#F8F8F8), barely visible
-grain pattern, high-end stationery feel, minimal contrast,
-professional and clean, 1:1 aspect ratio for tiling"
-```
-
-**Use Case**: Background for minimalist product pages, portfolio sites
-
-### Pattern 2: Maximalist Hero Section
-
-**Design Context**: Bold, energetic landing page with vibrant colors
-
-**Prompt Strategy**:
-```
-"Explosive color gradients, neon pink to electric blue,
-holographic reflections, dynamic diagonal composition,
-retrofuturistic aesthetic, vaporwave influence, high energy,
-layered transparency effects, 16:9 cinematic"
-```
-
-**Use Case**: Hero section for creative agencies, entertainment platforms
-
-### Pattern 3: Brutalist Geometric Pattern
-
-**Design Context**: Raw, bold interface with strong typography
-
-**Prompt Strategy**:
-```
-"Monochromatic geometric pattern, overlapping rectangles,
-stark black and white, high contrast, Swiss design influence,
-grid-based composition, architectural precision, repeatable
-pattern for backgrounds"
-```
-
-**Use Case**: Background pattern for design studios, architecture firms
-
-### Pattern 4: Organic Natural Elements
-
-**Design Context**: Wellness brand, calming user experience
-
-**Prompt Strategy**:
-```
-"Soft botanical watercolor, sage green and cream tones,
-gentle leaf shadows, natural light quality, serene atmosphere,
-minimal detail for text overlay, 3:4 portrait orientation"
-```
-
-**Use Case**: Hero section for wellness brands, eco-friendly products
-
-### Pattern 5: Retro-Futuristic
-
-**Design Context**: Tech product with nostalgic twist
-
-**Prompt Strategy**:
-```
-"80s computer graphics aesthetic, wireframe grids, cyan and magenta
-gradients, digital sunrise, Tron-inspired, geometric precision,
-nostalgic future vision, 16:9 widescreen"
-```
-
-**Use Case**: SaaS landing pages, tech conferences, gaming platforms
-
-### Pattern 6: Editorial Magazine Style
-
-**Design Context**: Content-heavy site with strong visual hierarchy
-
-**Prompt Strategy**:
-```
-"High-contrast editorial photography, dramatic side lighting,
-stark shadows, black and white, fashion magazine quality,
-strong vertical composition, 3:4 portrait for text layout"
-```
-
-**Use Case**: Blog headers, news sites, content platforms
-
-## Prompt Engineering Best Practices
-
-### 1. Be Specific About Style
-❌ "Modern design"
-✓ "Bauhaus-inspired geometric abstraction with primary colors"
-
-### 2. Define Color Precisely
-❌ "Colorful"
-✓ "Vibrant sunset palette: coral (#FF6B6B), amber (#FFB84D), violet (#A66FF0)"
-
-### 3. Specify Composition
-❌ "Nice layout"
-✓ "Rule of thirds composition, subject left-aligned, negative space right for text overlay"
-
-### 4. Reference Movements/Artists
-❌ "Artistic"
-✓ "Inspired by Bauhaus geometric abstraction and Swiss International Style"
-
-### 5. Technical Requirements First
-Always include: aspect ratio, resolution needs, intended use case
-
-### 6. Iterate Strategically
-- First generation: Broad aesthetic exploration
-- Second generation: Refine color and composition
-- Third generation: Fine-tune details and mood
-
-## Common Pitfalls to Avoid
-
-### ❌ Generic Stock Photo Aesthetics
-Don't prompt: "Professional business team working together"
-Instead: Design-specific, contextual imagery that serves the interface
-
-### ❌ Overcomplex Generated Images
-Generated assets that compete with UI elements create visual chaos
-Keep backgrounds subtle enough for text/button overlay
-
-### ❌ Inconsistent Visual Language
-Each generated asset should feel part of the same design system
-Maintain color palette, visual style, mood consistency
-
-### ❌ Ignoring Integration Context
-Assets aren't standalone—consider how they work with:
-- Typography overlays
-- Interactive elements (buttons, forms)
-- Navigation and UI chrome
-- Responsive behavior across devices
-
-## Responsive Asset Strategy
-
-### Desktop-First Approach
-1. Generate primary asset at 16:9 (desktop hero)
-2. Generate mobile variant at 9:16 with same prompt
-3. Ensure focal point works in both orientations
-
-### Mobile-First Approach
-1. Generate primary asset at 9:16 (mobile hero)
-2. Generate desktop variant at 16:9 with same prompt
-3. Test that composition scales effectively
-
-### Variant Generation
-```bash
-# Desktop (16:9)
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[prompt]" \
-  --output docs/assets/hero-desktop \
-  --model imagen-4.0-generate-001 \
-  --aspect-ratio 16:9
-
-# Mobile (9:16)
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[same prompt]" \
-  --output docs/assets/hero-mobile \
-  --model imagen-4.0-generate-001 \
-  --aspect-ratio 9:16
-
-# Square (1:1)
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[same prompt]" \
-  --output docs/assets/hero-square \
-  --model imagen-4.0-generate-001 \
-  --aspect-ratio 1:1
-```
-
-## Model Cost Optimization
-
-**Imagen 4 Pricing** (as of 2024):
-- Standard: ~$0.04 per image
-- Ultra: ~$0.08 per image
-- Fast: ~$0.02 per image
-
-**Optimization Strategy**:
-1. Use Fast model for exploration (3-5 variations)
-2. Select best direction, generate with Standard model
-3. Use Ultra only for final production assets
-4. Batch generate variations in single session
-
-## Complete Example Workflow
-
-```bash
-# 1. Fast exploration (3 variations)
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "Minimalist mountain landscape, muted blue-gray tones,
-  fog layers, serene morning atmosphere, clean for text overlay, 16:9" \
-  --output docs/assets/concept-1 \
-  --model imagen-4.0-fast-generate-001 \
-  --aspect-ratio 16:9
-
-# 2. Analyze best variation
-python scripts/gemini_batch_process.py \
-  --files docs/assets/concept-1.png \
-  --task analyze \
-  --prompt "Rate 1-10 for aesthetic quality, color harmony, text overlay suitability" \
-  --output docs/assets/analysis-1.md \
-  --model gemini-2.5-flash
-
-# 3. If score ≥ 7/10, generate production version
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[refined prompt based on analysis]" \
-  --output docs/assets/hero-final \
-  --model imagen-4.0-generate-001 \
-  --aspect-ratio 16:9
-
-# 4. Generate mobile variant
-python scripts/gemini_batch_process.py \
-  --task generate \
-  --prompt "[same refined prompt]" \
-  --output docs/assets/hero-mobile \
-  --model imagen-4.0-generate-001 \
-  --aspect-ratio 9:16
-```
-
-## Next Steps
-
-- **Verify quality**: See `visual-analysis.md` for comprehensive analysis workflow
-- **Optimize assets**: See `technical-guide.md` for file optimization and integration
-- **Extract inspiration**: See `design-extraction.md` to learn from existing designs

package/.antigravity/skills/frontend-design/references/design-extraction-overview.md

@@ -1,71 +0,0 @@
-# Extract Design Guidelines from Existing Assets
-
-Reverse-engineer design principles from existing images or videos to establish design guidelines.
-
-## Purpose
-
-- Analyze competitor designs to understand their approach
-- Extract design systems from inspiration screenshots
-- Learn from high-quality design examples
-- Create documented guidelines based on visual analysis
-- Establish consistent aesthetic direction from references
-
-## Use Cases
-
-- Analyzing competitor websites or apps
-- Learning from inspiration galleries (Dribbble, Awwwards, Mobbin)
-- Extracting design systems from brand materials
-- Reverse-engineering successful interfaces
-- Creating design documentation from visual references
-
-## Quick Workflows
-
-### Single Image Analysis
-```bash
-python scripts/gemini_batch_process.py \
-  --files docs/inspiration/reference-design.png \
-  --task analyze \
-  --prompt "[see extraction-prompts.md for detailed prompt]" \
-  --output docs/design-guidelines/extracted-design-system.md \
-  --model gemini-2.5-flash
-```
-
-### Multi-Screen System Extraction
-```bash
-python scripts/gemini_batch_process.py \
-  --files docs/inspiration/home.png docs/inspiration/about.png \
-  --task analyze \
-  --prompt "[see extraction-prompts.md for multi-screen prompt]" \
-  --output docs/design-guidelines/complete-design-system.md \
-  --model gemini-2.5-flash
-```
-
-### Video Motion Analysis
-```bash
-python scripts/gemini_batch_process.py \
-  --files docs/inspiration/interaction-demo.mp4 \
-  --task analyze \
-  --prompt "[see extraction-prompts.md for motion prompt]" \
-  --output docs/design-guidelines/motion-system.md \
-  --model gemini-2.5-flash
-```
-
-### Competitive Analysis
-```bash
-python scripts/gemini_batch_process.py \
-  --files competitor-a.png competitor-b.png competitor-c.png \
-  --task analyze \
-  --prompt "[see extraction-prompts.md for competitive prompt]" \
-  --output docs/design-guidelines/competitive-analysis.md \
-  --model gemini-2.5-flash
-```
-
-## Detailed References
-
-- `extraction-prompts.md` - All extraction prompt templates
-- `extraction-best-practices.md` - Capture quality, analysis tips
-- `extraction-output-templates.md` - Documentation formats
-
-## Integration
-
-After extraction, use guidelines with `asset-generation.md` for generating design-aligned visual assets.

package/.antigravity/skills/frontend-design/references/extraction-best-practices.md

@@ -1,141 +0,0 @@
-# Extraction Best Practices
-
-Guidelines for capturing and analyzing design references effectively.
-
-## Capture Quality Guidelines
-
-### Screenshot Requirements
-- High-resolution (minimum 1920px wide for desktop)
-- Accurate color reproduction (disable browser extensions that alter colors)
-- Actual viewport size, not full-page scrolls
-- Device-specific resolutions (desktop 1920x1080, mobile 390x844)
-- Multiple states: default, hover, active, responsive breakpoints
-
-### Multiple Examples
-- Analyze 3-5 screens minimum for pattern recognition
-- Include different page types (home, product, about, contact)
-- Single screenshots miss patterns
-- Capture from same site to identify consistency
-
-## Analysis Best Practices
-
-### 1. Demand Specifics
-❌ Accept: "Uses blue and gray colors"
-✓ Demand: "Primary: #1E40AF, Secondary: #6B7280, Accent: #F59E0B"
-
-❌ Accept: "Modern sans-serif font"
-✓ Demand: "Inter, weight 600, 48px for h1, tracking -0.02em"
-
-### 2. Document Rationale
-Understand *why* design decisions work, not just *what* they are:
-- Why does this color palette create trust?
-- Why does this spacing scale improve readability?
-- Why does this typography hierarchy guide user attention?
-
-### 3. Create Actionable Guidelines
-Output should be directly implementable in code:
-
-```css
-/* Immediately usable CSS from extraction */
-:root {
-  --font-display: 'Bebas Neue', sans-serif;
-  --font-body: 'Inter', sans-serif;
-
-  --color-primary-600: #1E40AF;
-  --color-accent-500: #F59E0B;
-
-  --spacing-xs: 4px;
-  --spacing-sm: 8px;
-  --spacing-md: 16px;
-  --spacing-lg: 24px;
-
-  --radius-sm: 4px;
-  --radius-md: 8px;
-
-  --shadow-sm: 0 1px 2px rgba(0,0,0,0.05);
-  --shadow-md: 0 4px 6px rgba(0,0,0,0.1);
-}
-```
-
-### 4. Cross-Reference
-- Validate font predictions against Google Fonts library
-- Use font identification tools (WhatFont, Font Ninja) for accuracy
-- Manually verify extracted colors with eyedropper tools
-
-### 5. Iterate Analysis
-First pass may miss subtleties:
-- Run initial comprehensive analysis
-- Review output, identify gaps
-- Run focused follow-up queries for specific elements
-
-## Advanced Techniques
-
-### Design System Mining
-Extract complete design system from single brand (10+ screens):
-
-```bash
-python scripts/gemini_batch_process.py \
-  --files docs/inspiration/brand/*.png \
-  --task analyze \
-  --prompt "Extract complete, production-ready design system:
-- All color tokens (20+ colors)
-- All typography specs (sizes, weights, line-heights)
-- All spacing tokens
-- All component variants
-- All animation timings
-Output as CSS variables ready for implementation." \
-  --output docs/design-guidelines/brand-design-system.md \
-  --model gemini-2.5-flash
-```
-
-### Trend Analysis
-Analyze multiple top designs to identify current trends:
-
-```bash
-python scripts/gemini_batch_process.py \
-  --files docs/inspiration/awwwards-*.png \
-  --task analyze \
-  --prompt "Trend analysis across 10 award-winning designs:
-1. Dominant aesthetic movements
-2. Common color strategies
-3. Typography trends
-4. Layout innovations
-5. Animation patterns
-Identify what's trending in 2024 web design." \
-  --output docs/design-guidelines/trend-analysis.md \
-  --model gemini-2.5-flash
-```
-
-### Historical Evolution
-Track design evolution of single brand over time:
-
-```bash
-python scripts/gemini_batch_process.py \
-  --files docs/inspiration/brand-2020.png docs/inspiration/brand-2024.png \
-  --task analyze \
-  --prompt "Compare 2020 vs 2024 design evolution:
-1. What changed and why
-2. What remained consistent (brand identity)
-3. How trends influenced changes
-4. Lessons for our design evolution" \
-  --output docs/design-guidelines/evolution-analysis.md \
-  --model gemini-2.5-flash
-```
-
-## Common Pitfalls
-
-### ❌ Surface-Level Analysis
-"Uses blue colors and sans-serif fonts"
-**Fix**: Demand specifics—hex codes, font names, size values
-
-### ❌ Missing Context
-Extracting design without understanding target audience or purpose
-**Fix**: Research brand context before analysis
-
-### ❌ Blind Copying
-Extracting and applying design 1:1 to your project
-**Fix**: Extract principles, adapt to your unique context
-
-### ❌ Single Source
-Learning from one example only
-**Fix**: Analyze 3-5 examples to identify patterns vs. anomalies

package/.antigravity/skills/frontend-design/references/extraction-output-templates.md

@@ -1,162 +0,0 @@
-# Extraction Output Templates
-
-Documentation format templates for extracted design guidelines.
-
-## Template 1: Complete Design System
-
-```markdown
-# [Project/Competitor] Design System
-
-## Aesthetic Direction
-- **Style**: Neo-brutalism with organic elements
-- **Mood**: Bold, confident, approachable
-- **Differentiation**: High contrast typography with soft color accents
-
-## Typography
-### Display Font
-- Family: Archivo Black (Google Fonts)
-- Sizes: h1: 72px, h2: 48px, h3: 36px
-- Weights: 400 (regular)
-- Line Height: 1.1
-- Letter Spacing: -0.02em
-
-### Body Font
-- Family: Inter (Google Fonts)
-- Sizes: body: 16px, small: 14px
-- Weights: 400, 500, 600
-- Line Height: 1.6
-- Letter Spacing: 0
-
-## Color Palette
-\```css
-:root {
-  /* Primary Colors */
-  --color-primary-900: #0A1628;
-  --color-primary-600: #1E40AF;
-  --color-primary-400: #60A5FA;
-
-  /* Accent Colors */
-  --color-accent-500: #F59E0B;
-  --color-accent-300: #FCD34D;
-
-  /* Neutral Colors */
-  --color-neutral-900: #111827;
-  --color-neutral-700: #374151;
-  --color-neutral-500: #6B7280;
-  --color-neutral-300: #D1D5DB;
-  --color-neutral-100: #F3F4F6;
-
-  /* Background */
-  --color-bg-primary: #FFFFFF;
-  --color-bg-secondary: #F9FAFB;
-}
-\```
-
-## Spacing System
-- Base: 4px
-- Scale: 4, 8, 12, 16, 24, 32, 48, 64, 96px
-- Usage: Consistent 8px rhythm for most components
-
-## Component Specifications
-
-### Button (Primary)
-\```css
-.button-primary {
-  background: var(--color-primary-600);
-  color: white;
-  padding: 12px 24px;
-  border-radius: 8px;
-  font-weight: 600;
-  transition: background 200ms ease-out;
-}
-.button-primary:hover {
-  background: var(--color-primary-900);
-}
-\```
-
-### Card
-\```css
-.card {
-  background: white;
-  border-radius: 12px;
-  padding: 24px;
-  box-shadow: 0 4px 6px rgba(0,0,0,0.05);
-  transition: box-shadow 200ms ease-out;
-}
-.card:hover {
-  box-shadow: 0 10px 15px rgba(0,0,0,0.1);
-}
-\```
-
-## Motion Guidelines
-- Transition timing: 200ms for micro-interactions, 400ms for page transitions
-- Easing: ease-out for entrances, ease-in for exits
-- Stagger delay: 50ms between sequential elements
-```
-
-## Template 2: Competitive Analysis
-
-```markdown
-# Competitive Design Analysis
-
-## Competitors Analyzed
-1. Competitor A - [URL]
-2. Competitor B - [URL]
-3. Competitor C - [URL]
-
-## Comparative Summary
-
-| Aspect | Competitor A | Competitor B | Competitor C |
-|--------|--------------|--------------|--------------|
-| Aesthetic | Minimalist | Maximalist | Editorial |
-| Primary Color | #1E40AF | #7C3AED | #DC2626 |
-| Typography | Inter | Poppins | Playfair Display |
-| Layout | Grid-based | Asymmetric | Magazine |
-
-## Common Patterns (Industry Standard)
-- All use sans-serif for body text
-- All prioritize mobile-first responsive design
-- All use card-based layouts for content
-- All feature hero sections with large imagery
-
-## Differentiation Opportunities
-1. **Color Strategy**: Competitors use saturated colors; opportunity for muted, sophisticated palette
-2. **Typography**: No one uses display serifs; opportunity for elegant, high-end feel
-3. **Layout**: All symmetric; opportunity for asymmetric, dynamic composition
-
-## Recommendations
-Based on analysis, recommend:
-- Aesthetic: Refined minimalism with editorial typography
-- Color: Muted earth tones with one bold accent
-- Layout: Asymmetric grid with generous white space
-- Differentiation: Unexpected typography hierarchy, subtle animations
-```
-
-## Integration Workflow
-
-### After Extraction
-
-1. **Review & Validate**
-   - Manually verify color codes with eyedropper tool
-   - Cross-reference font predictions against Google Fonts
-   - Check spacing values against browser dev tools
-
-2. **Adapt & Customize**
-   - Don't copy—adapt principles to your unique context
-   - Maintain underlying logic, change expression
-   - Example: Extract "generous white space" principle, apply with your colors
-
-3. **Document Decisions**
-   - Save extracted guidelines in project `docs/design-guidelines/`
-   - Create design system spec from extraction
-   - Reference when generating new assets
-
-4. **Reference in Implementation**
-   - Use extracted tokens when generating new assets with `asset-generation.md`
-   - Apply extracted principles when analyzing your own designs with `visual-analysis.md`
-   - Maintain consistency between inspiration and implementation
-
-5. **Iterate & Refine**
-   - Update guidelines as design evolves
-   - Extract from multiple sources, synthesize learnings
-   - Create your own unique voice from combined insights