# design-discovery

> Discover POD design trends, generate NanaBanana Pro prompts, and manage the Awakening Apparel design pipeline. Use when creating new apparel designs, running design discovery, or managing the L13 pipeline.

- Author: Shawn Garland
- Repository: shawngarlandgit/neuro-pipeline
- Version: 20260129223835
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/shawngarlandgit/neuro-pipeline
- Web: https://mule.run/skillshub/@@shawngarlandgit/neuro-pipeline~design-discovery:20260129223835

---

---
name: design-discovery
description: Discover POD design trends, generate NanaBanana Pro prompts, and manage the Awakening Apparel design pipeline. Use when creating new apparel designs, running design discovery, or managing the L13 pipeline.
---

# Design Discovery Skill (L13)

## Overview

L13 Design Discovery is the automated system that discovers trending designs, sayings, and styles, then intelligently combines them into NanaBanana Pro prompts for Etsy apparel (Awakening Apparel brand).

## Quick Commands

### Run Full Discovery
```bash
# Full daily discovery (all 5 steps)
node api/services/l13-design-discovery/workflow.js

# With Telegram notification format
node api/services/l13-design-discovery/workflow.js --telegram

# View statistics only
node api/services/l13-design-discovery/workflow.js --stats
```

### Generate Sayings
```bash
# Slavic folklore sayings (brand specialty)
node api/services/l13-design-discovery/workflow.js --slavic

# Category-specific sayings
node scripts/run-l13-discovery.js --category=motivational
```

### Production-Ready Concepts
```bash
# List concepts ready for NanaBanana Pro
node api/services/l13-design-discovery/workflow.js --ready

# Test apparel design generation
node scripts/test-l13-apparel-designs.js
```

### Export Prompts
```bash
# Export all prompts to markdown
node scripts/export-design-prompts.js

# Export with filtering
node scripts/export-design-prompts.js --status=approved
```

## 5-Engine Pipeline

| Engine | Purpose | Output |
|--------|---------|--------|
| **Design Trend Engine** | Discover trending visual styles | `design_trends` table |
| **Saying Discovery Engine** | Find brand-aligned quotes | `saying_discoveries` table |
| **Style Expander Engine** | Expand styles with motifs | `style_expansions` table |
| **Intelligent Matcher** | Combine trend+saying+style | `design_concepts` table |
| **Prompt Generator** | Create NanaBanana prompts | `nanabananapro_prompt` field |

## Prompt Templates

### Typography Focused
Bold text-centric designs for t-shirts.
```
Main text: "{{saying}}"
Style: {{typography_style}}
Effect: Bold, readable
```

### Illustration with Text
Art + typography combinations.
```
Main subject: {{main_subject}}
Quote: "{{saying}}"
Art style: {{art_style}}
```

### Slavic Mythology (Brand Specialty)
Dark, mystical ancient Slavic aesthetic.
```
Mythological subject: {{mythological_subject}}
Symbols: {{slavic_symbols}}
Quote: "{{saying}}"
Typography: Ancient/runic inspired
```

## Database Tables

| Table | Purpose |
|-------|---------|
| `design_trends` | Discovered visual trends |
| `saying_discoveries` | Brand-aligned quotes/sayings |
| `style_expansions` | Expanded style variations |
| `design_concepts` | Matched concept combinations |
| `prompt_templates` | Reusable prompt templates |
| `design_trend_sources` | RSS/API sources for trends |

## Common Queries

### View Recent Concepts
```sql
SELECT id, concept_name, concept_score, target_collection, created_at
FROM design_concepts
ORDER BY created_at DESC
LIMIT 10;
```

### GOLD Concepts (Ready for Production)
```sql
SELECT id, concept_name, nanabananapro_prompt
FROM design_concepts
WHERE status = 'approved' AND nanabananapro_prompt IS NOT NULL
ORDER BY concept_score DESC;
```

### Sayings by Category
```sql
SELECT id, saying_text, category, tone
FROM saying_discoveries
WHERE status = 'active'
ORDER BY created_at DESC;
```

### Check Stats
```sql
SELECT
  (SELECT COUNT(*) FROM design_trends WHERE status = 'active') as trends,
  (SELECT COUNT(*) FROM saying_discoveries WHERE status IN ('active', 'approved')) as sayings,
  (SELECT COUNT(*) FROM style_expansions WHERE status IN ('approved', 'active')) as styles,
  (SELECT COUNT(*) FROM design_concepts) as concepts,
  (SELECT COUNT(*) FROM design_concepts WHERE status = 'approved') as ready;
```

## Key Files

| File | Purpose |
|------|---------|
| `api/services/l13-design-discovery/index.js` | Main entry point |
| `api/services/l13-design-discovery/workflow.js` | Daily discovery workflow |
| `api/services/l13-design-discovery/prompt-generator.js` | NanaBanana prompt creation |
| `api/services/l13-design-discovery/design-trend-engine.js` | Trend discovery from L0/AI |
| `api/services/l13-design-discovery/saying-discovery-engine.js` | Quote/saying generation |
| `api/services/l13-design-discovery/intelligent-matcher.js` | Concept matching |
| `api/services/nano-banana/scene-pools.js` | Lifestyle scene descriptions |
| `scripts/export-design-prompts.js` | Export prompts to markdown |
| `docs/L13-DESIGN-DISCOVERY.md` | Full documentation |

## Scene Pools (Lifestyle Photography)

For mockup backgrounds, use seasonal scene pools:

| Pool | Seasons | Use Case |
|------|---------|----------|
| `REFLECTIVE_SCENES` | winter/spring/summer/fall | Introspective moments |
| `ACTIVE_SCENES` | winter/spring/summer/fall | Energy/movement |
| `SOCIAL_SCENES` | winter/spring/summer/fall | Connection moments |
| `CELEBRATORY_SCENES` | winter/spring/summer/fall | Achievement/joy |
| `KITCHEN_SCENES` | winter/spring/summer/fall | Cozy domestic |
| `WINDOW_SCENES` | winter/spring/summer/fall | Natural light |

## Telegram Notifications

When concepts are generated, notifications are sent to Telegram with:
- Concept name and score
- Target collection
- Saying preview
- Trend source
- NanaBanana prompt (truncated)
- Action buttons (Approve/Edit/Archive)

## Environment Variables

```bash
GOOGLE_API_KEY=...           # For Gemini AI
TELEGRAM_BOT_TOKEN=...       # For notifications
TELEGRAM_CHAT_ID=...         # Your chat ID
```

## Troubleshooting

- **No trends found**: Check L0 signals, may need AI fallback
- **Prompt too short**: AI enhancement runs automatically
- **Slavic symbols missing**: Use `--slavic` flag for specialized generation