mvp-automation

name	mvp-automation
description	Orquesta el flujo completo de MVP automatizado: SPEC → Historias → Tareas → Skills. Genera skills especializadas para cada tarea para que los agentes paralelos tengan conocimiento contextual específico.
metadata	{"author":"vicente-rivas","version":"2.0","category":"orchestration"}

MVP Automation - Flujo Completo Automatizado

Resumen

Este skill orquesta la creación automatizada de un MVP completo, generando no solo la especificación, sino también:

1. Historias de Usuario desde el SPEC
2. Tareas paralelas desde cada historia
3. Skills especializadas para cada tarea

Flujo Automatizado

┌─────────────────────────────────────────────────────────────────┐
│                    MVP AUTOMATION FLOW                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  /project:interview <nombre>                                    │
│           │                                                     │
│           ▼                                                     │
│     ┌─────────────┐                                             │
│     │   SPEC.md   │  ← Entrevista profunda                      │
│     └──────┬──────┘                                             │
│            │                                                    │
│            ▼ [Usuario confirma]                                 │
│                                                                 │
│  /mvp:auto-generate                                             │
│           │                                                     │
│           ├──────────────────────────────────────┐              │
│           ▼                                      ▼              │
│     ┌─────────────┐                       ┌─────────────┐       │
│     │  H001.md    │                       │  H002.md    │  ...  │
│     │  Historia 1 │                       │  Historia 2 │       │
│     └──────┬──────┘                       └──────┬──────┘       │
│            │                                     │              │
│            ▼                                     ▼              │
│     ┌─────────────┐                       ┌─────────────┐       │
│     │  T001.md    │                       │  T003.md    │       │
│     │  T002.md    │                       │  T004.md    │       │
│     └──────┬──────┘                       └──────┬──────┘       │
│            │                                     │              │
│            ▼                                     ▼              │
│     ┌─────────────┐                       ┌─────────────┐       │
│     │ SKILL-T001  │                       │ SKILL-T003  │       │
│     │ SKILL-T002  │                       │ SKILL-T004  │       │
│     └─────────────┘                       └─────────────┘       │
│                                                                 │
│            │ [Skills generadas]                                 │
│            ▼                                                    │
│                                                                 │
│  /swarm:launch N   ← Agentes con skills especializadas          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Comandos

/project:interview <nombre>

Inicia entrevista profunda para generar SPEC.md (ya existente).

/mvp:auto-generate

Nuevo comando que tras confirmar el SPEC:

1. Genera historias de usuario automáticamente
2. Divide cada historia en tareas paralelas
3. Crea una skill especializada para cada tarea
4. Prepara el entorno para /swarm:launch

/skill:generate <task-id>

Genera una skill especializada para una tarea específica.

/skill:batch <story-id>

Genera skills para todas las tareas de una historia.

Estructura de Archivos Generados

.claude/
├── specs/
│   └── PROYECTO-SPEC.md
├── stories/
│   ├── H001-feature-name.md
│   ├── H002-another-feature.md
│   └── STORIES-INDEX.md
├── tasks/
│   ├── T001-task-name.md
│   ├── T002-task-name.md
│   └── TASKS-INDEX.md
└── skills/
    └── generated/
        └── PROYECTO/
            ├── T001-skill/
            │   └── SKILL.md
            ├── T002-skill/
            │   └── SKILL.md
            └── INDEX.md

Generación de Skills

Cada skill generada incluye:

1. Conocimiento Contextual

• Resumen de la historia padre
• Criterios de aceptación específicos
• Dependencias con otras tareas

2. Patrones Recomendados

• Patrones de código específicos del stack
• Mejores prácticas para el tipo de tarea
• Ejemplos de implementación similares

3. Anti-patterns

• Errores comunes a evitar
• Trampas específicas del dominio

4. Checklist de Completitud

• Criterios verificables para "done"
• Tests requeridos
• Integración esperada

Ejemplo de Skill Generada

---
name: T001-supabase-auth
description: |
  Implementa autenticación con Supabase SSR para Next.js 14.
  Incluye middleware de protección de rutas y providers de contexto.
metadata:
  author: mvp-automation
  version: "1.0"
  category: auth
  story_id: H001
  task_id: T001
---

# T001: Configurar Autenticación Supabase

## Contexto

**Historia**: H001 - Sistema de Autenticación **Tarea**: Configurar cliente
Supabase con SSR

## Conocimiento Especializado

### Supabase SSR en Next.js 14

- Usar `@supabase/ssr` en lugar de `@supabase/auth-helpers-nextjs`
- Crear cliente separado para browser y server
- Middleware para refresh de tokens

### Patrones Recomendados

```typescript
// lib/supabase/server.ts
import { createServerClient } from "@supabase/ssr";
import { cookies } from "next/headers";

export async function createClient() {
  const cookieStore = await cookies();
  return createServerClient(url, key, {
    cookies: {
      getAll: () => cookieStore.getAll(),
      setAll: (cookiesToSet) => {
        cookiesToSet.forEach(({ name, value, options }) =>
          cookieStore.set(name, value, options),
        );
      },
    },
  });
}
```

Anti-patterns

• ❌ No usar createBrowserClient en Server Components
• ❌ No almacenar tokens en localStorage
• ❌ No olvidar el middleware para refresh

Checklist

• Cliente browser en lib/supabase/client.ts
• Cliente server en lib/supabase/server.ts
• Middleware en middleware.ts
• AuthProvider con contexto
• Rutas protegidas funcionando

## Integración con Agentes Paralelos

Cuando se lanza `/swarm:launch`:

1. Cada agente recibe su tarea asignada
2. El agente carga automáticamente la skill correspondiente
3. La skill proporciona contexto y guía específica
4. El agente ejecuta con conocimiento especializado

## Configuración del Worktree

```bash
# En cada worktree, el archivo .claude/PROMPT.md incluye:
# 1. La tarea específica
# 2. Referencia a la skill generada
# 3. Contexto de la historia

cat trees/T001/.claude/PROMPT.md
# ---
# Tarea: T001 - Configurar Autenticación Supabase
# Skill: .claude/skills/generated/PROYECTO/T001-skill/SKILL.md
# Historia: H001 - Sistema de Autenticación
# ---
# [Contenido de la tarea]

Beneficios

1. Agentes más inteligentes: Cada agente tiene conocimiento específico
2. Menos errores: Anti-patterns documentados previenen problemas
3. Consistencia: Patrones estandarizados en todo el proyecto
4. Trazabilidad: Cada skill vinculada a su tarea e historia
5. Reutilización: Skills pueden servir para proyectos similares

Próximos Pasos

Tras ejecutar /mvp:auto-generate:

1. Revisar skills generadas (ajustar si necesario)
2. Ejecutar /swarm:launch N con el número de agentes
3. Monitorear con /swarm:status
4. Integrar con /swarm:integrate