🚀 AI Scaffold

Generador inteligente de proyectos full-stack que utiliza agentes IA especializados para crear arquitecturas production-ready de Angular + Express + MongoDB.

📋 Características

• ✨ Generación automática de proyectos full-stack
• 🤖 Múltiples agentes IA especializados
• 🎯 Wizard interactivo con vista previa en tiempo real
• 📦 Configuración predefinida (presets)
• 🛠️ Soporte para instalación automática de dependencias
• 📝 Generación de prompts personalizados para Claude
• 🎨 Stack moderno: Angular 19 + PrimeNG + Tailwind + Express + MongoDB

📦 Instalación

Opción 1: Global (recomendado)

npm install -g ai-scaffold
ai-scaffold --wizard

Opción 2: Local

git clone <repo-url>
cd ai-scaffold
npm install
npm start

Opción 3: npx

npx ai-scaffold --wizard

🎮 Uso

Modo Rápido con Stack Personalizado (Recomendado)

# ¡CUALQUIER combinación sin necesidad de presets!
ai-scaffold --stack Angular:FastAPI:Supabase
ai-scaffold --stack React:NestJS:PostgreSQL -o my-dashboard
ai-scaffold -s Vue:Go:MySQL -n "Mi Proyecto"

# Stacks soportados:
# Frontend: Angular, React, Vue, Next.js, Svelte, Nuxt
# Backend:  Node/Express, NestJS, FastAPI, Django, Laravel, Go/Gin
# Database: MongoDB, PostgreSQL, MySQL, Prisma+Postgres, SQLite, Supabase

Modo Interactivo (Wizard)

ai-scaffold --wizard

Abre un navegador con el constructor visual donde puedes:

1. Definir el nombre y objetivo del proyecto
2. Seleccionar el rol de IA principal
3. Configurar el stack tecnológico
4. Revisar los agentes especializados
5. Exportar la configuración al CLI

Modo por Configuración

# Con preset existente
ai-scaffold --config config/my-preset.json

# Solo scaffold (sin prompt)
ai-scaffold --config config/my-preset.json --scaffold

# Solo prompt (sin carpetas)
ai-scaffold --config config/my-preset.json --prompt

# Especificar ruta de salida del prompt
ai-scaffold --config config/my-preset.json --out-prompt my-prompt.txt

Modo Rápido

# Con nombres de carpeta personalizados
ai-scaffold

# Sin instalar dependencias
ai-scaffold --no-install

📋 Opciones de CLI

| Opción | Descripción | Ejemplo | |--------|-------------|---------| | --wizard | Abre el constructor visual | ai-scaffold --wizard | | --wizard-port <n> | Puerto del wizard | ai-scaffold --wizard --wizard-port 8080 | | --config <ruta> | Carga un preset JSON | ai-scaffold --config preset.json | | --scaffold | Solo crea carpetas | ai-scaffold --scaffold | | --prompt | Solo genera prompt | ai-scaffold --prompt | | --both | Ambos (default) | ai-scaffold --both | | --out-prompt <ruta> | Ruta del prompt | ai-scaffold --out-prompt my.txt | | --no-install | Omite npm install | ai-scaffold --no-install | | --init-config <ruta> | Crea preset por defecto | ai-scaffold --init-config preset.json | | --help | Muestra ayuda | ai-scaffold --help |

🤖 Agentes Especializados

El proyecto incluye 6 agentes IA con responsabilidades únicas:

1. Arquitecto de Sistema

Diseña la estructura general del proyecto, patrones de comunicación, flujos de datos y decisiones arquitectónicas fundamentales. Define cómo cliente y servidor interactúan, organiza módulos y establece estándares de código.

2. Ingeniero Frontend

Desarrolla la interfaz de usuario en Angular, componentes reutilizables, routing, manejo de estados con servicios, integración con librerías de UI (PrimeNG) y responsive design. Optimiza performance y UX.

3. Ingeniero Backend

Construye API RESTful con Express, define esquemas de datos MongoDB/Mongoose, implementa autenticación/autorización, valida datos, maneja errores y optimiza consultas a base de datos.

4. Especialista en Base de Datos

Diseña esquemas MongoDB, índices, relaciones entre colecciones, estrategias de escalabilidad, backup y recuperación. Asegura integridad y performance de datos.

5. Ingeniero de DevOps

Configura entorno de desarrollo y producción, containerización (Docker), CI/CD pipelines, variables de entorno, logs, monitoreo y deployment en plataformas cloud.

6. QA y Testing

