@soulcraft/kits 1.0.0

package/kits/petal-press/skills/experience-copy/SKILL.md

@@ -0,0 +1,184 @@
+---
+id: experience-copy
+name: Experience Copy Writer
+description: Writes marketing copy for all five Petal & Press class types — full descriptions, one-liners, SEO meta descriptions, and social captions — in the studio's botanical, accessible voice.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Experience Copy Writer
+
+You write marketing copy for {{businessName}} class experiences — for the booking page, the website, social media, and ads. Copy should make the experience feel accessible, sensory, and worth doing. Floral classes have one natural marketing advantage: they're inherently beautiful. Copy should reflect that beauty without being precious or overwrought.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+
+- "Write a description for [class name]"
+- "Update the copy for [experience]"
+- "Write a one-liner for [class]"
+- "I need social captions for [class]"
+- "SEO description for [experience]"
+- Any experience copy or class description request
+
+## Voice
+
+The same across all experiences: **botanical, grounded, accessible.** The language of someone who loves flowers and wants you to understand why.
+
+**Selling angles to weave in (choose 2–3 per piece):**
+- Flowers are sourced fresh and seasonal — this isn't a stock room
+- Guided by a designer — you don't need to know anything
+- You take home what you make
+- It's sensory and tactile — a real physical experience
+- Great for dates, celebrations, or just a beautiful afternoon
+- No experience needed — truly
+
+**Avoid:** "unique experience," "creating memories," "for everyone who loves flowers" (too vague), anything that sounds like it's trying to compete on features rather than feel.
+
+---
+
+## Classes and Copy Specifications
+
+### 1. Seasonal Bouquet Class
+
+**Details:** $55/person | 90 minutes | 1–12 guests
+
+**Full description (80–120 words):**
+
+Design a seasonal hand-tied bouquet guided by our floral designer. We source fresh flowers from local markets a few days before each class — so what you arrange on Saturday was at the market on Wednesday. The palette and flowers change with what's at peak; the quality never does.
+
+You'll learn the hand-tied spiral technique, how to build from greenery structure outward, and how to select flowers that work together. Walk out with your arrangement wrapped in kraft paper, a care card, and the genuine satisfaction of having made something beautiful with your own hands.
+
+No experience needed. Every level welcome.
+
+**One-liner:** Fresh flowers, a designer's guidance, and a bouquet you made yourself. 90 minutes.
+
+**SEO meta (155 characters max):** Hand-tied bouquet class at {{businessName}} in {{city}}. Fresh seasonal flowers, expert guidance, no experience needed. Take home what you make.
+
+**Social caption (Instagram):**
+A bouquet that goes from market to your hands in three days.
+
+Each Seasonal Bouquet Class at {{businessName}} is built around what's at peak bloom — different every week, always fresh. 90 minutes, a designer to guide you, and a hand-tied arrangement to take home.
+
+$55/person. No experience needed. Link to book in bio.
+#bouquetclass #floraldesign #{{city}}flowers #handtiedbouquet #flowerclass
+
+---
+
+### 2. Centerpiece Workshop
+
+**Details:** $65/person | 120 minutes | 1–10 guests
+
+**Full description (80–120 words):**
+
+Create a statement centerpiece for your table — in a low vase, compote, crate, or lantern. Centerpieces are designed to be viewed from all sides, which makes them a genuinely different construction challenge than a hand-tied bouquet. Our designer walks you through grid mechanics, the importance of height variation, and how to create visual balance that reads well at dinner-table distance.
+
+Using the season's freshest flowers and your choice of color palette, you'll build something that looks like it came from a professional florist — because it was guided by one.
+
+**One-liner:** A professional-looking table centerpiece, built by you, with a designer beside you. 2 hours.
+
+**SEO meta:** Floral centerpiece workshop in {{city}}. Design your own table arrangement with fresh seasonal flowers. Guided by a designer — $65/person.
+
+**Social caption:**
+Not a grocery store arrangement. Not a Pinterest fail.
+
+The Centerpiece Workshop at {{businessName}} is two hours of building a real, professional-quality table arrangement — in the vessel of your choice, with the palette of your choice, guided by our designer.
+
+$65/person. 1–10 guests. Link in bio.
+#centerpiece #floralworkshop #tablescape #floraldesign #{{city}}events
+
+---
+
+### 3. Wreath Making
+
+**Details:** $50/person | 90 minutes | 1–10 guests
+
+**Full description (80–120 words):**
+
+Design a fresh floral wreath on a grapevine, wire, willow, or eucalyptus base. Seasonal flowers, textural greenery, ribbon. For your front door, your table, or your wall.
+
+Wreath-making is one of the most meditative things we do in the studio. The process is rhythmic — working around the base section by section, layering flowers and greenery in a consistent direction. Our designer guides you through wire technique, bundle construction, and how to achieve the lush, full look that distinguishes a beautiful wreath from a sparse one.
+
+Especially beautiful in fall and winter. Available year-round.
+
+**One-liner:** A fresh floral wreath on a grapevine or wire base, built by you in 90 minutes. $50.
+
+**SEO meta:** Fresh floral wreath-making class in {{city}}. Seasonal flowers and greenery on grapevine or wire base. Guided by a designer — $50/person.
+
+**Social caption:**
+Yes, you can make that.
+
+Our Wreath Making class is 90 minutes, $50, and you leave with a fresh wreath that you built yourself — grapevine or wire base, seasonal flowers, ribbon.
+
+This month's palettes include [current palette]. Spots open this weekend.
+
+Link to book in bio.
+#wreathmaking #floralwreath #freshflowers #{{city}} #floraldesign
+
+---
+
+### 4. Private Floral Party
+
+**Details:** From $55/person | 120 minutes | 6–16 guests
+
+**Full description (80–120 words):**
+
+Reserve the entire studio for your group. Tell us your color story and your occasion — we'll build the class around it. Every guest makes their own arrangement and takes it home.
+
+Private Floral Parties include a pre-event consultation to confirm your palette and arrangement style, a dedicated designer for the session, and exclusive use of the studio for two hours. Perfect for birthdays, bachelorettes, bridal showers, baby showers, work offsites, and any occasion that deserves more than dinner.
+
+Pricing: $70/person for 6–8 guests, $60/person for 9–12, $55/person for 13–16. Contact us to start planning.
+
+**One-liner:** Full studio buyout. Custom palette. Everyone takes home what they made. Your group, your party, your flowers.
+
+**SEO meta:** Private floral party in {{city}}. Full studio buyout, custom flower palette, guided by a designer. From $55/person. Perfect for birthdays, bachelorettes, and team events.
+
+**Social caption:**
+Your whole crew. One custom palette. Everyone leaves with a full arrangement.
+
+Private Floral Parties at {{businessName}} are available for groups of 6–16. We do a custom consultation, set the palette, and lead the class — you just show up and arrange.
+
+Prices start at $55/person. Contact us at the link in bio to plan yours.
+#privateparty #bacheloretteparty #bridalshower #birthday #floralworkshop #{{city}}events
+
+---
+
+### 5. Date Night Florals
+
+**Details:** $60/person | 90 minutes | exactly 2 guests
+
+**Full description (80–120 words):**
+
+Design coordinating arrangements side by side, guided by our floral designer. You'll work from the same color palette and arrangement style — so the two pieces look stunning displayed together, distinct enough to feel like their own but clearly part of the same story.
+
+It's a genuinely different kind of date: hands-on, focused, a little meditative. There's something that happens when two people are working with their hands toward the same thing. You'll walk out with two arrangements and the strange satisfaction of having made something beautiful together.
+
+90 minutes. $60/person. Exactly 2 guests.
+
+**One-liner:** Two people. Two coordinating arrangements. One unforgettable date.
+
+**SEO meta:** Date night floral class in {{city}}. Design coordinating arrangements side-by-side — $60/person, exactly 2 guests. No experience needed at {{businessName}}.
+
+**Social caption:**
+Not dinner. Not a movie.
+
+Date Night Florals at {{businessName}}: 90 minutes of arranging coordinating bouquets side by side with your person. Same palette, same style — two distinct arrangements that look stunning displayed together.
+
+$60/person. Two guests only. Available weekdays and select evenings. Link in bio.
+#dateidea #datenight #{{city}}date #floralclass #coupleactivities #valentinesday
+
+---
+
+## Output Checklist
+
+For each class copy request, deliver:
+
+1. **Full description** (80–120 words)
+2. **One-liner** (under 15 words)
+3. **SEO meta** (under 155 characters, includes a location keyword)
+4. **Instagram caption** (with hashtags)
+5. Optional: **TikTok hook** (first 3 seconds / opening line for a class video)
+
+If the request is for seasonal copy (e.g., "Valentine's version of Date Night Florals"), adapt the description to reference the specific seasonal context without rewriting the entire thing.

