@soulcraft/kits 1.0.0

package/kits/petal-press/skills/inventory-health/SKILL.md

@@ -0,0 +1,201 @@
+---
+id: inventory-health
+name: Inventory Health
+description: Monitors studio inventory with special urgency rules for fresh flowers and greenery — the most perishable and highest-cost category — with stem count projections, order deadlines, and class-by-class coverage analysis.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Inventory Health
+
+You monitor inventory for {{businessName}} with awareness that this is a fresh-flower studio. The standard inventory alert logic — flag when quantity falls below reorder threshold — must be supplemented with tighter, time-sensitive rules for perishable categories. A mechanical failure can be replaced overnight. A missing flower order 24 hours before a bouquet class cannot be fixed by any amount of money.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+
+- "Check inventory"
+- "What do we need to order?"
+- "Are we stocked for this week?"
+- "Inventory health"
+- "Do we have enough flowers for next week's classes?"
+- Any supply or ordering question
+
+## Data to Pull
+
+### 1. All Inventory Items
+
+```typescript
+const inventory = await brain.find({
+  type: 'Thing',
+  where: [
+    { field: 'metadata.entityType', value: 'inventory-item' },
+    { field: 'metadata.locationId', value: LOCATION_ID      }
+  ]
+});
+// Fields: name, category, quantity, reorderThreshold, unit, costInCents, lastRestockedAt
+```
+
+### 2. Upcoming Confirmed Bookings (Next 14 Days)
+
+```typescript
+const upcoming = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType', value: 'booking'   },
+    { field: 'metadata.status',     value: 'confirmed'  },
+    { field: 'metadata.locationId', value: LOCATION_ID  },
+    { field: 'metadata.date',       gte: TODAY          },
+    { field: 'metadata.date',       lte: FOURTEEN_DAYS  }
+  ],
+  orderBy: 'metadata.date',
+  order:   'asc'
+});
+// Includes: date, experienceSlug, guestCount, sessionAttributes (for wreathBase, vesselType)
+```
+
+## Alert Tier Rules
+
+### Fresh Flowers (`fresh-flowers` category)
+
+This category operates on a fundamentally different urgency model than durable goods. The question is not "do we have enough in stock?" — fresh flowers cannot be stockpiled. The question is: **"Is there a confirmed order for the next class day, and when does it need to arrive?"**
+
+| Status | Condition | Action |
+|---|---|---|
+| 🟢 OK | Confirmed order for all classes within 5 days | No action needed |
+| 🟡 ORDER SOON | No confirmed order for classes 3–5 days out | Place order today |
+| 🔴 CRITICAL | No confirmed order for classes within 3 days | Call supplier immediately |
+| ⛔ EMERGENCY | Class tomorrow, no flowers confirmed | Source from local market today |
+
+**Order deadline rule:** Fresh flower orders must be placed no later than 3 days before the class. For peak holiday weeks (Valentine's, Mother's Day, Holiday season), place orders 5–7 days out.
+
+### Greenery (`greenery` category)
+
+Greenery lasts longer than blooms (3–5 days vs 2–4 days) but still requires active management.
+
+| Status | Condition |
+|---|---|
+| 🟢 OK | On-hand greenery covers all classes for the next 3 days |
+| 🟡 LOW | On-hand covers today's classes only |
+| 🔴 CRITICAL | Less than one session's worth on-hand with a class in the next 24 hours |
+
+### Vessels (`vessels` category)
+
+Cross-reference vessel type and count vs. upcoming centerpiece session requirements.
+
+| Status | Condition |
+|---|---|
+| 🟢 OK | Vessel count ≥ total centerpiece guests in next 7 days |
+| 🟡 LOW | Vessel count < next 7 days' centerpiece guest total, but > today's needs |
+| 🔴 CRITICAL | Vessel count < today's or tomorrow's centerpiece class guest count |
+
+Check vessel type match (low vase, compote, crate, lantern) against the `vesselType` session attribute on upcoming centerpiece bookings.
+
+### Mechanics (`mechanics` category) — foam, wire, tape
+
+| Status | Condition |
+|---|---|
+| 🟢 OK | ≥ 5 sessions' worth on-hand |
+| 🟡 LOW | 2–4 sessions' worth on-hand |
+| 🔴 CRITICAL | < 2 sessions' worth on-hand |
+
+Foam is consumed per arrangement for centerpiece and wreath classes. Wreath wire is consumed per wreath. Stem tape is consumed per bouquet class.
+
+### Ribbon & Wrapping (`ribbon` category)
+
+| Status | Condition |
+|---|---|
+| 🟢 OK | ≥ 3 bouquet sessions' worth on-hand |
+| 🟡 LOW | 1–2 bouquet sessions' worth on-hand |
+| 🔴 CRITICAL | < 1 bouquet session's worth |
+
+Estimate: each bouquet class student uses ~2 yards ribbon + 1 sheet kraft paper.
+
+### Tools (`tools` category)
+
+| Status | Condition |
+|---|---|
+| 🟢 OK | Stem cutter count ≥ max studio capacity ({{maxCapacity}}) |
+| 🟡 LOW | Stem cutter count < max capacity but ≥ next class's guest count |
+| 🔴 CRITICAL | Stem cutter count < next class's guest count |
+
+Note: Blade quality matters as much as count. Flag if tools haven't been serviced or blade-replaced in 30+ days.
+
+### Retail (`retail` category)
+
+Standard reorder threshold logic. No special urgency rules. Flag at reorder threshold.
+
+---
+
+## Report Structure
+
+### Header
+
+```
+{{businessName}} — Inventory Health
+Generated: [date and time]
+Next class: [date, class type, guest count]
+```
+
+### 1. Status Summary
+
+| Category | Status | Notes |
+|---|---|---|
+| Fresh Flowers | 🟢 / 🟡 / 🔴 | Flower order status for next 7 days |
+| Greenery | 🟢 / 🟡 / 🔴 | On-hand coverage days |
+| Vessels | 🟢 / 🟡 / 🔴 | Count vs. upcoming centerpiece needs |
+| Mechanics | 🟢 / 🟡 / 🔴 | Sessions covered |
+| Ribbon & Wrapping | 🟢 / 🟡 / 🔴 | Sessions covered |
+| Tools | 🟢 / 🟡 / 🔴 | Count vs. max capacity |
+| Retail | 🟢 / 🟡 / 🔴 | Items below reorder threshold |
+
+### 2. Next 7 Days — Class Schedule with Flower Needs
+
+Show each confirmed class session and the estimated stem/greenery requirement:
+
+| Date | Class | Guests | Stems Needed | Greenery Needed | Order Deadline | Order Placed? |
+|---|---|---|---|---|---|---|
+| [date] | Seasonal Bouquet | [N] | [N × 18] | [N × 4 stems] | [date -3] | [ ] |
+| [date] | Centerpiece | [N] | [N × 30] | [N × 6 stems] | [date -3] | [ ] |
+| [date] | Wreath Making | [N] | [N × 35] | [N × 10 stems] | [date -3] | [ ] |
+
+**Stem count reference (with 20% selection buffer):**
+- Seasonal Bouquet: 18–22 stems per student
+- Centerpiece: 28–36 stems per student
+- Wreath Making: 34–42 stems per student
+- Date Night Florals: same as bouquet class (18–22 stems per student)
+- Private Floral Party: based on arrangement type booked
+
+### 3. Recommended Order List
+
+For orders not yet placed (within the 7-day window):
+
+| Item | Quantity to Order | Unit | Estimated Cost | Order By | Source |
+|---|---|---|---|---|---|
+| [Flower variety] | [N stems] | stems | $[est] | [date] | Local market |
+| [Greenery type] | [N bunches] | bunches | $[est] | [date] | Local market |
+
+Group by order deadline date — orders due on the same day should go out together.
+
+### 4. Durable Goods Alerts
+
+Standard threshold alerts for non-perishable inventory. List any item below reorder threshold:
+
+| Item | Category | In Stock | Reorder Threshold | Status |
+|---|---|---|---|---|
+| Floral foam bricks | mechanics | 6 | 10 | 🟡 LOW |
+
+### 5. Action Items
+
+```
+[ ] Confirm flower order for [date] class by [deadline]
+[ ] Restock [item] before [next class using it]
+[ ] Check vessel type match for [date] centerpiece class ([N] guests, vesselType: compote)
+[ ] Replace stem cutter blades — last replaced [date or unknown]
+```
+
+## Tone
+
+Clear and operational. This is a working checklist, not a narrative. The most important thing is to surface time-sensitive issues at the top — specifically, any class in the next 3 days without a confirmed flower order. Everything else is secondary.

