carlospalanca.es/TODO.md

TODO — carlospalanca.es + Sistema Multi-Agente

Documentación técnica completa en /docs/

---

Fase 1 — Web Base ✅

• Scaffold Astro con template blog
• Instalar @astrojs/mdx, @astrojs/sitemap, @astrojs/rss
• Actualizar astro.config.mjs con site URL y config Markdown
• Actualizar src/content.config.ts con colecciones blog + guiones
• Crear src/content/guiones/ con .gitkeep
• Crear .github/workflows/ci.yml (build check en PRs)
• Crear .github/workflows/deploy.yml (deploy a VPS en merge a main)
• Crear AGENTS.md (fuente de verdad para agentes)

Fase 2 — Agentes ✅

• Crear agents/shared/github_client.py
• Crear agents/tyrion/ (orquestador)
• Crear agents/varys/ (SEO & research)
• Crear agents/samwell/ (guiones & blog)
• Crear agents/bronn/ (sponsors)
• Crear agents/bran/ (infraestructura)
• Crear agents/davos/ (redes sociales)
• Crear agents/arya/ (code review)
• Crear agents/daenerys/ (visuales)
• Crear agents/jon/ (formación)
• Crear agents/docker-compose.yml
• Crear agents/.env.example

Fase 3 — VPS ✅

• Crear vps/docker-compose.openwebui.yml
• Crear vps/nginx/carlospalanca.conf
• Crear vps/deploy.sh

Fase 4 — Documentación técnica ✅

• docs/setup/01-github.md — Configuración del repositorio GitHub
• docs/setup/02-vps.md — Provisionar y configurar el VPS
• docs/setup/03-openwebui.md — Instalar y configurar OpenWebUI
• docs/setup/04-discord.md — Crear las 9 Discord Apps y bots
• docs/setup/05-agents.md — Desplegar los agentes en el VPS
• docs/architecture.md — Arquitectura general del sistema
• docs/agents-reference.md — Referencia de cada agente
• docs/stack-explained.md — Qué es cada plataforma y para qué sirve
• docs/cost-roi.md — Coste, rendimiento y ganancia de cada componente

---

Pendiente — Tú lo haces en el VPS/GitHub

4.1 GitHub ✅

• Crear repositorio cpalanca/carlospalanca.es en GitHub (público)
• Push inicial a main
• Crear GitHub Fine-Grained PAT (carlospalanca-agents) → guardado como secret AGENTS_GH_TOKEN
• Añadir GitHub Secrets: VPS_HOST, VPS_USER, VPS_SSH_PRIVATE_KEY, AGENTS_GH_TOKEN, OPENWEBUI_API_KEY
• Crear labels: agent-created, needs-review, approved
• Activar branch protection ruleset en main (requiere PR)

4.2 VPS ✅

• VPS existente en 217.154.185.188 (Ubuntu 24.04, Docker + NPM)
• DNS carlospalanca.es y ai.carlospalanca.es apuntando al VPS
• Stack carlospalanca con nginx:alpine en /opt/stacks/carlospalanca/
• SSL gestionado por Nginx Proxy Manager
• Deploy automático via GitHub Actions (push a main → rsync → /opt/stacks/carlospalanca/html/)
• https://carlospalanca.es operativo

4.3 OpenWebUI ✅

• Stack desplegado en /opt/stacks/openwebui/ con proxy-net
• NPM host ai.carlospalanca.es → openwebui:8080 con SSL
• Anthropic API key configurada (Claude 3.5 Sonnet)
• API Keys habilitadas en admin → secret OPENWEBUI_API_KEY añadido al repo
• https://ai.carlospalanca.es operativo

4.4 Discord ⏳ — MANUAL (no automatizable)

Discord no permite crear bots por API. Hay que hacerlo desde https://discord.com/developers/applications

• Activar Developer Mode: Discord → Ajustes → Avanzado → Modo desarrollador
• Crear categoría LA MANO DEL REY en tu servidor y los 9 canales:
  • el-trono-de-hierro, el-pajarillo, la-ciudadela, el-banco-de-hierro, el-muro
  • desembarco-del-rey, cara-sin-nombre, poniente-en-llamas, la-guardia-de-la-noche
• Copiar los 9 Channel IDs (click derecho → Copiar ID)
• Crear 9 Discord Applications en https://discord.com/developers/applications:
  • Tyrion Lannister, Varys, Samwell Tarly, Bronn, Bran Stark
  • Davos Seaworth, Arya Stark, Daenerys Targaryen, Jon Snow
• En cada app → Bot → activar Message Content Intent → Reset Token → copiar token
• En cada app → OAuth2 → bot permissions (Read + Send + History) → invitar al servidor
• Dar todos los tokens y Channel IDs para añadirlos como secrets

4.5 Despliegue de agentes (15 min)

• Dar tokens Discord y Channel IDs (ver 4.4)
• Claude Code desplegará agents/ en /opt/stacks/agents/ y creará el .env
• Verificar que los 9 bots aparecen online en Discord

4.6 Test end-to-end

• Escribir en #el-trono-de-hierro: "Tyrion, necesito un guión para un vídeo sobre Docker"
• Verificar que Tyrion responde y delega a Samwell en #la-ciudadela
• Verificar que Samwell crea un PR en GitHub
• Verificar que el CI build check comenta en el PR
• Hacer merge del PR
• Verificar que el deploy action despliega el sitio

---

Mejoras futuras (backlog)

• Añadir remotion/ con setup inicial de Remotion para Daenerys
• Personalizar el diseño de la web (colores, tipografía, logo)
• Añadir página de vídeos de YouTube con embed
• Añadir historial de conversaciones por agente en Discord
• Configurar Ansible playbooks con Bran para gestión de infra
• Dashboard de métricas del canal (views, subs) en la web