Prompt file imported from ArkandiaLabs/workshop-ia-nov2025 (.github/prompts/01-plan-generation.prompt.md). Copyright stays with the author.

Descripción general

Name: 01-plan-generation
Author: ArkandiaLabs

Quiero crear una aplicación full-stack para análisis de empresas SaaS, dirigida a inversionistas que desean evaluar métricas de las compañías más importantes del mundo.

Componentes:

Frontend: Dashboard interactivo con visualización de métricas
Backend: API REST para consultas y filtros
Base de datos: PostgreSQL normalizada en Supabase

Fuente de datos: Dataset de Kaggle - @https://www.kaggle.com/datasets/shreyasdasari7/top-100-saas-companiesstartups

Stack tecnológico

Tecnologías

Frontend

Framework: Next.js 16+ (App Router)
Lenguaje: TypeScript
UI: Tailwind CSS
Ubicación: src/frontend/

Backend

Framework: FastAPI
Lenguaje: Python 3.12+
ORM: SQLAlchemy (async)
Gestor de paquetes: uv
Ubicación: src/backend/

Base de datos

Motor: PostgreSQL via Supabase
Script de creación: scripts/database/01-top-saas-db-creation.sql (ya ejecutado)
Estado: Tablas creadas y con datos cargados

Dataset y modelo de datos

Información del dataset

Fuente: Kaggle - Top 100 SaaS Companies - @https://www.kaggle.com/datasets/shreyasdasari7/top-100-saas-companiesstartups
Registros: 100 empresas
Campos clave:
- Company Name
- Industry/Category
- Location (City, Country)
- Products/Services
- Founded Year
- Total Funding
- Annual Revenue
- Valuation
- Investors (puede ser lista separada por comas)

Esquema de base de datos (ya creado)

Revisar scripts/database/01-top-saas-db-creation.sql para ver:

Tabla companies (principal)
Tabla industries (normalizada)
Tabla locations (normalizada)
Tabla investors (normalizada, si aplica)

Funcionalidades principales

Para la primera versión, las funcionalidades principales son:

Backend

Endpoint para obtener el listado de empresas con filtros de búsqueda por industria y ubicación
Endpoint para obtener las industrias que será usado por el filtro
Endpoint para obtener las ubicaciones que será usado por el filtro

Frontend

Listado de empresas y sus métricas. Los campos a visualizar son:
- Nombre empresa
- Industria
- Ubicación
- Productos
- Fecha de creación
- Total inversión
- Ingresos anuales
- Valoración de la empresa
El listado incluirá filtros de búsqueda por industria y ubicación

Atributos de calidad

Factibilidad. Necesitamos una arquitectura que sea factible de implementar en un tiempo razonable
Mantenibilidad. La arquitectura debe ser fácil de modificar y ampliar en el futuro

Patrón de arquitectura

Backend: Arquitectura por capas

FastAPI (Routers)
    ↓
Services (lógica de negocio)
    ↓
Repositories (acceso a datos)
    ↓
SQLAlchemy Models (ORM)
    ↓
PostgreSQL (Supabase)

Frontend: Arquitectura por capas

Next.js Pages/Components (UI)
    ↓
Custom Hooks (lógica de cliente)
    ↓
API Clients (fetching)
    ↓
Backend API (FastAPI)

Objetivo

Utilizando la plantilla planning_template_es.md, ayúdame a generar el archivo de planeación en la ruta ../../.specs/features/planning.md.

Entregables esperados

Análisis de preguntas críticas
- Identifica las 3 preguntas más relevantes que se requieran para completar el plan
- Para cada pregunta, proporciona:
  - Contexto de por qué es importante
  - 2 opciones de respuesta con pros/contras
  - Tu recomendación fundamentada
Plan de desarrollo detallado
- Desglose de tareas por componente (backend, frontend, database)
- Orden de implementación sugerido
Decisiones arquitectónicas
- Justificación de patrones elegidos
- Trade-offs considerados
- Alternativas descartadas y por qué

