Showcase: Amazing Speckits Built with MetaSpec

[NeilJo-GY]

Have you built a speckit with MetaSpec? Share it here and inspire the community! 🚀

🎯 What to Share

We want to see:

• Your speckit: Name, description, repository link
• Domain: What problem does it solve?
• Highlights: What makes it special?
• Demo: Commands, screenshots, or GIFs
• Lessons learned: What surprised you? What worked well?

---

📝 Showcase Template

Copy this template and fill it in:

### [Your Speckit Name]

**Repository**: [Link to GitHub/GitLab]  
**Domain**: [e.g., API Testing, Design Systems, Marketing Automation]  
**Status**: [Alpha/Beta/Production]

**What it does**:
[1-2 sentence description]

**Key features**:
- Feature 1
- Feature 2
- Feature 3

**Example usage**:
\`\`\`bash
your-speckit command example
\`\`\`

**Lessons learned**:
[What surprised you while building it?]

**Community**: [How can others contribute?]

---

🎨 Featured Examples

⭐ marketing-spec-kit - Spec-Driven Marketing (SDM)

Repository: ACNet-AI/marketing-spec-kit
Domain: Marketing Operations
Status: Production (v0.4.0)
Generated by: MetaSpec 0.9.5

What it does:
Transform marketing chaos into structured, AI-driven workflows. Define campaigns in Markdown specs, generate executable code and configs automatically.

Key features:

• ✅ 10 SDM Commands: Complete marketing workflow (constitution → specify → clarify → plan → checklist → tasks → analyze → implement → review → optimize)
• ✅ Distributed Architecture: Clean separation (specs/ + config/ + templates/ + data/ + src/)
• ✅ AI-First Design: Code Execution with MCP for progressive disclosure
• ✅ Real SDS + SDD: Used both to define specifications AND build the toolkit itself
• ✅ 45 Validation Rules: Optional YAML validation for campaign configs

Example usage:

# Initialize marketing project
marketing_spec_kit init my-campaign

# Follow SDM workflow with AI
/marketspec.constitution  # Define principles
/marketspec.specify       # Define campaign requirements
/marketspec.implement     # Generate src/, config/, templates/

# Execute campaign (with MCP)
cd my-campaign/src/campaigns
node 001-my-campaign.ts

Architecture Highlight:

my-campaign/
├── specs/           # What (Markdown specs)
├── config/          # Configuration (YAML)
├── templates/       # Content templates
├── data/            # Collected metrics
└── src/             # How (TypeScript execution)

Why it's special:

• First production speckit built with MetaSpec's distributed architecture
• Real-world validated: Currently running MetaSpec's own marketing campaign
• Complete lifecycle: 10-command workflow covering Constitution → Specify → Clarify → Plan → Checklist → Tasks → Analyze → Implement → Review → Optimize
• Education value: Excellent reference for building non-development speckits

Community: Open for contributions! See AGENTS.md for workflow guide.

---

🚀 More Coming Soon!

As the community grows, we'll feature more amazing speckits here. Be the first to share yours!

Example Categories:

• 🔧 SD-Development: Framework-specific toolkits (MCP, FastAPI, etc.)
• 🎨 SD-Design: Design system validators and generators
• 🧪 SD-Testing: Domain-specific testing frameworks
• 📚 SD-Documentation: Doc generation from structured specs
• ⚙️ SD-Operations: Infrastructure automation tools
• 📱 SD-Marketing: Campaign management toolkits
• 🔌 SD-API: API design and validation tools
• 📊 SD-Data: Data pipeline spec tools

---

🏆 Recognition

High-quality speckits will be:

• ⭐ Featured in this discussion
• 📦 Highlighted in awesome-spec-kits
• 📢 Promoted on social media
• 💬 Mentioned in MetaSpec updates

---

💡 First-Time Contributors

New to building speckits? Here's how to get started:

Step 1: Generate Your Speckit

# Interactive mode (recommended)
metaspec init

# Or quick start
metaspec init my-speckit

Step 2: Define Your Specifications (SDS)

cd my-speckit

# Use built-in MetaSpec commands
/metaspec.sds.constitution  # Define design principles
/metaspec.sds.specify       # Define spec entities
/metaspec.sds.implement     # Write spec documents

Step 3: Build Your Toolkit (SDD)

/metaspec.sdd.constitution  # Define implementation principles
/metaspec.sdd.specify       # Define CLI/API specs
/metaspec.sdd.plan          # Plan architecture
/metaspec.sdd.tasks         # Break down work
/metaspec.sdd.implement     # Write code

Step 4: Share with Community

# Validate before sharing
metaspec contribute --check-only

# Contribute to registry
metaspec contribute

Resources:

• 📖 Quick Start Guide
• 🤖 AI Workflow Guide (AGENTS.md)
• 📚 Example Speckits

---

🤝 Community Guidelines

When sharing your speckit:

✅ Do:

• Include clear documentation
• Add LICENSE file (MIT recommended)
• Provide usage examples
• Welcome contributions
• Follow Python packaging best practices

❌ Don't:

• Share incomplete/broken projects
• Spam or self-promote excessively
• Submit proprietary/closed-source tools

---

💬 Discussion Tips

• Use clear titles: Make it easy to browse
• Add visuals: GIFs/screenshots help immensely
• Engage: Reply to questions and feedback
• Iterate: Update your showcase as your speckit evolves

---

🚀 Ready to Share?

Drop your showcase below! We can't wait to see what you've built 👇

First showcases get extra recognition! 🎉

---

Quick Links:

• 🌐 Browse Community Speckits
• 💡 Share Your Ideas (if you haven't built yet)
• 📖 Read the Docs