Framework Multi-Agente para Desarrollo de Software Autónomo en Bare Metal
Arquitectura KISS para SDLC Enterprise con Agentes de IA Especializados

# Crear directorio persistente para Gitea
mkdir -p /opt/gitea/data /opt/gitea/config

# Ejecutar Gitea
docker run -d \
  --name gitea \
  --restart always \
  -p 3000:3000 \
  -p 222:22 \
  -v /opt/gitea/data:/data \
  -v /opt/gitea/config:/data/gitea/conf \
  -e USER_UID=1000 \
  -e USER_GID=1000 \
  gitea/gitea:latest

# Crear un Issue (PM Agent)
curl -X POST "http://localhost:3000/api/v1/repos/pm_agent/test/issues" \
  -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Implementar Todo-List", "body": "..."}'

# Crear un Pull Request (Dev Agent)
curl -X POST "http://localhost:3000/api/v1/repos/pm_agent/test/pulls" \
  -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Frontend implementation", "head": "feature/frontend", "base": "main"}'

# Fusionar un PR (PM Agent)
curl -X POST "http://localhost:3000/api/v1/repos/pm_agent/test/pulls/3/merge" \
  -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"merge_commit_id": "auto"}'

# Cerrar un Issue (PM Agent)
curl -X PATCH "http://localhost:3000/api/v1/repos/pm_agent/test/issues/2" \
  -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"state": "closed"}'

# Crear grupo compartido para herramientas
groupadd tools

# Crear usuarios para cada agente
for agent in pm_agent dev_frontend dev_backend qa_agent ci_cd doc_agent security_agent; do
  useradd -m -s /bin/bash $agent
  passwd $agent
  usermod -aG tools $agent
done

# Agregar ci_cd al grupo docker para construir contenedores
usermod -aG docker ci_cd

# Instalar Node.js, npm, OpenCode en /opt/tools
mkdir -p /opt/tools
cd /opt/tools

# Descargar e instalar Node.js
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | tar -xJ
ln -s node-v22.0.0-linux-x64 node
ln -s node/bin/node /usr/local/bin/node
ln -s node/bin/npm /usr/local/bin/npm
ln -s node/bin/npx /usr/local/bin/npx

# Instalar OpenCode
npm install -g opencode

# Configurar permisos
chown -R root:tools /opt/tools
chmod -R 775 /opt/tools

# Instalar Postfix (o usar el MTA nativo de Slackware)
# Configurar para entrega local únicamente
postconf -e "inet_interfaces = loopback-only"
postconf -e "mydestination = localhost, mtk.org"
systemctl restart postfix

/home/{agente}/
├── .opencode/
│   ├── opencode.json          # Configuración de permisos
│   └── system-prompt.md       # Instrucciones especializadas
└── .bashrc                    # Configuración del shell

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "default": {
      "prompt": "{file:/home/dev_frontend/.opencode/system-prompt.md}",
      "permission": {
        "write": "allow",
        "edit": "deny",
        "read": "allow",
        "bash": "allow"
      }
    }
  }
}

# DIRECTRICES OPERATIVAS: AGENTE DESARROLLADOR FRONTEND (NIVEL SENIOR)

## 1. MISIÓN Y ALCANCE
Usted actúa como Desarrollador Frontend Senior. Su responsabilidad es implementar
la interfaz de usuario según los requisitos del Product Manager.

DOMINIO EXCLUSIVO:
- Trabajar EXCLUSIVAMENTE en la carpeta /client
- Implementar componentes React, estilos CSS, y lógica de UI

PROHIBICIONES ABSOLUTAS:
- NO tocar archivos en /server
- NO escribir lógica de base de datos
- NO instalar dependencias globales

## 2. REGLA DE ORO DE AISLAMIENTO DE ROL
- Su único trabajo es el frontend
- Si necesita algo del backend, solicítelo por correo al PM

## 3. PROTOCOLO DE HERRAMIENTAS (POLÍTICA KISS)
Queda estrictamente prohibido el uso de MCPs. Toda interacción se ejecuta
exclusivamente vía bash usando utilidades POSIX.

REGLA DE ESCAPADO SEGURO:
- Para correos: Use heredocs con comillas simples (cat << 'EOF' | mail ...)

## 4. REGLA DE ENTORNO PRECONFIGURADO (CRÍTICO)
El sistema ya tiene Node.js, npm, npx y OpenCode instalados globalmente en /opt/tools.
- NUNCA intente instalar Node.js, npm o NVM
- NUNCA use apt install
- Ejecute npm install dentro del directorio del proyecto

# Comando obligatorio para leer el último correo
formail -s cat < /var/spool/mail/{agente}

# Enviar reporte al PM
cat << 'EOF' | mail -s "[COMPLETADO] Issue #X: Descripción" pm_agent@mtk.org
Estimado PM,

Se ha completado la implementación.

DETALLES TÉCNICOS:
- Issue: #X
- Rama: feature/descripcion
- Commit: hash
- PR: http://localhost:3000/pm_agent/test/pulls/Y

Atentamente,
{Agente}
EOF

# Ejecutar cada 5 minutos
*/5 * * * * /usr/local/bin/check-and-run-agent.sh