Autonomous Agent Harness

¿Qué hace Autonomous Agent Harness?

Combina las herramientas de sesión de Claude Code con integraciones configuradas por separado para programación, memoria y uso de computadora. Esto es un patrón de configuración, no un tiempo de ejecución empaquetado siempre activo.

Límites de Consentimiento y Seguridad

La operación autónoma debe ser solicitada explícitamente y delimitada por el usuario. No crees horarios, despaches agentes remotos, escribas memoria persistente, uses control de computadora, publiques externamente, modifiques recursos de terceros ni actúes sobre comunicaciones privadas a menos que el usuario haya aprobado esa capacidad y el espacio de trabajo objetivo para la configuración actual.

Prefiere planes de prueba y archivos de cola locales antes de habilitar acciones recurrentes o basadas en eventos. Mantén credenciales, exportaciones de espacios de trabajo privados, conjuntos de datos personales y automatizaciones específicas de cuentas fuera de los artefactos ECC reutilizables.

Cuándo Activar

• El usuario quiere un agente que se ejecute de forma continua o programada
• Configurar flujos de trabajo automatizados que se activen periódicamente
• Construir un asistente de IA personal que recuerde el contexto entre sesiones
• El usuario dice "ejecuta esto todos los días", "revisa esto regularmente", "sigue monitoreando"
• Quiere replicar funcionalidades de Hermes, AutoGPT o frameworks de agentes autónomos similares
• Necesita uso de computadora combinado con ejecución programada

Arquitectura

┌──────────────────────────────────────────────────────────────┐
│                    Claude Code Runtime                        │
│                                                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐ │
│  │  Crons   │  │ Dispatch │  │ Memory   │  │ Computer    │ │
│  │ Schedule │  │ Remote   │  │ Store    │  │ Use         │ │
│  │ Tasks    │  │ Agents   │  │          │  │             │ │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────┬──────┘ │
│       │              │             │                │        │
│       ▼              ▼             ▼                ▼        │
│  ┌──────────────────────────────────────────────────────┐    │
│  │              ECC Skill + Agent Layer                  │    │
│  │                                                      │    │
│  │  skills/     agents/     commands/     hooks/        │    │
│  └──────────────────────────────────────────────────────┘    │
│       │              │             │                │        │
│       ▼              ▼             ▼                ▼        │
│  ┌──────────────────────────────────────────────────────┐    │
│  │              MCP Server Layer                        │    │
│  │                                                      │    │
│  │  memory    github    exa    supabase    browser-use  │    │
│  └──────────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────────┘

Componentes Principales

1. Memoria Persistente

Usa el sistema de memoria integrado de Claude Code mejorado con el servidor MCP de memoria para datos estructurados.

