{"$schema":"https://soulcraft.com/schemas/kit/v2.json","id":"music-collection","type":"soulcraft","role":"primary","status":"released","name":"Music Collection Manager","description":"Organize and explore your music library with albums, artists, playlists, and listening journal","longDescription":"A comprehensive system for music lovers to catalog their collection, track listening habits, create smart playlists based on moods and genres, and discover connections between artists. Perfect for vinyl collectors, streaming curators, or anyone who wants to engage more deeply with their music.","version":"1.0.0","author":{"name":"Soulcraft Labs","email":"kits@soulcraft.com","url":"https://soulcraft.com"},"icon":"🎵","tags":["music","collection","vinyl","playlists","listening","curation"],"variables":[{"key":"projectName","label":"Collection Name","description":"The name of your music collection","type":"string","required":true,"example":"My Music Collection"},{"key":"ownerName","label":"Your Name","description":"Your name as the collector","type":"string","required":false,"example":"Your Name"},{"key":"primaryFormat","label":"Primary Format","description":"Your main way of listening","type":"string","required":false,"example":"Vinyl, Digital, CD, Streaming"}],"shared":{"industry":"creative-arts","category":"creative","glossary":{"vinyl":"A physical record format prized for its warm, analog sound","curation":"The art of selecting and organizing music into meaningful collections"},"aiExpertise":["Music history and artist knowledge","Genre classification and connections","Album and artist recommendations","Playlist curation by mood and context","Music metadata and discography"],"dataModelHints":["person","thing","topic","event"],"dataModel":{"entities":[{"domain":"artist","type":"Person","description":"A musician or band whose work is in the collection","products":{"workshop":{"view":"gallery","icon":"🎸"},"academy":{"mapsTo":"learning-subject","assessable":false},"venue":{"mapsTo":"CustomerMeta","pos":false}}},{"domain":"album","type":"Thing","description":"A music album or release with track listing and rating","products":{"workshop":{"view":"gallery","icon":"💿"},"academy":{"mapsTo":"resource","assessable":false},"venue":{"mapsTo":"InventoryItemMeta","pos":true}}},{"domain":"track","type":"Thing","description":"An individual song or track within an album","products":{"workshop":{"view":"gallery","icon":"🎵"},"academy":{"mapsTo":"resource","assessable":false},"venue":{"mapsTo":"ContentPageMeta","pos":false}}},{"domain":"playlist","type":"Concept","description":"A curated collection of tracks grouped by mood or theme","products":{"workshop":{"view":"board","icon":"📋"},"academy":{"mapsTo":"knowledge-unit","assessable":true}}},{"domain":"genre","type":"Concept","description":"A music genre or style category","products":{"workshop":{"view":"graph","icon":"🎼"},"academy":{"mapsTo":"knowledge-unit","assessable":false}}}],"relationships":[{"from":"album","to":"artist","verb":"CreatedBy","description":"Album was created by this artist"},{"from":"artist","to":"artist","verb":"InfluencedBy","description":"Musical influence relationship"},{"from":"artist","to":"artist","verb":"CollaboratedWith","description":"Artists who have worked together"},{"from":"album","to":"genre","verb":"HasGenre","description":"Album belongs to this genre"},{"from":"track","to":"playlist","verb":"InPlaylist","description":"Track appears in this playlist"}]},"suggestions":[{"label":"Add an album","prompt":"Help me add a new album to my music collection"},{"label":"Rate and review","prompt":"Help me write a review and rating for an album"},{"label":"Discover connections","prompt":"Find connections between artists and genres in my collection"},{"label":"Create a playlist","prompt":"Help me curate a playlist from my collection"},{"label":"Collection stats","prompt":"Show me statistics about my music collection by genre and decade"},{"label":"Browse collection","prompt":"Show me my music collection in the gallery view"}]},"academy":{"skillPath":"music-curation","level":"beginner","learningObjectives":["Catalog albums with complete metadata (artist, year, genre, format, personal rating)","Identify and document influence relationships between artists across genres and eras","Build thematic playlists by selecting tracks that share mood, key, or narrative arc","Write a substantive album review that articulates why a record is significant"],"assessmentTypes":["portfolio"],"mode":"self-paced","tutorPersona":{"inheritsFrom":"workshop.aiPersona","method":"exploratory","encouragementLevel":"warm","flashcardsEnabled":true},"certification":{"requiresHumanCertifier":false,"aiCertifierAllowed":true,"lineageEnabled":false,"certificationSlug":"music-curator"},"gamification":{"enabled":true,"achievements":["connector","deep-thinker","streak","completionist"],"streaks":true,"leaderboard":false}},"workshop":{"difficulty":"beginner","templateTier":4,"aiPersona":{"role":"You are an expert music curator and historian helping music lovers catalog their collections, discover connections between artists, and deepen their appreciation of music.","expertise":["Music history and genre knowledge","Artist biography and discography","Album curation and recommendation","Playlist design by mood and context","Music metadata and cataloging"],"tone":"collaborator"},"workspaceConfig":{"paradigm":"creative","defaultTab":"explore","defaultView":"gallery","defaultFile":"albums/first-album.md","layout":{"leftDock":"concepts","rightDock":"views"},"onboarding":{"showGuide":true,"highlightFeatures":["gallery","graph"],"suggestedActions":["Add albums to your collection","Use Gallery view to browse album art","Explore artist connections in Graph view","Build playlists by linking tracks"]}},"graphGuidance":{"conceptCreation":{"triggers":["User adds a new album to their collection","User mentions a new artist","User creates a new playlist","User references a genre not yet in the system"],"typeMapping":{"artist":"person","album":"creative-work","track":"creative-work","playlist":"collection","genre":"category","mood":"category","label":"organization","era":"category"}},"relationshipPatterns":[{"from":"creative-work","to":"person","verb":"createdBy","description":"Album by artist"},{"from":"person","to":"person","verb":"influencedBy","description":"Musical influence"},{"from":"person","to":"person","verb":"collaboratedWith","description":"Worked together"},{"from":"creative-work","to":"category","verb":"hasGenre","description":"Album genre"},{"from":"creative-work","to":"collection","verb":"inPlaylist","description":"Track in playlist"}],"rules":["Every album should link to its artist","Artists should have at least one genre","Influential relationships should be bidirectional when known","Playlists should link to their tracks or albums"]},"qualityGates":{"fileChecks":[{"path":"artists/*.md","required":["Genres","Key Albums"],"optional":["Influences","Personal Notes","Rating"]},{"path":"albums/*.md","required":["Artist","Year","Track Listing"],"optional":["My Review","Rating","When to Listen"]}],"projectChecks":["At least 5 artists documented","At least 10 albums in collection","At least one playlist created","Listening journal has entries"],"exportReady":["All albums linked to artists","Genres assigned to artists","Collection stats updated"]},"sampleData":{"description":"Sample music collection with albums, artists, and playlists","entities":[{"type":"media","name":"OK Computer","properties":{"artist":"Radiohead","year":1997,"format":"Vinyl LP","rating":10,"description":"Groundbreaking alternative rock album exploring technology and alienation.","status":"owned"}},{"type":"person","name":"Radiohead","properties":{"genre":"Alternative Rock","activeYears":"1985-present","origin":"Oxford, UK","description":"Influential British band known for experimental rock and electronic music."}}],"relationships":[{"from":"OK Computer","verb":"createdBy","to":"Radiohead"}]},"deploy":{"provider":"cloud-run","buildCommand":"npm run build","outputDir":"build","config":{"port":3000,"memory":"512Mi"},"oneClickCommand":"gcloud run deploy"}},"venue":{"bookingNumberPrefix":"MC","subdomainPrefix":"musicstore","features":{"blog":true,"cms":true,"customerAccounts":true,"subscriptions":true,"website":true,"notifications":true,"analytics":true,"giftCards":true,"pos":true,"loyalty":true,"waivers":false,"animals":false,"adoption":false,"memories":true,"partners":false,"franchise":false},"fees":{"billingModel":"subscription","feeMode":"online-only"},"theme":{"primary":"oklch(0.35 0.12 290)","bgBase":"oklch(0.10 0.04 290)","accent":"oklch(0.65 0.18 50)","textPrimary":"oklch(0.95 0.01 290)","displayFont":"Space Grotesk","bodyFont":"Inter"},"experienceTypes":[{"slug":"vinyl-listening-session","name":"Vinyl Listening Session","description":"Reserve a private listening booth for 60 minutes. Browse our curated vinyl selection, spin whatever calls to you, and enjoy the warm analogue sound.","priceInCents":2000,"durationMinutes":60,"minGuests":1,"maxGuests":4,"requiresWaiver":false,"isCombo":false,"sortOrder":0,"color":"oklch(0.48 0.14 290)","sessionAttributeDefinitions":[{"key":"genrePreference","label":"Genre Preference","type":"select","perGuest":false,"options":["Jazz","Soul/R&B","Rock","Electronic","Hip-Hop","Classical","Surprise me"],"required":false}]},{"slug":"music-discovery-consultation","name":"Music Discovery Consultation","description":"A 45-minute session with our resident music curator. Tell us what you love, what you've never heard, and walk away with a personalised listening roadmap.","priceInCents":8000,"durationMinutes":45,"minGuests":1,"maxGuests":1,"requiresWaiver":false,"isCombo":false,"sortOrder":1,"color":"oklch(0.58 0.16 50)","sessionAttributeDefinitions":[{"key":"favoriteArtists","label":"Favourite Artists","type":"text","perGuest":false,"required":false},{"key":"explorationGoal","label":"Exploration Goal","type":"select","perGuest":false,"options":["Discover new genres","Dig deeper into one genre","Find obscure gems","Build my vinyl collection","Create the perfect playlist"],"required":false}]}],"inventoryCategories":[{"id":"vinyl","label":"Vinyl Records","icon":"💿"},{"id":"cd","label":"CDs","icon":"📀"},{"id":"merch","label":"Band Merch","icon":"👕"},{"id":"accessories","label":"Accessories","icon":"🎧"},{"id":"equipment","label":"Turntables & Equipment","icon":"🎚️"}],"staffRoles":[{"id":"music-curator","label":"Music Curator","defaultCapabilities":["checkin","pos","inventory-view","cms","analytics"]},{"id":"floor-staff","label":"Floor Staff","defaultCapabilities":["checkin","pos","inventory-view"]}],"chatSuggestions":[{"label":"Browse the collection","message":"What genres and artists do you stock? I'm looking for something specific.","emoji":"🎵"},{"label":"Book a listening session","message":"I'd love to book a private vinyl listening session. What's available?","emoji":"🎶"},{"label":"Get music recommendations","message":"I want to expand my listening. Can I book a music discovery consultation?","emoji":"🔍"},{"label":"Subscribe for new arrivals","message":"How do I get notified when new records arrive?","emoji":"📬"}],"inventoryLevelDetection":"manual"},"previewImageUrl":"kits/music-collection/images/preview.webp"}