Episodio 001 — Identidad y setup

Serie: bitácora de ingeniería — caprini.dev
Slug: 001-identidad-y-setup
Enfoque: nacimiento del proyecto, metodología, stack, “boss fight” del entorno Windows y primer hito visual (layout + cabecera con Carpincho Tech).

Este episodio documenta trabajo ya realizado. El tono mezcla precisión técnica con voz humana: sirve para lectura en voz alta, resúmenes con IA o audio generado (p. ej. NotebookLM); las secciones finales siguen el formato estándar del log acordado para la serie.

De dónde sale Caprini Dev

Caprini Dev no empezó como un repo anónimo: nació como un contenedor para experimentar en público con una forma de construir productos que combine rigor y ritmo. En lugar de improvisar cada sesión, el proyecto adopta Spec Driven Development (SDD): lo importante —alcance, branding, rutas de despliegue, decisiones de stack— debe poder apuntarse bajo src/content/docs/ y leerse en orden desde src/content/docs/system/DOC_ROUTER.md. Paralelamente entra en juego lo que aquí llamamos Vibecoding: iterar rápido, sí, pero sin saltarse el router ni la memoria viva del agente; la intención del producto (synthwave, Neo-Dev, tono técnico accesible) guía cada commit pequeño en lugar de un megaplan rígido que nunca toca el teclado.

Esa combinación es el ADN del workspace: especificaciones como contrato, vibes como brújula.

Stack: Astro y Tailwind v4

El motor del sitio es Astro (en el repo, dependencia ástroen rama ^6), orientado a **salida estática** hacia un flujo de publicación posterior (SFTP haciacaprini.dev, según memoria del proyecto). El styling no va con pegotes sueltos: **Tailwind CSS v4** entra por la vía oficial con Vite —tailwindcssy@tailwindcss/vite en ástro.config.mjs— de modo que los tokens y utilidades viven en el mismo ecosistema de build que Astro. Node queda anclado con éngines.node >= 22.12.0enpackage.json` para que “en mi máquina funciona” no sea una lotería entre colaboradores y agentes.

En una frase para quien solo escucha: Astro monta las páginas; Tailwind v4 pinta la interfaz con un pipeline limpio bajo Vite.

Boss fight: Git, PATH y OneDrive en Windows 11

Si hubo un momento de jefe final en el setup, no fue un bug de Astro: fue el entorno. En Windows 11, tener Git instalado no basta si la terminal no resuelve el ejecutable: PowerShell (y las herramientas que delegan en ella) puede responder con el clásico no se reconoce como comando cuando el PATH del sistema o de la sesión no incluye la carpeta bin de Git, o cuando hace falta reabrir la terminal tras el instalador para que el PATH actualizado exista de verdad. Esa fricción es oro puro para un vídeo: todos han vivido los cinco minutos de “¿pero si lo instalé?”.

El segundo round del combate suma un villano moderno: OneDrive. Sincronizar el workspace bajo la jerarquía de usuario sincronizada puede traer bloqueos de archivos, latencia en operaciones masivas de Git, o sensación de que el índice “parpadea” mientras el sync compite con git status. La lección práctica no es filosófica: validar git --version en la misma shell que usarás para trabajar y, si el repo vive bajo OneDrive, ser consciente de que el disco “local” a veces es un escenario con red de por medio; muchos equipos terminan moviendo proyectos activos a rutas fuera del sync o pausando sync en sesiones largas de commits.

Cuando PATH y ubicación del repo están alineados, el flujo remoto encaja: rama por defecto main, remoto **órigin** hacia **GitLab** (caprini/caprini-blog`), identidad de autor configurada solo en este repo para no contaminar el Git global del sistema.

Hito visual: Master Layout y Header con Carpincho Tech

El primer “se ve en el navegador” que cierra el arco del episodio es visual y estructural. La fuente de verdad de paleta, tipografía y mood está en src/content/docs/system/BRANDING.md: void, neón, grid, identidad Synthcode / Neo-Dev. Ahí también vive la idea del Carpincho Tech —la mascota con auriculares que representa al dev que disfruta el craft sin perder el humor.

En código, el Master Layout es src/layouts/MainLayout.astro: documento HTML base, meta viewport, descripción, favicon, carga de src/styles/global.css, JetBrains Mono desde Google Fonts (alineado al branding), y el contenido de cada página entrando por <slot />. Encima va src/components/Header.astro: marca con logo en /assets/images/logo-flat.png, texto Caprini Dev, navegación a secciones como Proyectos y Specs, e iconos hacia X (@CapriniDev77) y GitLab. El resultado no es solo “una barra”: es la cara del blog y el ancla visual del Carpincho en el sitio.

Resumen Técnico

• Producto: blog estático para caprini.dev, motor Astro ^6, estilos Tailwind v4 vía @tailwindcss/vite, Node >= 22.12.0.
• Gobernanza: src/content/docs/system/DOC_ROUTER.md (router de lectura), AGENT_PERSISTENT_MEMORY.md (estado), reglas bajo .cursor/rules/.
• Repo: Git en raíz del workspace, rama main, remoto GitLab caprini/caprini-blog.
• UI base: MainLayout.astro + Header.astro, branding en src/content/docs/system/BRANDING.md, assets bajo public/assets/images/.

Errores Encontrados

• git no reconocido en terminal (Windows 11): PATH sin la ruta de Git o sesión sin recargar variables tras instalar.
• Fricción al trabajar con el repo bajo carpeta sincronizada por OneDrive: posibles bloqueos o lentitud perceptible en operaciones de Git frente a un directorio “solo local”.
• Riesgo de inconsistencia documental: sin router y memoria, cada sesión podría reinterpretar stack y despliegue distinto.

Solución de la IA

• PATH: corregir variables de entorno para incluir el bin de Git (o reinstalar/reparar con la opción de PATH para el sistema) y abrir una terminal nueva; comprobar con git --version.
• OneDrive: documentar el riesgo y preferir rutas de trabajo predecibles; en sesiones críticas, considerar pausar sync o clonar fuera del árbol sincronizado si los síntomas persisten.
• SDD + Vibecoding: mantener DOC_ROUTER.md y AGENT_PERSISTENT_MEMORY.md como fuente de verdad y cerrar turnos actualizando memoria; cambios pequeños y trazables en lugar de refactors masivos no pedidos.

Vibe Check (Sensaciones del humano)

Espacio para el humano: mezcla de alivio cuando git por fin responde en PowerShell, cansancio cómplice después de pelear con PATH y carpetas sincronizadas, y pequeño subidón al ver el Header con el Carpincho y la estética synthwave tomando forma —la sensación de que el proyecto ya tiene personalidad, no solo dependencias. Si grabas esto para YouTube, el arco emocional vende solo: del “no reconoce el comando” al “mira cómo quedó la cabecera”.

Referencias rápidas en el repo

Fin del episodio 001.