402 lines
14 KiB
Markdown
402 lines
14 KiB
Markdown
# Wave 0: Sector Brief Generation Prompt
|
|
|
|
## Purpose
|
|
|
|
Generate a **sector brief** that provides alignment context for classification agents. This brief describes what customers care about in this sector — NOT how to classify it, NOT what primitives to use, NOT what solutions exist.
|
|
|
|
## Critical Guardrails
|
|
|
|
**DO:**
|
|
- Describe customer concerns in plain language
|
|
- Use real review language patterns
|
|
- Focus on what customers judge, complain about, praise
|
|
- Include industry-specific terminology
|
|
- Identify mode-specific concerns (dine-in vs delivery, etc.)
|
|
|
|
**DO NOT:**
|
|
- Assign primitive codes
|
|
- Suggest priorities or weights
|
|
- Propose solutions or playbooks
|
|
- Define new categories or dimensions
|
|
- Include KPIs or metrics
|
|
- Make up statistics
|
|
|
|
---
|
|
|
|
## Input
|
|
|
|
You will receive:
|
|
|
|
```json
|
|
{
|
|
"sector_code": "FOOD_DINING",
|
|
"sector_name": "Food & Dining",
|
|
"description": "Restaurants, cafes, bars, bakeries, food trucks, catering services",
|
|
"sample_business_types": [
|
|
"Restaurants",
|
|
"Cafes & Coffee",
|
|
"Bars & Nightlife",
|
|
"Bakeries & Desserts",
|
|
"Food Services",
|
|
"Quick Service"
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Output Schema
|
|
|
|
Return ONLY valid JSON matching this schema:
|
|
|
|
```json
|
|
{
|
|
"sector_code": "string",
|
|
"sector_name": "string",
|
|
"generated_at": "ISO timestamp",
|
|
"version": "1.0",
|
|
|
|
"what_customers_judge": {
|
|
"description": "The primary dimensions customers evaluate in this sector",
|
|
"items": [
|
|
{
|
|
"aspect": "string (2-5 words)",
|
|
"importance": "critical | high | moderate",
|
|
"why_it_matters": "string (1 sentence)"
|
|
}
|
|
]
|
|
},
|
|
|
|
"critical_pain_points": {
|
|
"description": "What damages reputation most severely in this sector",
|
|
"items": [
|
|
{
|
|
"pain_point": "string (2-5 words)",
|
|
"typical_language": ["array of phrases customers actually use"],
|
|
"reputation_impact": "severe | significant | moderate"
|
|
}
|
|
]
|
|
},
|
|
|
|
"common_praise": {
|
|
"description": "What earns customer loyalty and positive reviews",
|
|
"items": [
|
|
{
|
|
"praise_area": "string (2-5 words)",
|
|
"typical_language": ["array of phrases customers actually use"],
|
|
"loyalty_impact": "high | moderate"
|
|
}
|
|
]
|
|
},
|
|
|
|
"industry_terminology": {
|
|
"description": "Domain-specific vocabulary used in this sector",
|
|
"staff_terms": ["waiter", "server", "bartender", "chef"],
|
|
"product_terms": ["dish", "meal", "appetizer", "entree"],
|
|
"process_terms": ["reservation", "seating", "check", "tab"],
|
|
"quality_terms": ["fresh", "authentic", "homemade"],
|
|
"problem_terms": ["cold", "undercooked", "wrong order"]
|
|
},
|
|
|
|
"mode_specific_concerns": {
|
|
"description": "Different service modes have different customer priorities",
|
|
"modes": [
|
|
{
|
|
"mode": "string (e.g., 'Dine-in', 'Takeout', 'Delivery')",
|
|
"primary_concerns": ["array of top concerns for this mode"],
|
|
"unique_pain_points": ["pain points specific to this mode"]
|
|
}
|
|
]
|
|
},
|
|
|
|
"what_is_actionable": {
|
|
"description": "Feedback that businesses can realistically act on",
|
|
"actionable_examples": [
|
|
{
|
|
"feedback_type": "string",
|
|
"example": "string",
|
|
"action_owner": "string (role/team that can fix it)"
|
|
}
|
|
],
|
|
"not_actionable_examples": [
|
|
{
|
|
"feedback_type": "string",
|
|
"example": "string",
|
|
"why_not_actionable": "string"
|
|
}
|
|
]
|
|
},
|
|
|
|
"sector_specific_signals": {
|
|
"description": "Signals that have different meaning in this sector vs others",
|
|
"examples": [
|
|
{
|
|
"signal": "string",
|
|
"meaning_in_this_sector": "string",
|
|
"contrast_with": "string (how it differs in other sectors)"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Example Output (Food & Dining)
|
|
|
|
```json
|
|
{
|
|
"sector_code": "FOOD_DINING",
|
|
"sector_name": "Food & Dining",
|
|
"generated_at": "2026-01-31T10:00:00Z",
|
|
"version": "1.0",
|
|
|
|
"what_customers_judge": {
|
|
"description": "The primary dimensions customers evaluate in this sector",
|
|
"items": [
|
|
{
|
|
"aspect": "Food taste and quality",
|
|
"importance": "critical",
|
|
"why_it_matters": "The core product - customers primarily visit for the food experience"
|
|
},
|
|
{
|
|
"aspect": "Service speed and attentiveness",
|
|
"importance": "critical",
|
|
"why_it_matters": "Direct impact on dining experience and whether they feel valued"
|
|
},
|
|
{
|
|
"aspect": "Cleanliness and hygiene",
|
|
"importance": "critical",
|
|
"why_it_matters": "Health/safety concern that can override all other positives if failed"
|
|
},
|
|
{
|
|
"aspect": "Value for money",
|
|
"importance": "high",
|
|
"why_it_matters": "Portion size and quality relative to price affects return intent"
|
|
},
|
|
{
|
|
"aspect": "Ambiance and atmosphere",
|
|
"importance": "moderate",
|
|
"why_it_matters": "Sets expectations and affects overall enjoyment, especially for special occasions"
|
|
}
|
|
]
|
|
},
|
|
|
|
"critical_pain_points": {
|
|
"description": "What damages reputation most severely in this sector",
|
|
"items": [
|
|
{
|
|
"pain_point": "Food safety incidents",
|
|
"typical_language": ["got sick", "food poisoning", "found hair", "bug in food", "raw chicken"],
|
|
"reputation_impact": "severe"
|
|
},
|
|
{
|
|
"pain_point": "Cold or wrong food",
|
|
"typical_language": ["food was cold", "wrong order", "not what I ordered", "missing items"],
|
|
"reputation_impact": "significant"
|
|
},
|
|
{
|
|
"pain_point": "Rude or dismissive staff",
|
|
"typical_language": ["rude waiter", "ignored us", "attitude", "condescending", "eye roll"],
|
|
"reputation_impact": "significant"
|
|
},
|
|
{
|
|
"pain_point": "Excessive wait times",
|
|
"typical_language": ["waited forever", "40 minutes for food", "never came back", "forgotten"],
|
|
"reputation_impact": "significant"
|
|
},
|
|
{
|
|
"pain_point": "Dirty facilities",
|
|
"typical_language": ["dirty bathroom", "sticky table", "flies everywhere", "unclean"],
|
|
"reputation_impact": "severe"
|
|
}
|
|
]
|
|
},
|
|
|
|
"common_praise": {
|
|
"description": "What earns customer loyalty and positive reviews",
|
|
"items": [
|
|
{
|
|
"praise_area": "Exceptional food quality",
|
|
"typical_language": ["best I've ever had", "delicious", "perfectly cooked", "authentic", "fresh ingredients"],
|
|
"loyalty_impact": "high"
|
|
},
|
|
{
|
|
"praise_area": "Attentive friendly service",
|
|
"typical_language": ["amazing server", "made us feel welcome", "remembered us", "went above and beyond"],
|
|
"loyalty_impact": "high"
|
|
},
|
|
{
|
|
"praise_area": "Great value",
|
|
"typical_language": ["huge portions", "great price", "worth every penny", "can't beat it"],
|
|
"loyalty_impact": "high"
|
|
},
|
|
{
|
|
"praise_area": "Perfect ambiance",
|
|
"typical_language": ["beautiful setting", "romantic", "cozy atmosphere", "perfect for date night"],
|
|
"loyalty_impact": "moderate"
|
|
}
|
|
]
|
|
},
|
|
|
|
"industry_terminology": {
|
|
"description": "Domain-specific vocabulary used in this sector",
|
|
"staff_terms": ["server", "waiter", "waitress", "host", "hostess", "bartender", "chef", "cook", "manager", "busboy"],
|
|
"product_terms": ["dish", "meal", "appetizer", "entree", "main course", "dessert", "special", "daily special", "sides"],
|
|
"process_terms": ["reservation", "walk-in", "seated", "table", "check", "bill", "tab", "tip", "takeout", "to-go", "delivery"],
|
|
"quality_terms": ["fresh", "homemade", "authentic", "crispy", "tender", "juicy", "flavorful", "seasoned", "cooked to perfection"],
|
|
"problem_terms": ["cold", "lukewarm", "overcooked", "undercooked", "raw", "burnt", "soggy", "bland", "stale", "greasy"]
|
|
},
|
|
|
|
"mode_specific_concerns": {
|
|
"description": "Different service modes have different customer priorities",
|
|
"modes": [
|
|
{
|
|
"mode": "Dine-in",
|
|
"primary_concerns": ["ambiance", "service attentiveness", "wait time to be seated", "table cleanliness"],
|
|
"unique_pain_points": ["loud neighbors", "rushed out", "ignored by server", "wrong seating"]
|
|
},
|
|
{
|
|
"mode": "Takeout",
|
|
"primary_concerns": ["order accuracy", "ready on time", "packaging quality", "ease of pickup"],
|
|
"unique_pain_points": ["order not ready", "missing items", "cold by pickup", "wrong order in bag"]
|
|
},
|
|
{
|
|
"mode": "Delivery",
|
|
"primary_concerns": ["delivery time", "food temperature", "order accuracy", "packaging integrity"],
|
|
"unique_pain_points": ["arrived cold", "leaked in bag", "missing sauces", "driver got lost", "late delivery"]
|
|
},
|
|
{
|
|
"mode": "Catering",
|
|
"primary_concerns": ["on-time setup", "quantity accuracy", "presentation", "dietary accommodation"],
|
|
"unique_pain_points": ["not enough food", "late arrival", "wrong items", "poor presentation"]
|
|
}
|
|
]
|
|
},
|
|
|
|
"what_is_actionable": {
|
|
"description": "Feedback that businesses can realistically act on",
|
|
"actionable_examples": [
|
|
{
|
|
"feedback_type": "Specific staff behavior",
|
|
"example": "Our server John was rude and rolled his eyes when we asked for substitutions",
|
|
"action_owner": "Front of house manager"
|
|
},
|
|
{
|
|
"feedback_type": "Food quality issue",
|
|
"example": "The chicken was undercooked - pink in the middle",
|
|
"action_owner": "Kitchen manager / Chef"
|
|
},
|
|
{
|
|
"feedback_type": "Facility issue",
|
|
"example": "Men's bathroom was out of soap and paper towels",
|
|
"action_owner": "Facilities / Shift manager"
|
|
},
|
|
{
|
|
"feedback_type": "Process issue",
|
|
"example": "Waited 20 minutes to get our check after flagging the server twice",
|
|
"action_owner": "FOH manager / Training"
|
|
}
|
|
],
|
|
"not_actionable_examples": [
|
|
{
|
|
"feedback_type": "Subjective taste preference",
|
|
"example": "I just don't like spicy food",
|
|
"why_not_actionable": "Personal preference, not a quality issue"
|
|
},
|
|
{
|
|
"feedback_type": "Location/parking",
|
|
"example": "Hard to find parking in this area",
|
|
"why_not_actionable": "External factor beyond restaurant control"
|
|
},
|
|
{
|
|
"feedback_type": "Price objection without context",
|
|
"example": "Too expensive",
|
|
"why_not_actionable": "Vague, no specifics on what was mispriced"
|
|
}
|
|
]
|
|
},
|
|
|
|
"sector_specific_signals": {
|
|
"description": "Signals that have different meaning in this sector vs others",
|
|
"examples": [
|
|
{
|
|
"signal": "long wait",
|
|
"meaning_in_this_sector": "Usually negative - food taking too long, being ignored",
|
|
"contrast_with": "Healthcare: expected and sometimes indicates thoroughness"
|
|
},
|
|
{
|
|
"signal": "portion size",
|
|
"meaning_in_this_sector": "Critical value indicator - directly affects perceived value",
|
|
"contrast_with": "Healthcare: not applicable"
|
|
},
|
|
{
|
|
"signal": "noisy",
|
|
"meaning_in_this_sector": "Context-dependent - negative for fine dining, expected at sports bars",
|
|
"contrast_with": "Professional services: always negative"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Sectors to Generate
|
|
|
|
Generate one brief for each of these L1 sectors:
|
|
|
|
| Code | Sector Name | Sample Business Types |
|
|
|------|-------------|----------------------|
|
|
| `FOOD_DINING` | Food & Dining | Restaurants, Cafes, Bars, Bakeries, Catering |
|
|
| `RETAIL_SHOPPING` | Retail & Shopping | Clothing, Electronics, Grocery, Specialty stores |
|
|
| `AUTOMOTIVE` | Automotive | Dealers, Repair, Car Wash, Parts |
|
|
| `HEALTHCARE` | Healthcare | Hospitals, Clinics, Dental, Mental Health, Veterinary |
|
|
| `PROFESSIONAL_SERVICES` | Professional Services | Legal, Accounting, Consulting, Marketing |
|
|
| `HOME_SERVICES` | Home Services | Plumbing, Electrical, HVAC, Cleaning, Landscaping |
|
|
| `PERSONAL_SERVICES` | Personal Services | Salons, Spas, Fitness, Tattoo |
|
|
| `EDUCATION` | Education | Schools, Tutoring, Driving Schools, Language |
|
|
| `HOSPITALITY_TRAVEL` | Hospitality & Travel | Hotels, Tours, Travel Agencies |
|
|
| `ENTERTAINMENT` | Entertainment | Movies, Museums, Amusement Parks, Sports |
|
|
| `FINANCE_INSURANCE` | Finance & Insurance | Banks, Insurance, Investment, Loans |
|
|
| `REAL_ESTATE` | Real Estate | Agents, Property Management, Appraisers |
|
|
| `INDUSTRIAL` | Industrial | Manufacturing, Construction, Warehousing |
|
|
| `TRANSPORTATION` | Transportation | Taxis, Moving, Shipping, Courier |
|
|
| `GOVERNMENT` | Government | DMV, Courts, Public Services |
|
|
| `EVENTS_WEDDINGS` | Events & Weddings | Wedding Venues, Planners, DJ, Photography |
|
|
| `RELIGIOUS` | Religious | Churches, Temples, Mosques, Spiritual |
|
|
| `NONPROFIT` | Non-Profit | Charities, Community Organizations |
|
|
| `TECHNOLOGY` | Technology | IT Services, Software, Web Design |
|
|
| `PETS_ANIMALS` | Pets & Animals | Pet Stores, Grooming, Boarding, Training |
|
|
|
|
---
|
|
|
|
## Usage
|
|
|
|
This brief will be injected into Wave 1 and Wave 2 prompts as alignment context:
|
|
|
|
```
|
|
You are configuring primitives for: {sector_name}
|
|
|
|
## Sector Context (READ-ONLY, do not modify or extend)
|
|
|
|
{sector_brief_json}
|
|
|
|
## Your Task
|
|
|
|
Using the above context to understand what matters in this sector,
|
|
configure the following primitives...
|
|
```
|
|
|
|
---
|
|
|
|
## Validation
|
|
|
|
Before returning, verify:
|
|
- [ ] All arrays have 3-10 items (not empty, not excessive)
|
|
- [ ] `typical_language` arrays contain realistic review phrases
|
|
- [ ] No primitive codes, priorities, or solutions appear anywhere
|
|
- [ ] Industry terminology is accurate for this sector
|
|
- [ ] Modes are appropriate for the sector (not all sectors have delivery)
|
|
- [ ] Actionable vs not-actionable distinction is clear
|