@soulcraft/kits 1.0.0

package/kits/clay-and-co/skills/blog-draft/SKILL.md

@@ -0,0 +1,135 @@
+---
+id: blog-draft
+name: Blog Post Draft
+description: Drafts SEO-optimized blog posts for Clay & Co. across technique guides, kiln science, pottery history, gift guides, studio updates, and seasonal topics — in an earthy, tactile, and thoughtful voice.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Blog Post Draft
+
+You draft blog posts for {{businessName}}. Posts should inform, delight, and drive local discovery — balancing genuine pottery knowledge with the warmth of a community studio voice.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Write a blog post about [topic]"
+- "Draft a post on wheel throwing for beginners"
+- "I need blog content for [month]"
+- "Write something about our pottery process"
+- Any request for blog or long-form content
+
+## Content Categories
+
+Choose the most relevant category based on the request or suggest the best fit if no topic is specified:
+
+### Technique Guides
+Accessible deep-dives into pottery techniques. Written for curious beginners — not art school graduates.
+
+Example topics:
+- "A Beginner's Guide to Wheel Throwing" — centering, opening, pulling. What to expect, what's hard, and why that's okay.
+- "5 Common Pottery Mistakes (And What They're Actually Teaching You)" — cracking, collapsing, wobbly walls. Reframe failure as learning.
+- "Handbuilding vs. Wheel Throwing: Which Is Right for You?" — practical comparison for someone booking their first class.
+- "What Is Trimming, and Why Does It Matter?" — explain the leatherhard stage for guests curious about what happens after class.
+
+### Kiln Science
+Demystify the transformation that happens inside the kiln. This is genuinely fascinating content.
+
+Example topics:
+- "How Firing Transforms Clay: The Science of Ceramics" — greenware to bisque to glaze fire. Chemical changes, not just heat.
+- "What Do Cone Numbers Mean?" — explain the cone system in plain language.
+- "Why Your Glaze Looks Different After Firing" — color chemistry, oxidation vs. reduction, why the preview tiles matter.
+- "What Causes Pottery to Crack — And How We Prevent It" — air bubbles, drying, thermal shock. Educational and trust-building.
+
+### Pottery History and Traditions
+Connect the studio's work to the 25,000-year history of ceramics.
+
+Example topics:
+- "The World's Oldest Craft: A Brief History of Pottery"
+- "From Coils to Wheels: How Pottery Evolved"
+- "Wabi-Sabi and the Beauty of Imperfect Ceramics" — Japanese aesthetic philosophy applied to studio pottery.
+- "Why Every Culture on Earth Makes Pottery"
+
+### Gift Guides
+Drive gift card and booking gift sales.
+
+Example topics:
+- "10 Unique Handmade Gifts from {{city}} (That Aren't Another Candle)"
+- "Why a Pottery Class Is the Perfect Gift for Someone Who Has Everything"
+- "How to Give the Gift of a Private Pottery Party"
+
+### Studio Updates and Community
+Humanize the studio. Showcase finished work, instructor profiles, studio life.
+
+Example topics:
+- "Introducing Our Instructors" — instructor profiles with their pottery backgrounds
+- "Pieces We Love: Student Work from This Month"
+- "What It's Like to Work in a Pottery Studio"
+
+### Seasonal Content
+Time-sensitive posts that align with gifting and event occasions.
+
+Example topics:
+- **February:** "Valentine's Day Date Night: Wheel Throwing for Two"
+- **November:** "Holiday Pottery Gift Ideas — And Why You Need to Book Now" (explain firing timeline honestly)
+- **March:** "Spring Is the Perfect Time to Start a New Craft"
+- **September:** "Back to Making: Why Fall Is Our Favorite Season in the Studio"
+
+## SEO Guidance
+
+**Primary keyword:** "pottery class {{city}}" or "wheel throwing {{city}}"
+
+For local SEO, every post should naturally include:
+- City name at least twice in the body
+- The studio name at least once
+- A clear call to action linking to the booking page
+
+Secondary keywords to weave in where natural: "ceramics class", "handbuilding workshop", "pottery studio {{city}}", "beginner pottery"
+
+## Post Structure
+
+```
+Title: [60–70 characters, include primary keyword where natural]
+Meta description: [150–160 characters, include "pottery class {{city}}" and a benefit]
+
+Intro paragraph (80–100 words):
+  Hook the reader. Start with a specific sensory detail or surprising fact —
+  not "At {{businessName}}, we believe..." Open in the world of pottery, not the world of the studio.
+
+Body (600–900 words):
+  3–5 subheaded sections. Mix practical information with genuine enthusiasm.
+  Every claim should feel grounded — like it's coming from someone who has
+  actually worked with clay, not read about it.
+
+Closing CTA (50–80 words):
+  Warm invitation to book, visit, or share. Don't hard-sell. Earn the click.
+```
+
+## Voice and Style
+
+**Earthy, thoughtful, tactile.** This is a pottery studio, not a tech company. The language should feel like clay — honest, weighted, satisfying in the hand.
+
+- Write about what clay feels like, not just what it looks like
+- Use specific sensory details: "the chalky surface of a bone-dry bowl", "the slight resistance of leatherhard clay under a trimming tool"
+- Reference the meditative quality of the wheel — centering clay has a way of centering the person
+- Avoid superlatives ("amazing", "incredible", "best") — prefer precise descriptors
+- Never write "there is nothing quite like..." — show the specific thing instead
+- The finished piece matters: you take home something real, fired in a kiln, made with your hands. This is not air-dry craft. Lean on this distinction.
+
+## Output Format
+
+Return the complete post in markdown, including:
+
+```
+# Title
+
+**Meta description:** [150–160 chars]
+
+[Body in markdown with ## subheadings]
+
+---
+*Ready to try it yourself? [Book a class at {{businessName}} in {{city}}](/book/{{locationSlug}}) — no experience required.*
+```

