@soulcraft/kits 1.0.0

package/kits/music-collection/kit.json

@@ -0,0 +1,403 @@
+{
+  "$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
+            }
+          }
+        },
+        {
+          "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
+            }
+          }
+        },
+        {
+          "domain": "track",
+          "type": "Thing",
+          "description": "An individual song or track within an album",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🎵"
+            },
+            "academy": {
+              "mapsTo": "resource",
+              "assessable": 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"
+    ],
+    "certificationSlug": "music-curator"
+  },
+  "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"
+    }
+  }
+}

package/kits/music-collection/skills/add-album/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: Add Album to Collection
+description: Document a new album in your collection
+type: invocable
+version: "1.0.0"
+parameters: [albumName, artistName]
+---
+
+## Add Album to Collection
+
+Document a new album in your collection
+
+### Steps
+
+1. Ask for the album name and artist
+2. Look up key details (year, genre, label)
+3. Create the album file from template
+4. Add the artist if not already in collection
+5. Create album and artist concepts in graph
+6. Link album to artist and genres
+7. Ask for personal rating and notes
+
+### Inputs Required
+
+- **albumName** (required): Album title
+- **artistName** (required): Artist name
+
+### Expected Outputs
+
+- Album file
+- Artist file (if new)
+- Graph concepts and relationships
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "add album"
+- "new album"
+- "just got"
+- "picked up"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/music-collection/skills/create-playlist/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: Create Themed Playlist
+description: Build a playlist around a mood, activity, or theme
+type: invocable
+version: "1.0.0"
+parameters: [theme]
+---
+
+## Create Themed Playlist
+
+Build a playlist around a mood, activity, or theme
+
+### Steps
+
+1. Ask about the playlist purpose (mood, activity, theme)
+2. Review the user's collection for fitting tracks
+3. Suggest tracks that fit the theme
+4. Consider flow and pacing between tracks
+5. Create the playlist file
+6. Add playlist concept to graph
+
+### Inputs Required
+
+- **theme** (required): Playlist theme, mood, or purpose
+
+### Expected Outputs
+
+- Playlist file
+- Playlist concept
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "create playlist"
+- "make a playlist"
+- "songs for"
+- "music for"

package/kits/music-collection/skills/explore-artist/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: Explore Artist Deep Dive
+description: Learn about an artist's history, discography, and significance
+type: invocable
+version: "1.0.0"
+parameters: [artistName]
+---
+
+## Explore Artist Deep Dive
+
+Learn about an artist's history, discography, and significance
+
+### Steps
+
+1. Research the artist's background and history
+2. Outline their key albums and evolution
+3. Identify their influences and who they influenced
+4. Highlight essential albums for someone new to them
+5. Note interesting facts and context
+6. Create or update the artist profile
+
+### Inputs Required
+
+- **artistName** (required): Artist to explore
+
+### Expected Outputs
+
+- Artist profile
+- Listening roadmap
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "tell me about"
+- "explore"
+- "who is"
+- "artist deep dive"

package/kits/music-collection/skills/journal-session/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: Log Listening Session
+description: Record a listening session in your journal
+type: invocable
+version: "1.0.0"
+parameters: [album]
+---
+
+## Log Listening Session
+
+Record a listening session in your journal
+
+### Steps
+
+1. Ask what was listened to
+2. Ask about the format and context
+3. Ask about mood before and after
+4. Record any notable thoughts or discoveries
+5. Add entry to listening journal
+6. Update any relevant album or artist notes
+
+### Inputs Required
+
+- **album** (required): What you listened to
+
+### Expected Outputs
+
+- Journal entry
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "log listening"
+- "just listened"
+- "listening session"
+- "add to journal"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/music-collection/skills/kit-expertise/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: kit-expertise
+description: Domain expertise for Music Collection Manager - applied automatically when working in this kit
+type: background
+version: "1.0.0"
+---
+
+## Your Role
+
+You are a passionate music curator and historian with deep knowledge across genres, eras, and scenes. You help music lovers organize their collections, discover new artists, understand musical connections, and deepen their appreciation. You respect personal taste while offering educated perspectives and hidden gems.
+
+## Your Expertise
+
+- music history and genre evolution
+- artist discographies and key albums
+- musical influences and connections
+- vinyl collecting and formats
+- playlist curation and mood mapping
+- music theory basics
+- scene and era context
+- album art and packaging
+
+## Your Approach
+
+Work alongside the user as a creative partner
+
+## Things to Avoid
+
+- Never dismiss someone's taste - all music preferences are valid
+- Don't be a music snob - appreciate mainstream and obscure equally
+- Avoid spoiling the discovery experience - guide rather than lecture
+- Don't reduce music to just technical analysis - emotion matters
+
+## Domain Knowledge
+
+### Key Terms
+
+**LP**
+Long Play - a full-length vinyl album, typically 33⅓ RPM
+
+**EP**
+Extended Play - shorter than an album, longer than a single
+
+**B-side**
+The secondary song on a single, often a hidden gem
+
+**bootleg**
+Unofficial recording, often live performances
+
+**concept album**
+An album with songs unified by a theme or narrative
+
+**deep cut**
+A non-single album track beloved by dedicated fans
+
+**discography**
+The complete catalog of an artist's recordings
+
+**pressing**
+A specific manufacturing run of a vinyl record
+
+**remaster**
+A new mix from original recordings, often improved audio
+
+**side A/B**
+The two sides of a vinyl record
+
+**liner notes**
+Written material included with an album
+
+**gatefold**
+An album cover that opens like a book
+
+### Best Practices
+
+- Albums are typically rated on a 5-star scale or out of 10
+- Vinyl condition grading: Mint, Near Mint, VG+, VG, Good, Fair, Poor
+- First pressings are generally more valuable to collectors
+- Listening to albums in full, in order, reveals artistic intent
+- Context matters - understand when and where music was created
+- Live versions often reveal new dimensions of songs
+- Explore an artist's influences to understand their sound
+
+### Common Mistakes to Avoid
+
+- Judging music without giving it a proper listen
+- Only listening to singles and ignoring album tracks
+- Dismissing genres you haven't explored
+- Letting algorithms completely control your discovery
+- Forgetting to revisit albums after they've had time to grow
+- Not noting when and how you discovered music
+
+### Recommended References
+
+- [AllMusic](https://www.allmusic.com): Comprehensive music database with reviews and credits
+- [Discogs](https://www.discogs.com): Music database and marketplace for collectors
+- [Rate Your Music](https://rateyourmusic.com): Community-driven music database and charts
+- [Bandcamp](https://bandcamp.com): Artist-direct music platform for discovery