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:

•Historias de Usuario desde el SPEC
•Tareas paralelas desde cada historia
•Skills especializadas para cada tarea

Flujo Automatizado

code

┌─────────────────────────────────────────────────────────────────┐
│                    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:

•Genera historias de usuario automáticamente
•Divide cada historia en tareas paralelas
•Crea una skill especializada para cada tarea
•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

code

.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

markdown

---
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

code


## 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

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

Próximos Pasos

Tras ejecutar /mvp:auto-generate:

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