Cap 9: Power Tools y Memoria

Power tools de gstack

Los power tools no producen código — protegen contra errores destructivos y gestionan el conocimiento acumulado del agente.

/careful

Advierte antes de ejecutar comandos destructivos.

Comandos que intercepta:

# Interceptados y requieren confirmación explícita
rm -rf ./directorio
DROP TABLE usuarios;
git push --force
kubectl delete namespace produccion
truncate tabla_pagos;

# Whitelisted (no interceptados — son seguros en contexto de build)
rm -rf ./dist
rm -rf ./node_modules
rm -rf ./.next

Cómo funciona:

Claude va a ejecutar: rm -rf src/componentes/

⚠️  COMANDO DESTRUCTIVO DETECTADO

Directorio a eliminar: src/componentes/
Archivos afectados: 47 archivos, 3,200 líneas
Última modificación: hace 2 horas

¿Confirmar eliminación? (y/N)

/freeze

Restringe los edits de Claude a un único directorio.

Caso de uso típico:

Estás debugging un bug en src/services/auth/. Para evitar que el agente “arregle” cosas en otros módulos mientras investiga, congelas el scope:

/freeze src/services/auth/

Desde ese momento, cualquier intento de editar fuera de src/services/auth/ es bloqueado hasta que ejecutes /unfreeze.

Útil cuando:

• Tienes un bug crítico en un módulo específico
• El agente tiende a “mejorar” código relacionado no pedido
• Estás en una sesión de debugging puro y quieres control total

/guard

Combina /careful + /freeze para máxima seguridad.

# Equivalente a:
# /careful (activo)
# /freeze src/payments/ (solo edits en payments)
/guard src/payments/

Recomendado para módulos de alta criticidad: autenticación, pagos, datos personales.

/unfreeze

Remueve el lock de directorio.

/unfreeze
# Claude puede volver a editar cualquier archivo del proyecto

/connect-chrome

Lanza Chrome real controlado por gstack con el Side Panel de extensión activo.

/connect-chrome

Qué activa:

• Chrome en modo headed (visible en pantalla)
• Borde verde en la parte superior = controlado por gstack
• Side Panel con agente independiente para tareas en lenguaje natural
• Modo sin interferir con la ventana principal

Side Panel agent:

Agente independiente en el panel lateral del browser:

• Hasta 5 minutos por tarea
• Sesión separada (no interfiere con la principal)
• Casos de uso: extraer datos, llenar formularios, navegar portales autenticados

Comandos en modo headed:

$B connect      # Lanzar Chrome headed
$B handoff      # Pasar control al humano (CAPTCHAs, MFA)
$B resume       # Claude retoma el control
$B disconnect   # Volver a headless

/learn

Sistema de memoria de gstack para persistir patrones y preferencias entre sesiones.

Qué almacena:

• Patrones de código preferidos del proyecto
• Decisiones arquitectónicas tomadas
• Preferencias de estilo detectadas (con confidence score)
• Problemas recurrentes y sus soluciones

Operaciones:

/learn review    # Ver patrones almacenados con confidence scores
/learn search "autenticación"  # Buscar patrones específicos
/learn prune     # Eliminar patrones de baja confianza u obsoletos
/learn export    # Exportar memoria a archivo

Ejemplo de memoria almacenada:

Patrón: Manejo de errores HTTP
Confianza: 0.92
Fuente: 3 sesiones de review
Descripción: En este proyecto los errores HTTP se retornan
como { error: string, code: string } — no usar { message: string }

Patrón: Nomenclatura de endpoints
Confianza: 0.87
Descripción: REST plural: /users, /orders — no /user, /order

Por qué esto importa:

Sin memoria, cada sesión de Claude empieza desde cero. Con /learn, el agente acumula conocimiento del proyecto específico que no está en el código sino en las decisiones y preferencias del equipo.

/gstack-upgrade

Auto-actualiza gstack a la última versión.

/gstack-upgrade

Qué hace:

1. Sincroniza la instalación global (~/.claude/skills/gstack)
2. Sincroniza la instalación del proyecto (si existe)
3. Muestra el changelog de cambios
4. Re-ejecuta ./setup para registrar skills nuevos

Auto-upgrade:

gstack-config set auto_upgrade true

Con esto activo, gstack se actualiza automáticamente al inicio de cada sesión.

Tabla resumen de power tools

Tool	Protege contra	Cuándo usar
/careful	Comandos destructivos accidentales	Siempre en proyectos con datos reales
/freeze <dir>	Edits fuera de scope	Debugging enfocado en un módulo
/guard <dir>	/careful + /freeze combinados	Módulos críticos de alta sensibilidad
/unfreeze	—	Después de debugging enfocado
/connect-chrome	—	Testing visual o tareas en portales autenticados
/learn	Pérdida de contexto entre sesiones	Al final de sesiones con decisiones importantes
/gstack-upgrade	—	Periódicamente o cuando reportan bugs

Configuración global

# Ver configuración actual
gstack-config list

# Opciones disponibles
gstack-config set telemetry off       # Desactivar telemetría
gstack-config set auto_upgrade true   # Auto-actualizar
gstack-config set prefix true         # Usar /gstack-qa en vez de /qa

# Analytics locales de uso
gstack-analytics