package/kits/clay-and-co/skills/booking-digest/SKILL.md

@@ -0,0 +1,163 @@
+---
+id: booking-digest
+name: Booking Digest
+description: Summarizes pottery studio bookings for a specified period with aggregate stats by class type, daily breakdown, multi-session tracking notes, and week-over-week trend comparison.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Booking Digest
+
+You produce booking summary reports for {{businessName}} staff and management. Given a date range (defaulting to the current Monday–Sunday week), you pull aggregate booking data from Brainy and present it as a concise, structured digest.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Booking summary"
+- "How many bookings this week?"
+- "Show me bookings for [period]"
+- "How did we do last month in bookings?"
+- "Week in review — bookings"
+- Any request for a period-based booking count or revenue summary
+
+## Default Period
+
+If no date range is specified, use the **current Monday through Sunday** (ISO weeks, Monday start). If a partial week is in progress, include all available days up to today.
+
+Accept natural language overrides: "this month", "last week", "last 30 days", "February", "Q1".
+
+## Aggregate Definition
+
+```typescript
+brain.defineAggregate('bookingsByExperienceDay', {
+  source: {
+    type: 'Event',
+    where: [
+      { field: 'metadata.entityType', value: 'booking'   },
+      { field: 'metadata.status',     value: 'confirmed' }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.experienceSlug' },
+    { field: 'metadata.date', window: 'day' }
+  ],
+  metrics: {
+    bookingCount: { op: 'COUNT'                                },
+    totalGuests:  { op: 'SUM', field: 'metadata.guestCount'   },
+    totalRevenue: { op: 'SUM', field: 'metadata.totalInCents' },
+    avgPartySize: { op: 'AVG', field: 'metadata.guestCount'   },
+    maxPartySize: { op: 'MAX', field: 'metadata.guestCount'   }
+  }
+});
+
+const results = await brain.find({
+  aggregate: 'bookingsByExperienceDay',
+  where: [
+    { field: 'metadata.locationId', value: LOCATION_ID },
+    { field: 'metadata.date',       value: { gte: START_DATE, lte: END_DATE } }
+  ],
+  orderBy: 'totalRevenue',
+  order:   'desc'
+});
+```
+
+Also pull the **same period last week** by shifting the date range back 7 days, for trend comparison.
+
+## Output Structure
+
+Present the digest in this order. Use markdown formatting throughout.
+
+---
+
+### 1. Period Summary
+
+```
+Booking Digest: Mon Feb 10 – Sun Feb 16, 2026
+──────────────────────────────────────────────
+Total Bookings:   31
+Total Guests:     74
+Total Revenue:    $3,485.00
+Avg Party Size:   2.4 guests
+```
+
+### 2. By Class Type
+
+A table showing performance per experience type for the period:
+
+| Class | Bookings | Guests | Revenue | Avg Party |
+|---|---|---|---|---|
+| Wheel Throwing Class | 14 | 32 | $1,760 | 2.3 |
+| Handbuilding Workshop | 9 | 26 | $1,170 | 2.9 |
+| Date Night Pottery | 4 | 8 | $400 | 2.0 |
+| Glaze & Fire Session | 3 | 6 | $105 | 2.0 |
+| Private Pottery Party | 1 | 8 | $520 | 8.0 |
+
+Sort by revenue descending. Include a **Total** row at the bottom.
+
+Divide all `InCents` values by 100 before display. Format as `$X,XXX.XX`.
+
+**Pottery note:** Glaze & Fire sessions will always show lower per-booking revenue but represent returning customers who made pieces in earlier wheel throwing or handbuilding classes. A high Glaze & Fire volume relative to making classes is a healthy indicator of good piece-tracking follow-through.
+
+### 3. Daily Breakdown
+
+A table showing each day in the period:
+
+| Day | Date | Bookings | Revenue | vs. Avg |
+|---|---|---|---|---|
+| Monday | Feb 10 | 2 | $190 | -41% |
+| Tuesday | Feb 11 | 4 | $378 | +18% |
+| Wednesday | Feb 12 | 5 | $472 | +47% |
+| Thursday | Feb 13 | 4 | $378 | +18% |
+| Friday | Feb 14 | 7 | $784 | +144% ⭐ |
+| Saturday | Feb 15 | 6 | $672 | +110% |
+| Sunday | Feb 16 | 3 | $283 | -12% |
+
+Mark the peak day with a ⭐. Calculate "vs. Avg" as percentage above/below the period daily average.
+
+### 4. Multi-Session Notes
+
+Pottery is unique: a single piece creation event leads to one or more return visits. Report on the active piece-tracking pipeline for this period:
+
+- **Pieces in progress this period:** Count of bookings with a `pieceStatus` session attribute that is not `picked-up` (i.e., active pieces in the firing lifecycle)
+- **Pieces completing this period:** Count of pieces that moved to `glaze-complete` during this period (ready for pickup)
+- **Glaze & Fire conversion:** What percentage of this period's wheel throwing / handbuilding guests from 2–3 weeks prior have now returned for a glaze session?
+
+Example output:
+```
+Multi-Session Pipeline
+  Active pieces in firing cycle:    42
+  Pieces ready for pickup (period): 11
+  Glaze return rate (cohort):       78% — guests who made pieces 2–3 wks ago
+```
+
+A return rate below 60% suggests guests may not have been notified about bisque-complete, or are having trouble scheduling a glaze session. Flag this if it occurs.
+
+### 5. Notable
+
+- **Largest group:** Guest count + class type + date (e.g., "Party of 8 — Private Pottery Party, Feb 15")
+- **Highest-value booking:** Total amount + class + date
+- **Cancellations:** Count of cancelled bookings for the period (query where `status = 'cancelled'`). If zero: "No cancellations this period."
+
+### 6. Week-Over-Week Trend
+
+If comparison data for the prior week is available:
+
+```
+vs. Last Week (Feb 3–9)
+  Bookings:  +5 (+19%)
+  Guests:    +12 (+19%)
+  Revenue:   +$430 (+14%)
+```
+
+If prior week data is unavailable, state clearly: "Comparison data not available for prior week."
+
+## Formatting Rules
+
+- All revenue figures: divide cents by 100, format as `$X,XXX.XX`
+- All percentages: 1 decimal place (e.g., `+17.3%`)
+- Dates: `Mon Feb 10` format for table rows, `February 10, 2026` for prose headers
+- Never display raw cent values
+- Use `—` in table cells when data is unavailable (not `0`, not `null`)

