Nuevo Proyecto

Inicializar

/gsd:new-project

Con flag --auto para menos interaccion:

/gsd:new-project --auto

Ciclo de discovery

El comando ejecuta un ciclo completo de descubrimiento:

1. Preguntas

GSD hace preguntas para clarificar:

• Objetivos del proyecto
• Restricciones tecnicas
• Preferencias de stack
• Casos borde conocidos
• Alcance de la v1

2. Investigacion paralela

Lanza 4 agentes investigadores en paralelo:

Agente	Investiga
Stack	Tecnologias, versiones, compatibilidad
Features	Patrones de implementacion, referentes
Arquitectura	Estructura, escalabilidad, trade-offs
Pitfalls	Problemas comunes, gotchas, anti-patrones

Los resultados se guardan en .planning/research/.

3. Extraccion de requisitos

Separa los requisitos en tres categorias:

## v1 (alcance actual)
- REQ-001: Login con email y password
- REQ-002: Dashboard con metricas basicas

## v2 (futuro)
- REQ-010: Login con OAuth
- REQ-011: Dashboard con graficos avanzados

## Fuera de alcance
- Aplicacion movil
- Internacionalizacion

4. Creacion del roadmap

Mapea fases a requisitos:

## Phase 1: Foundation
- Setup proyecto y CI/CD
- Estructura de base de datos

## Phase 2: Auth
- REQ-001: Login con email/password
- REQ-003: Registro de usuarios

## Phase 3: Dashboard
- REQ-002: Dashboard con metricas

Archivos generados

Archivo	Proposito	Carga
PROJECT.md	Vision del proyecto, siempre cargado	Automatica
REQUIREMENTS.md	Requisitos v1/v2/fuera de alcance	Bajo demanda
ROADMAP.md	Fases con progreso	Bajo demanda
STATE.md	Decisiones, blockers, posicion actual	Automatica
.planning/research/	Investigacion de los 4 agentes	Bajo demanda

PROJECT.md

Es el archivo mas importante — siempre cargado en contexto:

# Mi App

## Vision
Plataforma de gestion de tareas para equipos remotos.

## Stack
- Next.js 14, TypeScript, Tailwind
- PostgreSQL con Prisma
- Deploy en Vercel

## Decisiones clave
- JWT sin refresh (sesiones de 24h)
- Server components por defecto

STATE.md

Memoria entre sesiones:

## Current Position
Phase 2, Plan 1 complete, Plan 2 in progress

## Decisions
- Usar bcrypt para hashing (discutido en Phase 2)

## Blockers
- Ninguno

## Notes
- El usuario prefiere forms sin librerias externas

Brownfield: proyecto existente

Si ya tienes codigo, ejecuta primero:

/gsd:map-codebase

Analiza la estructura existente antes de new-project. Esto permite que GSD entienda convenciones, dependencias y patrones ya establecidos.

Resumen

• /gsd:new-project ejecuta un ciclo completo de discovery
• 4 agentes investigan en paralelo: stack, features, arquitectura, pitfalls
• Separa requisitos en v1, v2 y fuera de alcance
• Genera PROJECT.md (vision), REQUIREMENTS.md, ROADMAP.md y STATE.md
• Para proyectos existentes: /gsd:map-codebase primero

---

← Instalacion | Indice | Siguiente: Fase Discuss →