Mantener

Esta lección todavía está en pruebas: mejora con los comentarios de quienes la siguen. Si algo no está claro, hay que corregir la lección, no a ti.

Al final de esta lección, sabrás

escribir un README que permite retomar tu herramienta;
probar ese README con una sesión nueva;
seguir una rutina de mantenimiento de diez minutos al mes;
saber cuándo archivar una herramienta.

Por qué te interesa

Una herramienta que ya no se entiende es una herramienta que ya no te atreves a tocar. Dentro de seis meses, habrás olvidado dónde están los datos, cómo hacer una copia de seguridad, qué se decidió. El README lo conserva todo, en una página. Y una pequeña rutina mensual evita las malas sorpresas: la copia de seguridad que ya no funciona, el dato perdido, la modificación que lo rompió todo.

Antes de empezar


Necesitas	Claude Code (app o terminal), en modo Manual, tu herramienta con su especificación y su historial de Git, y la plantilla de README (recurso)
Costo	La suscripción del agente: como mínimo Claude Pro, 18 € al mes sin IVA con facturación mensual, o 15 € al mes sin IVA con la suscripción anual de 180 € pagada por adelantado; precios mostrados en claude.com/pricing a fecha de 24/10/2026
Duración	45 minutos, y luego 10 minutos al mes
Recordatorio	Las copias de seguridad de tu herramienta contienen sus datos: guárdalas como el resto de tus copias

Entenderlo en 3 minutos

Lo que hace durar una herramienta pequeña:

Pieza	Lo que conserva
La especificación (lección 1)	Lo que debe hacer la herramienta y cómo comprobarlo
El historial de Git (lección 5)	Cada versión, con lo que cambió
El README (esta lección)	Cómo usarla, dónde están los datos, cómo modificarla
Las copias de seguridad (lección 3)	Los datos, fuera del navegador

Pocas piezas, poco mantenimiento. La CNIL (autoridad francesa de protección de datos) aconseja evaluar el interés de cada dependencia: algunas solo tienen unas pocas líneas, y cada elemento agregado aumenta la superficie de ataque. Una herramienta en un solo archivo, sin bibliotecas, casi no tiene nada que actualizar.

La CNIL también recuerda que la documentación es crucial para el mantenimiento de un proyecto: es la función del README.

Toda modificación sigue el mismo circuito: primero la especificación (si la necesidad cambia), una versión de Git, la modificación, todas las pruebas, una nueva versión.

Hagámoslo juntos

1Paso 1: Escribir el README

En Claude Code, en tu carpeta de proyecto, en modo Manual, usa la solicitud del recurso Plantilla de README.

En nuestra prueba del 24/10/2026, para el registro de préstamos del club, el README ocupó 25 líneas: los archivos, cómo abrir la herramienta, dónde están los datos (y qué los borra), cómo hacer una copia de seguridad y restaurarla, y cómo pedir una modificación con una versión de Git antes y después.

2Paso 2: Probarlo

Copia solo el README en una carpeta vacía y abre una sesión nueva en ella:

Lee solo README.md. En 3 líneas: dónde se guardan los datos, cómo hago una copia de seguridad y qué pasa si abro la herramienta en otro navegador.

En nuestra prueba, la sesión nueva respondió bien a los tres puntos, leyendo solo el README. Si en tu caso la respuesta es falsa o incompleta, corrige el README, no la respuesta.

3Paso 3: La rutina del mes

Una vez al mes, diez minutos:

exporta una copia de seguridad de los datos y guárdala con tus copias;
comprueba que se puede volver a importar (en otro navegador, por ejemplo);
repite dos o tres pruebas de la especificación;
mira git status: ¿está todo guardado?
anota la fecha en la parte «Último mantenimiento» del README.

4Paso 4: Archivar lo que ya no sirve

Una herramienta que ya no sirve: una última copia de seguridad de sus datos, una última versión de Git, y luego guarda la carpeta con tus proyectos archivados y anótalo en tu diario. Podrás retomarla gracias al README.

Ahora te toca a ti

El entregable del módulo 12: tu herramienta local, con:

su especificación, al día (lección 1);
la herramienta, con cada criterio comprobado (lecciones 3 y 4);
su historial de Git, con mensajes claros, y un .gitignore (lección 5);
ningún secreto ni dato personal innecesario (lección 6);
tu decisión de publicación en línea, por escrito (lección 7);
un README probado por una sesión nueva, y la fecha del primer mantenimiento.

Recursos para descargar

Plantilla de README para tu herramienta: las partes, la solicitud para tu agente y la prueba con una sesión nueva.

Comprobar

Funcionó si:

tu README cabe en una página, y una sesión nueva que solo lo lee a él responde bien;
la rutina del mes está anotada en tu calendario o en tu diario;
la parte «Último mantenimiento» del README tiene fecha;
sabes cómo archivar tu herramienta el día en que ya no sirva.

Errores frecuentes:

un README escrito una vez y nunca actualizado;
copias de seguridad que nunca se vuelven a importar: se descubre demasiado tarde que no funcionan;
agregar bibliotecas «para hacerlo mejor», y tener que mantenerlas;
modificar la herramienta sin pasar por la especificación y una versión de Git.

Guardar y retomar

Agrega la rutina del mes a tu mantenimiento mensual (módulo 5, lección 7).
Guarda juntos: la especificación, la herramienta, el README y la carpeta de copias de seguridad.

Para ir más lejos

opcional

El módulo 13 propone un proyecto final: tu herramienta puede ser su punto de partida.

Palabras nuevas

4 palabras explicadas

Palabra	Lo que significa
README	El manual de una herramienta, guardado en su carpeta
Mantenimiento	Las comprobaciones regulares que mantienen una herramienta útil y fiable
Dependencia	Un elemento externo que la herramienta necesita para funcionar (una biblioteca, un servicio)
Archivar	Guardar aparte una herramienta que ya no sirve, con lo necesario para retomarla