# 2026-02-06 Session Notes

## Design Pipeline Improvements

### ScreensGallery Fixes
- Fixed undefined `screen.path` causing 500 errors in gallery API
- Category grouping now shows in main grid view (not flat)
- Lightbox shows category info on click
- Files: `ScreensGallery.tsx`, `DesignPreview.tsx`

### Typography Component Fix
- "Pending" status was showing incorrectly
- Now checks `selected_at` OR `generated_at` OR presence of `heading` field
- Any of these indicates typography has been generated

### Design Prompting Research & Implementation
**Problem:** AI-generated landing pages were generic (purple gradients, 3-col grids, emoji icons, same layout every time)

**Research sources:**
- NN/g: vague-prototyping article
- Builder.io: 11 AI prompting tips
- CrazyEgg: 180+ prompt tests
- The New Stack: prompt engineering for design

**Solution implemented:**
1. Created `agency/templates/design-system-prompt.md` - template for auto-generated design system docs
2. Updated `build-plan-prompt.md` - references design-system-prompt.md as PRIMARY design reference
3. Updated `design-agent/SKILL.md` - Step 7 generates design system prompt from all artifacts
4. Updated `landing-page-builder/SKILL.md` - explicit anti-patterns and Lucide-only rule

**Key insight:** Must explicitly tell AI what NOT to do (anti-patterns list)

### Still TODO
- [ ] Update `frontend-design` skill with Lucide requirements + design-system-prompt.md reference

## Infrastructure

### Brave Search API
- Added API key to OpenClaw config at `tools.web.search.apiKey`
- web_search tool now working

### #aria Channel Config
- Auto-thread enabled (conversations start threads)
- Require-mention enabled (only respond when @mentioned)

## Design Handoff Flow (New)
```
Discovery artifacts → Design phase → design-system-prompt.md → Build phase
```
The design-system-prompt.md distills all discovery/design work into one coding-agent-ready document.

---

*Session focused on improving design quality through better prompting and explicit constraints.*
