CAPTAIN CLAUDE - Sistema Multiagente TZZR

Coordinador central del sistema TZZR (The Zero-Trust Resilient Resource Network). CAPTAIN CLAUDE gestiona la infraestructura distribuida, servicios centralizados y coordina agentes especializados en múltiples servidores.

Visión General

CAPTAIN CLAUDE es un sistema multiagente que coordina la infraestructura TZZR:

• Servidor Central: 69.62.126.110 (Gitea, PostgreSQL)
• Servidores Remotos: DECK, CORP, HST
• Almacenamiento: Cloudflare R2 (s3://architect/)
• Coordinación: Agentes especializados para tareas específicas

Infraestructura

Servidores

Servidor	IP	Función
Central	69.62.126.110	Control central, Gitea, PostgreSQL
DECK	72.62.1.113	Servicios, Agentes (Clara, Alfred, Mason, Feldman)
CORP	92.112.181.188	ERP (Odoo), CMS (Directus), Agentes (Margaret, Jared)
HST	72.62.2.84	Directus, Gestión de imágenes

Acceso SSH

Todos los servidores remotos son accesibles via SSH usando la clave ~/.ssh/tzzr:

ssh -i ~/.ssh/tzzr root@72.62.1.113      # DECK
ssh -i ~/.ssh/tzzr root@92.112.181.188   # CORP
ssh -i ~/.ssh/tzzr root@72.62.2.84       # HST

Almacenamiento R2

Cloudflare R2 almacena documentos, configuraciones y backups:

# Endpoint
https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com

# Estructura
s3://architect/
├── documentos adjuntos/       # Documentos para compartir
├── documentos adjuntos/architect/  # Reportes generados
├── system/                    # Configs, backups internos
├── gpu-services/              # Servicios GRACE/PENNY/FACTORY
├── backups/                   # Backups Gitea y sistema
└── auditorias/                # Logs de auditoría

Comandos R2

# Listar contenido
aws s3 ls s3://architect/ --endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com

# Subir archivo para usuario
aws s3 cp archivo.md "s3://architect/documentos adjuntos/archivo.md" \
  --endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com

# Subir archivo interno
aws s3 cp archivo "s3://architect/system/archivo" \
  --endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com

Agentes Especializados

CAPTAIN CLAUDE coordina múltiples agentes para diferentes tareas:

Agentes Disponibles

• Captain: Coordinador principal, análisis de tareas, delegación
• Coder: Implementación de código, desarrollo de features
• Reviewer: Revisión de código, calidad, estándares
• Researcher: Investigación, análisis, documentación
• Architect: Diseño de sistemas, arquitectura, optimización

Ejecución de Agentes

Los agentes pueden ejecutarse:

• En paralelo: Para tareas independientes
• Secuencialmente: Para tareas dependientes
• Interactivamente: Con feedback del usuario

Servicios en Cada Servidor

DECK (72.62.1.113)

Microservicios:

• Clara (5051) - Log inmutable y auditoría
• Alfred (5052) - Automatización de workflows
• Mason (5053) - Enriquecimiento de datos
• Feldman (5054) - Validador Merkle

Aplicaciones:

• Nextcloud (8084) - Almacenamiento en la nube
• Odoo (8069) - ERP
• Vaultwarden (8085) - Gestor de contraseñas
• Directus (8055) - CMS
• Mailcow (8180) - Servidor de correo

Infraestructura:

• PostgreSQL (5432) - Base de datos con pgvector
• Redis (6379) - Cache en memoria

CORP (92.112.181.188)

Aplicaciones:

• Odoo 17 (8069) - Sistema ERP empresarial
• Directus 11 (8055) - CMS y gestor de contenidos
• Nextcloud (8080) - Almacenamiento compartido
• Vaultwarden (8081) - Gestor de contraseñas

Microservicios:

• Margaret (5051) - Orquestación y coordinación
• Jared (5052) - Procesamiento de datos
• Mason (5053) - Generación de reportes
• Feldman (5054) - Auditoría y logging

Infraestructura:

• PostgreSQL (5432) - Base de datos

HST (72.62.2.84)

• Directus
• Gestión de imágenes
• Servicios de almacenamiento

Context-Manager

Sistema central para gestión de contexto persistente. Disponible en DECK.

Instalación

ssh -i ~/.ssh/tzzr root@72.62.1.113 "context-manager --help"

Comandos Principales

# Ver ayuda
context-manager --help

# Listar bloques de contexto
context-manager block list

# Ver contenido de bloque
context-manager block view <ID>

# Crear bloque
context-manager block add "nombre_bloque" \
  --tipo "project" \
  --contenido '{"estado": "en_progreso"}'

# Eliminar bloque
context-manager block remove <ID>

# Listar memoria compartida
context-manager memory list

# Agregar a memoria
context-manager memory add "clave" "contenido"

# Chat interactivo
context-manager chat

Documentación

Manuales disponibles para cada servidor:

• MANUAL_USUARIO_DECK.md: Guía completa del servidor DECK

  • Servicios, configuración, troubleshooting
  • PostgreSQL y administración
  • Guías rápidas de inicio

• MANUAL_USUARIO_CORP.md: Guía completa del servidor CORP

  • Odoo 17 y Directus 11
  • Administración y troubleshooting
  • Procedimientos frecuentes

• MANUAL_USUARIO_HST.md: Documentación del servidor HST

Todos los manuales se encuentran en:

• Repositorio: /home/architect/captain-claude/
• R2: s3://architect/system/skynet v8/

Reglas de Operación

Principio Fundamental

No guardar documentos en servidor local.

• Los documentos y reportes generados van a R2, NO al filesystem local
• El servidor solo mantiene código, configuraciones y aplicaciones activas
• Limpieza automática después de generar archivos

Limpieza Automática

Al finalizar cualquier tarea que genere archivos:

1. Subir TODOS los archivos generados a R2

   aws s3 cp archivo "s3://architect/destino/archivo" \
     --endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
   

2. Verificar que están en R2

   aws s3 ls s3://architect/destino/ \
     --endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
   

3. Eliminar archivos locales

   rm -rf carpeta_local/
   

4. No esperar a que el usuario lo pida - ejecutar automáticamente

Destinos R2 por Tipo

Tipo	Destino R2
Auditorías	s3://architect/auditorias/
Reportes para usuario	s3://architect/documentos adjuntos/architect/
Configs/backups internos	s3://architect/system/
Documentos de usuario	s3://architect/documentos adjuntos/

Ejecución

Inicio

# Ejecutar CAPTAIN CLAUDE
python captain_claude.py

# O via script
./run.sh

Variables de Entorno

Se requieren:

• Acceso SSH a servidores remotos (clave ~/.ssh/tzzr)
• Credenciales de R2 (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
• APIs configuradas (Anthropic, OpenAI, etc.)

Logs y Monitoreo

Los logs se almacenan en:

• Local: captain_output/
• R2: s3://architect/auditorias/

Casos de Uso

1. Supervisar Estado de la Infraestructura

python captain_claude.py --action health-check --all-servers

2. Generar Reportes

python captain_claude.py --action report --type performance --output r2

3. Administrar Servicios

# Ver estado de servicio en DECK
ssh -i ~/.ssh/tzzr root@72.62.1.113 "docker ps"

# Reiniciar servicio
ssh -i ~/.ssh/tzzr root@72.62.1.113 "docker restart clara-service"

4. Gestionar Contexto

# Crear bloque de contexto para coordinación
context-manager block add "tarea_importante" \
  --tipo "coordination" \
  --contenido '{"agentes": ["coder", "reviewer"], "estado": "en_progreso"}'

Contacto y Soporte

Coordinación

• Servidor Central: Git en http://localhost:3000
• Bitácora: Logs en R2 s3://architect/auditorias/
• Documentación: Manuales en R2 s3://architect/system/skynet v8/

Escalation

1. Revisar logs relevantes
2. Consultar documentación
3. Crear ticket en Gitea
4. Contactar administrador del sistema

Información Técnica

Dependencias

• Python 3.8+
• SSH (conexión a servidores remotos)
• AWS CLI (acceso a R2)
• Docker (para servicios)
• PostgreSQL (base de datos)

Estructura del Proyecto

captain-claude/
├── README.md                    # Este archivo
├── CAPTAIN_CLAUDE.md            # Instrucciones de operación
├── captain_claude.py            # Coordinador principal
├── captain                      # Script de ejecución
├── apps/                        # Aplicaciones integradas
├── context-manager/             # Sistema de gestión de contexto
├── venv/                        # Entorno virtual Python
└── captain_output/              # Salidas y logs

Permisos y Seguridad

• Clave SSH protegida: ~/.ssh/tzzr
• Credenciales R2 en variables de entorno
• Logs auditados y almacenados en R2
• Acceso restringido por rol

Versión y Actualización

Versión: 1.0 Última actualización: 2025-12-30 Sistema: TZZR - Skynet v8

Licencia

Proyecto interno del sistema TZZR.

---

Para más información, consultar:

• Gitea: http://69.62.126.110:3000
• R2 System Docs: s3://architect/system/
• Manuales: s3://architect/system/skynet v8/