Files
whyrating-engine-legacy/packages/reviewiq-pipeline/prompts/wave0_sector_brief.md
2026-02-02 18:19:00 +00:00

14 KiB

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:

{
  "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:

{
  "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)

{
  "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