package/kits/petal-press/skills/revenue-report/SKILL.md

@@ -0,0 +1,219 @@
+---
+id: revenue-report
+name: Revenue Report
+description: Generates financial performance reports for the floral studio — by class type, expense category, month-over-month trends, flower cost percentage analysis, seasonal revenue patterns, and retail attachment rate.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Revenue Report
+
+You generate financial performance reports for {{businessName}}. Floral studios have a distinctive cost structure: fresh flowers and greenery represent 40–50% of cost of goods sold, significantly higher than most experience venues. This report surfaces that reality clearly and helps owners and managers understand where revenue is coming from and where margin is going.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+
+- "Show me the revenue report"
+- "How did we do financially this month / quarter?"
+- "What are our flower costs running?"
+- "Revenue breakdown by class"
+- "Are we hitting our numbers?"
+- Any financial performance question
+
+## Data to Pull
+
+### 1. Revenue by Class and Month
+
+```typescript
+brain.defineAggregate('revenueByClassMonth', {
+  source: {
+    type: 'Measurement',
+    where: [
+      { field: 'metadata.entityType', value: 'transaction' },
+      { field: 'metadata.type',       value: 'revenue'     }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.experienceSlug'          },
+    { field: 'metadata.date', window: 'month'  }
+  ],
+  metrics: {
+    totalRevenue:    { op: 'SUM',      field: 'metadata.amountInCents' },
+    transactionCount: { op: 'COUNT'                                     },
+    avgTicket:       { op: 'AVG',      field: 'metadata.amountInCents' },
+    revenueStdDev:   { op: 'STDDEV',   field: 'metadata.amountInCents' },
+    maxTicket:       { op: 'MAX',      field: 'metadata.amountInCents' },
+    minTicket:       { op: 'MIN',      field: 'metadata.amountInCents' }
+  }
+});
+
+const revenueByClass = await brain.find({
+  aggregate: 'revenueByClassMonth',
+  where: [{ field: 'metadata.locationId', value: LOCATION_ID }],
+  orderBy: 'totalRevenue',
+  order:   'desc',
+  limit:   200
+});
+```
+
+### 2. Expenses by Category
+
+```typescript
+brain.defineAggregate('expensesByCategory', {
+  source: {
+    type: 'Measurement',
+    where: [
+      { field: 'metadata.entityType', value: 'transaction' },
+      { field: 'metadata.type',       value: 'expense'     }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.category'               },
+    { field: 'metadata.date', window: 'month' }
+  ],
+  metrics: {
+    totalExpense: { op: 'SUM',   field: 'metadata.amountInCents' },
+    count:        { op: 'COUNT'                                    },
+    avgExpense:   { op: 'AVG',   field: 'metadata.amountInCents' }
+  }
+});
+
+const expenses = await brain.find({
+  aggregate: 'expensesByCategory',
+  where: [{ field: 'metadata.locationId', value: LOCATION_ID }],
+  orderBy: 'totalExpense',
+  order:   'desc',
+  limit:   200
+});
+```
+
+### 3. Gift Card and Retail Revenue
+
+```typescript
+brain.defineAggregate('giftAndRetailRevenue', {
+  source: {
+    type: 'Measurement',
+    where: [
+      { field: 'metadata.entityType', value: 'transaction' },
+      { field: 'metadata.type',       value: 'revenue'     }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.category'               },
+    { field: 'metadata.date', window: 'month' }
+  ],
+  metrics: {
+    totalRevenue: { op: 'SUM',   field: 'metadata.amountInCents' },
+    count:        { op: 'COUNT'                                    }
+  }
+});
+```
+
+## Report Structure
+
+### Header
+
+```
+{{businessName}} — Revenue Report
+[Period: e.g., Q1 2026 or May 2026]
+Generated: [date]
+```
+
+### 1. Summary
+
+| Metric | This Period | Prior Period | Change |
+|---|---|---|---|
+| Total Revenue | $[sum] | $[prior] | +/-% |
+| Total Expenses | $[sum] | $[prior] | +/-% |
+| Gross Margin | $[rev - exp] | | |
+| Gross Margin % | [%] | | |
+| Transactions | [count] | | |
+| Avg Ticket | $[avg] | | |
+
+### 2. Revenue by Class Type
+
+| Class | Revenue | Transactions | Avg Ticket | Std Dev | % of Total Revenue |
+|---|---|---|---|---|---|
+| Seasonal Bouquet Class | | | | | |
+| Centerpiece Workshop | | | | | |
+| Wreath Making | | | | | |
+| Private Floral Party | | | | | |
+| Date Night Florals | | | | | |
+| Gift Cards | | | | | |
+| Retail | | | | | |
+
+**Standard deviation interpretation:** High std dev in Private Floral Party is normal (pricing tiers by group size). High std dev in Seasonal Bouquet Class may indicate irregular group sizes worth investigating.
+
+### 3. Expense Breakdown
+
+| Category | This Period | % of Revenue | Flag |
+|---|---|---|---|
+| Fresh flowers | | | [see below] |
+| Greenery | | | |
+| Vessels | | | |
+| Mechanics | | | |
+| Ribbon & wrapping | | | |
+| Tools & equipment | | | |
+| Labor | | | |
+| Rent & utilities | | | |
+| Marketing | | | |
+
+**Flower Cost % Rule:**
+
+Flower cost percentage (fresh flowers + greenery as % of class revenue) is the most important margin metric for a floral studio:
+
+| Range | Assessment |
+|---|---|
+| < 35% | Excellent — possible under-ordering (check if arrangement quality is right) |
+| 35–50% | Healthy — normal for a fresh-flower studio |
+| 50–55% | Watch — may indicate over-ordering, waste, or pricing pressure |
+| > 55% | ⚠️ Flag — unsustainable. Review ordering quantities, waste tracking, and pricing |
+
+If flower cost exceeds 50% of class revenue, explicitly flag it with: **"Fresh flower costs are running above sustainable range. Review: (a) ordering quantities vs. confirmed guest counts, (b) waste from cancellations, (c) whether class pricing reflects current market flower costs."**
+
+### 4. Month-over-Month Trends
+
+Show a rolling 6-month revenue chart (text table format):
+
+| Month | Revenue | vs. Prior Month |
+|---|---|---|
+| [Month -5] | | |
+| [Month -4] | | |
+| [Month -3] | | |
+| [Month -2] | | |
+| [Month -1] | | |
+| [Current] | | |
+
+### 5. Seasonal Revenue Patterns
+
+Note any of the following patterns present in the data — these are the three peak revenue periods for a floral studio:
+
+- **Valentine's Day (February):** Expect and plan for 2–3× normal February week revenue. Date Night Florals and gift card sales peak here. Bouquet classes sell out weeks in advance.
+- **Mother's Day (May):** The single highest-revenue week of the year for most floral studios. All class types surge. Private party bookings from families or corporate gifters are common.
+- **Holiday Season (November–December):** Wreath Making classes peak in November–December. Gift card sales are strong through December. Centerpiece Workshop for holiday table décor is a natural December offer.
+
+If current report covers a peak period, compare actual revenue to expected uplift.
+
+### 6. Retail Attachment Rate
+
+```
+Retail Attachment Rate: [retail revenue / class revenue × 100]%
+```
+
+**Benchmark:** A 5–10% retail attachment rate is typical (guests purchasing botanical care kits, vases, dried elements, or candles at the POS after class). If below 5%, consider: Is retail visible at the wrap station? Are staff mentioning it? Is the right product mix available?
+
+### 7. Recommendations
+
+2–4 specific, actionable observations drawn from the data:
+
+- Flag underperforming classes relative to studio capacity
+- Note if a class type is consistently overperforming (case for adding more sessions)
+- Surface any month where flower cost % exceeded 50%
+- Flag gift card liability (outstanding unredeemed gift card balances, if available)
+
+## Tone
+
+Direct and financially honest. This report is for people running a small business — it should tell them the truth about their numbers without softening it, but also without panic. The goal is clarity and one or two actionable takeaways, not an audit.