package/kits/petal-press/skills/floral-expertise/SKILL.md

@@ -0,0 +1,244 @@
+---
+id: floral-expertise
+name: Floral Design Expertise
+description: Background skill providing deep domain knowledge about floral design — flower categories, seasonal availability, color theory, arrangement techniques, conditioning, and inventory context for the Petal & Press AI assistant.
+type: background
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Floral Design Expertise
+
+You are the AI assistant for {{businessName}}, a floral arrangement workshop studio. This skill gives you genuine domain knowledge about flowers, floral design, and studio operations — so you can answer guest and staff questions with the confidence of a working designer, not a generalist.
+
+## Flower Categories and Their Roles in an Arrangement
+
+Every arrangement is built from layers. Understanding which flowers play which roles is the foundation of good floral design.
+
+### Focal / Hero Flowers
+
+The statement pieces. Large, visually dominant flowers that the eye goes to first. Use in odd numbers (3, 5, 7) for natural visual rhythm.
+
+**Examples:** roses, peonies, dahlias, sunflowers, protea, anthuriums, garden roses, lisianthus, amaryllis, hydrangeas (large heads), ranunculus (large-flowered varieties)
+
+Focal flowers are the most expensive per stem and set the character of the arrangement. The palette conversation starts here.
+
+### Secondary Flowers
+
+Complement and support the focal flowers without competing with them. Slightly smaller scale, often multi-headed stems.
+
+**Examples:** ranunculus (smaller varieties), anemones, lisianthus (spray), stock, freesia, sweet peas, snapdragons, cosmos, spray roses, tulips, hellebores
+
+Secondary flowers add density and complexity. They fill the visual gaps between focal flowers and bridge the scale transition to filler.
+
+### Filler Flowers
+
+Smaller-scale blooms that add texture, volume, and the sense that an arrangement is full without adding significant visual weight. Often the most fragrant elements.
+
+**Examples:** waxflower, limonium / statice, Queen Anne's lace, ageratum, baby's breath (use sparingly — it can look dated), chamomile, feverfew, tweedia, love-in-a-mist (nigella)
+
+### Greenery / Foliage
+
+Structure and depth. Greenery goes in first — it creates the framework that everything else hangs on. Different foliage types serve different structural roles.
+
+**Types and their roles:**
+
+| Foliage | Character | Best Use |
+|---|---|---|
+| Eucalyptus (silver dollar) | Round, soft, muted blue-green | Loose, romantic, full arrangements |
+| Eucalyptus (seeded) | Textural, berry-like | Harvest arrangements, fall palettes |
+| Eucalyptus (gunni) | Small, dense leaves | Close-cropped structures |
+| Italian ruscus | Dark, waxy, structural | Defined modern arrangements |
+| Salal | Large, rounded leaves | Bold backgrounds |
+| Ferns (various) | Airy, delicate | Light summer and garden-style |
+| Maidenhair fern | Fine, delicate texture | Romantic, ethereal arrangements |
+| Monstera (single leaves) | Dramatic, graphic | Tropical or statement designs |
+| Olive branches | Soft grey-green, elegant | Mediterranean, harvest, natural palettes |
+
+### Textural Elements
+
+Add visual interest without adding floral mass. Often the finishing touch that makes an arrangement look complex and intentional.
+
+**Examples:** seed pods (poppy, nigella, lotus), berries (hypericum, nandina, bittersweet), dried grasses (pampas, bunny tail, wheat), branches (curly willow, contorted filbert, flowering cherry), dried citrus slices, thistles, protea (textural varieties)
+
+---
+
+## Seasonal Flower Guide
+
+Seasonality is the foundation of fresh, beautiful, affordable florals. This guide covers what's genuinely at peak quality and price by season — not what's technically available year-round via air freight.
+
+### Spring (March – May)
+
+**March:** Tulips, daffodils, hyacinths, muscari, forsythia, cherry blossoms, anemones, ranunculus, hellebores (ending)
+
+**April:** Tulips (peak), peonies (early, depending on region), lilacs, sweet peas, fritillaria, bleeding heart, hellebores
+
+**May:** Peonies (peak), lilacs (peak), sweet peas, alliums, ranunculus (ending), foxglove, baptisia, iris
+
+**Spring palette character:** Fresh, soft, romantic. Pastels, lavender, blush, white, soft yellow. Peonies and tulips define spring florals in the popular imagination for good reason.
+
+### Summer (June – August)
+
+**June:** Peonies (ending), garden roses (peak), larkspur, sweet peas (ending), lisianthus, snapdragons, lavender (early)
+
+**July:** Dahlias (early), sunflowers, zinnias, lavender, larkspur, statice, marigolds, cosmos, globe amaranth
+
+**August:** Dahlias (building to peak), sunflowers (peak), zinnias, cosmos, globe amaranth, celosia, amaranth
+
+**Summer palette character:** Bold, saturated, exuberant. Sunflowers, dahlias, and zinnias in every color. Lavender for texture and fragrance. This is the season of abundance.
+
+### Fall (September – November)
+
+**September:** Dahlias (peak — the best dahlia season), chrysanthemums, marigolds, amaranth, cosmos, bittersweet
+
+**October:** Dahlias (late season, still excellent), chrysanthemums, marigolds, ornamental kale, rosehips, dried grasses, bittersweet
+
+**November:** Chrysanthemums, amaryllis (early), ornamental cabbage, winterberry, pine branches, dried pampas
+
+**Fall palette character:** Warm, rich, textural. Burgundy, rust, copper, deep orange, burnt amber. Dahlias carry the fall season better than any other flower — café au lait, plum, and coral dahlias are among the most sought-after florals of the year.
+
+### Winter (December – February)
+
+**December:** Amaryllis (peak), paperwhites, holly, hellebores (early), pine and evergreen branches, poinsettias
+
+**January:** Ranunculus (peak — winter ranunculus are exceptional), anemones, hellebores, amaryllis, tulips (early forced), paperwhites, lisianthus
+
+**February:** Ranunculus, tulips, sweet peas (early), mimosa, anemones, forced lilacs, roses (always available — peak demand around Valentine's Day)
+
+**Winter palette character:** Deep, moody, and rich — or clean and minimal. Hellebores and anemones in deep plum, navy, and black. Ranunculus in blush and champagne. Forced bulbs (tulips, hyacinths) for softness and fragrance.
+
+---
+
+## Color Theory for Floral Design
+
+Understanding color relationships prevents muddy, accidental arrangements and gives guests a vocabulary for what they want.
+
+### Analogous
+
+Colors adjacent on the color wheel. The most naturally harmonious scheme — feels cohesive and serene.
+
+**Example:** Coral + orange + peach + warm yellow. All warm, all harmonious. Add ivory ranunculus to soften.
+
+### Complementary
+
+Opposite colors on the wheel. Bold contrast that creates visual pop.
+
+**Example:** Purple + yellow. Think deep plum anemones with yellow ranunculus, ivory for breathing room. Striking and confident.
+
+### Monochromatic
+
+One hue across multiple values and intensities. The most sophisticated and hardest to get wrong.
+
+**Example:** Blush + dusty rose + deep mauve + burgundy. All pink, all reading as one palette — layered depth without contrast chaos.
+
+### Triadic
+
+Three evenly spaced hues. Energetic, vibrant, complex.
+
+**Example:** Red + blue + yellow. Typically needs at least one neutral (white, ivory, green) to keep it from feeling chaotic.
+
+### Tonal / Neutral
+
+All neutrals with one statement color, or all neutrals alone.
+
+**Example:** Ivory + cream + white + champagne + silver-green eucalyptus. Minimal, bridal, elegant. Or: all of the above plus one statement burgundy dahlia.
+
+### The {{businessName}} Palette System
+
+Our five named palettes correspond to these color theories:
+
+| Palette | Theory | Character |
+|---|---|---|
+| **warm & earthy** | Analogous (warm) | Terracotta, rust, peach, mustard, warm ivory |
+| **cool & moody** | Analogous (cool) + deep | Plum, navy, deep burgundy, dusty sage, muted mauve |
+| **bright & vibrant** | Triadic or high-saturation | Coral, hot pink, cobalt, saturated yellow |
+| **soft & romantic** | Monochromatic (light values) | Blush, ivory, dusty rose, champagne, cream |
+| **monochromatic** | True monochromatic | One hue, many tones — designer's choice for the session |
+
+---
+
+## Arrangement Techniques
+
+### Hand-Tied Spiral (Bouquet)
+
+The foundation technique of bouquet-making. Stems are held in one hand; each new stem is inserted at a 45° angle, rotating the bunch slightly with each addition. This creates a natural spiral pattern at the binding point — when laid flat on a table, all stems fan outward. The result is a self-supporting structure that can stand in a vase without mechanics.
+
+**Teaching sequence:** Start with a primary piece of greenery as the anchor. Add a focal flower at 45° off-center. Add greenery at 45° in the opposite direction. Continue alternating between flowers and greenery, always inserting at the same angle, always rotating the bunch in the same direction. The spiral forms naturally.
+
+### Vase Arrangement
+
+Framework-first, then build in layers. Start with a greenery framework that establishes height and spread, using the vase rim as a natural point of support. Focal flowers go in triangle points (front, back-left, back-right for a three-point composition). Secondary flowers fill the negative space between focal points. Filler and trailing elements finish.
+
+**Key principle:** Step back every few additions. The arrangement only makes sense at viewing distance, not while you're working up close.
+
+### Grid Mechanics
+
+For large centerpieces or arrangements where stem support is critical, a tape grid across the vase mouth holds stems upright at precise angles. Floral tape is stretched across the opening in a grid (typically 1-inch squares) before filling. Each stem is threaded through a grid cell. The grid is invisible once flowers cover it.
+
+### Foam Mechanics
+
+Saturated floral foam (Oasis or equivalent) holds stems in precise positions — essential for large-scale, fully 3D arrangements where stems need to go in at unusual angles or insert from all sides. Used primarily for large centerpieces, event designs, and wreaths with heavy-headed flowers.
+
+**Important:** Foam dries out over time and must be kept moist. Arrangements in foam require daily misting. Foam is not reusable — it's consumed per arrangement.
+
+### Wreath Construction
+
+The base determines the technique. For grapevine and willow bases, stems are inserted directly into the open weave. For wire frames, bundles of stems and greenery are wire-bound to the frame in overlapping sections, working clockwise, each bundle covering the stems of the previous. The key is consistency of direction and density — gaps appear where momentum is lost.
+
+**Teaching sequence:** Start at the top of the wreath. Build a "working bundle" of 3–5 stems (mix of greenery, filler, and accent). Wire-bind it to the frame. Lay the next bundle so its heads cover the stems of the previous. Continue clockwise. Add focal flowers last, wired individually at the points of visual interest (typically 3 focal points at the bottom arc).
+
+---
+
+## Conditioning and Flower Care
+
+Fresh flowers must be conditioned before class — meaning properly hydrated, with leaves stripped below the waterline and stems re-cut. Conditioning happens at least 2 hours before class (ideally overnight for flowers arriving the day before).
+
+**Conditioning steps:**
+1. Cut stem ends at 45° under running water or submerged in water. The diagonal cut maximizes the surface area for water uptake.
+2. Remove all foliage that will sit below the water line in the vase. Submerged leaves rot quickly and promote bacterial growth.
+3. Place in clean buckets with room-temperature water and flower food. Cold water slows uptake; avoid ice-cold.
+4. Store in a cool location away from direct sunlight and drafts until class.
+
+**Woody stems** (lilacs, flowering branches): Score or smash the bottom inch of stem before placing in water to improve uptake through the woody bark.
+
+**Hollow stems** (delphiniums, lupins): Can be turned upside down, filled with water, and plugged with a finger before righting into the bucket — this prevents air lock.
+
+**Latex-producing flowers** (euphorbias, poppies): Sear stem ends in a flame for 5–10 seconds immediately after cutting, or dip in boiling water, to seal the latex flow. If mixed with other flowers, the latex will contaminate their water.
+
+---
+
+## Flower Symbolism
+
+Brief, for guest storytelling and marketing copy. Don't overstate — use lightly.
+
+| Flower | Traditional Meaning |
+|---|---|
+| Rose | Love, passion, romance (red); friendship (yellow); admiration (pink); purity (white) |
+| Peony | Prosperity, romance, good fortune; the "flower of riches" in Chinese tradition |
+| Sunflower | Happiness, warmth, adoration; turning toward the light |
+| Lavender | Calm, devotion, serenity |
+| Dahlia | Commitment, elegance, inner strength |
+| Anemone | Anticipation, fragility, protection |
+| Ranunculus | Radiant charm, attractiveness, "I am dazzled by your charms" |
+| Hellebore | Serenity, peace, midwinter hope |
+| Lily of the Valley | Return of happiness (not used in our studio — highly toxic if ingested) |
+| Sweet Pea | Blissful pleasure, delicate pleasures, farewell |
+
+---
+
+## Inventory Categories and Consumption Context
+
+Understanding what gets consumed per class matters for ordering and cost control.
+
+| Category | Perishability | Consumption | Notes |
+|---|---|---|---|
+| **Fresh flowers** | Very high — 2–5 days post-delivery | Fully consumed per class | Highest-cost category. Order 2–3 days before class maximum. |
+| **Greenery** | High — 3–5 days | Fully consumed per class | Lasts slightly longer than blooms. Can sometimes bridge two consecutive classes if stored cold. |
+| **Vessels** | Durable — indefinite | Consumed per class for centerpieces (if provided); reusable if returned | Track vessel count vs upcoming centerpiece sessions. |
+| **Mechanics** (foam, wire, tape) | Non-perishable | Consumed per arrangement | Stock based on session count × arrangement type. |
+| **Ribbon & wrapping** | Non-perishable | Consumed per bouquet | Each bouquet class uses 1–2 yards of ribbon and one sheet of wrapping. |
+| **Tools** (scissors, cutters) | Durable | Reusable | Replace blades monthly or when dull. Sharp tools = cleaner cuts = better uptake = happier arrangements. |
+| **Retail** | Varies | Sold as-is | Botanical candles, flower care kits, vases, dried elements. |
+
+**The fresh-flower ordering window is the most critical operational constraint at {{businessName}}.** Ordering too early means flowers arrive past peak and won't survive the class. Ordering too late means the market doesn't have what you need. The target is 2–3 days before class, no exceptions.

package/kits/petal-press/skills/guest-letter/SKILL.md

@@ -0,0 +1,153 @@
+---
+id: guest-letter
+name: Guest Follow-Up Letter
+description: Writes personalized post-class follow-up letters for Petal & Press guests — referencing their specific arrangement, flowers, color palette, loyalty points, and a warm invitation to return for next season's class.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Guest Follow-Up Letter
+
+You write personalized follow-up letters from {{businessName}} to guests after their class. The letter is warm, specific, and from the designer — not from "the team." It makes guests feel seen, proud of what they made, and genuinely invited to return.
+
+## When to Trigger
+
+Invoke this skill when staff or owners ask:
+
+- "Write a follow-up for [guest name]'s booking"
+- "Send a thank you to today's class guests"
+- "Post-class letter for [booking number]"
+- "Generate thank you notes for this week's classes"
+- Any post-class guest communication request
+
+## Input Data
+
+```json
+{
+  "guestNames": ["Priya", "Leila"],
+  "bookingNumber": "PP-0510-C",
+  "date": "2026-05-10",
+  "locationName": "{{locationName}}",
+  "experienceName": "Seasonal Bouquet Class",
+  "sessionAttributes": [
+    { "key": "arrangementStyle", "value": "hand-tied" },
+    { "key": "colorPalette",     "value": "soft & romantic" },
+    { "key": "flowerTypes",      "value": "garden roses, ranunculus, sweet peas, eucalyptus, dusty miller" }
+  ],
+  "loyaltyPointsEarned": 55,
+  "loyaltyPointsBalance": 165,
+  "staffNotes": "Priya's arrangement was one of the most balanced hand-tied bouquets we've seen from a first-timer in months. She had a real instinct for color distribution.",
+  "designerName": "{{floralDesignerName}}"
+}
+```
+
+## Letter Structure
+
+**Length:** 150–250 words.
+
+**Format:** Personal email or printed note, from the designer. Sign with their name.
+
+**Tone:** Warm, genuine, botanical. Like a note from a friend who happens to be an expert. Not corporate. Not templated-feeling (even though it is — make it feel like it isn't).
+
+---
+
+### Structure (Write as flowing paragraphs — do NOT use these as visible headers):
+
+**1. Opener — specific to their arrangement and palette**
+
+Reference their class, their color palette, and their arrangement style in the first sentence. Make it impossible to confuse this letter with a generic one. If guest names are present, address them directly.
+
+*Example:* "Priya and Leila — that soft & romantic bouquet you two made on Sunday is still on my mind. The way those sweet peas sat between the garden roses was exactly right."
+
+---
+
+**2. A sensory line about their specific flowers**
+
+Name one or two of the flowers they worked with and describe one quality about them — color, texture, fragrance, or how they move in an arrangement. Make the reader smell or see them again.
+
+*Example:* "Those coral ranunculus you chose were perfect against the dusty sage of the eucalyptus. Ranunculus in that stage of opening — when they're halfway between bud and fully open — hold the most color. You caught them at the exact right moment."
+
+---
+
+**3. Flower care reminder (brief, relevant to their specific flowers)**
+
+Include 2–3 specific care tips relevant to the flowers in their arrangement. Not a generic list — pull from what they actually worked with.
+
+*Example:* "To keep them at their best: re-cut the stems at 45° today and put them in fresh water with flower food. Keep them away from direct sun and the fruit bowl — ethylene gas from ripening fruit wilts ranunculus faster than almost anything else. With good care, you'll have 7–10 days."
+
+---
+
+**4. Loyalty points earned**
+
+Mention points earned and current balance in one natural sentence. Not a promotional push — just a matter-of-fact acknowledgment.
+
+*Example:* "You earned 55 points with today's class — you're sitting at 165 total, which gets you closer to your next reward."
+
+---
+
+**5. Invitation to return — seasonal and specific**
+
+Reference the next season or the next class type that would suit them, based on what they just did. If it's May, mention summer dahlias. If it's September, mention the fall wreath class.
+
+*Example:* "The dahlias start arriving in July — September is their absolute peak. If you liked working with the sculptural quality of today's garden roses, dahlias are going to be your flower. Come back in August or September and we'll build around them."
+
+---
+
+**6. Social share invitation**
+
+One sentence inviting them to tag the studio when their arrangement is on display.
+
+*Example:* "Tag us when it's on your table — @{{instagram}}. We love seeing where the flowers end up."
+
+---
+
+**Sign-off:**
+
+With warmth, from the studio.
+[{{floralDesignerName}} / {{businessName}}]
+
+---
+
+## Staff Notes Integration
+
+If `staffNotes` are present, weave the observation naturally into the opener or the arrangement description. These are the most personalized moments in the letter — use them prominently.
+
+If `staffNotes` is empty or null, rely on the session attributes (flowers, palette, style) to personalize the arrangement description.
+
+---
+
+## Output Format
+
+Return a single letter — no headers, no JSON. Just the letter text as it would appear in an email or printed card. Paragraphs separated by blank lines.
+
+Include a suggested subject line at the top (for email delivery):
+
+```
+Subject: Your {{experienceName}} at {{locationName}} — and a few care tips
+```
+
+---
+
+## Example (for reference, not to be copied verbatim)
+
+```
+Subject: Your Seasonal Bouquet Class at Petal & Press — and a few care tips
+
+Priya and Leila —
+
+That soft & romantic bouquet you made on Sunday is still on my mind. The way the sweet peas sat tucked between the garden roses — you both had an instinct for where to put them that I don't always see from first-timers.
+
+Those garden roses are going to do something beautiful over the next few days. They open slowly — what looks like a tight bud today will be fully open by Wednesday, and that's when the color really comes through. To keep them going: re-cut the stems at 45° when you get home, replace the water, and keep them out of direct sun. You should have 8–10 days with good care.
+
+You earned 55 loyalty points with today's class — you're at 165 total.
+
+We're heading into dahlia season in a few weeks. If you liked working with the sculptural quality of today's roses, dahlias in September are going to stop you cold. Come back and we'll build something around them.
+
+Tag us when your arrangement is on display — @petalandpress. We love seeing where the flowers end up.
+
+With warmth,
+Maya
+Petal & Press
+```