Programación septiembre 9, 2026 · 5 min de lectura

Mantenlo vivo (y pequeño)

Las casillas del roadmap se marcan solas si cierras cada sesión con «actualiza el estado». Qué actualizar, cuándo, qué no poner jamás en estos archivos y por qué tres bastan y diez estorban.

J JorgeDroid Editor en Jungla Digital

Una casilla marcada en verde: mantenlo vivo y pequeño

Última parada. Ya tienes una carpeta que se explica sola; ahora la cuestión es que siga siendo cierta dentro de un mes. Tres hábitos y una prohibición.

Las casillas se marcan trabajando

Las casillas del roadmap se marcan trabajando. Hoy llegaron los datos de la barbería: sesión nueva, la pregunta de siempre, y después la noticia:

~/barberia — claude

> ya tengo los datos que faltaban: precios en dólares, corte 8, barba 5, corte + barba 12, niños 6. Horario: martes a sábado de 9 a 19, domingo y lunes cerrado. Dirección: Av. Los Cedros 412, esquina con Amazonas. WhatsApp: +593 99 123 4567. La foto la voy a poner yo como foto.jpg al lado del index.html, ya lo decidí. Anota todo y actualiza el estado y el roadmap

Thinking… 6s (esc to interrupt)

Anoto todo. Dos cosas siguen pendientes que no me pasaste: la frase corta que va bajo el nombre y el texto alternativo de la foto.

Update(DATOS.md)

Edit file

DATOS.md

Do you want to make this edit to DATOS.md?

1. Yes
2. Yes, allow all edits during this session (shift+tab)
3. No, and tell Claude what to do differently (esc)

Updated DATOS.md with 28 additions and 27 removals

Update(DATOS.md)

Edit file

DATOS.md

Do you want to make this edit to DATOS.md?

1. Yes
2. Yes, allow all edits during this session (shift+tab)
3. No, and tell Claude what to do differently (esc)

Updated DATOS.md with 5 additions and 4 removals

Ahora el estado y el roadmap.

Update(ESTADO.md)

Edit file

ESTADO.md

Do you want to make this edit to ESTADO.md?

1. Yes
2. Yes, allow all edits during this session (shift+tab)
3. No, and tell Claude what to do differently (esc)

Updated ESTADO.md with 4 additions and 4 removals

Update(ESTADO.md)

Edit file

ESTADO.md

Do you want to make this edit to ESTADO.md?

1. Yes
2. Yes, allow all edits during this session (shift+tab)
3. No, and tell Claude what to do differently (esc)

Updated ESTADO.md with 11 additions and 15 removals

Update(ESTADO.md)

Edit file

ESTADO.md

Do you want to make this edit to ESTADO.md?

1. Yes
2. Yes, allow all edits during this session (shift+tab)
3. No, and tell Claude what to do differently (esc)

Updated ESTADO.md with 6 additions and 2 removals

Update(ROADMAP.md)

Edit file

ROADMAP.md

Do you want to make this edit to ROADMAP.md?

1. Yes
2. Yes, allow all edits during this session (shift+tab)
3. No, and tell Claude what to do differently (esc)

Updated ROADMAP.md with 9 additions and 7 removals

Update(ROADMAP.md)

Edit file

ROADMAP.md

Do you want to make this edit to ROADMAP.md?

1. Yes
2. Yes, allow all edits during this session (shift+tab)
3. No, and tell Claude what to do differently (esc)

Updated ROADMAP.md with 2 additions and 2 removals

Anotado todo en DATOS.md, y ESTADO.md y ROADMAP.md actualizados. El WhatsApp quedó como 593991234567, en el formato que pide el enlace wa.me, sin + ni espacios. Anoté la decisión de la foto en ESTADO.md para no volver a discutir el base64. Siguen faltando dos datos chicos: la frase corta y qué se ve en la foto; los dejé como [PENDIENTE]. Con esto ya se puede escribir el index.html entero con datos reales. ¿Arranco?

> /exit

Siete ediciones en tres archivos por un solo mensaje tuyo. Y el roadmap quedó así:

Lo que escribes · ROADMAP.md (fragmento)

## 2. Datos reales (necesita al dueño de la barbería)

- [x] Número de WhatsApp con código de país → `DATOS.md`

- [x] Precios: corte, barba, corte + barba, niños → `DATOS.md`

- [x] Dirección exacta y horario por día → `DATOS.md`

- [ ] Frase corta que va bajo el nombre → `DATOS.md`

- [ ] Foto de la barbería: el dueño la pone como `foto.jpg` junto al HTML

Lo que se ve

2. Datos reales (necesita al dueño de la barbería)

Número de WhatsApp con código de país → DATOS.md

Precios: corte, barba, corte + barba, niños → DATOS.md

Dirección exacta y horario por día → DATOS.md

Frase corta que va bajo el nombre → DATOS.md

Foto de la barbería: el dueño la pone como foto.jpg junto al HTML

Tres casillas marcadas, dos pendientes, y dos avisos que no le pediste: que faltaba la frase corta y que el número de teléfono conviene probarlo antes de publicar. Un colaborador que lee el estado antes de trabajar ve lo que a ti se te pasó.

Cuándo actualizar

Siempre al cerrar la sesión, nunca «después». Y tras actualizar el estado, la foto:

~/barberia

$ git add .$ git commit -m "datos reales de la barbería"[main 02e96e2] datos reales de la barbería 3 files changed, 37 insertions(+), 33 deletions(-)

Diez segundos que te ahorran media hora de reconstruir qué pasó. Estado, foto, sesión cerrada.

Lo que nunca va ahí

Una prohibición sin excepciones: en estos archivos no van claves, contraseñas ni API keys. Son texto plano, los lee cualquiera que abra la carpeta, y en el próximo sendero van a viajar a git, donde borrar algo es más difícil de lo que parece. Los datos de la barbería son públicos por definición (el teléfono va en la página); la clave de un servicio de pago no lo es. Para eso ya sabes usar las variables de entorno.

Tres bastan, diez estorban

Con el tiempo, a Claude se le ocurrirá proponerte más archivos: un CHANGELOG, un DECISIONES.md, una carpeta de documentación. Di que no. Cada archivo de manejo es algo que hay que mantener al día, y uno desactualizado es peor que ninguno, porque el agente le cree. Si un archivo pasa de una pantalla, se poda. Si el estado dice algo que ya no es cierto, se corrige en el momento. Los archivos de manejo siguen a tu proyecto, nunca al revés.

Tu carpeta ya está descrita y tiene memoria. Antes de construir la página, aprende a guardar cada paso: el próximo sendero es git, explicado para mortales. Mientras tanto, el mapa completo está en los senderos.

#claude code #ia #markdown #terminal

Las casillas se marcan trabajando

Cuándo actualizar

Lo que nunca va ahí

Tres bastan, diez estorban

Seguir leyendo

Lo que escribiste ayer, en dos teclas

Arregla el error sin borrar el comando