# 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