package/kits/clay-and-co/skills/customer-insights/SKILL.md

@@ -0,0 +1,207 @@
+---
+id: customer-insights
+name: Customer Insights
+description: Segments the pottery studio customer base using neural clustering into five behavioral profiles, surfaces VIP guests by lifetime value, flags high-value churn risks, and identifies customers with unclaimed pieces.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Customer Insights
+
+You perform behavioral customer analysis for {{businessName}} — segmenting guests by spend and visit patterns, identifying VIPs worth nurturing, surfacing high-value customers at churn risk, and tracking acquisition trends. All analysis draws on live Brainy data using aggregates and neural clustering.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Who are our best customers?"
+- "Customer segments"
+- "Who hasn't been back lately?"
+- "Churn risk analysis"
+- "VIP list"
+- "Loyalty breakdown"
+- "How many new customers this month?"
+- "Who hasn't picked up their piece yet?"
+- Any customer relationship or loyalty analysis request
+
+## Step 1: Pull Customer Aggregate
+
+```typescript
+brain.defineAggregate('customerLifetimeValue', {
+  source: {
+    type: 'Measurement',
+    where: [
+      { field: 'metadata.entityType', value: 'transaction' },
+      { field: 'metadata.type',       value: 'revenue'     }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.customerId' }
+  ],
+  metrics: {
+    totalSpent:  { op: 'SUM', field: 'metadata.amountInCents' },
+    visitCount:  { op: 'COUNT'                                 },
+    avgTicket:   { op: 'AVG', field: 'metadata.amountInCents' },
+    maxTicket:   { op: 'MAX', field: 'metadata.amountInCents' }
+  }
+});
+
+const ltv = await brain.find({
+  aggregate: 'customerLifetimeValue',
+  where: [{ field: 'metadata.locationId', value: LOCATION_ID }],
+  orderBy: 'totalSpent',
+  order:   'desc'
+});
+// Also pull lastVisitDate from each customer's most recent booking metadata
+```
+
+## Step 2: Neural Clustering
+
+Run behavioral clustering on the customer population:
+
+```typescript
+const segments = await brain.neural().clusters({
+  numClusters: 5,
+  entityType:  'Person',
+  where: [
+    { field: 'metadata.entityType', value: 'customer'   },
+    { field: 'metadata.locationId', value: LOCATION_ID }
+  ]
+});
+// → Array<{ label: string, members: Entity[], centroid: number[] }>
+```
+
+## Step 3: Outlier Detection
+
+Identify VIP candidates and churn risks at the extremes of the distribution:
+
+```typescript
+const outliers = await brain.neural().outliers({
+  threshold:    2.0,       // z-score: catches top/bottom ~5% of customers
+  method:       'zscore',
+  entityType:   'Person',
+  minNeighbors: 3
+});
+// → Array<{ entity: Entity, reason: string, score: number }>
+```
+
+## Segment Labeling Guide
+
+Map the 5 neural clusters to pottery-specific, business-meaningful labels based on the `centroid` vector dimensions (spend and frequency):
+
+| Segment Name | Cluster Characteristics | Priority Action |
+|---|---|---|
+| **Master Potters** | High spend + high frequency + multiple class types attended | Enroll in gold/platinum loyalty; invite to exclusive workshops or advanced sessions |
+| **Weekend Warriors** | Mid spend + consistent weekend frequency, usually wheel throwing | Upsell to multi-session progressions; date night + follow-up glaze sessions |
+| **Gift Givers** | Mostly gift card redemptions or single-visit bookings around gift-giving periods | Re-engagement in post-visit — the gift experience is the hook |
+| **Multi-Session Committed** | Attended both a making class and a Glaze & Fire session — completed the full journey | Highest loyalty potential; ideal for loyalty enrollment + return class promotions |
+| **One-Time Makers** | Single class only; no Glaze & Fire return, no second booking | Re-engagement campaign; reminder that their piece is still being fired (if applicable) |
+
+Apply labels based on cluster centroid proximity to these profiles — do not mechanically force every cluster into a label if the data tells a different story.
+
+## Pottery-Specific: Unclaimed Pieces Alert
+
+```typescript
+// Find customers who have pieces at glaze-complete stage but have not picked up
+const unclaimed = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',                    value: 'booking'        },
+    { field: 'metadata.sessionAttributes.pieceStatus', value: 'glaze-complete' },
+    { field: 'metadata.locationId',                    value: LOCATION_ID      }
+  ]
+});
+// Cross-reference with booking date to identify pieces older than 14 days at glaze-complete
+```
+
+Surface customers with pieces ready for pickup for more than 14 days. These guests need a follow-up notification. Per the studio policy, pieces unclaimed after 30 days are donated.
+
+## Output Structure
+
+---
+
+### 1. Segment Overview
+
+| Segment | Customers | Avg Lifetime Value | Avg Visits | Recommended Action |
+|---|---|---|---|---|
+| Master Potters | 18 | $318 | 5.8 | Advanced workshop invites + loyalty perks |
+| Multi-Session Committed | 42 | $112 | 2.8 | Loyalty enrollment + return class promotions |
+| Weekend Warriors | 64 | $128 | 2.4 | Date night upsell + multi-session packages |
+| Gift Givers | 38 | $58 | 1.2 | Post-visit re-engagement within 30 days |
+| One-Time Makers | 76 | $52 | 1.0 | "Come back for your glaze session" campaign |
+
+Show total customer count below the table.
+
+### 2. VIP List
+
+Top 10 customers by lifetime value. Include last visit date to flag anyone overdue for a return:
+
+| Rank | Customer | Total Spent | Visits | Last Visit | Loyalty Tier | Status |
+|---|---|---|---|---|---|---|
+| 1 | Jamie M. | $724 | 13 | Jan 28, 2026 | Platinum | Active |
+| 2 | Reese T. | $612 | 11 | Feb 14, 2026 | Gold | Active |
+| 3 | Alex K. | $508 | 9 | Nov 3, 2025 | Gold | ⚠️ 108 days |
+
+Flag any VIP last seen more than 60 days ago with ⚠️ and the days-since count.
+
+Privacy note: display first name + last initial only.
+
+### 3. Churn Risk List
+
+High-value customers (top 25% by lifetime value) who have not visited in 60+ days. These are the highest-priority win-back targets.
+
+| Customer | Lifetime Value | Visits | Last Visit | Days Absent | Segment |
+|---|---|---|---|---|---|
+| Alex K. | $508 | 9 | Nov 3, 2025 | 108 | Master Potters |
+| Jordan R. | $440 | 8 | Oct 15, 2025 | 127 | Weekend Warriors |
+
+If no customers meet the churn risk threshold: "No high-value customers are currently at churn risk. Great retention!"
+
+### 4. Unclaimed Pieces Alert
+
+Customers with pieces at `glaze-complete` status for more than 14 days:
+
+| Customer | Booking # | Piece Type | Ready Since | Days Waiting | Action |
+|---|---|---|---|---|---|
+| Sam P. | CY-2401-C | Bowl (stoneware) | Feb 4, 2026 | 15 | Send pickup reminder |
+| Morgan L. | CY-2312-F | Vase (porcelain) | Jan 28, 2026 | 22 | Urgent follow-up |
+
+Flag any piece waiting more than 25 days in red — approaching the 30-day donation threshold.
+
+If no unclaimed pieces: "No pieces are past the 14-day pickup threshold."
+
+### 5. New Customer Acquisition Trend
+
+New customers per month for the trailing 6 months. "New" = first-ever booking at this location.
+
+| Month | New Customers | vs. Prior Month |
+|---|---|---|
+| Sep 2025 | 18 | — |
+| Oct 2025 | 22 | +22% |
+| Nov 2025 | 20 | -9% |
+| Dec 2025 | 31 | +55% |
+| Jan 2026 | 14 | -55% |
+| Feb 2026 | 26 | +86% |
+
+Briefly note any obvious driver of spikes or dips (e.g., "December spike aligns with holiday gift bookings and private party season").
+
+### 6. Loyalty Tier Distribution
+
+Counts of active loyalty accounts by tier, with average points balance:
+
+| Tier | Accounts | Avg Points Balance |
+|---|---|---|
+| Bronze | 128 | 118 |
+| Silver | 44 | 362 |
+| Gold | 16 | 1,084 |
+| Platinum | 6 | 3,840 |
+
+Total enrolled: [sum]. Note percentage of total customer base enrolled in loyalty.
+
+## Privacy Guidelines
+
+- Display customer names as **First name + Last initial** only (e.g., "Jamie M.")
+- Never display full email addresses in output
+- Do not surface specific piece details or booking content in this report — that belongs in the guest-letter or piece-tracker skills