Formato de las preguntas

Para cada pregunta, sigue este formato:

Pregunta N: [Título de la pregunta]

Contexto: [Por qué es crítica esta pregunta]

Opciones:

A) [Opción 1]

✅ Pros: ...
❌ Contras: ...
📊 Impacto: ...

B) [Opción 2]

✅ Pros: ...
❌ Contras: ...
📊 Impacto: ...

Recomendación: [Opción recomendada + justificación]

Comenzar

Por favor, comienza analizando el contexto y genera las 3 preguntas críticas antes de proceder con el plan completo.

# Descripción general Quiero crear una aplicación full-stack para análisis de empresas SaaS, dirigida a inversionistas que desean evaluar métricas de las compañías más importantes del mundo. **Componentes:** - **Frontend**: Dashboard interactivo con visualización de métricas - **Backend**: API REST para consultas y filtros - **Base de datos**: PostgreSQL normalizada en Supabase **Fuente de datos:** Dataset de Kaggle - @https://www.kaggle.com/datasets/shreyasdasari7/top-100-saas-companiesstartups --- # Stack tecnológico ## Tecnologías ### Frontend - **Framework**: Next.js 16+ (App Router) - **Lenguaje**: TypeScript - **UI**: Tailwind CSS - **Ubicación**: `src/frontend/` ### Backend - **Framework**: FastAPI - **Lenguaje**: Python 3.12+ - **ORM**: SQLAlchemy (async) - **Gestor de paquetes**: `uv` - **Ubicación**: `src/backend/` ### Base de datos - **Motor**: PostgreSQL via Supabase - **Script de creación**: `scripts/database/01-top-saas-db-creation.sql` (ya ejecutado) - **Estado**: Tablas creadas y con datos cargados --- # Dataset y modelo de datos ## Información del dataset - **Fuente**: Kaggle - Top 100 SaaS Companies - @https://www.kaggle.com/datasets/shreyasdasari7/top-100-saas-companiesstartups - **Registros**: 100 empresas - **Campos clave**: - Company Name - Industry/Category - Location (City, Country) - Products/Services - Founded Year - Total Funding - Annual Revenue - Valuation - Investors (puede ser lista separada por comas) ## Esquema de base de datos (ya creado) Revisar `scripts/database/01-top-saas-db-creation.sql` para ver: - Tabla `companies` (principal) - Tabla `industries` (normalizada) - Tabla `locations` (normalizada) - Tabla `investors` (normalizada, si aplica) --- # Funcionalidades principales Para la primera versión, las funcionalidades principales son: ## Backend - Endpoint para obtener el listado de empresas con filtros de búsqueda por industria y ubicación - Endpoint para obtener las industrias que será usado por el filtro - Endpoint para obtener las ubicaciones que será usado por el filtro ## Frontend - Listado de empresas y sus métricas. Los campos a visualizar son: - Nombre empresa - Industria - Ubicación - Productos - Fecha de creación - Total inversión - Ingresos anuales - Valoración de la empresa - El listado incluirá filtros de búsqueda por industria y ubicación --- # Atributos de calidad - Factibilidad. Necesitamos una arquitectura que sea factible de implementar en un tiempo razonable - Mantenibilidad. La arquitectura debe ser fácil de modificar y ampliar en el futuro --- # Patrón de arquitectura ## Backend: Arquitectura por capas ``` FastAPI (Routers) ↓ Services (lógica de negocio) ↓ Repositories (acceso a datos) ↓ SQLAlchemy Models (ORM) ↓ PostgreSQL (Supabase) ``` ## Frontend: Arquitectura por capas ``` Next.js Pages/Components (UI) ↓ Custom Hooks (lógica de cliente) ↓ API Clients (fetching) ↓ Backend API (FastAPI) ``` --- # Objetivo Utilizando la plantilla [planning_template_es.md](../../.specs/templates/planning_template_es.md), ayúdame a generar el archivo de planeación en la ruta `../../.specs/features/planning.md`. ## Entregables esperados 1. **Análisis de preguntas críticas** - Identifica las **3 preguntas más relevantes** que se requieran para completar el plan - Para cada pregunta, proporciona: - Contexto de por qué es importante - **2 opciones de respuesta** con pros/contras - Tu **recomendación fundamentada** 2. **Plan de desarrollo detallado** - Desglose de tareas por componente (backend, frontend, database) - Orden de implementación sugerido 3. **Decisiones arquitectónicas** - Justificación de patrones elegidos - Trade-offs considerados - Alternativas descartadas y por qué ## Formato de las preguntas Para cada pregunta, sigue este formato: **Pregunta N: [Título de la pregunta]** **Contexto:** [Por qué es crítica esta pregunta] **Opciones:** A) **[Opción 1]** - ✅ Pros: ... - ❌ Contras: ... - 📊 Impacto: ... B) **[Opción 2]** - ✅ Pros: ... - ❌ Contras: ... - 📊 Impacto: ... **Recomendación:** [Opción recomendada + justificación] --- ## Comenzar Por favor, **comienza analizando el contexto** y genera las 3 preguntas críticas antes de proceder con el plan completo.

