@soulcraft/kits 1.0.0

package/kits/clay-and-co/skills/kiln-scheduler/SKILL.md

@@ -0,0 +1,206 @@
+---
+id: kiln-scheduler
+name: Kiln Scheduler
+description: Plans bisque and glaze kiln loads by querying the active piece pipeline, estimates cubic footage requirements, recommends optimal firing dates, flags clay type compatibility, and generates firing parameters tailored to the studio's kiln type(s).
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Kiln Scheduler
+
+You plan kiln firings for {{businessName}}. The pottery studio's entire multi-session workflow depends on efficient kiln management — pieces wait in the queue, and the kiln fires when a load is ready. This skill turns that queue into a concrete firing schedule with dates, load estimates, and firing parameters.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Kiln schedule"
+- "What's in the kiln queue?"
+- "When should we load the bisque kiln?"
+- "Plan next week's firings"
+- "Loading the kiln — what goes in?"
+- Any firing planning or kiln management question
+
+## Kiln Capacity Concepts
+
+Understanding capacity is essential before planning a load.
+
+**Standard studio electric kiln:** approximately 7–10 cubic feet, loaded on 2–4 shelves.
+
+**Capacity rules of thumb:**
+- **Bisque load:** Pieces can be stacked and loaded more densely. Bisque firing does not use glaze, so touching is acceptable. A 7 cu ft kiln can typically hold 15–25 bisque pieces depending on size.
+- **Glaze load:** Pieces cannot touch (glaze melts and would fuse them together). Glazed pieces need at least 0.5" clearance from each other and from kiln walls. The same kiln fits 12–18 glazed pieces per load.
+- **Size adjustments:** Tall pieces (vases over 8") take vertical space; wide pieces (plates, large bowls) take shelf space. Account for both dimensions. A tall vase may require an entire shelf row to itself on the upper kiln section.
+
+**If {{kilnType}} includes gas kilns:**
+- Gas kilns fire in reduction atmosphere — intentional oxygen deprivation produces dramatic glaze color shifts (copper → red, iron → celadon).
+- Schedule reduction firings separately from standard oxidation firings.
+- Raku kiln (if available): fired outdoors, extremely rapid cycle, pieces pulled while glowing and placed in reduction chambers. Schedule separately from all other firings.
+
+## Data to Query
+
+### Bisque Queue
+
+```typescript
+const bisqueQueue = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',                    value: 'booking'        },
+    { field: 'metadata.sessionAttributes.pieceStatus', value: 'bisque-queued'  },
+    { field: 'metadata.locationId',                    value: LOCATION_ID      }
+  ]
+});
+// Each booking has: guestName, pieceType, clayType, date, bookingNumber
+```
+
+### Glaze Queue
+
+```typescript
+const glazeQueue = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',                    value: 'booking'        },
+    { field: 'metadata.sessionAttributes.pieceStatus', value: 'glaze-queued'   },
+    { field: 'metadata.locationId',                    value: LOCATION_ID      }
+  ]
+});
+// Each booking also has: glazeColors, firingType (glossy/matte/satin)
+```
+
+Also pull pieces at `trimmed` stage to project pieces approaching bisque-ready in the next 3–5 days:
+
+```typescript
+const nearlyReady = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',                    value: 'booking'   },
+    { field: 'metadata.sessionAttributes.pieceStatus', value: 'trimmed'   },
+    { field: 'metadata.locationId',                    value: LOCATION_ID }
+  ]
+});
+```
+
+## Clay Type Compatibility
+
+**Critical rule:** All pieces in a single kiln load must be fired at the same cone (temperature). Mixing incompatible cone levels ruins pieces.
+
+| Clay Type | Typical Firing Cone | Temperature |
+|---|---|---|
+| Standard stoneware | Cone 6 | ~1,225°C |
+| Porcelain | Cone 6–10 | ~1,225–1,300°C |
+| Earthenware | Cone 06 | ~1,000°C |
+
+**Mixing rules:**
+- Cone 6 stoneware + Cone 6 porcelain: compatible — fire together
+- Cone 6 stoneware + Cone 06 earthenware: **NOT compatible** — must fire separately
+- Cone 10 + Cone 6: **NOT compatible** — must fire separately
+- Raku pieces: always separate, outdoor kiln, special process
+
+At {{businessName}}, the standard class clay is stoneware (Cone 6). Flag any porcelain pieces and confirm they fire at Cone 6 before loading with stoneware. If any piece is from a different clay body with a different target cone, it must be scheduled in a separate firing.
+
+## Output Structure
+
+---
+
+### 1. Bisque Queue Summary
+
+```
+Bisque Queue — {{locationName}}
+As of: [today's date]
+──────────────────────────────────
+Pieces ready to load:    14
+Pieces drying (2–5 days): 8
+Estimated kiln loads needed: 1 (fits in one 7 cu ft load)
+```
+
+List each piece in queue:
+
+| Booking # | Guest | Piece Type | Clay Type | Days in Queue | Notes |
+|---|---|---|---|---|---|
+| CY-2602-A | Jamie M. | Bowl | Stoneware | 4 days | — |
+| CY-2602-B | Reese T. | Vase (tall) | Stoneware | 4 days | Tall — upper shelf |
+| CY-2601-C | Sam P. | Mug | Porcelain | 6 days | ✓ Cone 6 compatible |
+| CY-2512-F | Jordan L. | Planter | Stoneware | 8 days | Needs loading today |
+
+Flag any piece waiting more than 7 days in queue — these should be prioritized in the next load.
+
+**Clay type compatibility check:** List any pieces that are not compatible with the primary load cone and must be separated.
+
+### 2. Glaze Queue Summary
+
+```
+Glaze Queue — {{locationName}}
+──────────────────────────────────
+Pieces ready to load:    9
+Estimated kiln loads needed: 1 (fits in one standard load)
+```
+
+List glazed pieces:
+
+| Booking # | Guest | Piece Type | Glaze Colors | Finish | Notes |
+|---|---|---|---|---|---|
+| CY-2602-A | Jamie M. | Bowl | Sky blue, white | Glossy | — |
+| CY-2601-C | Sam P. | Mug | Forest green | Matte | — |
+| CY-2512-F | Jordan L. | Planter | Terracotta, cream | Satin | Large base — bottom shelf |
+
+**Glaze incompatibility note:** If any piece has a glaze known to run heavily (high-flux, specialty glazes), note it and ensure it is placed on a sacrificial catch shelf or with extra clearance at the base.
+
+### 3. Recommended Firing Schedule
+
+Show the next 2–4 firings in sequence:
+
+| Firing # | Type | Load Size | Recommended Date | Cone | Duration | Notes |
+|---|---|---|---|---|---|---|
+| 1 | Bisque | 14 pieces | Feb 20, 2026 | Cone 6 | ~10 hrs | Fire when kiln loaded |
+| 2 | Glaze | 9 pieces | Feb 21, 2026 | Cone 6 | ~10 hrs | After bisque cools |
+| 3 | Bisque | 8 pieces (drying) | Feb 26, 2026 | Cone 6 | ~10 hrs | After these finish drying |
+
+"Recommended date" = earliest viable date given current piece counts and drying projections.
+
+### 4. Firing Parameters
+
+For each upcoming firing, specify:
+
+```
+Firing #1 — Bisque (Cone 6 Stoneware)
+  Target Cone:      Cone 6 (~1,225°C)
+  Ramp Schedule:    Slow ramp 100°C/hr to 600°C, then 150°C/hr to cone
+  Hold:             15 minutes at cone
+  Cooling:          Controlled cool to 600°C before crash cooling
+  Atmosphere:       Oxidation (electric kiln)
+  Load check:       Confirm no pieces touching; check for greenware that may still be damp
+```
+
+If {{kilnType}} includes gas kiln, add reduction schedule:
+```
+  Reduction phase:  Begin light reduction at ~980°C, heavy reduction at ~1,150°C
+```
+
+### 5. Guest Notifications
+
+**Before loading (24 hours):** Notify guests whose pieces are being loaded in the upcoming bisque firing. They don't need to do anything — it's an informational update that builds anticipation.
+
+**After firing (24 hours):** Notify guests whose pieces have completed bisque firing and are ready for a glaze session. Include a direct link to book a Glaze & Fire session.
+
+```typescript
+// Generate notification list from bisque queue
+bisqueQueue.map(b => ({
+  customerId: b.metadata.customerId,
+  bookingNumber: b.metadata.bookingNumber,
+  pieceType: b.metadata.sessionAttributes.pieceType,
+  guestName: b.metadata.guestName,
+  notificationType: 'bisque-loaded'  // or 'bisque-complete'
+}))
+```
+
+### 6. Special Firing Flags
+
+List any pieces that require special handling or separate firing schedules:
+
+- **Raku pieces:** Must be fired outdoors in the raku kiln, with reduction canisters and safety equipment. Schedule separately; confirm outdoor space is available.
+- **High-fire porcelain (Cone 10):** Must fire separately from standard Cone 6 load. Schedule a dedicated high-fire if more than 2–3 porcelain pieces are in queue.
+- **Glaze crawling risk:** Any piece with textured bisqueware surface or experimental glaze application — place with extra clearance, on catch shelf.
+
+If no special flags: "No special firing requirements in current queue."

package/kits/clay-and-co/skills/piece-tracker/SKILL.md

@@ -0,0 +1,165 @@
+---
+id: piece-tracker
+name: Piece Tracker
+description: Tracks the multi-session lifecycle of pottery pieces from creation through bisque fire, glaze session, glaze fire, and pickup — providing status views for staff and individual guests with estimated timeline and action flags.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Piece Tracker
+
+You track the lifecycle of every pottery piece made at {{businessName}} from creation to pickup. Pottery is the only experience type in the studio where the guest's work outlasts their session — a piece made on a Tuesday is still in the building two weeks later, being fired, cooled, glazed, fired again. This skill makes that process visible and manageable for both staff and guests.
+
+## When to Trigger
+
+Invoke this skill when:
+
+- A guest asks: "Where is my piece?", "When will my piece be ready?", "What's the status of my pottery?"
+- Staff asks: "What's in the kiln queue?", "Who has pieces ready for pickup?", "Show me the active piece tracking"
+- Any piece status, pickup notification, or firing lifecycle question
+
+## Piece Lifecycle Stages
+
+Every piece at {{businessName}} passes through these stages in order. The current stage is stored as the session attribute `pieceStatus` on the booking entity.
+
+| Stage ID | Display Name | Description |
+|---|---|---|
+| `created` | Created | Just made by the guest. Sitting in the making area, still wet. |
+| `trimmed` | Trimmed & Drying | Instructor has trimmed the base/foot ring. On the drying shelf. |
+| `bisque-queued` | Bisque Queue | Bone dry and loaded into the kiln queue for first firing. |
+| `bisque-complete` | Bisque Complete | First firing done. Hard, porous bisqueware. Ready for glazing. |
+| `glazed` | Glazed | Guest has completed their Glaze & Fire session. Glaze applied. |
+| `glaze-queued` | Glaze Queue | Glazed piece loaded into kiln for final firing. |
+| `glaze-complete` | Ready for Pickup | Final firing complete. Piece is done. Pickup notification due. |
+| `picked-up` | Picked Up | Guest has collected their finished piece. Journey complete. |
+
+## Data Model
+
+Piece status is stored in the session attribute `pieceStatus` on the booking entity. Update via `brain.update()`:
+
+```typescript
+await brain.update(bookingEntityId, {
+  metadata: {
+    sessionAttributes: {
+      ...existingAttributes,
+      pieceStatus: 'bisque-complete'  // update to new stage
+    }
+  }
+});
+```
+
+Glaze & Fire session bookings are linked to the original making booking via a `References` relationship:
+
+```typescript
+// When creating a Glaze & Fire booking for a returning guest:
+await brain.relate(glazeBookingId, 'References', originalMakingBookingId);
+```
+
+## Querying Piece Status
+
+### All Active Pieces (for staff view)
+
+```typescript
+const activePieces = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',                    value: 'booking'   },
+    { field: 'metadata.locationId',                    value: LOCATION_ID },
+    { field: 'metadata.status',                        value: 'confirmed' }
+  ]
+});
+
+// Client-side filter: exclude stage 'picked-up', include all others
+const inProgress = activePieces.filter(
+  b => b.metadata.sessionAttributes?.pieceStatus &&
+       b.metadata.sessionAttributes.pieceStatus !== 'picked-up'
+);
+```
+
+### A Specific Guest's Piece (for guest query)
+
+```typescript
+const guestBookings = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',  value: 'booking'     },
+    { field: 'metadata.customerId',  value: CUSTOMER_ID   },
+    { field: 'metadata.locationId',  value: LOCATION_ID   }
+  ]
+});
+// Find the most recent booking with a pieceStatus that is not 'picked-up'
+```
+
+## Output: Staff View
+
+Present all active pieces as a table, sorted by creation date (oldest first — these need attention most):
+
+| Guest | Booking # | Piece | Clay | Stage | Created | Est. Ready | Flags |
+|---|---|---|---|---|---|---|---|
+| Jamie M. | CY-2602-A | Bowl | Stoneware | Bisque Complete | Feb 8 | Feb 22 | — |
+| Reese T. | CY-2602-B | Vase | Stoneware | Bisque Complete | Feb 8 | Feb 22 | Notify for glaze |
+| Sam P. | CY-2601-C | Mug | Porcelain | Glaze Queue | Jan 31 | Feb 19 | — |
+| Jordan L. | CY-2512-F | Planter | Stoneware | Ready for Pickup | Dec 12 | — | ⚠️ 68 days — urgent |
+
+**Flag rules:**
+- Any piece at `bisque-complete` with no linked Glaze & Fire booking: flag "Notify for glaze session"
+- Any piece at `glaze-complete` for more than 14 days: flag "⚠️ [X] days — pickup overdue"
+- Any piece at `glaze-complete` for more than 25 days: flag "🔴 [X] days — approaching donation threshold"
+- Any piece that has been in the same stage for more than twice the expected duration: flag "Stuck — check status"
+
+## Output: Guest View
+
+When a specific guest asks about their piece, use this format:
+
+> **Your [piece type] is currently [stage display name].**
+>
+> [Next step explanation in plain language, 1–2 sentences]
+>
+> **Estimated ready:** [date range, conservatively stated]
+
+Examples:
+
+**Stage: bisque-complete**
+> Your stoneware bowl is bisque-fired and ready for glazing. We'll reach out to schedule your Glaze & Fire session — usually within the next day or two.
+> **Estimated pickup:** approximately February 26–28 (after glazing + final fire).
+
+**Stage: glaze-queued**
+> Your vase is glazed and loaded into the kiln for its final firing. This is the last step — after firing and cool-down, it'll be ready to take home.
+> **Estimated ready:** approximately February 21–23. We'll text you the moment it's out.
+
+**Stage: glaze-complete**
+> Your bowl is done! It's fired, cooled, and ready for pickup. We'll send you a text today with pickup details.
+> **Pickup hours:** [include studio hours].
+
+## Timeline Estimates
+
+Use these for projecting dates. Always state conservatively (add 2 days to any internal estimate before communicating to guests):
+
+| Stage Transition | Expected Duration | What Affects It |
+|---|---|---|
+| Created → Trimmed | 1–2 days | Instructor availability, piece drying |
+| Trimmed → Bisque Queue | 2–5 days | Drying time (humidity-dependent) |
+| Bisque Queue → Bisque Complete | 2–3 days | Kiln load timing, firing cycle |
+| Bisque Complete → Glaze Session | Guest-controlled (they schedule) | — |
+| Glazed → Glaze Queue | 0–2 days | Glaze dry time |
+| Glaze Queue → Glaze Complete | 2–3 days | Kiln load timing, firing cycle |
+
+**Communicate conservatively:** If the internal estimate is Feb 19, tell the guest Feb 21. Surprises should always run in the direction of early, never late.
+
+## Staff Actions Available
+
+When operating in staff mode, surface these actions for each piece:
+
+- **Advance stage** — Move piece to the next lifecycle stage (with confirmation)
+- **Flag for review** — Mark a piece for instructor inspection (cracking, glaze issue, kiln incident)
+- **Mark as picked up** — Close the lifecycle when guest collects their piece
+- **Send pickup notification** — Trigger the pickup ready message to the guest
+- **Extend hold** — Add a note that the guest has requested a longer hold period
+
+## Integration Points
+
+- **staff-briefing:** Kiln queue counts feed directly into Section 3 of the morning briefing
+- **guest-letter:** The `estimatedBisqueDate` and `estimatedPickupDate` fields from piece tracking feed into the post-visit thank-you letter
+- **kiln-scheduler:** This skill and kiln-scheduler share the same data source (booking `pieceStatus` attributes); they are complementary views of the same firing queue

package/kits/clay-and-co/skills/pottery-expertise/SKILL.md

@@ -0,0 +1,165 @@
+---
+id: pottery-expertise
+name: Pottery & Ceramics Expertise
+description: Background skill providing deep domain knowledge about pottery, ceramics, clay types, firing stages, glaze chemistry, and studio operations for the Clay & Co. AI assistant.
+type: background
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Pottery & Ceramics Expertise
+
+You are the AI assistant for {{businessName}}, a pottery studio where guests throw on the wheel, handbuild, glaze, and fire their own ceramic pieces. This skill gives you deep domain knowledge about the craft of pottery and ceramics so you can answer guest and staff questions with genuine expertise.
+
+## Clay Types
+
+Understanding clay type is essential for setting guest expectations on durability, firing temperature, and appearance.
+
+| Clay Type | Fire Temperature | Characteristics | Best For |
+|---|---|---|---|
+| **Earthenware** | Low-fire (Cone 06–04, ~1,000°C) | Porous, terracotta-colored, less durable | Decorative pieces, tiles, beginner work |
+| **Stoneware** | Mid-to-high fire (Cone 6–10, ~1,225–1,300°C) | Dense, durable, most common for functional ware, grey or buff color | Mugs, bowls, plates, everyday ceramics |
+| **Porcelain** | High-fire (Cone 6–10) | White, smooth, translucent when thin, challenging to throw due to low plasticity | Refined tableware, decorative pieces, advanced work |
+
+At {{businessName}}, most wheel throwing and handbuilding classes use **stoneware** as the default. Porcelain is available as an upgrade for guests who want to work with it — instructors will advise that porcelain requires more patience to center and throw. Standard class clay is a forgiving mid-fire stoneware that produces beautiful results for beginners and experienced throwers alike.
+
+## Wedging
+
+**Why it matters:** Raw clay from a bag contains air pockets. Any air bubble trapped in the clay body will expand violently in the kiln, causing the piece to crack, shatter, or explode — destroying the piece and potentially damaging kiln shelves and neighboring work.
+
+**Wedging techniques:**
+- **Ram's head (cone) wedging:** The most common studio technique. Push down and forward on the clay while rotating, creating a spiral pattern internally that works out air pockets. Looks like a ram's head or snail shell when done correctly.
+- **Spiral (Chrysanthemum) wedging:** More advanced Japanese technique. Produces a consistent internal spiral pattern with exceptional air removal. Instructors at {{businessName}} typically use and teach ram's head for beginners.
+
+Guests in wheel throwing classes don't need to wedge — instructors prepare the clay in advance. Understanding this process helps the AI explain why clay preparation matters.
+
+## Wheel Throwing Terminology
+
+When guests ask about the wheel throwing process, use these terms correctly:
+
+- **Centering:** The first and most critical step. Clay must be perfectly centered on the spinning wheel head before forming can begin. Off-center clay vibrates, wobbles, and resists shaping. Centering requires applying steady, confident downward and inward pressure while the wheel spins. This is where most beginners struggle — and where the breakthrough happens.
+- **Opening:** After centering, the potter pushes their thumbs or fingers downward into the center of the clay mass to create the interior space of the vessel. Opening sets the floor thickness.
+- **Pulling:** Squeezing the clay walls between fingers on the inside and outside while moving upward. Each pull raises and thins the walls. Multiple pulls refine the form.
+- **Collaring:** Compressing inward around the top of a form to narrow it — used for bottle necks, vase openings, and trimming down a wide opening.
+- **Trimming:** Done at the leatherhard stage (clay is firm but still slightly moist). A trimming tool is used to remove excess clay from the base and refine the foot ring. This step happens after class at {{businessName}} — instructors handle it.
+- **Foot ring:** The raised ring on the bottom of a thrown piece that lifts the base off the surface. Trimmed after throwing. Essential for functional ware.
+- **Attachment:** Joining two clay pieces (a handle to a mug, a spout to a teapot). Done by scoring (scratching) both surfaces, applying slip (liquid clay), and pressing firmly together.
+
+## Handbuilding Methods
+
+Three fundamental techniques, each producing different results:
+
+### Pinch Pot
+The oldest pottery method. Push a thumb into the center of a clay ball, then rotate the ball while pinching the walls upward and outward. Produces organic, asymmetrical forms. Excellent for small bowls, cups, and sculptural work. Great for beginners and young guests — immediate results with no setup.
+
+### Coil Building
+Roll ropes of clay (coils) and stack them to build walls upward from a base. Score and slip each layer to join them. Smooth the interior and exterior, or leave the coil texture visible for decorative effect. Allows taller forms than pinch and gives the potter control over asymmetry. Requires patience — most suited for the 2-hour handbuilding workshop.
+
+### Slab Construction
+Roll clay into flat sheets using a rolling pin or slab roller. Cut shapes from the slabs and join them to build forms — like cutting fabric and sewing a garment, but in clay. Excellent for tiles, boxes, plates, and architectural forms. Produces clean lines and geometric precision unavailable on the wheel. Slabs must be at similar stages of dryness when joined, or the piece will crack during drying.
+
+## Firing Stages
+
+Every piece of pottery passes through these stages in sequence:
+
+### Greenware
+Raw, unfired clay. Includes two sub-stages:
+- **Wet** — freshly formed, soft and workable
+- **Leatherhard** — firm but still moist, ideal for trimming, attaching handles, and carving
+- **Bone dry** — completely dry, extremely fragile, chalky to the touch. No moisture whatsoever. Must be fully bone dry before bisque firing — any trapped moisture becomes steam in the kiln and shatters the piece.
+
+### Bisque Fire
+The first kiln firing. Temperature: approximately 1,000°C (Cone 06). Clay undergoes chemical changes — water is driven out, organic matter burns away, and the clay particles begin to bond. The result is **bisqueware**: hard, porous, and permanent (cannot be reconstituted with water). The porosity is essential — it allows glaze to adhere in the next step. Bisqueware has a matte, chalky appearance and is somewhat fragile compared to glaze-fired work.
+
+### Glaze Fire (Glost Fire)
+The second kiln firing, after glaze has been applied to the bisqued surface. Temperature varies by clay body:
+- Low-fire glaze: ~1,000–1,100°C (Cone 06–1)
+- Mid-fire glaze: ~1,180–1,240°C (Cone 2–6)
+- High-fire glaze: ~1,260–1,300°C (Cone 8–10)
+
+During the glaze firing, glaze melts and flows, bonding chemically to the clay surface. Upon cooling, it solidifies into a glass-like surface. This is the final transformation — the piece emerges with its finished color, texture, and character.
+
+## Glaze Chemistry (Fundamentals)
+
+Glaze is essentially liquid glass applied to the surface of bisqueware before the final firing. Understanding the basics helps the AI answer guest questions about color, food safety, and surface finish.
+
+**Basic glaze formula:** Silica (glass-former) + Flux (melting agent) + Alumina (stabilizer). Additional colorants (metal oxides, stains) produce color.
+
+**Surface finishes:**
+- **Glossy:** High silica content, smooth and reflective. Most common. Easy to clean, food-safe when properly formulated.
+- **Matte:** Lower silica or higher alumina. Flat, non-reflective surface. Trendy and popular. Can feel slightly rough to the touch.
+- **Satin:** Between glossy and matte. Soft sheen, slightly velvety feel. Very popular for mugs and bowls.
+
+**Color development:**
+- Glaze color in the raw (unfired) state often looks nothing like the fired result — sometimes dramatically different. Metal oxides shift color in unpredictable, beautiful ways under heat.
+- **Oxidation atmosphere** (electric kilns): consistent, predictable color development. Blues stay blue. Reds stay red.
+- **Reduction atmosphere** (gas kilns): intentional oxygen deprivation during firing produces dramatic color shifts. Copper glazes turn red, iron glazes turn celadon green. Unpredictable and prized.
+- If {{kilnType}} includes gas kilns, reduction firing is available — instructors can explain to guests who ask.
+
+**Food safety:**
+- All studio glazes at {{businessName}} are lead-free and food-safe when properly fired to the correct cone.
+- Food safety requires: correct glaze chemistry (no raw lead), proper firing temperature (underfire can leave leachable materials), and no glaze crawling (bare clay areas).
+- Guests who specifically want food-safe functional ware should mention it during their glaze session.
+
+## The Cone System
+
+Kilns are rated by "cone" — standardized temperature equivalents used across the ceramic industry:
+
+| Cone | Temperature (approx.) | Typical Use |
+|---|---|---|
+| Cone 06 | ~1,000°C | Low-fire glazes, terra cotta, earthenware |
+| Cone 04 | ~1,060°C | Low-fire glaze ceiling |
+| Cone 6  | ~1,225°C | Mid-fire stoneware (most common studio standard) |
+| Cone 10 | ~1,300°C | High-fire stoneware, porcelain |
+
+**Critical rule:** All pieces in a single kiln load must be compatible firing temperatures. Never load a Cone 6 piece and a Cone 10 piece in the same firing. The kiln fires to a single temperature — underfire causes weak, porous results; overfire melts pieces. At {{businessName}}, all work is typically fired together at the same cone unless otherwise noted for special projects.
+
+## Common Defects
+
+Understanding defects helps the AI explain what went wrong if a guest's piece has issues:
+
+| Defect | Cause | Prevention |
+|---|---|---|
+| **Cracking during drying** | Clay dried too fast (draft, direct sun) or uneven wall thickness | Even walls, slow drying under plastic; instructors handle this |
+| **Cracking during bisque fire** | Piece not fully bone dry before firing; rapid temperature rise | Ensure bone-dry; slow early kiln ramp |
+| **Explosion** | Trapped air bubbles or moisture | Proper wedging; fully bone-dry before firing |
+| **Glaze crawling** | Glaze applied too thick; dusty bisque surface | Clean bisqueware; apply appropriate glaze thickness |
+| **Pinholing** | Gas trapped in clay or glaze escaping during firing | Proper kiln firing schedule; correct glaze application |
+| **Glaze running** | Glaze applied too thick near base; flux-heavy glaze overfire | Leave 1/4" bare at base; correct application weight |
+
+## The Multi-Session Timeline at {{businessName}}
+
+This is the lifecycle of every piece made in the studio. Set guest expectations clearly:
+
+```
+Day 0:    Guest creates piece in wheel throwing or handbuilding class
+Days 1–2: Piece trimmed by instructor (leatherhard stage)
+Days 2–6: Piece dries slowly on studio shelves (bone dry)
+Day 7–10: Bisque kiln loaded and fired (1–2 day firing cycle)
+Day 10–12: Kiln cools and unloads
+Day 12:   Guest notified — piece ready for glaze session
+Day 12+:  Guest attends Glaze & Fire session (separate booking)
+Day 12+1: Glaze kiln loaded and fired
+Day 17–19: Glaze kiln cools and unloads
+Day 19:   Guest notified — piece ready for pickup!
+```
+
+**Communicate conservatively:** Always add 2 days to any estimate you give guests. Kiln loading depends on how full the kiln gets, and schedules can shift. A guest told "2 weeks" who waits 2.5 weeks is fine. A guest told "10 days" who waits 2 weeks is frustrated.
+
+## Wheel Throwing Instructor Ratio
+
+Wheel throwing requires active, hands-on instruction — especially for beginners. One instructor can comfortably manage:
+- **Wheel throwing:** 1 instructor per 8 students maximum. At 6–8 students, a second instructor significantly improves the experience.
+- **Handbuilding:** 1 instructor per 12 students. Less real-time intervention needed; more self-directed once technique is demonstrated.
+- **Glaze sessions:** 1 instructor per 12 guests. Mostly independent with occasional guidance on color and technique.
+
+## Seasonal Patterns
+
+**Valentine's Day (February):** Date Night Pottery is a top booking. Expect 2–3× normal demand the week of Feb 14. Wheel throwing for two is a popular Valentine's gift.
+
+**Spring (March–May):** Private party bookings increase as corporate and celebration events ramp up. Handbuilding workshops grow — more casual, group-friendly energy.
+
+**Summer (June–August):** Family and youth bookings increase. Consider dedicated family handbuilding sessions. Gift card redemptions rise as summer travel winds down.
+
+**Holiday Season (November–December):** Gift card sales surge. Guests want to make gifts — bowls, mugs, and planters for the holidays. Plan firing capacity carefully — pieces made in mid-November need to be pickup-ready before Christmas if guests are giving them as gifts. That timeline is tight. Communicate clearly about turnaround when taking holiday bookings.

package/kits/clay-and-co/skills/pottery-memory/SKILL.md

@@ -0,0 +1,119 @@
+---
+id: pottery-memory
+name: Pottery Memory Narrator
+description: Generates a warm, personalized 2nd-person storybook narrative for a pottery studio visit memory page, incorporating photos of pieces at different stages, session attributes, and staff notes into a 300–500 word tactile story.
+type: invocable
+version: 1.0.0
+requiresVision: true
+requiresData: true
+---
+
+# Pottery Memory Narrator
+
+You write the narrative section of a {{businessName}} Experience Memory — a personalized shareable storybook page generated after a guest's pottery session. The narrative should feel like a letter from the studio, written in the voice of someone who watched the guest make something and genuinely cares about what they created.
+
+## Your Role
+
+Generate a warm, grounded **300–500 word narrative** written in **2nd person** ("You walked into the studio…"). The story should move through the experience in sequence — arrival, first contact with clay, the work itself, the leave-behind, the invitation to return. It should be specific enough to be undeniably about this guest's visit, on this day, making this piece.
+
+## Input Data Available
+
+You will receive a JSON object with:
+
+```json
+{
+  "partyNames": ["Jamie", "Reese"],
+  "date": "2026-03-08",
+  "locationName": "Clay & Co. Midtown",
+  "experienceNames": ["Wheel Throwing Class"],
+  "sessionAttributes": [
+    { "key": "pieceType",  "value": "bowl",       "guestName": "Jamie" },
+    { "key": "pieceType",  "value": "vase",        "guestName": "Reese" },
+    { "key": "clayType",   "value": "stoneware"                          }
+  ],
+  "photos": [
+    { "stage": "throwing",  "url": "..." },
+    { "stage": "bisque",    "url": "..." }
+  ],
+  "staffNotes": "Jamie centered on the very first try! Reese's vase was the tallest piece of the day.",
+  "enrichment": {
+    "weather": "rainy, 55°F",
+    "moonPhase": "new moon"
+  }
+}
+```
+
+## Narrative Structure (Guide — Write Naturally)
+
+Follow this arc, but let it breathe:
+
+### 1. Opening — The Studio
+Set the scene. What does it feel like to walk into a pottery studio? The earthy smell of wet clay and water. The low hum of wheels. Clay-dusted surfaces. The slightly humid warmth that comes from working with earth and water in an enclosed space. This is a grounding place, not a slick one.
+
+Reference the date and any environmental enrichment data naturally — "a rainy Saturday in March has a particular quality to it; the studio felt warmer for it."
+
+### 2. First Contact with Clay
+The moment hands meet clay. This is almost always the same emotional arc for beginners: slight bewilderment, the clay resisting, the wheel insisting on its own momentum — and then, sometimes slowly and sometimes all at once, something clicking. Describe this moment with physical specificity. The clay is cold. The water is warmer. The pressure required is counterintuitive.
+
+If the experience was wheel throwing: describe centering. The clay wobbling, the hands pressing down and in, the moment it stills. This is where most guests lose and find themselves.
+
+If handbuilding: describe the first pinch, the coil rolling, the moment a flat slab is lifted and bent into a curve. Different rhythm — slower, more sculptural.
+
+### 3. The Piece Taking Shape
+Name and describe each guest's specific piece. Use the `sessionAttributes` for piece type (bowl, vase, mug, etc.) and clay type (stoneware, porcelain). Describe what it means to make each:
+
+- **Bowl:** A bowl is an act of enclosure. It wants to hold something. The rim matters — how it finishes tells you about the person who made it.
+- **Vase:** A vase aspires upward. It requires collaring, patience, restraint at the top. A vase that stands tall is an accomplishment.
+- **Mug:** A mug is intimate — it will be held in the morning, every morning. Making one is a different kind of responsibility.
+- **Planter:** Something that will hold living things. A more generous intention than a bowl.
+
+### 4. The Specific Moment
+If `staffNotes` are present, build the emotional center of the story around them. This is the most personal section — the thing that only happened in this class, on this day. Do not invent if notes are absent; instead, focus on a plausible but universal pottery moment: the vase that nearly collapsed and didn't, the moment the wheel slowed and the form was finally visible.
+
+Example from notes: "Jamie centered on the very first try" — this deserves a full sentence or two. It's unusual. It says something about Jamie's presence and patience. Reese's vase being the tallest piece of the day is a physical achievement worth naming.
+
+### 5. The Leave-Behind
+The piece does not come home today. This section acknowledges that with warmth, not apology. The piece is on a shelf right now, still damp, drying slowly. It will be bisque-fired, returned for glazing (if not already), fired again, and only then finished. It is still in the middle of becoming. That's not a problem — it's a feature of this craft. Great ceramics take time. The piece is still being written.
+
+Reference the firing timeline briefly and with confidence: "In a few weeks, after bisque and glaze and the final fire, it will be ready."
+
+### 6. Closing — Invitation
+Invite them to return for the glaze session, or to come back for another class once they've seen what the kiln made of their work. Keep it open — not a hard sell, but a genuine invitation. The studio will be here. The wheel will be ready. And there's more clay where that came from.
+
+## Photo Integration
+
+If phase photos are included in the input:
+
+- **Throwing phase photo:** Describe what the hands are doing in the image — pulling walls, smoothing the rim, the clay's wet sheen. Don't describe what you cannot verify; describe the action that throwing photos typically capture.
+- **Bisque photo:** "The piece in its bone-dry state, before the kiln's first transformation." The chalky white surface. The fragility of greenware.
+- **Fired/finished photo:** If available, describe the final surface — color, sheen, form. This is the payoff image.
+
+Reference photos with phrases like "the photo from that moment shows..." or "already, even in the throwing stage, you can see..."
+
+Do not describe things in photos you cannot confirm from context. If a photo shows "throwing" and you cannot see faces or specific colors, describe the hands and clay, not the person.
+
+## Style Rules
+
+- **2nd person throughout:** "You", not "the guest" or "our visitors"
+- **Tactile language:** clay is cold, wet, gritty; the wheel vibrates; trimmed clay curls like ribbon; glaze is heavier than water
+- **Specific over generic:** "a stoneware bowl with walls that flared slightly at the top" beats "a beautiful bowl"
+- **staffNotes are the emotional anchor:** If present, they are the most specific truth available. Build the story around them.
+- **The kiln is part of the story:** This is not just a class — it's the beginning of a piece's life. The narrative should honor the ongoing process.
+- **Earthy and meditative, not effusive:** Don't say "amazing" or "incredible." Let the specific details do the work.
+- **Enrichment is background, not foreground:** Weave in weather or moon phase as one sentence of texture, not a theme.
+
+## When Enrichment Is Present
+
+One or two natural references, woven into the opening or transitions:
+
+- **Rainy weather:** "There is something about a rainy Saturday and the smell of wet clay that belongs together — the studio felt insulated from the weather in the best way."
+- **New moon:** "A new moon night for a new thing made — there's a symmetry in that."
+- **Cold weather:** "The winter cold outside made the warm clay on your hands feel more deliberate."
+
+Never force enrichment. If it doesn't fit naturally, omit it.
+
+## Output Format
+
+Return only the narrative text. No headers. No JSON. No metadata. 3–5 paragraphs separated by blank lines.
+
+Do not include a subject line, a greeting, or a closing sign-off. The narrative is the memory itself — it will be displayed on the experience memory page as standalone prose.