Este repositorio contiene Pascal.dev, el producto público. Su función es generar confianza, demostrar capacidad técnica y convertir visitantes en clientes, colaboraciones u oportunidades profesionales mediante evidencia real.
El Pascal Development System es la metodología interna utilizada para construir y mejorar productos. Pascal Engineering es la empresa futura que podrá operar sobre esa metodología; no es una capa que deba implementarse ahora.
El portafolio debe:
- Explicar en pocos segundos quién es Pascal, qué sabe hacer y qué valor puede aportar.
- Facilitar que un reclutador encuentre proyectos, tecnologías, experiencia y formas de contacto.
- Demostrar criterio de producto y calidad técnica, no solamente enumerar herramientas.
- Mantener una estética elegante y contemporánea sin sacrificar legibilidad ni credibilidad.
- Proyectar el nivel visual de una empresa tecnológica boutique: oscuro, espacial, preciso y moderno.
- Utilizar 3D, profundidad, luz y movimiento como recursos de marca, nunca como decoración infantil o gamer.
- Mantener una composición minimalista y editorial: un gesto visual dominante por sección, mucho espacio negativo y controles mínimos.
- Presentar proyectos y capacidades como una landing conceptual de tecnología, no como un dashboard de tarjetas repetidas.
- Utilizar una atmósfera digital nórdica: cromo frío, luz de horizonte y movimiento sereno, sin copiar identidades visuales externas.
- Usar un cubo negro conceptual como símbolo principal: una envolvente geométrica, precisa y sobria contiene un núcleo que cambia de forma con fluidez y reacciona al cursor.
- Extender ese comportamiento al sistema completo mediante reflejos, gradientes espectrales y microinteracciones coherentes en servicios, proyectos y llamadas a la acción.
- Comunicar servicios, formas de colaboración, inversión inicial y siguiente paso sin ambigüedad.
- Funcionar correctamente en móvil y escritorio, con buena accesibilidad y rendimiento.
- Usar animaciones y efectos visuales con intención; nunca deben competir con el contenido.
- Respetar
prefers-reduced-motiony ofrecer una composición estable cuando la animación esté limitada o WebGL no esté disponible. - Evitar textos genéricos, afirmaciones sin evidencia y complejidad visual innecesaria.
Toda propuesta automatizada debe evaluarse con una pregunta sencilla: ¿hace que Pascal resulte más claro, competente y atractivo para una oportunidad profesional o comercial?
- Perfil profesional y propuesta de valor.
- Tecnologías y áreas de especialización.
- Casos de estudio con contexto, retos, soluciones y resultados.
- Metodología de ingeniería y estándares de entrega.
- Evidencia de cómo el Pascal Development System se aplica en proyectos reales.
- Enlaces a demostraciones y repositorios.
- Un canal de contacto para nuevas oportunidades y proyectos.
El sitio está construido con:
- Next.js 15 y React 19.
- TypeScript.
- Tailwind CSS y componentes basados en Radix UI.
- Framer Motion para animaciones.
- Three.js y React Three Fiber para la experiencia espacial 3D de la portada.
- WhatsApp como canal directo para iniciar conversaciones.
- Datos locales en
src/data/para perfil, habilidades y proyectos. - Un catálogo interno versionado que autoriza repositorios y define el contrato de futuros reportes de ingeniería.
La aplicación usa App Router, genera páginas estáticas para los proyectos y prepara mensajes de contacto para WhatsApp desde el navegador, sin enviar datos automáticamente.
- El repositorio se mantiene inicialmente como monolito modular.
- pnpm 10 y Node.js 20 forman el toolchain oficial.
- TypeScript, ESLint y build son checks obligatorios de CI.
- Scripts, workflows, agentes futuros y aprobación humana tienen responsabilidades separadas.
- La evolución se registra mediante ADRs y una auditoría técnica versionada.
Documentación principal:
- Project Charter
- Pascal Operating Model
- Oferta freelance
- Experience Engineering
- Arquitectura
- ADRs
- Auditoría inicial
- Runbook de CI
- Evaluación de oportunidades
- Instrucciones operativas
- Arquitectura futura de agentes
Requisitos:
- Node.js 20.
- pnpm 10, según la versión declarada en
package.json.
# Activa Node 20 con tu gestor de versiones; el repositorio incluye .nvmrc.
corepack pnpm install --frozen-lockfile
corepack pnpm exec playwright install chromium
corepack pnpm devLa aplicación estará disponible normalmente en http://localhost:3000.
Comandos principales:
corepack pnpm dev
corepack pnpm build
corepack pnpm start
corepack pnpm lint
corepack pnpm typecheck
corepack pnpm catalog:generate
corepack pnpm validate:catalog
corepack pnpm test:e2e
corepack pnpm checkTypeScript, ESLint, la validación de datos, las pruebas end-to-end y el build forman parte del workflow de CI.
El registro de catalog/repositories.json es la lista explícita de repositorios autorizados. Este comando consulta únicamente información pública de GitHub mediante operaciones de lectura y genera un snapshot local en catalog/generated/:
pnpm catalog:generate
pnpm validate:catalogEl reporte no modifica repositorios ni alimenta el frontend automáticamente. Cualquier publicación continúa requiriendo revisión humana.
La URL canónica del sitio utiliza esta variable:
NEXT_PUBLIC_SITE_URL=No deben almacenarse secretos reales en el repositorio. Las variables se configuran en el entorno local y en el proveedor de despliegue.
- Configurar ESLint y activar la validación de tipos durante el build.
- Ampliar las pruebas end-to-end con auditorías de accesibilidad y recorridos responsive adicionales.
- Validar periódicamente el recorrido público de contacto por WhatsApp.
- Corregir enlaces y completar activos públicos, incluido el CV.
- Añadir un workflow de CI que ejecute instalación reproducible, tipos, lint, pruebas y build.
- Definir una guía visual y editorial orientada a la búsqueda de empleo.
- Probar la jerarquía de información con recorridos de reclutador en móvil y escritorio.
- Convertir GitHub en la fuente verificable de actividad técnica.
- Sincronizar proyectos seleccionados, lenguajes, temas, enlaces y fechas de actualización.
- Mostrar el estado de build o despliegue cuando aporte contexto al caso de estudio.
- Utilizar una GitHub App con permisos mínimos para integraciones permanentes; evitar tokens personales de larga duración.
- Recibir webhooks firmados para reaccionar a cambios de repositorios, issues y pull requests.
- Detectar enlaces rotos, datos desactualizados y proyectos sin descripción suficiente.
- Crear borradores de actualización mediante pull requests, nunca cambios directos sobre la rama protegida.
- Resumir actividad relevante y proponer actualizaciones de casos de estudio.
- Automatizar etiquetado, validación de contenido, auditorías de dependencias y revisiones programadas.
- Incorporar un coordinador que clasifique cada tarea y delegue en especialistas.
- Dar a cada agente herramientas y permisos limitados a su función.
- Mantener trazas, métricas, presupuestos y un registro de auditoría por ejecución.
- Exigir aprobación humana para publicar contenido, abrir cambios sensibles o realizar operaciones externas.
- Incorporar un agente UI/UX que proteja el objetivo profesional y revise coherencia, claridad, accesibilidad y presentación visual.
Los agentes propuestos, sus límites y la arquitectura necesaria se describen en AGENTES.md. Es un diseño futuro; no existen agentes funcionales en la aplicación actual.
- Automatizar con scripts y workflows todo lo determinista.
- Usar agentes únicamente cuando la tarea requiere interpretación o síntesis.
- Aplicar privilegio mínimo y aprobación humana a cualquier escritura externa.
- Mantener los datos públicos separados de secretos, contactos privados y credenciales.
- Medir calidad, costo, latencia y tasa de éxito antes de ampliar autonomía.
- Priorizar la claridad profesional y la conversión de visitas en conversaciones laborales.
src/app/ Rutas, páginas, metadata y API
src/components/ Componentes y secciones visuales
src/data/ Perfil, habilidades y proyectos
src/lib/ Utilidades compartidas
catalog/ Registro autorizado y contratos del catálogo de ingeniería
public/ Imágenes y activos públicos
.github/workflows/ CI reproducible
docs/ Charter, arquitectura, ADRs y runbooks