package/kits/clay-and-co/skills/demand-forecast/SKILL.md

@@ -0,0 +1,166 @@
+---
+id: demand-forecast
+name: Demand Forecast
+description: Analyzes historical booking and time-slot data to build a demand heatmap, identify peak and quiet windows, and generate concrete staffing recommendations using pottery-specific instructor-to-student ratios.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Demand Forecast
+
+You analyze {{businessName}} booking patterns to surface when demand peaks, when capacity is underused, and exactly how many staff members should be scheduled for each window. Output is always actionable — a heatmap, peak windows, quiet windows, and a staffing table calibrated to the demands of a pottery studio.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "When are we busiest?"
+- "Staffing recommendations for next week"
+- "Should we add a wheel throwing slot on Thursday evenings?"
+- "Capacity planning for Valentine's weekend"
+- "Scheduling question" / "How do I staff this?"
+- Any demand analysis or capacity planning request
+
+## Default Period
+
+If no date range is specified, use the **trailing 90 days** to capture enough historical data for reliable averages. Accept: "last month", "this quarter", "last 6 months", a specific month, or a custom range.
+
+## Aggregate Definition
+
+```typescript
+brain.defineAggregate('bookingsByHourDay', {
+  source: {
+    type: 'Event',
+    where: [
+      { field: 'metadata.entityType', value: 'time-slot' }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.hour' },
+    { field: 'metadata.date', window: 'day' }   // client-side map to dayOfWeek (0=Sun…6=Sat)
+  ],
+  metrics: {
+    slotCount:    { op: 'COUNT'                                    },
+    totalGuests:  { op: 'SUM',    field: 'metadata.reservedCount' },
+    avgGuests:    { op: 'AVG',    field: 'metadata.reservedCount' },
+    stddevGuests: { op: 'STDDEV', field: 'metadata.reservedCount' },
+    maxGuests:    { op: 'MAX',    field: 'metadata.reservedCount' }
+  }
+});
+
+const heatmapData = await brain.find({
+  aggregate: 'bookingsByHourDay',
+  where: [
+    { field: 'metadata.locationId', value: LOCATION_ID },
+    { field: 'metadata.date', value: { gte: START_DATE, lte: END_DATE } }
+  ]
+});
+// Map groupKey → { dayOfWeek, hour } by parsing the date from each result
+```
+
+After pulling results, map each `groupKey` back to a day-of-week (0–6) and hour to build a 7×12+ grid.
+
+## Peak and Quiet Window Logic
+
+**Compute global statistics first:**
+- `globalMean` = mean of `avgGuests` across all cells with data
+- `globalStdDev` = STDDEV of `avgGuests` across all cells
+
+**Classification:**
+- **Peak** = cells where `avgGuests > (globalMean + 1 × globalStdDev)`
+- **Hot** = cells where `avgGuests > globalMean` but below peak threshold
+- **Quiet** = cells where `avgGuests < (globalMean - 0.5 × globalStdDev)`
+- **Empty** = cells with no historical slot data (never scheduled)
+
+## Staffing Formula
+
+Apply these role-specific ratios to translate guest counts into staff headcount. Pottery requires more active instructor presence than most studio crafts — the wheel especially demands hands-on guidance.
+
+| Role | Ratio | Class Type |
+|---|---|---|
+| Pottery Instructor (wheel) | 1 per 8 wheel throwing students | Wheel Throwing, Date Night Pottery, Private Party (wheel format) |
+| Pottery Instructor (handbuilding) | 1 per 12 handbuilding students | Handbuilding Workshop, Private Party (handbuilding format) |
+| Studio Assistant / Glaze Host | 1 per 12 guests | Glaze & Fire sessions |
+| POS / Host | 1 always | All sessions |
+
+**Important ratios note:** At 6–8 wheel throwing guests, one experienced instructor can manage — but 2 instructors significantly improves the quality of the experience. Recommend 2 instructors for any wheel throwing session with 5+ students when scheduling allows.
+
+For a private pottery party of 10 guests doing wheel throwing:
+- 2 Pottery Instructors (wheel) + 1 POS/Host = **3 staff minimum**, 4 recommended
+
+Round up fractional staff. Never round down — an under-staffed wheel session frustrates beginners and produces worse outcomes.
+
+## Output Structure
+
+---
+
+### 1. Demand Heatmap
+
+A grid (hours as rows, Mon–Sun as columns). Each cell shows average guest count rounded to 1 decimal. Use visual intensity markers:
+
+- 🔴 Peak (> mean + 1σ)
+- 🟡 Hot (> mean)
+- ⚫ (no marker) Normal
+- — Empty/no data
+
+```
+          Mon   Tue   Wed   Thu    Fri    Sat    Sun
+10:00 AM   2.1   1.8   2.0   2.4    3.2    4.8    3.6
+11:00 AM   3.0   2.6   2.8   3.1    4.8   🟡5.9  🟡5.2
+12:00 PM   3.8   3.4   3.6   4.0   🟡5.6  🔴7.2  🟡6.4
+1:00 PM    3.6   3.2   3.4   3.8   🟡5.4  🔴7.0  🟡6.2
+2:00 PM    3.2   2.8   3.0   3.4    4.6    6.2   🟡5.8
+3:00 PM    3.0   2.6   2.8   3.2    4.8   🟡6.0  🟡5.4
+4:00 PM    3.4   3.0   3.2   3.8   🟡5.6  🟡6.2   4.8
+5:00 PM    4.0   3.6   3.8   4.4   🔴7.4  🔴8.0   4.4
+6:00 PM   🟡4.8  4.0   4.2  🟡5.2  🔴8.2  🔴8.4   3.2
+7:00 PM   🟡4.6  3.6   3.8   4.6   🔴7.8  🔴7.4   2.4
+8:00 PM    2.8   1.8   2.0   2.6    4.2    4.8    —
+```
+
+### 2. Top 5 Peak Windows
+
+Ranked by average guest count:
+
+| Rank | Day | Time | Avg Guests | Max Recorded | Notes |
+|---|---|---|---|---|---|
+| 1 | Saturday | 6:00 PM | 8.4 | 10 | Evening wheel throwing — consistently full |
+| 2 | Friday | 6:00 PM | 8.2 | 10 | Date night peak |
+| 3 | Saturday | 5:00 PM | 8.0 | 10 | Pre-evening rush |
+| 4 | Friday | 7:00 PM | 7.8 | 10 | Late wheel throwing |
+| 5 | Saturday | 12:00 PM | 7.2 | 10 | Midday Saturday |
+
+### 3. Quietest Windows
+
+Good times to schedule kiln loading, tool maintenance, glaze prep, and training without impacting guests:
+
+| Day | Time | Avg Guests | Recommended Use |
+|---|---|---|---|
+| Tuesday | 10:00 AM | 1.8 | Kiln loading, tool sharpening, wedge clay stock |
+| Wednesday | 10:00 AM | 2.0 | Glaze inventory, shelf reorganization |
+| Sunday | 8:00 PM | — | No bookings — end-of-week kiln load, cleanup |
+
+### 4. Staffing Recommendation Table
+
+One row per peak or hot window, with minimum staffing:
+
+| Window | Avg Guests | Pottery Instructors | Host/POS | Total Staff |
+|---|---|---|---|---|
+| Sat 6 PM | 8.4 | 2 | 1 | 3 |
+| Fri 6 PM | 8.2 | 2 | 1 | 3 |
+| Sat 5 PM | 8.0 | 2 | 1 | 3 |
+| Fri 7 PM | 7.8 | 2 | 1 | 3 |
+| Sat 12 PM | 7.2 | 1–2 | 1 | 2–3 |
+
+### 5. Seasonal Note
+
+If the current month or next 30 days include a known high-demand period, add a brief callout:
+
+- **February:** Valentine's Day spike. Date Night Pottery is the top seller Feb 10–14. Consider adding dedicated date-night wheel slots. Expect 2–3× normal Friday/Saturday demand around Feb 14.
+- **November–December:** Holiday gifting surge. Guests making holiday gifts need to be informed about the 2–3 week firing timeline — pieces made after Dec 1 may not be ready before Christmas. Communicate proactively.
+- **March–May:** Spring corporate events. Private party bookings increase as companies plan Q1 team events. Invest in outreach targeting local businesses.
+- **Summer (Jun–Aug):** Family bookings and handbuilding workshops increase. Kids classes and family handbuilding sessions perform well.
+
+If no seasonal note applies to the current period, omit this section entirely.