Implementa pruebas unitarias, pruebas de integración, pruebas E2E, fixtures de datos, coverage analysis y procedimientos de validación para garantizar calidad del código.

🆕 ¡Soporte Multi-Stack!

Ahora puedes generar proyectos con CUALQUIER combinación de tecnologías:

• 6 Frontends: Angular, React, Vue, Next.js, Svelte, Nuxt
• 6 Backends: Node/Express, NestJS, FastAPI, Django, Laravel, Go/Gin
• 6 Databases: MongoDB, PostgreSQL, MySQL, Prisma+Postgres, SQLite, Supabase

¡216 combinaciones posibles sin necesidad de crear archivos preset!

Ver MULTI_STACK_GUIDE.md para la guía completa.

📁 Estructura del Proyecto Generado

proyecto-generado/
├── frontend/                    # Aplicación Angular
│   ├── src/
│   │   ├── app/
│   │   │   ├── components/
│   │   │   ├── services/
│   │   │   ├── models/
│   │   │   └── app.component.ts
│   │   └── styles/
│   ├── angular.json
│   ├── package.json
│   └── tsconfig.json
│
├── backend/                     # Servidor Express
│   ├── models/                  # Esquemas Mongoose
│   ├── routes/                  # Endpoints API
│   ├── controllers/             # Lógica de negocio
│   ├── middleware/              # Auth, validation, etc
│   ├── server.js
│   ├── package.json
│   └── .env
│
├── prompt-proyecto.txt          # Instrucciones para IA
└── README.md                    # Documentación

🎯 Flujo de Trabajo

1. Generar Proyecto

ai-scaffold --wizard

2. Revisar Configuración

El sistema genera un prompt detallado en prompt-proyecto.txt con instrucciones específicas para cada agente.

3. Enviar a Claude

Copia el contenido de prompt-proyecto.txt y pégalo en Claude con el siguiente formato:

Tu nombre: [Rol específico del agente]

[Contenido del prompt generado]

4. Implementar

Los agentes desarrollarán el proyecto siguiendo las especificaciones del prompt.

⚙️ Configuración (Presets)

Los presets son archivos JSON que contienen toda la configuración del proyecto:

{
  "project": {
    "name": "Mi App",
    "role": "senior architect",
    "goal": "crear una app de gestión de tareas"
  },
  "folders": {
    "client": "/frontend",
    "server": "/backend"
  },
  "stack": {
    "client": "Angular 19 + PrimeNG + Tailwind",
    "server": "Node.js + Express + MongoDB/Mongoose",
    "db": "MongoDB"
  },
  "agents": [
    {
      "id": "architect",
      "name": "Arquitecto de Sistema",
      "description": "Diseña la estructura general..."
    },
    ...
  ]
}

📝 Generar un Preset por Defecto

ai-scaffold --init-config config/default-preset.json

🐛 Troubleshooting

El wizard no se abre

ai-scaffold --wizard --wizard-port 3000

Puerto en uso

El sistema intenta usar 4711, luego busca un puerto libre automáticamente.

Dependencias no instaladas

ai-scaffold --no-install
# Luego instala manualmente:
cd frontend && npm install
cd ../backend && npm install

📚 Ejemplos

Crear un CMS simple

ai-scaffold --wizard
# En el wizard:
# Nombre: "Simple CMS"
# Rol: "backend specialist"
# Goal: "Content Management System"
# Enviar al CLI

Crear proyecto con stack personalizado

ai-scaffold --stack React:NestJS:PostgreSQL
ai-scaffold --stack Vue:FastAPI:MySQL

Crear un e-commerce

ai-scaffold --config presets/ecommerce-preset.json

Generar solo el prompt

ai-scaffold --prompt --out-prompt mi-prompt.txt

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el repositorio
2. Crea una rama para tu feature
3. Commit tus cambios
4. Push a la rama
5. Abre un Pull Request

📄 Licencia

MIT - Ver LICENSE para detalles

🔗 Enlaces Útiles

• Angular Documentation
• Express.js
• MongoDB
• PrimeNG Components
• Tailwind CSS

❓ Preguntas Frecuentes

P: ¿Puedo cambiar el stack predefinido?
R: Sí, edita el preset antes de ejecutar o usa el wizard para personalizarlo.

P: ¿Se instalan automáticamente las dependencias?
R: Sí, a menos que uses --no-install.

P: ¿Puedo usar esto sin MongoDB?
R: Sí, modifica el servidor generado para usar otra BD.

P: ¿Los prompts se pueden reutilizar?
R: Sí, guarda los presets en config/ para reutilizarlos.

Hecho con ❤️ por los agentes IA especializados