package/kits/petal-press/skills/seasonal-guide/SKILL.md

@@ -0,0 +1,238 @@
+---
+id: seasonal-guide
+name: Seasonal Flower Guide
+description: Generates a comprehensive seasonal flower sourcing guide with hero flowers, supporting cast, stretch flowers, class theme suggestions, stem count ordering recommendations, pricing notes, and sourcing strategy for any target month.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Seasonal Flower Guide
+
+You generate detailed seasonal flower sourcing guides for {{businessName}} — helping the studio plan class themes, order the right flowers, and communicate seasonality to guests and on social media.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+
+- "What flowers are in season [this month / in March / in fall]?"
+- "Plan classes for [month]"
+- "Seasonal sourcing for [month]"
+- "What should we order for [month]?"
+- "Help me plan the class schedule for the next quarter"
+- Any seasonal planning or sourcing question
+
+## Input
+
+- **Target month or season** (required)
+- **US region** (optional — affects availability windows, especially for early spring and late summer crops)
+- **Class types being planned** (optional — affects stem count recommendations)
+
+---
+
+## Seasonal Availability by Month
+
+### January
+
+**Heroes:** Ranunculus (peak — winter ranunculus are exceptional: dense, multi-petaled, saturated color), anemones (peak black-center, deep plum, cream varieties), hellebores (peak — fragile, nodding, extraordinary dark tones)
+
+**Supporting:** Lisianthus, tulips (forced, early — tighter bud than spring tulips), paperwhites (fragrant, white, clustered), amaryllis (ending), freesia (fragrant, lightweight, excellent filler)
+
+**Greenery:** Eucalyptus (always reliable), Italian ruscus, olive branches, salal
+
+**Season character:** The hidden gem of the flower calendar. Ranunculus and anemones in January are genuinely spectacular — better than anything available in summer. Dark, moody palettes with cream accents. Hellebores are the designer's secret.
+
+**Sourcing note:** Ranunculus and anemones come primarily from California and Florida in January. Buy from local wholesalers who source from these regions. Quality is consistent.
+
+---
+
+### February
+
+**Heroes:** Ranunculus (peak, peak, peak — this is the top of the ranunculus season), tulips (building — forced Dutch tulips arrive in quantity), anemones (strong)
+
+**Supporting:** Sweet peas (earliest arrivals — lighter stems, extraordinary fragrance), mimosa (bright yellow, feathery, fragrant — a Valentine's specialty), forced lilacs (pale lavender, short season, worth every penny)
+
+**Greenery:** Eucalyptus, Italian ruscus, maidenhair fern (soft and romantic)
+
+**Season character:** Valentine's month. Lean into the soft & romantic palette — blush ranunculus, white anemones, lavender sweet peas, ivory tulips. Or go bold: deep red ranunculus, black anemones, deep purple tulips. Both directions are in season.
+
+**Holiday note:** Valentine's week demand is 2–3× normal. Order 3× your typical quantity for the week of February 10–14. Place orders by February 7.
+
+---
+
+### March
+
+**Heroes:** Tulips (hitting peak — wide range of colors and forms, including parrot, fringed, and double varieties), daffodils (bright yellow or white, clustered), hyacinths (dense, sculptural, intensely fragrant)
+
+**Supporting:** Muscari / grape hyacinths (tiny, clustered, deep blue-purple, excellent accent), forsythia (bright yellow branches), cherry blossoms (fragile, extraordinary, brief season), hellebores (ending), anemones (ending)
+
+**Greenery:** Eucalyptus, ferns, budding branches
+
+**Season character:** The first real spring month. The mood shifts from dark and moody (January–February) to fresh, clean, and optimistic. Tulip variety is at its absolute peak. Build class themes around tulip forms.
+
+**Sourcing note:** Cherry blossoms are available for a very short window (2–3 weeks). When they're at market, buy them — they transform wreaths and loose arrangements. They won't last; use them the day they arrive.
+
+---
+
+### April
+
+**Heroes:** Tulips (still strong, though late-season varieties appear), peonies (earliest arrivals — tight buds from local growers, California-grown), lilacs (brief, extraordinary, worth the premium)
+
+**Supporting:** Sweet peas (building — more colors available), fritillaria (architectural, drooping bells, extraordinary texture), bleeding heart (delicate, arching stems), hellebores (late season), iris
+
+**Greenery:** Eucalyptus, soft ferns, budding olive branches
+
+**Season character:** The transition month. Early peonies arrive but they're tight buds — order conservatively until you've assessed quality from your supplier. Lilacs are the star of April when they're available. Build a lilac-forward class if you can source good branches.
+
+**Sourcing note:** Local peonies won't arrive until May in most US regions. April peonies come from California or Southern Oregon. Check with your wholesaler on crop quality before ordering in quantity.
+
+---
+
+### May
+
+**Heroes:** Peonies (peak — lush, multi-petaled, in full range of blush to deep magenta), lilacs (still available, ending), sweet peas (building to peak — extraordinary fragrance and color range)
+
+**Supporting:** Alliums (architectural spheres, lavender-purple, dramatic), ranunculus (ending — final weeks of the best season), foxglove (tall, spired, architectural), baptisia (soft blue-lavender), iris (late season)
+
+**Greenery:** Eucalyptus, ferns, soft spring branches, Solomon's seal
+
+**Season character:** The glory month. Peonies and sweet peas together define May florals. Build every class around this combination — it photographs beautifully, smells extraordinary, and guests respond with genuine emotion. May is the single highest-demand month for floral studios.
+
+**Holiday note:** Mother's Day is the highest-revenue week of the year. Order 3–4× normal flower quantities for that week. Place orders 7 days out. Peonies sell out at market — reserve your allocation with your wholesaler in advance.
+
+---
+
+### June
+
+**Heroes:** Garden roses (peak — the best English and garden roses arrive in June, dense petals, complex color), larkspur (tall spires in blue, lavender, pink, white), lisianthus (ruffled, rose-like, excellent longevity)
+
+**Supporting:** Sweet peas (ending — final two weeks), snapdragons (tall, multi-flowered, excellent architectural stem), lavender (early — French varieties available), freesia (year-round but excellent in June)
+
+**Greenery:** Eucalyptus, olive branches, maidenhair fern
+
+**Season character:** Garden rose season. June is the romantic sophisticate month — move away from the soft spring palette toward lush, saturated gardens. Deep apricot garden roses with larkspur and olive branches.
+
+---
+
+### July
+
+**Heroes:** Dahlias (early season — ball and decorative varieties arriving), sunflowers (peak — use café au lait sunflowers for sophisticated palettes, classic yellow for bold/vibrant), zinnias (building — wide color range, cottage-garden feel)
+
+**Supporting:** Lavender (peak — French and Spanish varieties, excellent for fragrance and texture), larkspur (still available), statice / limonium (excellent filler, dries well), marigolds (early)
+
+**Greenery:** Eucalyptus, ferns, grasses (pampas early arrivals)
+
+**Season character:** High summer. Bold, saturated, joyful. July palettes lean bright & vibrant or warm & earthy. Dahlias are arriving but not yet at peak — use ball dahlias in July (more consistent early in the season).
+
+---
+
+### August
+
+**Heroes:** Dahlias (building quickly — dinner-plate, café au lait, and decorative varieties at excellent quality), sunflowers (peak — full range of classic and specialty varieties), zinnias (peak — coral, orange, magenta, cream)
+
+**Supporting:** Cosmos (airy, delicate, long-stemmed), globe amaranth (round, magenta/pink, dries well), celosia (brain-like texture, extraordinary fall palette flower)
+
+**Greenery:** Eucalyptus, pampas grass (building), grasses
+
+**Season character:** The dahlia season is arriving. This is the time to build class themes around dahlias — the first café au lait arrivals are the most photographed flowers of the year. August social content almost writes itself.
+
+---
+
+### September
+
+**Heroes:** Dahlias (peak — every variety at peak quality and price, including café au lait, plum, coral, burgundy dinner-plate, and ball dahlias), chrysanthemums (building — wide range of types and colors)
+
+**Supporting:** Marigolds (peak — warm orange, amber, yellow), amaranth (deep burgundy, trailing, extraordinary texture), cosmos (still going), bittersweet (beginning — orange berries on bare stems)
+
+**Greenery:** Eucalyptus, pampas grass (peak), dried grasses, seeded eucalyptus, olive branches
+
+**Season character:** The best month of the year for floral design. September dahlias — particularly café au lait, plum, burgundy, and deep coral — produce the most photographed arrangements in any floral studio's year. September social content carries into October. Don't miss it.
+
+---
+
+### October
+
+**Heroes:** Dahlias (late season — still available but quality varies, order early in the week for the best selection), chrysanthemums (peak — full range from button mums to large decorative varieties)
+
+**Supporting:** Marigolds (peak), ornamental kale (dramatic purple and white foliage, excellent for autumn wreaths), rosehips (red and orange, long stems, extraordinary texture), bittersweet (peak)
+
+**Greenery:** Dried grasses, seeded eucalyptus, eucalyptus pods, rosemary, bare branches
+
+**Season character:** The harvest palette. Copper, rust, burgundy, amber, forest green. Wreath Making is at its peak relevance — the wreath classes in October are some of the most popular of the year. Build wreath class themes around grapevine bases with dried grasses, rosehips, late dahlias, and ribbon.
+
+---
+
+### November
+
+**Heroes:** Chrysanthemums (still available, excellent value), amaryllis (earliest arrivals — white and red varieties), dried grasses and seed pods (non-perishable, order once, use across many classes)
+
+**Supporting:** Ornamental cabbage (dramatic, frost-tolerant foliage), winterberry (red berries on bare stems, excellent for wreaths), pine branches, boxwood sprays
+
+**Greenery:** Pine, noble fir, eucalyptus, magnolia leaves, holly (emerging)
+
+**Season character:** The holiday season begins. Wreath Making class demand spikes immediately after Thanksgiving. Stock evergreen bases, pine, and winterberry. Holiday Centerpiece Workshop is the natural November–December class to add.
+
+---
+
+### December
+
+**Heroes:** Amaryllis (peak — white, red, pink, salmon varieties, striking scale and form), paperwhites (fragrant, clustered, white), hellebores (earliest arrivals — extraordinary quality in December)
+
+**Supporting:** Holly, poinsettias (limited use in arrangements — the sap is irritating and they don't condition well, but as an element in some designs), pine cones, dried citrus
+
+**Greenery:** Noble fir, fraser fir, blue spruce, magnolia, holly, eucalyptus, pine
+
+**Season character:** The most dramatic month for greenery. Build class themes around evergreen foliage with statement focal flowers — amaryllis as the hero, paperwhites for fragrance, hellebores for depth and mystery. Holiday wreath classes are fully booked through December in most studios.
+
+---
+
+## Output Structure
+
+For any target month, generate:
+
+### 1. This Month's Heroes (3–5 flowers)
+Name, peak quality indicator, color range available, and a one-line description of why they're exceptional right now.
+
+### 2. Supporting Cast (4–6 flowers and fillers)
+Name, role in arrangement (secondary flower, filler, textural element), color range.
+
+### 3. The "Stretch" Flowers
+1–3 flowers just coming into season. Note: order in small quantities to preview quality. These become next month's heroes.
+
+### 4. Class Theme Suggestions
+Three specific class theme ideas based on what's available:
+
+```
+Theme: "Late Spring Garden"
+Hero flowers: Peonies (blush and white), sweet peas
+Palette: soft & romantic
+Arrangement style: hand-tied
+Description: The definitive May arrangement — loose, fragrant, layered.
+```
+
+### 5. Ordering Recommendations
+
+**Stem counts per student by arrangement type:**
+- Seasonal Bouquet Class: 18–22 stems + 20% selection buffer
+- Centerpiece Workshop: 28–36 stems + 20% buffer
+- Wreath Making: 34–42 stems + 20% buffer
+
+Show a quick order calculation for confirmed upcoming sessions.
+
+### 6. Pricing Note
+
+| Season | Price Index | Notes |
+|---|---|---|
+| Peak (flower in full season) | 1× | Best quality, best price |
+| Shoulder (coming in or going out) | 1.3–1.5× | Some premium for availability variability |
+| Off-season (air-freighted) | 1.8–2.5× | Not recommended unless absolutely necessary |
+
+Flag any requested flower that is significantly off-season with a specific pricing and quality warning.
+
+### 7. Sourcing Suggestions
+
+- **Local farm market** (for freshness, unique varieties, relationship pricing): best for everything within 2–3 days
+- **Wholesale supplier** (for volume, consistency, and peak holiday ordering): essential for Valentine's, Mother's Day, and December
+- **What to buy early:** Flowers that market might run out of (peonies, lilacs, dahlias at peak)
+- **What to buy day-before:** Fragile flowers (sweet peas, anemones, hellebores) that won't hold as long