Package Spike MCP Server

SpikeMe

Gerador de documentos de spike com IA. Envie o package.json do seu projeto, escolha um tema, e receba em streaming um documento de decisão técnica completo: opções comparadas com a sua stack real (com downloads, versão, licença e bundle de cada uma — fatos vivos do npm, com fonte e data de coleta), recomendação opinativa e plano de prova de conceito. SaaS: conta com magic link/Google, plano Free (1 spike + 1 kit/mês) e assinaturas Starter/Pro via Stripe. A chave da IA vive no backend, nunca no navegador.

Como funciona

1. Stack — arraste (ou cole) o package.json. A análise é 100% local: detecta framework, build, categorias de dependências e lacunas da stack (sem testes E2E? sem lib de estado?).
2. Tema — escreva o tema do spike ou toque numa sugestão gerada pela análise. Ajuste profundidade (rápido/completo), quantas opções comparar (2–4) e idioma (PT-BR/EN).
3. Documento — a IA "escreve" o documento (typewriter sobre o streaming), renderizado em markdown com syntax highlight nas cores do tema: objetivo e critérios, opções com snippets, tabela comparativa, recomendação, plano de PoC com timebox, riscos e critérios de aceite. Copie, baixe o .md, exporte como ADR (formato MADR) ou compartilhe por link público (/s/<slug>). Cada spike fica salvo em Meus spikes para reabrir depois.
4. Kit do time — a aba já nasce junto com o documento (empty state com a action); gere (opt-in) um kit de adoção no formato do agente de IA que o time usa — Claude Code (.claude/), Cursor (.cursor/rules/), GitHub Copilot (.github/instructions|prompts/) ou Codex/AGENTS.md (docs/ai/, padrão aberto usado pelo Codex da OpenAI) — via structured outputs (JSON garantido por schema). Cards com copiar individual, arquivo expansível e Baixar kit (.zip) com o spike incluído em docs/. A aba também lista fontes públicas para comparar com skills mantidas pela comunidade: skills.sh (npx skills add <owner>/<skill>), anthropics/skills, github/awesome-copilot, cursor.directory e agents.md.

Rodando

O app inteiro (site de marketing + wizard em /app) vive em marketing/:

cd marketing
pnpm install
pnpm dev          # desenvolvimento (Next.js)
pnpm test         # testes do analisador e prompts (Vitest)
pnpm type-check   # tsc --noEmit
pnpm build        # build de produção
pnpm start        # serve o build

Verificação end-to-end (Playwright — ver docs/testing-e2e.md):

cd marketing
pnpm test:e2e

Segurança & arquitetura SaaS

Front Next.js SSR (marketing/) + Supabase (Auth, Postgres/RLS, Edge Functions) + Stripe. Detalhes de setup no DEPLOY.md.

• Chave da IA no servidor: as edge functions (generate-spike, generate-kit) guardam a ANTHROPIC_API_KEY, validam o JWT do usuário, reivindicam cota antes de gastar tokens (claim_usage, atômico, com refund em falha) e repassam o streaming.
• Cotas por plano (fonte da verdade no SQL plan_limits): Free 1 spike/0 kit · Starter 5/2 · Pro ilimitado com teto diário de fair use (20/10).
• Billing: Stripe Checkout + Customer Portal; webhook mantém profiles.plan sincronizado com a assinatura.
• Login fácil: magic link por e-mail ou Google — criar conta e entrar são o mesmo gesto.
• CSP: connect-src restrito a api.spikeme.io e *.supabase.co (ver marketing/next.config.ts).
• Guardrails de escopo: tema em <spike_topic> como dado (escape removido, 500 chars) e recusa estruturada "Fora do escopo" no system prompt.
• Resiliência: ErrorBoundary com retry e sessão do wizard em sessionStorage — reload/crash restaura onde você estava.
• Privacidade: o package.json é analisado no navegador; só o resumo derivado vai para a geração.

Stack

Next.js 15 (App Router) · React 19 · TypeScript · Tailwind CSS 4 · Motion (animações) · Geist / Geist Mono · rehype-highlight (syntax highlight) · i18n próprio PT-BR/EN (wizard) · Supabase (auth+DB+functions) · Stripe · react-markdown + GFM · Vitest · Playwright

Arquitetura

O app único vive em marketing/:

marketing/
  app/
    (site)/        # marketing: home, /precos, /blog, /comparativos, /privacidade, /termos
    app/            # rota /app — ilha client-only que monta o wizard
    not-found.tsx   # 404 com o chrome do site
  wizard/
    lib/
      analyzer.ts   # parse + detecção de stack + lacunas (puro, testado)
      prompt.ts     # system/user prompt do documento de spike
      llm.ts        # transporte gerenciado (edge functions + SSE) e erros de cota/auth
      auth.tsx      # conta, plano e cota (contexto sobre o Supabase Auth)
      kit.ts        # schema, prompt e caminhos do kit do time (puro, testado)
      storage.ts    # sessão do wizard (restauração pós-reload)
    components/     # stepper, auth, pricing, paywall, primitivos
  components/       # SiteHeader/SiteFooter e demais componentes do site
  content/blog/     # posts em MDX
  lib/              # copy da home, planos, constantes do site (SITE_URL etc.)
  e2e/              # Playwright: marketing.spec.ts (smoke do site) + wizard/ (port dos specs do app)
supabase/
  migrations/       # perfis, uso, plan_limits, claim/refund_usage (RLS)
  functions/        # generate-spike|kit, create-checkout|portal, stripe-webhook