@girardmedia/bootspring 1.2.0 → 2.0.3

package/agents/partnerships-expert/context.md

@@ -1,286 +0,0 @@
-# Partnerships Expert Agent
-
-## Role
-Specialized in strategic partnerships, integrations, channel partnerships, and building partnership ecosystems for startups.
-
-## Core Expertise
-
-### Partnership Types
-
-```markdown
-## Partnership Categories
-
-### 1. Technology/Integration Partners
-- **What**: Integrate products together
-- **Value**: Better user experience, expanded capabilities
-- **Examples**: Slack + Salesforce, Stripe + Shopify
-- **Revenue**: Usually co-marketing, no rev share
-
-### 2. Channel/Reseller Partners
-- **What**: Partner sells your product
-- **Value**: Extended sales reach
-- **Examples**: MSPs, agencies, consultants
-- **Revenue**: 15-30% commission
-
-### 3. Strategic/OEM Partners
-- **What**: Deep product integration
-- **Value**: Access to customer base
-- **Examples**: White-label, embedded solutions
-- **Revenue**: Revenue share or licensing
-
-### 4. Affiliate Partners
-- **What**: Referral for commission
-- **Value**: Low-cost customer acquisition
-- **Examples**: Influencers, content creators
-- **Revenue**: 10-30% of first year
-
-### 5. Co-Marketing Partners
-- **What**: Joint marketing efforts
-- **Value**: Audience sharing
-- **Examples**: Webinars, content, events
-- **Revenue**: Leads, no direct revenue
-```
-
-### Partnership Evaluation
-
-```markdown
-## Partner Evaluation Framework
-
-### Strategic Fit (1-10)
-- [ ] Complementary products?
-- [ ] Shared target customer?
-- [ ] Aligned values/culture?
-- [ ] Similar growth stage?
-
-### Market Opportunity (1-10)
-- [ ] Partner's customer base size?
-- [ ] Overlap with our ICP?
-- [ ] Growth trajectory?
-- [ ] Geographic coverage?
-
-### Execution Ability (1-10)
-- [ ] Technical capability?
-- [ ] Dedicated partnership team?
-- [ ] Track record of partnerships?
-- [ ] Bandwidth to execute?
-
-### Risk Assessment (1-10)
-- [ ] Competitive risk?
-- [ ] Dependency risk?
-- [ ] Brand risk?
-- [ ] Technical risk?
-
-### Scoring
-| Factor | Weight | Score |
-|--------|--------|-------|
-| Strategic Fit | 30% | X |
-| Market Opportunity | 30% | X |
-| Execution Ability | 25% | X |
-| Risk (inverted) | 15% | X |
-| **Total** | 100% | X |
-```
-
-### Integration Partnership Playbook
-
-```markdown
-## Integration Partnership Process
-
-### Phase 1: Discovery
-- [ ] Identify potential partners
-- [ ] Research their ecosystem
-- [ ] Find internal champion
-- [ ] Initial outreach
-
-### Phase 2: Alignment
-- [ ] Discovery call
-- [ ] Share integration concept
-- [ ] Understand their requirements
-- [ ] Define mutual value
-
-### Phase 3: Planning
-- [ ] Technical requirements
-- [ ] Timeline and milestones
-- [ ] Resource allocation
-- [ ] Success metrics
-
-### Phase 4: Build
-- [ ] API/integration development
-- [ ] Documentation
-- [ ] Testing
-- [ ] Security review
-
-### Phase 5: Launch
-- [ ] Marketplace listing
-- [ ] Co-marketing announcement
-- [ ] Customer communication
-- [ ] Sales enablement
-
-### Phase 6: Ongoing
-- [ ] Monitor usage
-- [ ] Gather feedback
-- [ ] Iterate and improve
-- [ ] Expand collaboration
-
-## Integration Checklist
-- OAuth/authentication setup
-- API documentation
-- Sandbox/test environment
-- Marketplace listing content
-- Launch blog post
-- Demo video
-```
-
-### Partner Agreement Essentials
-
-```markdown
-## Partnership Agreement Key Terms
-
-### Scope
-- Partnership type and activities
-- Geographic territory
-- Customer segments
-- Exclusivity (if any)
-
-### Commercial Terms
-| Item | Detail |
-|------|--------|
-| Revenue share | X% of revenue generated |
-| Payment terms | Net 30/60/90 |
-| Minimum commitment | $X or X customers |
-| Term | X years with renewal |
-
-### Responsibilities
-
-**Your Responsibilities**
-- Provide product/API access
-- Technical support for integration
-- Marketing materials
-- Training and enablement
-
-**Partner Responsibilities**
-- Integration development
-- Customer support (tier 1)
-- Marketing activities
-- Sales/referral activities
-
-### Termination
-- Notice period: 30/60/90 days
-- Cause termination events
-- Wind-down obligations
-- Customer transition
-
-### IP and Branding
-- Trademark usage rights
-- Co-branding guidelines
-- Customer data ownership
-- Integration IP ownership
-```
-
-### Partner Program Structure
-
-```markdown
-## Partner Program Tiers
-
-### Registered Partner
-- **Requirements**: Sign up, complete training
-- **Benefits**:
-  - Partner portal access
-  - Basic co-marketing
-  - 10% referral commission
-
-### Silver Partner
-- **Requirements**: 5 referrals/year, certified
-- **Benefits**:
-  - Listed in directory
-  - Lead sharing
-  - 15% commission
-  - Quarterly business review
-
-### Gold Partner
-- **Requirements**: 15 referrals/year, 2+ certified
-- **Benefits**:
-  - Premium listing
-  - Co-marketing fund ($X)
-  - 20% commission
-  - Dedicated partner manager
-  - Early access to features
-
-### Platinum Partner
-- **Requirements**: 30+ referrals/year, strategic fit
-- **Benefits**:
-  - Featured partner status
-  - Joint sales opportunities
-  - 25% commission
-  - Executive sponsor
-  - Custom integration support
-
-## Partner Enablement
-- Partner portal with resources
-- Certification program
-- Sales playbooks
-- Technical training
-- Marketing assets
-```
-
-### Co-Marketing Activities
-
-```markdown
-## Co-Marketing Playbook
-
-### Joint Content
-- [ ] Co-authored blog post
-- [ ] Joint webinar
-- [ ] Case study featuring both
-- [ ] Integration guide
-
-### Social Amplification
-- [ ] Launch announcement tweets
-- [ ] LinkedIn posts
-- [ ] Newsletter inclusion
-- [ ] Community posts
-
-### Events
-- [ ] Joint booth at conference
-- [ ] Co-hosted meetup
-- [ ] Partner spotlight at event
-
-### Campaigns
-- [ ] Joint email campaign
-- [ ] Landing page
-- [ ] Promotional offer
-
-## Co-Marketing Brief Template
-```markdown
-### Campaign: [Name]
-
-**Partners**: [Company A] + [Company B]
-**Goal**: [Leads, awareness, etc.]
-**Timeline**: [Dates]
-
-**Assets Needed**
-- [ ] Asset 1 - Owner - Due
-- [ ] Asset 2 - Owner - Due
-
-**Distribution**
-- Channel 1: [Owner]
-- Channel 2: [Owner]
-
-**Success Metrics**
-- Metric 1: Target
-- Metric 2: Target
-```
-```
-
-## Partnerships Checklist
-
-- [ ] Partnership strategy defined
-- [ ] Target partners identified
-- [ ] Outreach templates created
-- [ ] Agreement template ready
-- [ ] Partner portal set up
-- [ ] Enablement materials created
-- [ ] Tracking system in place
-- [ ] Success metrics defined
-
-## Trigger Keywords
-partnership, integration, partner, channel, reseller, affiliate, co-marketing, ecosystem, API, marketplace, alliance, collaboration

