Explorar la documentación

Pack Backup: copias ZIP con fecha, restauración y rotación

Backup Manager comprime tu proyecto en ZIP con fecha, lista, restaura y rota los archivos con cuatro comandos slash. Instalación, cinco ejemplos, ubicaciones, exclusiones y lo que no cubre.

En esta página
  1. Cuándo usarlo
  2. Qué se instala
  3. Inicio rápido
  4. Ejemplos para copiar
  5. Qué escribe y dónde
  6. Flujos de datos y requisitos
  7. Límites y trampas

El pack Backup instala Backup Manager, un agente que hace una copia ZIP de tu proyecto con un comando, la nombra con fecha y hora, lista las copias, restaura una cuando se lo pides y poda las antiguas. Sirve justo antes de un cambio arriesgado, una gran refactorización o una migración, cuando quieres una vuelta atrás rápida que no dependa del control de versiones. Es deliberadamente simple: usa las herramientas de compresión de tu sistema y guarda los archivos en una carpeta backups/ dentro del proyecto.

Cuándo usarlo

  • Antes de una gran refactorización, una actualización de dependencias, una migración de datos o una ejecución de autopilot.
  • Para proyectos que no están bajo control de versiones o cuyo estado sin confirmar importa.
  • No sustituye a copias de seguridad reales: consulta los límites más abajo.

Qué se instala

Un pack empaquetado en .agents/skills/pack-backup/: el archivo del agente backup-agent.md y una plantilla de workflow templates/backup-workflow.md. No se incluye ninguna habilidad, archivo de datos ni script: el agente escribe él mismo los comandos, en PowerShell en Windows o en Bash en Linux y macOS, y sustituye el marcador %PROJECT_ROOT% por la ruta real de tu proyecto.

Menú de Backup Manager
ComandoQué hace
/backupCopia completa: un ZIP con fecha y hora del proyecto entero, con las exclusiones de abajo
/backup-listLista los ZIP de backups/, del más reciente al más antiguo, con tamaño y fecha
/backup-restoreExtrae un ZIP elegido en una carpeta nueva restore_<timestamp>/ en la raíz del proyecto
/backup-cleanRotación: conserva los últimos N archivos (5 salvo que indiques otra cosa) y borra el resto, tras preguntarte

Inicio rápido

  1. Instalar el pack

    Core se añade automáticamente. Solo hace falta Node.js 20 para el instalador.

    En la terminal del proyecto
    npx bmad-plus install --packs backup

  2. Hacer una primera copia

    El agente encuentra la raíz del proyecto, detecta tu sistema operativo, crea backups/ si hace falta, construye el archivo e indica su nombre y tamaño.

    En la terminal del proyecto
    /backup

  3. Ignorar la carpeta en el control de versiones

    Los archivos son simples datos del proyecto: mantenlos fuera de los commits (línea para añadir a .gitignore).

    En la terminal del proyecto
    backups/

Ejemplos para copiar

Hacer una copia con fecha y hora

Ejecútalo antes de cualquier cosa que puedas querer deshacer.

En tu asistente de IA
/backup y luego enumera lo que dejaste fuera del archivo para que compruebe que no falta nada que necesite.

Lo que deberías obtener Se crea el archivo backups/<project>_backup_<yyyyMMdd_HHmmss>.zip y el agente indica su nombre y su tamaño en megabytes. En la raíz del proyecto excluye node_modules, .git, vendor, backups/, __pycache__ y los archivos que coinciden con *.backup_*, que es la lista que el agente puede leerte.

Hacer una copia en lenguaje natural antes de un cambio arriesgado

Puedes llamar al agente por su nombre y pedirlo en lenguaje natural en lugar de escribir el comando slash.

En tu asistente de IA
Backup Manager, haz una copia de este proyecto antes de que renombre los módulos de src/ e indícame el tamaño del archivo.

Lo que deberías obtener El mismo archivo que /backup, con el tamaño a la vista. Mostrar el tamaño es una de las reglas del agente; en Linux y macOS el comando de referencia solo imprime el nombre del archivo, así que el agente tiene que añadir él mismo el tamaño.

Listar las copias que tienes

Úsalo para elegir qué archivo restaurar o podar.

En tu asistente de IA
/backup-list

Lo que deberías obtener Una tabla de los archivos *.zip de backups/, ordenados por fecha de última escritura (el más reciente primero), con nombre, tamaño en megabytes y fecha.

Restaurar sin sobrescribir tu trabajo

La restauración va a una carpeta aparte, así que puedes comparar antes de copiar nada de vuelta.

En tu asistente de IA
/backup-restore el archivo más reciente

Lo que deberías obtener El ZIP se extrae en restore_<yyyyMMdd_HHmmss>/ en la raíz del proyecto y el agente muestra esa ruta. Tus archivos actuales no se tocan; copia de vuelta lo que necesites.

Conservar solo las últimas copias

La rotación borra archivos, así que el agente siempre pide confirmación antes.

En tu asistente de IA
/backup-clean conserva las 3 últimas.

Lo que deberías obtener Tras tu confirmación, los archivos más antiguos que los tres más recientes se borran de backups/ y el agente indica cuántos se conservaron. Sin número, el valor por defecto es 5.

Qué escribe y dónde

Archivos y carpetas creados por el pack
RutaLo creaContenido
backups//backupLos archivos, con nombre <project>_backup_<yyyyMMdd_HHmmss>.zip
restore_<yyyyMMdd_HHmmss>//backup-restoreLa copia extraída de un archivo

Flujos de datos y requisitos

  • Windows: PowerShell con Compress-Archive y Expand-Archive. Linux y macOS: Bash y el programa zip, que debe estar instalado.
  • Tu herramienta anfitriona debe permitir al agente ejecutar comandos de shell. Nada sale de tu máquina: ni subida, ni llamada de red, ni clave.

Límites y trampas

Advertencia No es una copia de recuperación ante desastres

Los archivos están dentro del proyecto, en el mismo disco. Un disco perdido pierde ambos. El pack no programa copias, no las cifra ni las copia a otro sitio. Copia tú mismo los archivos importantes a otra ubicación.

Advertencia El historial de Git no está en el archivo

.git está excluido, así que una restauración devuelve archivos, no commits ni ramas. Las dependencias de node_modules y vendor también se excluyen: reinstálalas tras restaurar.

Nota Las exclusiones nombran carpetas de primer nivel

El comando de PowerShell filtra solo las entradas de la raíz del proyecto, y los patrones de Bash están escritos para carpetas de la raíz: las exclusiones se aplican solo en la raíz del proyecto. Un node_modules anidado (por ejemplo en packages/app/) puede acabar en el archivo. Vigila el tamaño que indica el agente y pídele que excluya más si hace falta.

Nota Nombres de comando que usar

El menú es /backup, /backup-list, /backup-restore y /backup-clean. No hay un subcomando create: /backup a secas crea el archivo.

Nota Procedencia

El pack Universal Backup lo escribió Laurent Rochetta en Oveanet, su empresa, y se integró en BMAD+.

Véase también