product-expert-design

# Product Expert Design

Guide for designing agent experts that serve end users through adaptive, personalized experiences.

## Codebase Experts vs Product Experts

| Aspect | Codebase Expert | Product Expert |
| --- | --- | --- |
| **Scope** | One per domain | One per user |
| **Storage** | File system (YAML) | Database (JSONB) |
| **Updates** | After code changes | After user actions |
| **Size** | 300-1000 lines | Typically smaller |
| **Latency** | Not critical | Must be fast |
| **Privacy** | Internal only | User data concerns |

## When to Use

- Building product features that learn from user behavior
- Creating per-user expertise files for personalization
- Implementing AI-driven adaptive UX
- Designing recommendation systems with user mental models
- Evaluating whether product experts are appropriate for your use case
- Building progressive personalization with latency considerations

## Product Expert Architecture

```text
┌─────────────────────────────────────────────────────┐
│ User Action (view, click, purchase, etc.)           │
└──────────────────────┬──────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────┐
│ Action Tracker                                      │
│ • Capture action type                               │
│ • Record context (time, device, etc.)               │
│ • Queue for expertise update                        │
└──────────────────────┬──────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────┐
│ User Expertise Store (Database)                     │
│ • Per-user JSONB column                             │
│ • Structured preference model                       │
│ • Behavior patterns                                 │
└──────────────────────┬──────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────┐
│ UI Gen