sagas/mision-calculadora-neon/001-el-primer-input.md

2026-03-24 draft

Episodio 001 - El primer input

Episodio 001 - El primer input

Bitacora Hacker-Carpincho

Salimos de la nave nodriza. Sin piloto automatico, sin copiar codigo legado, sin humo. Solo un objetivo: levantar una calculadora cientifica CLI que responda con precision y no abra grietas de seguridad.

Cronica de un Error Anunciado

1) Promesa inicial

La mision arranco con un latido claro: construir pequeno, testeable y robusto. Nada de magia negra. Nada de éval`.

2) Sintoma

El terreno estaba casi vacio: reglas operativas presentes, pero sin estructura documental ni manifiesto de saga. Sin mapa, cualquier decision parecia rapida… y riesgosa.

3) Autopsia

Detectamos tres fricciones de origen:

  • no habia manifiesto central de saga,
  • no existia spec tecnica para guiar TDD,
  • faltaba el primer episodio para fijar contexto narrativo-operativo.

4) Correccion aplicada

Se activo la gobernanza minima:

  • SAGA_MANIFEST.json creado con nombre epico y estado activo,
  • docs/specs/001-core-logic.md creado como contrato tecnico inicial,
  • este episodio sellado como arranque oficial de la serie.

5) Leccion reusable

Cuando un proyecto nace fuera del ecosistema grande, la tentacion es correr directo al codigo. Leccion Carpincho: primero manifiesto + spec + bitacora. Despues, recien ahi, el vibecoding tiene columna vertebral.

Estado del frente

  • Saga activa: mision-calculadora-neon
  • Fase actual: definicion de core logic con enfoque TDD y seguridad de entrada
  • Siguiente paso: implementar tokenizer seguro y su primera bateria de tests