package/agents/payment-expert/context.md

@@ -1,340 +0,0 @@
-# Payment Expert Agent
-
-## Role
-Specialized in payment processing, subscription management, Stripe integration, and billing systems for SaaS applications.
-
-## Core Expertise
-
-### Stripe Integration
-
-```typescript
-// lib/stripe.ts
-import Stripe from 'stripe';
-
-export const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
-  apiVersion: '2024-12-18.acacia',
-  typescript: true,
-});
-
-// Price IDs from Stripe Dashboard
-export const PLANS = {
-  FREE: { priceId: null, name: 'Free', price: 0 },
-  PRO: {
-    priceId: process.env.STRIPE_PRO_PRICE_ID!,
-    name: 'Pro',
-    price: 29,
-  },
-  TEAM: {
-    priceId: process.env.STRIPE_TEAM_PRICE_ID!,
-    name: 'Team',
-    price: 99,
-  },
-} as const;
-```
-
-### Checkout Session
-
-```typescript
-// app/api/checkout/route.ts
-import { stripe } from '@/lib/stripe';
-import { auth } from '@/lib/auth';
-
-export async function POST(req: Request) {
-  const session = await auth();
-  if (!session?.user) {
-    return Response.json({ error: 'Unauthorized' }, { status: 401 });
-  }
-
-  const { priceId } = await req.json();
-
-  // Get or create Stripe customer
-  let customerId = await getStripeCustomerId(session.user.id);
-
-  if (!customerId) {
-    const customer = await stripe.customers.create({
-      email: session.user.email!,
-      metadata: { userId: session.user.id },
-    });
-    customerId = customer.id;
-    await saveStripeCustomerId(session.user.id, customerId);
-  }
-
-  // Create checkout session
-  const checkoutSession = await stripe.checkout.sessions.create({
-    customer: customerId,
-    mode: 'subscription',
-    payment_method_types: ['card'],
-    line_items: [{ price: priceId, quantity: 1 }],
-    success_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard?success=true`,
-    cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/pricing?canceled=true`,
-    subscription_data: {
-      metadata: { userId: session.user.id },
-    },
-  });
-
-  return Response.json({ url: checkoutSession.url });
-}
-```
-
-### Webhook Handler
-
-```typescript
-// app/api/webhooks/stripe/route.ts
-import { stripe } from '@/lib/stripe';
-import { headers } from 'next/headers';
-import Stripe from 'stripe';
-
-export async function POST(req: Request) {
-  const body = await req.text();
-  const signature = headers().get('stripe-signature')!;
-
-  let event: Stripe.Event;
-
-  try {
-    event = stripe.webhooks.constructEvent(
-      body,
-      signature,
-      process.env.STRIPE_WEBHOOK_SECRET!
-    );
-  } catch (err) {
-    console.error('Webhook signature verification failed');
-    return Response.json({ error: 'Invalid signature' }, { status: 400 });
-  }
-
-  switch (event.type) {
-    case 'checkout.session.completed': {
-      const session = event.data.object as Stripe.Checkout.Session;
-      await handleCheckoutComplete(session);
-      break;
-    }
-
-    case 'customer.subscription.updated': {
-      const subscription = event.data.object as Stripe.Subscription;
-      await handleSubscriptionUpdate(subscription);
-      break;
-    }
-
-    case 'customer.subscription.deleted': {
-      const subscription = event.data.object as Stripe.Subscription;
-      await handleSubscriptionCanceled(subscription);
-      break;
-    }
-
-    case 'invoice.payment_failed': {
-      const invoice = event.data.object as Stripe.Invoice;
-      await handlePaymentFailed(invoice);
-      break;
-    }
-  }
-
-  return Response.json({ received: true });
-}
-
-async function handleCheckoutComplete(session: Stripe.Checkout.Session) {
-  const userId = session.metadata?.userId;
-  const subscriptionId = session.subscription as string;
-
-  const subscription = await stripe.subscriptions.retrieve(subscriptionId);
-
-  await prisma.subscription.create({
-    data: {
-      userId,
-      stripeSubscriptionId: subscriptionId,
-      stripePriceId: subscription.items.data[0].price.id,
-      status: subscription.status,
-      currentPeriodStart: new Date(subscription.current_period_start * 1000),
-      currentPeriodEnd: new Date(subscription.current_period_end * 1000),
-    },
-  });
-}
-```
-
-### Customer Portal
-
-```typescript
-// app/api/portal/route.ts
-import { stripe } from '@/lib/stripe';
-import { auth } from '@/lib/auth';
-
-export async function POST() {
-  const session = await auth();
-  if (!session?.user) {
-    return Response.json({ error: 'Unauthorized' }, { status: 401 });
-  }
-
-  const customerId = await getStripeCustomerId(session.user.id);
-  if (!customerId) {
-    return Response.json({ error: 'No subscription' }, { status: 400 });
-  }
-
-  const portalSession = await stripe.billingPortal.sessions.create({
-    customer: customerId,
-    return_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard`,
-  });
-
-  return Response.json({ url: portalSession.url });
-}
-```
-
-### Usage-Based Billing
-
-```typescript
-// lib/usage.ts
-import { stripe } from '@/lib/stripe';
-
-// Report usage for metered billing
-export async function reportUsage(
-  subscriptionItemId: string,
-  quantity: number
-) {
-  await stripe.subscriptionItems.createUsageRecord(subscriptionItemId, {
-    quantity,
-    timestamp: Math.floor(Date.now() / 1000),
-    action: 'increment', // or 'set'
-  });
-}
-
-// Track API calls
-export async function trackApiUsage(userId: string) {
-  const subscription = await getSubscription(userId);
-  if (!subscription?.meteredItemId) return;
-
-  await reportUsage(subscription.meteredItemId, 1);
-}
-```
-
-### Subscription Helpers
-
-```typescript
-// lib/subscription.ts
-import { stripe } from '@/lib/stripe';
-import { prisma } from '@/lib/db';
-
-export async function getSubscription(userId: string) {
-  return prisma.subscription.findUnique({
-    where: { userId },
-  });
-}
-
-export async function isSubscribed(userId: string): Promise<boolean> {
-  const subscription = await getSubscription(userId);
-  return subscription?.status === 'active';
-}
-
-export async function getPlan(userId: string) {
-  const subscription = await getSubscription(userId);
-  if (!subscription) return 'FREE';
-
-  // Map price ID to plan
-  const priceId = subscription.stripePriceId;
-  if (priceId === process.env.STRIPE_PRO_PRICE_ID) return 'PRO';
-  if (priceId === process.env.STRIPE_TEAM_PRICE_ID) return 'TEAM';
-
-  return 'FREE';
-}
-
-export async function cancelSubscription(userId: string) {
-  const subscription = await getSubscription(userId);
-  if (!subscription) throw new Error('No subscription');
-
-  await stripe.subscriptions.update(subscription.stripeSubscriptionId, {
-    cancel_at_period_end: true,
-  });
-
-  await prisma.subscription.update({
-    where: { userId },
-    data: { cancelAtPeriodEnd: true },
-  });
-}
-```
-
-### Pricing Page Component
-
-```tsx
-// components/pricing.tsx
-'use client';
-
-import { useState } from 'react';
-import { Button } from '@/components/ui/button';
-
-const plans = [
-  {
-    name: 'Free',
-    price: 0,
-    features: ['1 project', 'Basic features', 'Community support'],
-  },
-  {
-    name: 'Pro',
-    price: 29,
-    priceId: process.env.NEXT_PUBLIC_STRIPE_PRO_PRICE_ID,
-    features: ['Unlimited projects', 'All features', 'Priority support'],
-    popular: true,
-  },
-  {
-    name: 'Team',
-    price: 99,
-    priceId: process.env.NEXT_PUBLIC_STRIPE_TEAM_PRICE_ID,
-    features: ['Everything in Pro', 'Team collaboration', 'Admin controls'],
-  },
-];
-
-export function Pricing() {
-  const [loading, setLoading] = useState<string | null>(null);
-
-  async function handleSubscribe(priceId: string) {
-    setLoading(priceId);
-    const res = await fetch('/api/checkout', {
-      method: 'POST',
-      body: JSON.stringify({ priceId }),
-    });
-    const { url } = await res.json();
-    window.location.href = url;
-  }
-
-  return (
-    <div className="grid md:grid-cols-3 gap-8">
-      {plans.map((plan) => (
-        <div
-          key={plan.name}
-          className={`p-8 border rounded-lg ${
-            plan.popular ? 'border-blue-500 shadow-lg' : ''
-          }`}
-        >
-          <h3 className="text-xl font-bold">{plan.name}</h3>
-          <p className="text-3xl font-bold mt-4">
-            ${plan.price}<span className="text-sm">/mo</span>
-          </p>
-          <ul className="mt-6 space-y-2">
-            {plan.features.map((feature) => (
-              <li key={feature}>✓ {feature}</li>
-            ))}
-          </ul>
-          {plan.priceId && (
-            <Button
-              className="w-full mt-8"
-              onClick={() => handleSubscribe(plan.priceId!)}
-              disabled={loading === plan.priceId}
-            >
-              {loading === plan.priceId ? 'Loading...' : 'Subscribe'}
-            </Button>
-          )}
-        </div>
-      ))}
-    </div>
-  );
-}
-```
-
-## Payment Checklist
-
-- [ ] Stripe account created
-- [ ] Products/prices configured
-- [ ] Checkout integration complete
-- [ ] Webhook handler implemented
-- [ ] Customer portal enabled
-- [ ] Subscription status tracking
-- [ ] Email notifications set up
-- [ ] Testing with test mode
-
-## Trigger Keywords
-payment, stripe, subscription, billing, checkout, pricing, invoice, webhook, customer, SaaS, recurring, metered