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 (15 min)

• Crear repositorio carlospalanca.es en GitHub
• Push inicial: git init && git add . && git commit -m "feat: initial project setup" && git remote add origin <url> && git push -u origin main
• Crear GitHub Fine-Grained PAT → ver docs/setup/01-github.md
• Añadir GitHub Secrets al repo → ver docs/setup/01-github.md
• Crear labels: agent-created, needs-review, approved
• Activar branch protection en main (requerir PR + CI)

4.2 VPS (30-60 min)

• Contratar VPS Ubuntu 24.04 (Hetzner CX22 recomendado ~5€/mes)
• Apuntar DNS carlospalanca.es y ai.carlospalanca.es a la IP del VPS
• Ejecutar bash vps/deploy.sh en el VPS → ver docs/setup/02-vps.md
• Obtener certificados SSL: sudo certbot --nginx -d carlospalanca.es -d www.carlospalanca.es -d ai.carlospalanca.es
• Verificar que https://carlospalanca.es carga la web

4.3 OpenWebUI (15 min)

• Subir vps/docker-compose.openwebui.yml al VPS en /opt/openwebui/
• Crear /opt/openwebui/.env → ver docs/setup/03-openwebui.md
• docker compose up -d
• Crear API key en OpenWebUI → guardar como OPENWEBUI_API_KEY
• Verificar https://ai.carlospalanca.es

4.4 Discord (30 min)

• Crear 9 Discord Applications → ver docs/setup/04-discord.md
• Activar "Message Content Intent" en cada bot
• Invitar los 9 bots al servidor
• Crear los 9 canales de Discord
• Copiar los 9 Channel IDs

4.5 Despliegue de agentes (15 min)

• Subir agents/ al VPS en /opt/agents/
• Crear /opt/agents/.env desde .env.example con todos los tokens
• docker compose up -d --build
• 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