@soulcraft/kits 1.0.0

package/src/kits/marketing-plan.ts

@@ -0,0 +1,398 @@
+/**
+ * @module @soulcraft/kits/kits/marketing-plan
+ * @description Strategic marketing plan with campaigns, channels, budget, and performance tracking
+ *
+ * Generated from: kits/marketing-plan/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * Marketing Plan kit configuration.
+ *
+ * @description Strategic marketing plan with campaigns, channels, budget, and performance tracking
+ * @see {@link SoulcraftKitConfig}
+ */
+const marketingPlan: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "marketing-plan",
+	"name": "Marketing Plan",
+	"description": "Strategic marketing plan with campaigns, channels, budget, and performance tracking",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "📣",
+	"longDescription": "Create a comprehensive marketing plan that aligns strategy with execution. Includes situation analysis, target audience definition, channel strategy, campaign planning, budget allocation, and KPI tracking. Perfect for annual planning, product launches, or scaling marketing efforts.",
+	"tags": [
+		"marketing",
+		"strategy",
+		"campaigns",
+		"growth",
+		"content",
+		"digital"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "projectName",
+			"label": "Company/Product Name",
+			"description": "The company or product being marketed",
+			"type": "string",
+			"required": true,
+			"example": "Acme Product"
+		},
+		{
+			"key": "planPeriod",
+			"label": "Planning Period",
+			"description": "The time period this plan covers",
+			"type": "string",
+			"required": false,
+			"example": "2024"
+		},
+		{
+			"key": "marketingBudget",
+			"label": "Marketing Budget",
+			"description": "Total annual marketing budget",
+			"type": "string",
+			"required": false,
+			"example": "$100,000"
+		},
+		{
+			"key": "primaryGoal",
+			"label": "Primary Goal",
+			"description": "Main objective for this period",
+			"type": "string",
+			"required": false,
+			"example": "Increase brand awareness"
+		}
+	],
+	"shared": {
+		"industry": "business-strategy",
+		"category": "business",
+		"glossary": {},
+		"aiExpertise": [
+			"Marketing strategy and planning",
+			"Campaign management",
+			"Customer persona development",
+			"Digital marketing channels",
+			"KPI definition and measurement"
+		],
+		"dataModelHints": [
+			"document",
+			"event",
+			"person",
+			"topic"
+		],
+		"suggestions": [
+			{
+				"label": "Define target audience",
+				"prompt": "Help me define and document my target audience personas"
+			},
+			{
+				"label": "Plan a campaign",
+				"prompt": "Help me plan a marketing campaign with goals and channels"
+			},
+			{
+				"label": "Analyze competitors",
+				"prompt": "Help me analyze my competitors' marketing strategies"
+			},
+			{
+				"label": "Set KPIs",
+				"prompt": "Help me define key performance indicators for my marketing plan"
+			},
+			{
+				"label": "Create messaging",
+				"prompt": "Help me develop core messaging and value propositions"
+			},
+			{
+				"label": "Review plan progress",
+				"prompt": "Show me my marketing plan structure and what needs attention"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "campaign",
+					"type": "Event",
+					"description": "A marketing campaign with dates, goals, and channels",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "📣"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "persona",
+					"type": "Person",
+					"description": "A detailed customer persona with demographics and motivations",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🎯"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "channel",
+					"type": "Concept",
+					"description": "A marketing channel such as social, email, or paid ads",
+					"products": {
+						"workshop": {
+							"view": "stats",
+							"icon": "📡"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "metric",
+					"type": "Concept",
+					"description": "A KPI or performance metric used to measure campaign success",
+					"products": {
+						"workshop": {
+							"view": "stats",
+							"icon": "📊"
+						},
+						"academy": {
+							"mapsTo": "assessment-criterion",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "content",
+					"type": "Document",
+					"description": "A piece of marketing content supporting a campaign",
+					"products": {
+						"workshop": {
+							"view": "board",
+							"icon": "📝"
+						},
+						"academy": {
+							"mapsTo": "learning-artifact",
+							"assessable": true
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "campaign",
+					"to": "persona",
+					"verb": "Targets",
+					"description": "Campaign is directed at this customer persona"
+				},
+				{
+					"from": "campaign",
+					"to": "channel",
+					"verb": "Uses",
+					"description": "Campaign runs on this channel"
+				},
+				{
+					"from": "content",
+					"to": "campaign",
+					"verb": "Supports",
+					"description": "Content supports and promotes this campaign"
+				},
+				{
+					"from": "metric",
+					"to": "campaign",
+					"verb": "Measures",
+					"description": "Metric is used to evaluate campaign performance"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "planner",
+			"defaultTab": "explore",
+			"defaultView": "calendar",
+			"defaultFile": "strategy/situation-analysis.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"User defines a new campaign",
+					"User creates a customer persona",
+					"User adds a marketing channel",
+					"User defines a KPI"
+				],
+				"typeMapping": {
+					"campaign": "event",
+					"persona": "person",
+					"channel": "category",
+					"metric": "concept",
+					"content": "document"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "event",
+					"to": "person",
+					"verb": "targets",
+					"description": "Campaign targets persona"
+				},
+				{
+					"from": "event",
+					"to": "category",
+					"verb": "uses",
+					"description": "Campaign uses channel"
+				},
+				{
+					"from": "document",
+					"to": "event",
+					"verb": "supports",
+					"description": "Content supports campaign"
+				},
+				{
+					"from": "concept",
+					"to": "event",
+					"verb": "measures",
+					"description": "Metric measures campaign"
+				}
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "strategy/01-situation-analysis.md",
+					"required": [
+						"Current Performance",
+						"SWOT"
+					],
+					"optional": [
+						"Competitor Analysis"
+					]
+				},
+				{
+					"path": "strategy/02-target-audience.md",
+					"required": [
+						"Primary Persona",
+						"Audience Segments"
+					],
+					"optional": [
+						"Customer Journey"
+					]
+				},
+				{
+					"path": "strategy/04-objectives.md",
+					"required": [
+						"SMART Goals",
+						"KPIs"
+					],
+					"optional": [
+						"OKRs"
+					]
+				}
+			],
+			"projectChecks": [
+				"Situation analysis complete with data",
+				"At least one detailed persona defined",
+				"SMART objectives set with specific targets",
+				"Channel strategy aligned with audience",
+				"Budget allocated by channel and campaign",
+				"Calendar populated for planning period"
+			],
+			"exportReady": [
+				"All strategy sections complete",
+				"Budget finalized",
+				"Calendar filled in",
+				"KPIs defined"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert marketing strategist helping businesses create comprehensive, data-driven marketing plans that drive measurable growth.",
+			"expertise": [
+				"Marketing strategy and planning",
+				"Campaign design and management",
+				"Customer persona and segmentation",
+				"Channel strategy and media mix",
+				"Performance measurement and KPIs"
+			],
+			"tone": "mentor"
+		},
+		"exporters": [
+			{
+				"id": "marketing-plan-pdf",
+				"name": "Marketing Plan (PDF)",
+				"description": "Professional marketing plan document",
+				"icon": "📄",
+				"format": "pdf",
+				"category": "document",
+				"handler": "wdoc-pdf"
+			},
+			{
+				"id": "marketing-plan-slides",
+				"name": "Presentation Deck",
+				"description": "Slides for team presentations",
+				"icon": "🎭",
+				"format": "html",
+				"category": "presentation",
+				"handler": "wdoc-slides"
+			},
+			{
+				"id": "campaign-briefs",
+				"name": "Campaign Briefs",
+				"description": "Individual campaign documents",
+				"icon": "📋",
+				"format": "zip",
+				"category": "archive",
+				"handler": "markdown-bundle"
+			}
+		],
+		"exportPreferences": {
+			"defaultExporter": "marketing-plan-pdf",
+			"fileNameTemplate": "{{projectName}}-marketing-plan-{{planPeriod}}"
+		},
+		"exportStructure": {
+			"combineStrategy": "graph-order",
+			"orderRelationship": "precedes",
+			"includePatterns": [
+				"strategy/*.md"
+			],
+			"excludePatterns": [
+				"campaigns/*",
+				"analytics/*"
+			]
+		},
+		"difficulty": "intermediate",
+		"templateTier": 4
+	},
+	"academy": {
+		"skillPath": "marketing",
+		"level": "intermediate",
+		"learningObjectives": [
+			"Conduct a situation analysis with SWOT and current-performance benchmarks",
+			"Build detailed customer personas with demographics, motivations, and buying journey",
+			"Select and justify a channel mix based on audience behavior and budget",
+			"Set SMART marketing objectives with KPIs tied to business outcomes",
+			"Allocate a marketing budget across campaigns and track spend against projections"
+		],
+		"assessmentTypes": [
+			"portfolio",
+			"peer-review"
+		],
+		"certificationSlug": "marketing-strategist"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default marketingPlan;

package/src/kits/marketing-site.ts

@@ -0,0 +1,248 @@
+/**
+ * @module @soulcraft/kits/kits/marketing-site
+ * @description Multi-page static website - edit HTML/CSS directly, deploy anywhere
+ *
+ * Generated from: kits/marketing-site/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * Marketing Website kit configuration.
+ *
+ * @description Multi-page static website - edit HTML/CSS directly, deploy anywhere
+ * @see {@link SoulcraftKitConfig}
+ */
+const marketingSite: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "marketing-site",
+	"name": "Marketing Website",
+	"description": "Multi-page static website - edit HTML/CSS directly, deploy anywhere",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🌐",
+	"longDescription": "A clean, modern multi-page marketing website you can edit directly and deploy anywhere.\n\n**What's Included:**\n- Landing page with hero, features, testimonials, and CTA\n- About page with company story and team section\n- Contact page with form and contact info\n- Responsive CSS with easy-to-customize variables\n- Minimal JavaScript for interactivity\n\n**How to Use:**\n- Edit HTML files directly in the editor\n- Ask the AI to add sections, change colors, or create new pages\n- Export as ZIP and deploy to Netlify, Vercel, or any static host\n\n**No build step required** - just HTML, CSS, and JavaScript.",
+	"tags": [
+		"html",
+		"css",
+		"static",
+		"marketing",
+		"landing-page",
+		"no-build"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "siteName",
+			"label": "Site Name",
+			"description": "The name of your website or product",
+			"type": "string",
+			"required": true,
+			"example": "My Awesome Site"
+		},
+		{
+			"key": "tagline",
+			"label": "Tagline",
+			"description": "Your site's hero tagline",
+			"type": "string",
+			"required": false,
+			"example": "Build something amazing"
+		},
+		{
+			"key": "primaryColor",
+			"label": "Primary Color",
+			"description": "The main brand color (hex code)",
+			"type": "string",
+			"required": false,
+			"example": "#2563eb"
+		}
+	],
+	"shared": {
+		"industry": "software-development",
+		"category": "dev",
+		"glossary": {},
+		"aiExpertise": [
+			"HTML and CSS web development",
+			"Responsive design principles",
+			"Conversion copywriting",
+			"Landing page optimization",
+			"Static site deployment"
+		],
+		"dataModelHints": [
+			"document",
+			"thing"
+		],
+		"suggestions": [
+			{
+				"label": "Write landing copy",
+				"prompt": "Help me write compelling landing page copy"
+			},
+			{
+				"label": "Plan site structure",
+				"prompt": "Help me plan the structure and pages of my marketing site"
+			},
+			{
+				"label": "Create a CTA",
+				"prompt": "Help me craft effective call-to-action text and placement"
+			},
+			{
+				"label": "Write testimonials",
+				"prompt": "Help me structure and write customer testimonial sections"
+			},
+			{
+				"label": "SEO optimization",
+				"prompt": "Help me optimize my marketing site content for SEO"
+			},
+			{
+				"label": "Review site content",
+				"prompt": "Show me all my marketing site pages and their status"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "page",
+					"type": "Document",
+					"description": "An HTML page of the marketing site with copy and sections",
+					"products": {
+						"workshop": {
+							"view": "tree",
+							"icon": "🌐"
+						},
+						"academy": {
+							"mapsTo": "learning-artifact",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "section",
+					"type": "Concept",
+					"description": "A content section within a page such as hero, features, or CTA",
+					"products": {
+						"workshop": {
+							"view": "tree",
+							"icon": "📐"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "asset",
+					"type": "Thing",
+					"description": "A static file such as an image, icon, or CSS stylesheet",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🖼️"
+						},
+						"academy": {
+							"mapsTo": "resource",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "page",
+					"to": "section",
+					"verb": "Contains",
+					"description": "Page contains this content section"
+				},
+				{
+					"from": "page",
+					"to": "page",
+					"verb": "References",
+					"description": "Page links to another page in the site"
+				},
+				{
+					"from": "page",
+					"to": "asset",
+					"verb": "Uses",
+					"description": "Page references this static asset"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "index.html",
+					"required": [
+						"<!DOCTYPE html>",
+						"<meta name=\"viewport\"",
+						"<link rel=\"stylesheet\""
+					],
+					"optional": [
+						"<script"
+					]
+				},
+				{
+					"path": "styles.css",
+					"required": [
+						":root",
+						"@media"
+					],
+					"optional": []
+				}
+			],
+			"projectChecks": [
+				"All pages have consistent header/footer",
+				"Site is responsive on mobile",
+				"All images have alt text",
+				"Forms have proper labels"
+			],
+			"exportReady": [
+				"No broken links",
+				"Valid HTML structure",
+				"CSS loads correctly"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert web designer and copywriter helping creators build beautiful, conversion-focused marketing websites with clean HTML and CSS.",
+			"expertise": [
+				"HTML and CSS web development",
+				"Responsive design and mobile-first development",
+				"Conversion copywriting",
+				"Landing page optimization",
+				"Static site deployment"
+			],
+			"tone": "collaborator"
+		},
+		"difficulty": "beginner",
+		"templateTier": 4,
+		"templateMetadata": {
+			"identifyByStructure": true,
+			"runnable": false
+		}
+	},
+	"academy": {
+		"skillPath": "web-development",
+		"level": "intermediate",
+		"learningObjectives": [
+			"Structure a multi-page site with semantic HTML and a clear navigation hierarchy",
+			"Write conversion-focused landing page copy with a compelling hero, benefits, and CTA",
+			"Apply responsive CSS using custom properties and media queries for mobile-first layouts",
+			"Deploy a static site to a public host and verify it loads correctly across devices"
+		],
+		"assessmentTypes": [
+			"demo",
+			"code-review"
+		],
+		"certificationSlug": "web-builder"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default marketingSite;