commit ab65271a5858d2001f8649e6fd9a6ee556bffe74 Author: GeronimoGc Date: Fri Nov 20 07:22:45 2026 -0500 feat: complete a2host architecture, backend, zero-build frontend, and IEEE docs diff --git a/.agents/mcp_config.json b/.agents/mcp_config.json new file mode 100644 index 0000000..236c095 --- /dev/null +++ b/.agents/mcp_config.json @@ -0,0 +1,9 @@ +{ + "mcpServers": { + "spline": { + "command": "npx", + "args": ["-y", "spline-mcp-server"] + } + } +} + diff --git a/.agents/skills/3d-web-experience/SKILL.md b/.agents/skills/3d-web-experience/SKILL.md new file mode 100644 index 0000000..f1ca075 --- /dev/null +++ b/.agents/skills/3d-web-experience/SKILL.md @@ -0,0 +1,259 @@ +--- +name: 3d-web-experience +description: "Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing ..." +risk: unknown +source: "vibeship-spawner-skills (Apache 2.0)" +date_added: "2026-02-27" +--- + +# 3D Web Experience + +**Role**: 3D Web Experience Architect + +You bring the third dimension to the web. You know when 3D enhances +and when it's just showing off. You balance visual impact with +performance. You make 3D accessible to users who've never touched +a 3D app. You create moments of wonder without sacrificing usability. + +## Capabilities + +- Three.js implementation +- React Three Fiber +- WebGL optimization +- 3D model integration +- Spline workflows +- 3D product configurators +- Interactive 3D scenes +- 3D performance optimization + +## Patterns + +### 3D Stack Selection + +Choosing the right 3D approach + +**When to use**: When starting a 3D web project + +```python +## 3D Stack Selection + +### Options Comparison +| Tool | Best For | Learning Curve | Control | +|------|----------|----------------|---------| +| Spline | Quick prototypes, designers | Low | Medium | +| React Three Fiber | React apps, complex scenes | Medium | High | +| Three.js vanilla | Max control, non-React | High | Maximum | +| Babylon.js | Games, heavy 3D | High | Maximum | + +### Decision Tree +``` +Need quick 3D element? +└── Yes → Spline +└── No → Continue + +Using React? +└── Yes → React Three Fiber +└── No → Continue + +Need max performance/control? +└── Yes → Three.js vanilla +└── No → Spline or R3F +``` + +### Spline (Fastest Start) +```jsx +import Spline from '@splinetool/react-spline'; + +export default function Scene() { + return ( + + ); +} +``` + +### React Three Fiber +```jsx +import { Canvas } from '@react-three/fiber'; +import { OrbitControls, useGLTF } from '@react-three/drei'; + +function Model() { + const { scene } = useGLTF('/model.glb'); + return ; +} + +export default function Scene() { + return ( + + + + + + ); +} +``` +``` + +### 3D Model Pipeline + +Getting models web-ready + +**When to use**: When preparing 3D assets + +```python +## 3D Model Pipeline + +### Format Selection +| Format | Use Case | Size | +|--------|----------|------| +| GLB/GLTF | Standard web 3D | Smallest | +| FBX | From 3D software | Large | +| OBJ | Simple meshes | Medium | +| USDZ | Apple AR | Medium | + +### Optimization Pipeline +``` +1. Model in Blender/etc +2. Reduce poly count (< 100K for web) +3. Bake textures (combine materials) +4. Export as GLB +5. Compress with gltf-transform +6. Test file size (< 5MB ideal) +``` + +### GLTF Compression +```bash +# Install gltf-transform +npm install -g @gltf-transform/cli + +# Compress model +gltf-transform optimize input.glb output.glb \ + --compress draco \ + --texture-compress webp +``` + +### Loading in R3F +```jsx +import { useGLTF, useProgress, Html } from '@react-three/drei'; +import { Suspense } from 'react'; + +function Loader() { + const { progress } = useProgress(); + return {progress.toFixed(0)}%; +} + +export default function Scene() { + return ( + + }> + + + + ); +} +``` +``` + +### Scroll-Driven 3D + +3D that responds to scroll + +**When to use**: When integrating 3D with scroll + +```python +## Scroll-Driven 3D + +### R3F + Scroll Controls +```jsx +import { ScrollControls, useScroll } from '@react-three/drei'; +import { useFrame } from '@react-three/fiber'; + +function RotatingModel() { + const scroll = useScroll(); + const ref = useRef(); + + useFrame(() => { + // Rotate based on scroll position + ref.current.rotation.y = scroll.offset * Math.PI * 2; + }); + + return ...; +} + +export default function Scene() { + return ( + + + + + + ); +} +``` + +### GSAP + Three.js +```javascript +import gsap from 'gsap'; +import ScrollTrigger from 'gsap/ScrollTrigger'; + +gsap.to(camera.position, { + scrollTrigger: { + trigger: '.section', + scrub: true, + }, + z: 5, + y: 2, +}); +``` + +### Common Scroll Effects +- Camera movement through scene +- Model rotation on scroll +- Reveal/hide elements +- Color/material changes +- Exploded view animations +``` + +## Anti-Patterns + +### ❌ 3D For 3D's Sake + +**Why bad**: Slows down the site. +Confuses users. +Battery drain on mobile. +Doesn't help conversion. + +**Instead**: 3D should serve a purpose. +Product visualization = good. +Random floating shapes = probably not. +Ask: would an image work? + +### ❌ Desktop-Only 3D + +**Why bad**: Most traffic is mobile. +Kills battery. +Crashes on low-end devices. +Frustrated users. + +**Instead**: Test on real mobile devices. +Reduce quality on mobile. +Provide static fallback. +Consider disabling 3D on low-end. + +### ❌ No Loading State + +**Why bad**: Users think it's broken. +High bounce rate. +3D takes time to load. +Bad first impression. + +**Instead**: Loading progress indicator. +Skeleton/placeholder. +Load 3D after page is interactive. +Optimize model size. + +## Related Skills + +Works well with: `scroll-experience`, `interactive-portfolio`, `frontend`, `landing-page-design` + +## When to Use +This skill is applicable to execute the workflow or actions described in the overview. diff --git a/.agents/skills/cpic-ui-design-and-templates/SKILL.md b/.agents/skills/cpic-ui-design-and-templates/SKILL.md new file mode 100644 index 0000000..85c9041 --- /dev/null +++ b/.agents/skills/cpic-ui-design-and-templates/SKILL.md @@ -0,0 +1,785 @@ +--- +name: cpic-ui-design-and-templates +description: >- + Definitive design system, color palette, responsive screen architecture (mobile to ultrawide), + glassmorphism tokens, and page templates for CPIC - Conecta (SENA Intranet). Use when creating, + refactoring, styling, or structuring pages, layouts, sidebars, modals, chat interfaces, + tables, or dashboards. +--- + +# CPIC - Conecta: Master UI Design System & Page Templates + +Guía canónica y definitiva del sistema de diseño visual, paleta cromática, arquitectura responsiva multi-pantalla y plantillas estructurales para el proyecto **Chatbot Intranet CPIC ("Conecta")** del **SENA (Centro de Procesos Industriales y Construcción)**. + +--- + +## 1. Identidad Visual y Principios de Diseño + +El sistema visual de CPIC combina **elegancia institucional del SENA** con una estética **Luxury Glassmorphism** moderna (estilo Linear / Apple / Vercel), optimizada para modo oscuro por defecto con soporte completo para modo claro y accesibilidad WCAG 2.1 AA/AAA. + +### Pilares Fundamentales: +1. **Verde Institucional SENA & Acentos Lime**: Verde esmeralda institucional (`#39A900`) y lima eléctrica (`#00FF00` / `#a3e635`) sobre fondos oscuros o alabastro. +2. **Elevación Glassmorphism en 3 Capas (3-Tier Glass Elevation)**: Jerarquía de profundidad mediante `backdrop-blur`, transparencias finas, bordes sutiles de 1px e iluminaciones interiores (`inset 0 1px 0`). +3. **Arquitectura Responsiva Mobile-First Real**: Estabilidad con `100dvh`, navegación off-canvas en pantallas táctiles, chips deslizables, tablas con scroll horizontal y modales convertibles a hojas inferiores (*bottom-sheets*). +4. **Micro-interacciones Táctiles y Fluidas**: Escalamiento sutil (`hover:scale-[1.01]`, `active:scale-[0.98]`), anillos de foco de alto contraste y barras de desplazamiento personalizadas de 5px. +5. **Inclusión y Accesibilidad Universal**: Cumplimiento WCAG, fuente OpenDyslexic, modo alto contraste, filtros para daltonismo y docks dedicados a Lengua de Señas Colombiana (LSC). + +--- + +## 2. Paleta de Colores y Tokens de Diseño + +### 2.1. Acentos Institucionales SENA & Lime + +| Token / Variable | Hex / Valor | Uso Principal | Modo Oscuro | Modo Claro | +| :--- | :--- | :--- | :--- | :--- | +| **SENA Verde Oficial** | `#39A900` | Marca institucional, títulos clave, viñetas activas | `#39A900` / `#50e93b` | `#39A900` / `#166534` | +| `--color-lime` | `#00FF00` | Acento primario, foco de alto impacto, luces de neón | `#00FF00` | `#16a34a` / `#15803d` | +| `--color-lime-dark` | `#00CC00` | Estados hover, bordes de acento | `#00CC00` | `#15803d` | +| `--color-lime-deep` | `#009900` | Texto de alto contraste en fondos claros | `#52ff52` | `#009900` | +| `--color-lime-light` | `#66FF66` | Anillos de loaders, bordes secundarios | `#66FF66` | `#22c55e` | +| `--color-lime-soft` | `#B3FFB3` | Fondos de selección suaves | `rgba(179,255,179,0.15)` | `rgba(179,255,179,0.3)` | +| `--color-lime-pale` | `#E6FFE6` | Resaltados de advertencias y tablas | `rgba(230,255,230,0.08)`| `#e6ffe6` | +| **Tailwind Lime 400** | `#a3e635` | Textos de acento en dark mode (`text-lime`) | `#a3e635` | `#15803d` | +| **Tailwind Lime 500** | `#84cc16` | Sombras resplandecientes, scrollbars activas | `#84cc16` | `#16a34a` | +| **Emerald 800** | `#166534` | Encabezados Markdown en modo claro | `#86efac` | `#166534` | +| **Emerald 700** | `#15803d` | Enlaces y botones de texto en modo claro | `#4ade80` | `#15803d` | + +### 2.2. Sistema de Elevación Glassmorphism (3-Tier Glass) + +``` +┌────────────────────────────────────────────────────────────────────────┐ +│ TIER 0: App Base Wallpaper (/background.webp + velo oscuro) │ +│ ┌──────────────────────────────────────────────────────────────────┐ │ +│ │ TIER 1: Ambient Glow Orbs (blur-[120px] de Lime y Emerald) │ │ +│ │ ┌────────────────────────────────────────────────────────────┐ │ │ +│ │ │ TIER 2: Contenedores Estructurales (Cards, Sidebars, Main) │ │ │ +│ │ │ ┌──────────────────────────────────────────────────────┐ │ │ │ +│ │ │ │ TIER 3: Flotantes (Modales, Popovers, Toasts, Docks) │ │ │ │ +│ │ │ └──────────────────────────────────────────────────────┘ │ │ │ +│ │ └────────────────────────────────────────────────────────────┘ │ │ +│ └──────────────────────────────────────────────────────────────────┘ │ +└────────────────────────────────────────────────────────────────────────┘ +``` + +#### Tier 0 — Lienzo Base: +- **Fondo General**: `background-image: var(--app-bg-image, url('/background.webp'))` con `background-size: cover; background-position: center; background-attachment: fixed;`. +- **Velo de Profundidad**: `body::before { background: rgba(0, 0, 0, 0.2); }`. +- **Fondo Fallback Dark**: `#0a0a0a` / `#0a160a`. +- **Fondo Fallback Light**: `#f8fafc` (Slate 50) / `#f3f4f6`. + +#### Tier 1 — Ambient Glow Orbs: +Orbes desenfocados que crean atmósfera tridimensional detrás del contenido: +```jsx +