{"$schema":"https://soulcraft.com/schemas/kit/v2.json","id":"experiential-retail","type":"soulcraft","role":"primary","status":"released","visibility":{"scope":"unlisted"},"primaryProduct":"venue","kitFamily":"business-archetype","name":"Experiential Retail","description":"Physical venue where guests come to do something — make candles, throw axes, paint pottery, escape a room, taste wine, arrange flowers, cook with a chef, meet foster kittens. Bookings, waivers, staff, POS, seasonal rotation.","longDescription":"The unified archetype for experiential retail businesses. Bookings, waivers, staff, POS, CMS + 8 operational feature toggles (leagues, memories, kilns, hints, COGS, animal-welfare, cellar, perishables) that flex the kit to any specific business type. Replaces 8 branded venue clones (Axe House, Canvas & Corks, Clay & Co, Escape Vault, Gather & Grill, Paws & Pour, Petal Press, Pour House) with one flexible archetype. Every skill knows the operational rhythm of running a physical experiential business: pre-booking coordination, day-of check-ins, session flow, post-visit follow-up, inventory pacing, staff briefings, seasonal calendar rotation, and the specific data patterns (bookings, guest lifecycle, inventory consumption, staff scheduling, marketing calendar) that make these businesses actually work. Wicks & Whiskers Charlotte is the reference implementation — this archetype will eventually absorb W&W's tenant configuration as a data-only migration (no re-onboarding). See forge/docs/KITS-CATALOGUE.md for the full 26-kit consolidation program.","version":"0.1.2","author":{"name":"Soulcraft Labs","email":"kits@soulcraft.com","url":"https://soulcraft.com"},"icon":"🎭","tags":["venue","experiential","bookings","waivers","pos","staff","candle","pottery","axe-throwing","escape-room","cooking","wine-tasting","flowers","paint-and-sip","pet-cafe","archetype"],"previewImageUrl":"kits/experiential-retail/images/preview.webp","variables":[{"key":"businessName","label":"Business Name","description":"The name of your business (e.g. \"Wicks & Whiskers\", \"The Axe House\", \"Clay & Co\").","type":"string","required":true,"example":"Your Business Name","default":"Your Experiential Business"},{"key":"tagline","label":"Tagline","description":"A short phrase describing your business (shown under the logo). Should convey what guests do at your venue.","type":"string","required":false,"example":"candle bar & kitten rescue","default":"an experiential retail experience"},{"key":"businessCategory","label":"Business Category","description":"What kind of experiential business this is. Drives skill flavor, station availability, and default content.","type":"enum","options":["candle-making","pottery","paint-and-sip","axe-throwing","escape-room","cooking-class","pet-cafe","wine-tasting","flower-arranging","custom"],"required":true,"example":"candle-making","default":"custom"},{"key":"locationName","label":"Location Name","description":"The display name for this specific location (e.g. \"Wicks & Whiskers Charlotte\"). Often just the businessName + city.","type":"string","required":false,"example":"Your Business Charlotte"},{"key":"locationSlug","label":"Location URL Slug","description":"URL-safe identifier for this location used in booking links (e.g. \"charlotte-plaza-midwood\").","type":"string","required":true,"example":"main-location","default":"main"},{"key":"address","label":"Street Address","description":"The physical street address of the venue.","type":"address","required":true,"example":"1234 Main Street"},{"key":"city","label":"City","description":"City the venue is in.","type":"string","required":true,"example":"Charlotte"},{"key":"state","label":"State / Province","description":"Two-letter state or province code.","type":"string","required":true,"example":"NC"},{"key":"zip","label":"Postal Code","description":"ZIP or postal code.","type":"string","required":true,"example":"28203"},{"key":"timezone","label":"Timezone","description":"IANA timezone identifier for scheduling.","type":"timezone","required":true,"example":"America/New_York","default":"America/New_York"},{"key":"phone","label":"Phone","description":"Primary contact phone number.","type":"phone","required":true,"example":"+15551234567"},{"key":"email","label":"Email","description":"Primary contact email address.","type":"email","required":true,"example":"hello@yourbusiness.com"},{"key":"instagram","label":"Instagram Handle","description":"Instagram username (no @).","type":"string","required":false,"example":"yourbusiness"},{"key":"facebook","label":"Facebook Page","description":"Facebook page slug or full URL.","type":"string","required":false,"example":"yourbusiness"},{"key":"tiktok","label":"TikTok Handle","description":"TikTok username (no @).","type":"string","required":false,"example":"yourbusiness"},{"key":"maxCapacity","label":"Maximum Venue Capacity","description":"Maximum simultaneous guests the venue can accommodate.","type":"number","required":true,"example":"40","default":"30"},{"key":"partnerOrgName","label":"Partner Organization Name","description":"Optional — a partner nonprofit or rescue organization (e.g. \"Killer Kitties Rescue\" for a pet cafe). Only relevant if enableAnimalWelfare or a similar partnership toggle is active.","type":"string","required":false,"example":"Your Partner Rescue"},{"key":"enableLeagues","label":"Enable Leagues","description":"Enable competitive league scheduling (axe throwing, escape room championships, cooking class series).","type":"boolean","required":false,"default":"false"},{"key":"enableMemories","label":"Enable Session Memories","description":"Enable session keepsakes / craft-choice tracking (candles, pottery, paintings). Guests get a post-session memory storybook.","type":"boolean","required":false,"default":"false"},{"key":"enableKilns","label":"Enable Multi-Session Pickup (Kilns)","description":"Enable multi-session workflow (drop-off, fire/dry/set, notify, pickup) for pottery, drying processes, custom framing.","type":"boolean","required":false,"default":"false"},{"key":"enableHints","label":"Enable Hint Delivery (Escape Rooms)","description":"Enable game-master ops — hint delivery, completion time tracking, escape outcome logging.","type":"boolean","required":false,"default":"false"},{"key":"enableCOGS","label":"Enable Food-Cost COGS","description":"Enable ingredient-based food cost tracking (recipes, waste, per-experience COGS, margin). For cooking classes, food-tasting experiences.","type":"boolean","required":false,"default":"false"},{"key":"enableAnimalWelfare","label":"Enable Animal Welfare","description":"Enable rescue/adoption ops — animal profiles, medical records, adoption applications, interaction tracking. For pet cafes, kitten lounges, animal-assisted therapy.","type":"boolean","required":false,"default":"false"},{"key":"enableCellar","label":"Enable Cellar / Vintage Tracking","description":"Enable vintage/lot/producer tracking for wine, spirits, curated tastings.","type":"boolean","required":false,"default":"false"},{"key":"enablePerishables","label":"Enable Perishable Inventory","description":"Enable short-shelf-life inventory tracking (flowers, produce, prepared foods) with daily receipt and EOD spoilage checks.","type":"boolean","required":false,"default":"false"}],"shared":{"industry":"experiential-retail","category":"physical-venue","glossary":{"Experience":"The core bookable activity a guest does at the venue (a candle-making session, a pottery class, an axe-throwing lane, an escape room, a wine tasting, a cooking class).","Guest":"A person visiting the venue for an experience. Used interchangeably with 'customer' but 'guest' better reflects the hospitality-forward nature of experiential retail.","Session":"A specific instance of an experience — a scheduled time slot, capacity limit, staff assignment, participant list.","Waiver":"Legal acknowledgment of risk that a guest signs before participating (required for physical activities like axe throwing, animal interaction, hot-wax handling).","Chandler":"The staff member who guides a candle-making session (used in W&W). Analog: 'Instructor' (paint/pottery), 'Kounselor' (kitten lounge), 'Guide' (escape room game master), 'Sommelier' (wine tasting).","Cover":"Industry term for a booking or reservation — 'we did 40 covers on Saturday' means 40 guests. Common in hospitality.","Season":"The rotation of experiences a venue offers, typically changing quarterly to reflect seasonal themes.","Craft Choice":"A per-guest customization decision made during a session (fragrance blend, paint colors, wick length). Powers the memories/keepsakes flow.","COGS":"Cost of Goods Sold — the per-unit cost of the materials and ingredients consumed by an experience. Key input to gross margin."},"aiExpertise":["Running experiential retail businesses (candle bars, pottery studios, axe ranges, escape rooms, cooking studios, wine bars, floral studios, pet cafes)","Booking systems, waiver flows, and staff scheduling for physical venues with hourly experiences","Inventory management including consumable supplies (fragrance oils, wax, wine bottles, flowers) and durable equipment","Guest lifecycle from first-visit to loyalty to review to referral","Seasonal experience rotation and marketing calendar tied to holidays and local events","POS and payment flows for hybrid retail + experiential businesses","Loyalty programs, gift cards, and subscription/membership models","Content marketing for experiential businesses (blog, social, email) with an emphasis on the sensory/tactile experience"],"suggestions":[{"label":"Plan next month's schedule","prompt":"Use the demand-forecast skill to look at last month's booking patterns and recommend staffing + capacity for next month. Highlight which experiences are underperforming."},{"label":"Draft this week's blog post","prompt":"Use the blog-draft skill to write a 600-900 word blog post for {{businessName}}. Pick a topic tied to a current experience or seasonal moment."},{"label":"Weekly staff briefing","prompt":"Use the staff-briefing skill to draft this morning's opening briefing: today's bookings, VIPs, weather considerations, inventory alerts, and one specific coaching note for the team."},{"label":"Customer segments","prompt":"Use the customer-insights skill to cluster our customers into 5 behavioral segments and recommend one marketing action per segment."},{"label":"Revenue report for this quarter","prompt":"Use the revenue-report skill to build a P&L for the quarter with month-over-month comparisons and highlight two anomalies worth investigating."},{"label":"Refresh gift card marketing","prompt":"Use the email-campaign skill to draft two A/B variants of a gift card promotion email tied to the upcoming holiday season."}],"dataModelHints":["person","event","concept","document"],"dataModel":{"entities":[{"domain":"location","type":"Place","description":"The physical venue location. For multi-location operators, one entity per venue.","products":{"workshop":{"view":"map","icon":"📍"},"venue":{"mapsTo":"TenantMeta","pos":false}}},{"domain":"experience","type":"Concept","description":"A type of bookable activity offered at the venue. Distinct from a specific session — this is the reusable template.","products":{"workshop":{"view":"gallery","icon":"🎭"},"venue":{"mapsTo":"ExperienceType","pos":true}}},{"domain":"session","type":"Event","description":"A specific scheduled instance of an experience with start time, capacity, staff assignment, participant list.","products":{"workshop":{"view":"calendar","icon":"📅"},"venue":{"mapsTo":"SessionMeta","pos":true}}},{"domain":"booking","type":"Event","description":"A guest's reservation for a specific session. Includes party size, contact info, waiver status, payment, and check-in state.","products":{"workshop":{"view":"timeline","icon":"🎫"},"venue":{"mapsTo":"BookingMeta","pos":true}}},{"domain":"guest","type":"Person","description":"A person who has booked, visited, or expressed interest in the venue. Tracks visit history, preferences, party affiliations, communication opt-ins.","products":{"workshop":{"view":"gallery","icon":"👤"},"venue":{"mapsTo":"CustomerMeta","pos":true}}},{"domain":"staff","type":"Person","description":"A team member — chandler, instructor, sommelier, game master, host, manager. Includes role, capabilities, schedule, pay rate.","products":{"workshop":{"view":"gallery","icon":"🧑‍🏫"},"venue":{"mapsTo":"StaffMeta","pos":false}}},{"domain":"inventory_item","type":"Thing","description":"A stocked SKU consumed or sold by the business. Tracks category, unit, current stock, reorder threshold.","products":{"workshop":{"view":"board","icon":"📦"},"venue":{"mapsTo":"InventoryItemMeta","pos":true}}},{"domain":"transaction","type":"Event","description":"A payment event — booking payment, retail sale, gift card purchase, expense.","products":{"workshop":{"view":"stats","icon":"💳"},"venue":{"mapsTo":"TransactionMeta","pos":true}}},{"domain":"waiver","type":"Document","description":"A signed liability waiver — either per-guest (adults) or per-guardian (minors). Referenced by bookings.","products":{"workshop":{"view":"board","icon":"📜"},"venue":{"mapsTo":"WaiverMeta","pos":false}}},{"domain":"gift_card","type":"Thing","description":"A gift card — initial value, current balance, issuance date, recipient. Redeemable against bookings or retail.","products":{"workshop":{"view":"board","icon":"🎁"},"venue":{"mapsTo":"GiftCardMeta","pos":true}}},{"domain":"loyalty_account","type":"Concept","description":"A guest's loyalty program membership — current points, tier, lifetime value.","products":{"workshop":{"view":"stats","icon":"⭐"},"venue":{"mapsTo":"LoyaltyAccountMeta","pos":true}}},{"domain":"content_page","type":"Document","description":"A CMS page (homepage, about, faq, location, experience pages, policies, gift cards, blog).","products":{"workshop":{"view":"board","icon":"📝"},"venue":{"mapsTo":"ContentPageMeta","pos":false}}}],"relationships":[{"from":"booking","to":"session","verb":"reserves","description":"A booking reserves capacity in a session."},{"from":"session","to":"experience","verb":"instance-of","description":"A session is a scheduled instance of an experience type."},{"from":"guest","to":"booking","verb":"makes","description":"A guest makes a booking."},{"from":"staff","to":"session","verb":"leads","description":"A staff member leads a session."},{"from":"booking","to":"waiver","verb":"requires","description":"A booking requires a signed waiver from each participant."},{"from":"transaction","to":"booking","verb":"settles","description":"A transaction settles the payment for a booking. Related to loyalty point accrual."},{"from":"session","to":"inventory_item","verb":"consumes","description":"A session consumes inventory items."}]}},"workshop":{"difficulty":"intermediate","templateTier":5,"aiPersona":{"role":"You are the operating brain for an experiential retail business — a physical venue where guests come to do something specific (make candles, throw axes, paint pottery, escape a room, taste wine, arrange flowers, cook, meet animals). You follow the Soulcraft voice baseline (forge/docs/SOULCRAFT-VOICE.md): warm/direct/efficient, no fabrication of metrics or guest names, ask before assuming, concrete over abstract, first-person plural for the business, contrarian when a plan won't work. Your domain overlay: you know the daily flow (pre-arrival prep, staff briefings, guest check-in, session leadership, cleanup, post-visit follow-up), the weekly flow (schedule optimization, inventory pacing, marketing calendar, staff coaching), and the quarterly flow (seasonal experience rotation, KPI review, staff planning). Your tone modifier is 'warm-hospitality' — you write like a manager who has run the floor for years, not a marketing consultant.","expertise":["Operations for experiential retail venues (bookings, waivers, staff, POS, inventory)","Guest lifecycle and hospitality — first visit, second visit, loyalty, review, referral","Seasonal experience calendar and marketing rotation","Local marketing for physical businesses (walk-ins, community, partnerships)","Small business staff coaching and daily briefings","Financial reporting for hybrid retail + experience businesses"],"tone":"collaborator","avoidances":["Do not fabricate metrics, guest names, or specific transaction data — always ask first.","Do not recommend generic small-business advice that could apply to any storefront; ground every recommendation in the specific experiential venue context.","Do not use hospitality buzzwords ('luxury experience', 'elevated moments', 'unforgettable memories') as filler."]},"workspaceConfig":{"paradigm":"analyst","defaultTab":"explore","defaultView":"board","defaultFile":"README.md"},"graphGuidance":{"conceptCreation":{"triggers":["User describes a new experience type they want to offer","User mentions a staff hire, promotion, or role change","User references a specific guest by name","User describes an inventory item with SKU-level detail","User discusses a seasonal calendar or event","User names a partner organization or supplier"],"typeMapping":{"experience":"concept","session":"event","booking":"event","guest":"person","customer":"person","staff":"person","chandler":"person","instructor":"person","sommelier":"person","supplier":"organization","partner":"organization","location":"place","waiver":"document","policy":"document","blog":"document","product":"thing","gift-card":"thing","inventory":"thing"}},"relationshipPatterns":[{"from":"person","to":"event","verb":"attends","description":"A guest attends a session"},{"from":"person","to":"event","verb":"leads","description":"A staff member leads a session"},{"from":"event","to":"concept","verb":"instance-of","description":"A session is an instance of an experience"}],"rules":["When a user names a specific guest, staff member, or supplier — create a Person / Organization entity.","When a user describes a new experience — create a Concept entity, not multiple Events. The experience is the reusable template.","Booking, session, and transaction are Events with specific timestamps."]},"qualityGates":{"projectChecks":["The venue's core operational data (Experience, Session, Booking, Guest, Staff, Inventory Item, Transaction) is represented in the graph.","Every published experience has a defined price, duration, capacity, and staff role requirement.","The seasonal calendar for the current quarter is drafted."]}},"venue":{"experienceTypes":[],"subdomainPrefix":"venue","catalogThemeId":"soulcraft-light","theme":{"primary":"oklch(0.42 0.03 240)","bgBase":"oklch(0.98 0.005 240)","accent":"oklch(0.72 0.14 60)","textPrimary":"oklch(0.20 0.02 240)","displayFont":"Fraunces","bodyFont":"Inter"},"features":{"cms":true,"blog":true,"pos":true,"waivers":true,"loyalty":true,"giftCards":true,"customerAccounts":true,"apps":true,"notifications":true,"website":true,"analytics":true,"memories":true,"subscriptions":true,"partners":true,"franchise":true,"animals":true,"adoption":true,"rescuePartner":true,"craftChoices":true,"documents":true},"terminology":{"participant":{"singular":"guest","plural":"guests"},"offering":{"singular":"experience","plural":"experiences"},"reservation":{"singular":"booking","plural":"bookings"},"group":{"singular":"party","plural":"parties"},"document":{"singular":"waiver","plural":"waivers"},"host":{"singular":"guide","plural":"guides"},"space":{"singular":"studio","plural":"studios"},"partySize":"Party size","checkIn":"Check-in"},"chatSuggestions":[{"label":"Book an experience","message":"Show me what experiences you offer and help me pick one to book.","emoji":"🎫"},{"label":"See what's happening this week","message":"What's on the schedule this week? Any special events?","emoji":"📅"},{"label":"Buy a gift card","message":"I want to buy a gift card. How much can I load and what's the process?","emoji":"🎁"},{"label":"Private event inquiry","message":"I want to book a private event for a group. What are my options?","emoji":"🎉"}],"fees":{"billingModel":"per-transaction","feeMode":"all-channels","platformFeeRate":0.05},"inventoryLevelDetection":"manual","seedData":{"seed":false,"demo":false},"authGate":"action","authExemptRoutes":["/","/blog","/blog/*","/experiences","/experiences/*","/gifts","/about","/faq","/location","/policies","/waivers"],"pages":[{"slug":"home","type":"homepage","label":"Home","navOrder":0,"showInNav":false},{"slug":"experiences","type":"catalog","label":"Experiences","navOrder":10,"showInNav":true},{"slug":"gifts","type":"gifts","label":"Gift Cards","navOrder":20,"showInNav":true,"featureGate":"giftCards"},{"slug":"blog","type":"blog","label":"Blog","navOrder":30,"showInNav":true,"featureGate":"blog"},{"slug":"about","type":"cms","label":"About","navOrder":40,"showInNav":true,"cmsPageSlug":"about"},{"slug":"location","type":"cms","label":"Visit Us","navOrder":50,"showInNav":true,"cmsPageSlug":"location"},{"slug":"faq","type":"cms","label":"FAQ","navOrder":60,"showInNav":true,"cmsPageSlug":"faq"},{"slug":"policies","type":"cms","label":"Policies","navOrder":70,"showInNav":false,"cmsPageSlug":"policies"},{"slug":"waivers","type":"cms","label":"Waivers","navOrder":80,"showInNav":false,"cmsPageSlug":"waivers"}],"navigation":{"sections":[{"id":"today","label":"Today","stationIds":["guest-experience","experience-calendar"]},{"id":"operations","label":"Operations","stationIds":["inventory-pulse"]}]},"stations":[{"id":"guest-experience","label":"Guest Experience","route":"/manage/guest-experience","icon":"M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z","roles":["staff","manager","owner"],"scope":"kit","context":"physical","group":"Operations"},{"id":"experience-calendar","label":"Experience Calendar","route":"/manage/experience-calendar","icon":"M9 11H7v2h2v-2zm4 0h-2v2h2v-2zm4 0h-2v2h2v-2zm2-7h-1V2h-2v2H8V2H6v2H5c-1.11 0-1.99.9-1.99 2L3 20c0 1.1.89 2 2 2h14c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2z","roles":["staff","manager","owner"],"scope":"kit","context":"digital","group":"Operations"},{"id":"inventory-pulse","label":"Inventory Pulse","route":"/manage/inventory-pulse","icon":"M20 2H4c-1 0-2 .9-2 2v3.01c0 .72.43 1.34 1 1.69V20c0 1.1 1.1 2 2 2h14c.9 0 2-.9 2-2V8.7c.57-.35 1-.97 1-1.69V4c0-1.1-1-2-2-2zm-5 12H9v-2h6v2zm5-7H4V4l16-.02V7z","roles":["staff","manager","owner"],"scope":"kit","context":"physical","group":"Operations"}]}}