Episodio 016 — El showroom de herramientas

Serie: bitácora de ingeniería — caprini.dev
Enfoque: la galería de proyectos como vitrina honesta del aprendizaje activo.

Aprender en público no es solo escribir posts

Cuando documentamos solo en commits o en notas privadas, el arco narrativo se fragmenta: alguien (incluido el yo futuro) pierde la trazabilidad entre intención, spec y código que corre. El blog cuenta la historia; las carpetas bajo src/content/docs/projects/ son el inventario de lo que estamos construyendo de verdad.

Un showroom — en nuestro caso la ruta /proyectos — no sustituye a la galería de specs (/specs): la complementa. La galería de proyectos es un filtro visual por carpeta de iniciativa: cada tarjeta resume ID, título, estado y un extracto, y enlaza directamente al documento normativo en /specs/[slug]. Así el visitante entiende de un vistazo qué módulos existen antes de abrir el Markdown completo.

Por qué importa mostrar las herramientas

1. Honestidad de producto — Un spec en borrador (Draft) visible en panel dice: esto está definido pero aún evoluciona. Cuando pase a Operational, la misma tarjeta refleja el salto sin reescribir la historia del blog entero.
2. Motivación y ritmo — Ver la lista crecer en una cuadrícula tipo panel de hardware refuerza que el repo no es solo contenido estático: es un taller con piezas ensamblables.
3. Onboarding — Nuevos colaboradores (o el agente) localizan rápido qué iniciativas hay y dónde vive cada spec, alineado con DOC_ROUTER.md y la memoria persistente.

Cierre

El showroom no es vanidad: es gobernanza ligera con cara de terminal. Si construimos herramientas mientras aprendemos, merecen un hueco en el tablero — no solo en el historial de Git.