Memoria integrada (~/.claude/projects/*/memory/):

• Preferencias del usuario, comentarios, contexto del proyecto
• Almacenada como archivos markdown con frontmatter
• Cargada automáticamente al inicio de la sesión

Servidor MCP de memoria (grafo de conocimiento estructurado):

• Entidades, relaciones, observaciones
• Estructura de grafo consultable
• Persistencia entre sesiones

Patrones de memoria:

# Corto plazo: contexto de sesión actual
Usa TodoWrite para el seguimiento de tareas dentro de la sesión

# Medio plazo: archivos de memoria del proyecto
Escribe en ~/.claude/projects/*/memory/ para recordar entre sesiones

# Largo plazo: grafo de conocimiento MCP
Usa mcp__memory__create_entities para datos estructurados permanentes
Usa mcp__memory__create_relations para mapeo de relaciones
Usa mcp__memory__add_observations para nuevos datos sobre entidades conocidas

2. Operaciones Programadas (Crons)

Usa las tareas programadas nativas de Claude Code para indicaciones recurrentes dentro de una sesión interactiva. Estas tareas están limitadas al ámbito de la sesión; se requiere un programador externo para el trabajo que debe ejecutarse independientemente de una sesión abierta. No se requiere un servidor MCP de programación para /loop.

Configuración de un cron:

# En una sesión interactiva de Claude Code
/loop 30m Revisa los PRs abiertos en este repositorio y resume los fallos de CI.

Para una ejecución única desde un shell, establece el directorio de trabajo antes de invocar la CLI:

cd "/path/to/repo" && claude -p "Revisa los PRs abiertos y resume"

Usa un programador del SO o un cron de CI para invocar ese comando repetidamente cuando no haya una sesión interactiva en ejecución. Configura la autenticación y los permisos de herramientas del ejecutor por separado.

Patrones de cron útiles:

Patrón	Horario	Caso de Uso
Reunión diaria	0 9 * * 1-5	Revisar PRs, incidencias, estado de despliegue
Revisión semanal	0 10 * * 1	Métricas de calidad de código, cobertura de pruebas
Monitor por hora	0 * * * *	Salud de producción, comprobación de tasas de error
Compilación nocturna	0 2 * * *	Ejecutar suite completa de pruebas, escaneo de seguridad
Pre-reunión	*/30 * * * *	Preparar contexto para próximas reuniones

3. Despacho / Agentes Remotos

Haz que un job de CI autenticado o un receptor de webhook invoque a Claude Code en un espacio de trabajo que posee. El punto de entrada compatible es el modo CLI programático, no un endpoint público de despacho de Anthropic.

Patrones de despacho:

# Ejecutar dentro del espacio de trabajo de CI
cd "/path/to/repo" && claude -p "La compilación falló en main. Diagnostica el fallo."

# Activar desde webhook
# Webhook de GitHub -> ejecutor de CI autenticado -> claude -p -> resultado revisable

# Activar desde otro agente
claude -p "Analiza la salida del escaneo de seguridad y crea incidencias para los hallazgos"

4. Uso de Computadora

El control de computadora necesita una integración configurada por separado. La herramienta de uso de computadora y entorno de referencia de Anthropic requiere una aplicación para ejecutar llamadas de herramientas en un entorno de escritorio aislado. Agregar un nombre de paquete MCP no proporciona ese entorno.

Capacidades:

• Automatización del navegador (navegar, hacer clic, rellenar formularios, capturas de pantalla)
• Control de escritorio (abrir aplicaciones, escribir, control del ratón)
• Operaciones del sistema de archivos más allá de la CLI

Casos de uso dentro del arnés:

• Pruebas automatizadas de interfaces web
• Relleno de formularios y entrada de datos
• Monitoreo basado en capturas de pantalla
• Flujos de trabajo entre múltiples aplicaciones

5. Cola de Tareas

Gestiona una cola persistente de tareas que sobreviven los límites de la sesión.

Implementación:

# Persistencia de tareas a través de la memoria
Escribe la cola de tareas en ~/.claude/projects/*/memory/task-queue.md

# Formato de la tarea
---
name: task-queue
type: project
description: Cola de tareas persistente para operación autónoma
---

## Tareas Activas
- [ ] PR #123: Revisar y aprobar si el CI está en verde
- [ ] Monitorear despliegue: comprobar /health cada 30 min durante 2 horas
- [ ] Investigar: encontrar 5 clientes potenciales en el espacio de herramientas de IA

## Completadas
- [x] Reunión diaria: revisó 3 PRs, 2 incidencias

Reemplazando Hermes

Componente de Hermes	Equivalente en ECC	Cómo
Gateway/Router	CLI + programador externo	Un ejecutor autenticado inicia sesiones de agente
Sistema de Memoria	Memoria de Claude + servidor MCP de memoria	Persistencia integrada + grafo de conocimiento
Registro de Herramientas	Servidores MCP	Proveedores de herramientas cargados dinámicamente
Orquestación	Skills + agentes de ECC	Las definiciones de habilidad dirigen el comportamiento del agente
Uso de Computadora	Integración configurada por separado	Control de navegador o escritorio en un entorno aislado
Gestor de Contexto	Gestión de sesiones + memoria	Ciclo de vida de sesión de ECC 2.0
Cola de Tareas	Lista de tareas persistida en memoria	TodoWrite + archivos de memoria

Guía de Configuración

Paso 1: Configurar Servidores MCP

El servidor MCP de memoria es opcional. El servidor de memoria de referencia de MCP se publica como @modelcontextprotocol/server-memory; la versión 2026.8.31 fue verificada en el registro público npm el 2026-09-07. Es una implementación de referencia, no un servicio empaquetado con ECC.

Después de revisar ese paquete y aprobar su uso, fusiona esta entrada en la configuración MCP del usuario en ~/.claude.json, conservando la configuración existente. Reemplaza MEMORY_FILE_PATH con una ruta absoluta en un directorio privado que poseas. Consulta la Configuración MCP de Claude Code para el registro CLI y la configuración de Windows cmd /c npx.

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/[email protected]"],
      "env": {
        "MEMORY_FILE_PATH": "/ruta/absoluta/a/memoria/privada.jsonl"
      }
    }
  }
}

No registres paquetes npm adivinados o no publicados: npx -y ejecutaría cualquier cosa que se publique más tarde con ese nombre. Verifica el paquete exacto, el editor y la versión antes de agregar otro servidor. La programación y el uso de computadora no requieren los tres nombres de paquetes no publicados listados anteriormente aquí.

Paso 2: Crear Crons Base

Para sondeo durante una sesión interactiva, ingresa:

/loop 30m Revisa los PRs abiertos en este repositorio y resume los fallos de CI.

Para trabajo diario o semanal que debe sobrevivir a una sesión cerrada, configura un programador externo, como un cron del SO o GitHub Actions, para ejecutar el comando único del Paso 2 de Componentes Principales. Llamar a claude -p para solicitar un horario no aprovisiona un programador siempre activo. Elige el horario, el espacio de trabajo y las acciones permitidas explícitamente antes de habilitarlo.

Paso 3: Inicializar el Grafo de Memoria

# Inicializa tu identidad y contexto
claude -p "Crea entidades de memoria para: yo (perfil de usuario), mis proyectos, mis contactos clave. Agrega observaciones sobre las prioridades actuales."

Paso 4: Habilitar Uso de Computadora (Opcional)

Sigue el entorno de referencia de uso de computadora enlazado anteriormente, o la documentación para una integración específica del navegador que hayas revisado. Concede solo los permisos requeridos y verifica una acción inofensiva en el entorno aislado antes de agregarla a flujos de trabajo programados.

Ejemplos de Flujos de Trabajo

Revisor Autónomo de PRs

Cron: cada 30 min durante el horario laboral
1. Comprobar nuevos PRs en repositorios vigilados
2. Para cada nuevo PR:
   - Traer la rama localmente
   - Ejecutar pruebas
   - Revisar cambios con el agente revisor de código
   - Publicar comentarios de revisión a través del MCP de GitHub
3. Actualizar memoria con el estado de la revisión

Agente de Investigación Personal

Cron: diario a las 6 AM
1. Comprobar consultas de búsqueda guardadas en memoria
2. Ejecutar búsquedas de Exa para cada consulta
3. Resumir nuevos hallazgos
4. Comparar contra resultados de ayer
5. Escribir resumen en memoria
6. Marcar elementos de alta prioridad para revisión matutina

Agente de Preparación de Reuniones

Disparador: 30 min antes de cada evento del calendario
1. Leer detalles del evento del calendario
2. Buscar en memoria contexto sobre los asistentes
3. Extraer hilos recientes de correo electrónico/Slack con los asistentes
4. Preparar puntos de discusión y sugerencias de agenda
5. Escribir documento de preparación en memoria

Limitaciones

• Las indicaciones programadas nativas comparten su sesión interactiva. Las invocaciones del programador externo inician sesiones separadas a menos que se reanuden explícitamente.
• El uso de computadora requiere concesiones de permisos explícitas. No asumas acceso.
• La automatización de la CLI aún consume uso del modelo y está sujeta a los límites del proveedor configurado. Elige intervalos de programador apropiados.
• Los archivos de memoria deben mantenerse concisos. Archiva datos antiguos en lugar de permitir que los archivos crezcan sin límite.
• Siempre verifica que las tareas programadas se completaron exitosamente. Agrega manejo de errores a las indicaciones de cron.