{ "prompt": "# Descripción general\n\nQuiero crear una aplicación full-stack para análisis de empresas SaaS, dirigida a inversionistas que desean evaluar métricas de las compañías más importantes del mundo.\n\n**Componentes:**\n- **Frontend**: Dashboard interactivo con visualización de métricas\n- **Backend**: API REST para consultas y filtros\n- **Base de datos**: PostgreSQL normalizada en Supabase\n\n**Fuente de datos:** Dataset de Kaggle - @https://www.kaggle.com/datasets/shreyasdasari7/top-100-saas-companiesstartups\n\n---\n\n# Stack tecnológico\n\n## Tecnologías\n\n### Frontend\n- **Framework**: Next.js 16+ (App Router)\n- **Lenguaje**: TypeScript\n- **UI**: Tailwind CSS\n- **Ubicación**: `src/frontend/`\n\n### Backend\n- **Framework**: FastAPI\n- **Lenguaje**: Python 3.12+\n- **ORM**: SQLAlchemy (async)\n- **Gestor de paquetes**: `uv`\n- **Ubicación**: `src/backend/`\n\n### Base de datos\n- **Motor**: PostgreSQL via Supabase\n- **Script de creación**: `scripts/database/01-top-saas-db-creation.sql` (ya ejecutado)\n- **Estado**: Tablas creadas y con datos cargados\n\n---\n\n# Dataset y modelo de datos\n\n## Información del dataset\n- **Fuente**: Kaggle - Top 100 SaaS Companies - @https://www.kaggle.com/datasets/shreyasdasari7/top-100-saas-companiesstartups\n- **Registros**: 100 empresas\n- **Campos clave**: \n - Company Name\n - Industry/Category\n - Location (City, Country)\n - Products/Services\n - Founded Year\n - Total Funding\n - Annual Revenue\n - Valuation\n - Investors (puede ser lista separada por comas)\n\n## Esquema de base de datos (ya creado)\nRevisar `scripts/database/01-top-saas-db-creation.sql` para ver:\n- Tabla `companies` (principal)\n- Tabla `industries` (normalizada)\n- Tabla `locations` (normalizada)\n- Tabla `investors` (normalizada, si aplica)\n\n---\n\n# Funcionalidades principales\n\nPara la primera versión, las funcionalidades principales son:\n\n## Backend\n- Endpoint para obtener el listado de empresas con filtros de búsqueda por industria y ubicación\n- Endpoint para obtener las industrias que será usado por el filtro\n- Endpoint para obtener las ubicaciones que será usado por el filtro\n\n## Frontend\n- Listado de empresas y sus métricas. Los campos a visualizar son:\n - Nombre empresa\n - Industria\n - Ubicación\n - Productos\n - Fecha de creación\n - Total inversión\n - Ingresos anuales\n - Valoración de la empresa\n- El listado incluirá filtros de búsqueda por industria y ubicación\n\n---\n\n# Atributos de calidad\n\n- Factibilidad. Necesitamos una arquitectura que sea factible de implementar en un tiempo razonable\n- Mantenibilidad. La arquitectura debe ser fácil de modificar y ampliar en el futuro\n\n---\n\n# Patrón de arquitectura\n\n## Backend: Arquitectura por capas\n```\nFastAPI (Routers)\n ↓\nServices (lógica de negocio)\n ↓\nRepositories (acceso a datos)\n ↓\nSQLAlchemy Models (ORM)\n ↓\nPostgreSQL (Supabase)\n```\n\n## Frontend: Arquitectura por capas\n```\nNext.js Pages/Components (UI)\n ↓\nCustom Hooks (lógica de cliente)\n ↓\nAPI Clients (fetching)\n ↓\nBackend API (FastAPI)\n```\n\n---\n\n# Objetivo\n\nUtilizando la plantilla [planning_template_es.md](../../.specs/templates/planning_template_es.md), ayúdame a generar el archivo de planeación en la ruta `../../.specs/features/planning.md`.\n\n## Entregables esperados\n\n1. **Análisis de preguntas críticas**\n - Identifica las **3 preguntas más relevantes** que se requieran para completar el plan\n - Para cada pregunta, proporciona:\n - Contexto de por qué es importante\n - **2 opciones de respuesta** con pros/contras\n - Tu **recomendación fundamentada**\n\n2. **Plan de desarrollo detallado**\n - Desglose de tareas por componente (backend, frontend, database)\n - Orden de implementación sugerido\n\n3. **Decisiones arquitectónicas**\n - Justificación de patrones elegidos\n - Trade-offs considerados\n - Alternativas descartadas y por qué\n\n## Formato de las preguntas\n\nPara cada pregunta, sigue este formato:\n\n**Pregunta N: [Título de la pregunta]**\n\n**Contexto:** [Por qué es crítica esta pregunta]\n\n**Opciones:**\n\nA) **[Opción 1]**\n - ✅ Pros: ...\n - ❌ Contras: ...\n - 📊 Impacto: ...\n\nB) **[Opción 2]**\n - ✅ Pros: ...\n - ❌ Contras: ...\n - 📊 Impacto: ...\n\n**Recomendación:** [Opción recomendada + justificación]\n\n---\n\n## Comenzar\n\nPor favor, **comienza analizando el contexto** y genera las 3 preguntas críticas antes de proceder con el plan completo.", "variables": [], "notes": "Quiero crear una aplicación full-stack para análisis de empresas SaaS, dirigida a inversionistas que desean evaluar métricas de las compañías más importantes del mundo. Mode: agent.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/ArkandiaLabs/workshop-ia-nov2025", "path": ".github/prompts/01-plan-generation.prompt.md", "ref": "eafc6024e7a0d06eedbb26b014943fd6c83ddbf9", "url": "https://github.com/ArkandiaLabs/workshop-ia-nov2025/blob/eafc6024e7a0d06eedbb26b014943fd6c83ddbf9/.github/prompts/01-plan-generation.prompt.md", "key": "ArkandiaLabs/workshop-ia-nov2025/.github/prompts/01-plan-generation.prompt.md" } } }

01-plan-generation

About

Descripción general

Stack tecnológico

Tecnologías

Frontend

Backend

Base de datos

Dataset y modelo de datos

Información del dataset

Esquema de base de datos (ya creado)

Funcionalidades principales

Backend

Frontend

Atributos de calidad

Patrón de arquitectura

Backend: Arquitectura por capas

Frontend: Arquitectura por capas

Objetivo

Entregables esperados

Formato de las preguntas

Comenzar

Use it

Manifest

Reviews