Add comprehensive README for CAPTAIN CLAUDE system
- Document full infrastructure overview (Central, DECK, CORP, HST) - Add SSH access instructions and R2 storage documentation - Detail all available services and microservices - Include context-manager CLI commands and examples - Document operation rules and automatic cleanup procedures - Provide troubleshooting and contact information - Add examples for common use cases 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
ARCHITECT
352
README.md
Normal file
352
README.md
Normal file
@@ -0,0 +1,352 @@
|
|||||||
|
# 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`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ssh -i ~/.ssh/tzzr root@72.62.1.113 "context-manager --help"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Comandos Principales
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
```bash
|
||||||
|
aws s3 cp archivo "s3://architect/destino/archivo" \
|
||||||
|
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Verificar que están en R2
|
||||||
|
```bash
|
||||||
|
aws s3 ls s3://architect/destino/ \
|
||||||
|
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Eliminar archivos locales
|
||||||
|
```bash
|
||||||
|
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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python captain_claude.py --action health-check --all-servers
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Generar Reportes
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python captain_claude.py --action report --type performance --output r2
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Administrar Servicios
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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/
|
||||||
Reference in New Issue
Block a user