@soulcraft/kits 1.0.0

package/kits/reading-tracker/kit.json

@@ -0,0 +1,368 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "reading-tracker",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Reading Tracker",
+  "description": "Book collection with reading timeline, themes, quotes, and author connections",
+  "longDescription": "Track your reading journey with a knowledge-graph powered library. Collect books, save memorable quotes, explore themes across your reading history, and discover author bibliographies. Uses Brainy for document, person, content, and concept entity modeling.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "📚",
+  "tags": [
+    "books",
+    "reading",
+    "library",
+    "quotes",
+    "authors",
+    "brainy",
+    "sveltekit"
+  ],
+  "variables": [
+    {
+      "key": "appName",
+      "label": "App Name",
+      "description": "The name of your reading tracker app",
+      "type": "string",
+      "required": true,
+      "example": "my-library"
+    },
+    {
+      "key": "description",
+      "label": "Description",
+      "description": "A short description of your reading journal",
+      "type": "string",
+      "required": false,
+      "example": "My reading journal",
+      "default": "A personal reading tracker and book journal"
+    }
+  ],
+  "shared": {
+    "industry": "personal-productivity",
+    "category": "knowledge",
+    "aiExpertise": [
+      "Book recommendations and discovery",
+      "Literary theme analysis",
+      "Reading habit tracking",
+      "Author bibliography research",
+      "Reading goal setting"
+    ],
+    "dataModelHints": [
+      "document",
+      "person",
+      "content",
+      "concept"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "book",
+          "type": "Document",
+          "description": "A book in the reading collection with status and rating",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "📚"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "author",
+          "type": "Person",
+          "description": "The author of one or more books in the collection",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "✍️"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "quote",
+          "type": "Concept",
+          "description": "A memorable quote saved from a book",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "💬"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "theme",
+          "type": "Concept",
+          "description": "A recurring literary theme appearing across books",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🧵"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "book",
+          "to": "author",
+          "verb": "CreatedBy",
+          "description": "Book was written by this author"
+        },
+        {
+          "from": "book",
+          "to": "quote",
+          "verb": "Contains",
+          "description": "Book contains this saved quote"
+        },
+        {
+          "from": "theme",
+          "to": "book",
+          "verb": "Describes",
+          "description": "Theme appears in this book"
+        },
+        {
+          "from": "book",
+          "to": "book",
+          "verb": "References",
+          "description": "Book cites or connects to another book"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Add a book",
+        "prompt": "Help me add a new book to my reading tracker"
+      },
+      {
+        "label": "Write a review",
+        "prompt": "Help me write a review of a book I just finished"
+      },
+      {
+        "label": "Find similar books",
+        "prompt": "Recommend books similar to ones I've enjoyed"
+      },
+      {
+        "label": "Set reading goals",
+        "prompt": "Help me set and track my reading goals"
+      },
+      {
+        "label": "Analyze reading habits",
+        "prompt": "Show me statistics and insights about my reading habits"
+      },
+      {
+        "label": "Browse my library",
+        "prompt": "Show me my book collection in the gallery view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "literary-analysis",
+    "level": "beginner",
+    "learningObjectives": [
+      "Write a structured book review covering argument, evidence, style, and personal evaluation",
+      "Identify recurring themes across multiple books and articulate how they connect",
+      "Extract and contextualise quotes that capture an author's key ideas or literary style",
+      "Build a reading list that systematically covers a topic or expands into new genres"
+    ],
+    "assessmentTypes": [
+      "portfolio"
+    ],
+    "certificationSlug": "book-reviewer"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are a literary companion helping readers track their reading journey, discover connections between books, and build a meaningful personal library.",
+      "expertise": [
+        "Book recommendations",
+        "Literary theme analysis",
+        "Reading habit optimization",
+        "Author research",
+        "Reading goal setting"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "researcher",
+      "defaultTab": "explore",
+      "defaultView": "graph",
+      "defaultFile": "books/current.md",
+      "layout": {
+        "leftDock": "concepts",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "graph",
+          "timeline",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Add your first book to the collection",
+          "Track themes and quotes as you read",
+          "Use Graph view to see author and theme connections",
+          "Use Timeline view to see your reading journey"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "typeMapping": {
+          "book": "document",
+          "author": "person",
+          "quote": "content",
+          "theme": "concept"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "document",
+          "to": "person",
+          "verb": "createdBy",
+          "description": "Book written by author"
+        },
+        {
+          "from": "document",
+          "to": "content",
+          "verb": "contains",
+          "description": "Book contains quote"
+        },
+        {
+          "from": "concept",
+          "to": "document",
+          "verb": "describes",
+          "description": "Theme appears in book"
+        },
+        {
+          "from": "document",
+          "to": "document",
+          "verb": "references",
+          "description": "Book references another"
+        }
+      ],
+      "rules": [
+        "Every book should link to its author",
+        "Quotes should link to source book",
+        "Themes should link to related books"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "package.json",
+          "required": [
+            "svelte",
+            "@sveltejs/kit",
+            "@soulcraft/brainy"
+          ],
+          "optional": [
+            "typescript"
+          ]
+        },
+        {
+          "path": "src/lib/types.ts",
+          "required": [
+            "Book",
+            "Author"
+          ],
+          "optional": [
+            "Quote",
+            "Theme"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "App starts with npm run dev",
+        "Can add books to library",
+        "Can track reading status",
+        "Can save quotes",
+        "Timeline view shows reading history"
+      ],
+      "exportReady": [
+        "No TypeScript errors",
+        "All routes load correctly",
+        "Error handling in place"
+      ]
+    },
+    "sampleData": {
+      "entities": [
+        {
+          "type": "document",
+          "name": "The Great Gatsby",
+          "properties": {
+            "year": 1925,
+            "status": "completed",
+            "rating": 5,
+            "dateRead": "2024-06-15",
+            "genre": "Fiction",
+            "description": "A tragic story of wealth, love, and the American Dream in 1920s New York."
+          }
+        },
+        {
+          "type": "person",
+          "name": "F. Scott Fitzgerald",
+          "properties": {
+            "birthYear": 1896,
+            "nationality": "American",
+            "description": "American novelist of the Jazz Age, known for lyrical prose."
+          }
+        },
+        {
+          "type": "concept",
+          "name": "The American Dream",
+          "properties": {
+            "description": "The pursuit of prosperity and success in American society."
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "The Great Gatsby",
+          "verb": "createdBy",
+          "to": "F. Scott Fitzgerald"
+        },
+        {
+          "from": "The American Dream",
+          "verb": "describes",
+          "to": "The Great Gatsby"
+        }
+      ]
+    },
+    "templateMetadata": {
+      "runnable": true,
+      "runnableCommand": "npm run dev"
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/reading-tracker/skills/add-book/SKILL.md

@@ -0,0 +1,32 @@
+---
+id: add-book
+name: Add Book to Library
+description: Add a new book with author and metadata
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Add Book to Library
+
+Add a new book with author and metadata
+
+### Steps
+
+1. Create book document entity
+2. Add or link existing author
+3. Set reading status (to-read, reading, completed)
+4. Add genre/theme tags
+5. Optionally add to reading queue
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "add book"
+- "new book"
+- "track book"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/reading-tracker/skills/book-connections/SKILL.md

@@ -0,0 +1,161 @@
+---
+id: book-connections
+name: book-connections
+description: Find thematic connections between books in your reading history
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Book Connections Skill
+
+When the user invokes `/connections`, help them discover thematic and conceptual connections between books they've read.
+
+### Invocation Patterns
+
+- `/connections` - Analyze connections across library
+- `/connections [book]` - Find books related to specific title
+- `/connections theme [theme]` - Find books sharing a theme
+- `/connections sequence` - Suggest reading sequences
+
+### Connection Types
+
+**Thematic Connections**
+- Shared themes or ideas
+- Similar philosophical positions
+- Common subject matter
+
+**Authorial Connections**
+- Same author
+- Influenced by/influences
+- Same school of thought
+- Contemporaries
+
+**Response/Dialogue**
+- Books that respond to each other
+- Critiques and rebuttals
+- Building on ideas
+- Opposing viewpoints
+
+**Genre/Style**
+- Same genre
+- Similar writing style
+- Same narrative approach
+
+### Output Format
+
+```markdown
+## Book Connections Analysis
+
+### Library Overview
+- **Total books**: X
+- **Genres covered**: [List]
+- **Most connected book**: [Title]
+- **Thematic clusters**: X identified
+
+### Connection Map
+
+#### Cluster 1: [Theme Name]
+```
+[Book A] ←→ [Book B]
+    ↓         ↓
+[Book C] ←→ [Book D]
+```
+**Theme**: [Description]
+**Key connection**: [Explanation]
+
+#### Cluster 2: [Theme Name]
+[Same format]
+
+### Specific Book Connections
+
+For: **[Book Title]**
+
+| Connected Book | Connection Type | Strength | Why |
+|---------------|-----------------|----------|-----|
+| [Book B] | Thematic | Strong | [Explanation] |
+| [Book C] | Authorial | Medium | [Explanation] |
+| [Book D] | Dialogue | Strong | [Explanation] |
+
+### Cross-Genre Connections
+Surprising links between different genres:
+- **[Fiction Book]** ↔ **[Non-Fiction Book]**: [Connection]
+
+### Reading Sequences
+
+**Suggested Sequence 1**: [Theme] Journey
+1. [Book A] - [Why start here]
+2. [Book B] - [How it builds]
+3. [Book C] - [Deepens understanding]
+4. [Book D] - [Synthesis or capstone]
+
+### Underexplored Connections
+Books that could connect but you haven't explored:
+- [Book X] might relate to [Theme Y]
+- Consider reading [Book Z] to connect [Cluster A] and [Cluster B]
+
+### Books That Bridge
+These books connect otherwise separate clusters:
+- **[Book]**: Links [Cluster A] to [Cluster B]
+```
+
+### Finding Connections
+
+**Questions to Ask**
+- What questions does this book answer?
+- What questions does it raise?
+- What would the author think of [other book]?
+- What's the opposite position?
+- Who influenced this author?
+
+**Connection Strength**
+- **Strong**: Direct engagement with same ideas
+- **Medium**: Related themes or approaches
+- **Weak**: Tangential relationship
+
+### Thematic Categories
+
+**Big Ideas**
+- Human nature
+- Consciousness
+- Morality/ethics
+- Power and society
+- Knowledge and truth
+
+**Practical Themes**
+- Leadership
+- Creativity
+- Decision-making
+- Communication
+- Learning
+
+**Life Themes**
+- Meaning and purpose
+- Relationships
+- Growth and change
+- Mortality
+- Identity
+
+### Building Reading Journeys
+
+**Linear Journey**
+Book A → B → C (building understanding)
+
+**Dialogue Journey**
+Book A ↔ Book B (contrasting views)
+
+**Synthesis Journey**
+Books A, B, C → Book D (bringing together)
+
+**Historical Journey**
+Classic → Response → Modern synthesis
+
+### Cross-Pollination Benefits
+
+**Why Connections Matter**
+- Deeper understanding
+- New insights at intersections
+- Better retention
+- Creative thinking
+- Richer discussions

package/kits/reading-tracker/skills/kit-expertise/SKILL.md

@@ -0,0 +1,72 @@
+---
+id: kit-expertise
+name: kit-expertise
+description: Domain expertise for Reading Tracker - applied automatically when working in this kit
+version: "1.0.0"
+type: background
+requiresVision: false
+requiresData: false
+---
+
+## Your Role
+
+You are a literary application developer helping build a personal reading tracker. You understand book metadata, author relationships, and how themes connect across literature. You help users create a "second brain" for their reading.
+
+## Your Expertise
+
+- Book metadata and cataloging
+- Author-book relationships
+- Theme and concept tracking
+- Quote management
+- Reading progress tracking
+- Literary connections and references
+- SvelteKit and Brainy integration
+
+## Your Approach
+
+Work alongside the user as a creative partner
+
+## Domain Knowledge
+
+### Key Terms
+
+**book**
+A literary work, stored as Brainy 'document' entity
+
+**author**
+A book's writer, stored as 'person' entity
+
+**quote**
+A memorable passage, stored as 'content' entity
+
+**theme**
+A recurring idea/concept, stored as 'concept' entity
+
+**reading status**
+To-read, reading, completed status
+
+**DNF**
+Did Not Finish - abandoned book
+
+**TBR**
+To Be Read - books in your queue
+
+### Best Practices
+
+- Store books as 'document' entities
+- Store authors as 'person' entities
+- Store quotes as 'content' entities
+- Store themes as 'concept' entities
+- Use 'createdBy' for book-to-author
+- Use 'contains' for book-to-quote
+- Use 'describes' for theme-to-book
+- Use 'references' for book-to-book citations
+- Track reading start/end dates for timeline
+- Rate books using consistent scale
+
+### Common Mistakes to Avoid
+
+- Not tracking when you read books
+- Forgetting to note memorable quotes
+- Not linking authors to their books
+- Ignoring thematic connections across books

package/kits/reading-tracker/skills/log-progress/SKILL.md

@@ -0,0 +1,29 @@
+---
+id: log-progress
+name: Log Reading Progress
+description: Update progress on current read
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Log Reading Progress
+
+Update progress on current read
+
+### Steps
+
+1. Update current page/percentage
+2. Optionally add notes or quotes
+3. Mark as completed if finished
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "update progress"
+- "reading update"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.