Episodio 031 — Herramientas que crean herramientas
Serie: bitacora de ingenieria de caprini.dev
Modo Hacker-Carpincho: vibecoding con contrato claro y latido verificable.
La promesa
Durante semanas el sitio fue una bitacora: escribiamos lo que ibamos aprendiendo y dejabamos huellas en episodios. Esta vez la promesa fue mas ambiciosa: que el propio blog empezara a fabricar piezas operativas, no solo relatos. El objetivo practico fue abrir /tools/spec-generator para generar un SPEC.md util desde el navegador, sin backend y sin peso innecesario.
El sintoma
El primer borrador de la idea tenia olor a sobreingenieria: formularios complejos, estado disperso y riesgo de romper la vibe ligera del proyecto. Si para crear una SPEC habia que montar media aplicacion, el flujo SDD quedaba mas lento que escribir a mano.
La autopsia
El error anunciado era confundir “mas framework” con “mas valor”. En este caso, el valor estaba en un circuito corto:
- Capturar cinco campos esenciales.
- Generar Markdown legible con estructura estable.
- Dejarlo visible en un preview.
- Descargarlo como
SPEC.md.
Nada de dependencias pesadas. Nada de backend prematuro. Solo HTML5 + JavaScript en cliente, con una UI terminal coherente al branding.
La correccion
Se implemento una pagina Astro dedicada con formulario vanilla, dos botones (PREVIEW y DOWNLOAD) y un bloque <pre> con scroll para validar el resultado antes de bajarlo. El generador crea secciones tipo Overview, Stack, Goals, Todos, Acceptance Criteria y Risks, manteniendo un molde reusable para nuevas iniciativas.
El blog ahora no solo documenta SDD: lo ejecuta en vivo con una utilidad concreta.
La leccion reusable
Cuando una bitacora madura, llega un punto donde escribir sobre el sistema no alcanza: hay que convertir conocimiento en herramienta. La regla reusable queda asi:
- si un proceso se repite, encapsularlo en una utilidad minima;
- si la utilidad acelera decisiones, documentarla en la bitacora;
- si el latido mejora, mantenerlo simple y verificable.
Ese es el salto de hoy: de diario tecnico a taller operativo.