# TODO — carlospalanca.es + Sistema Multi-Agente

> Documentación técnica completa en `/docs/`

---

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

## Fase 2 — Agentes ✅
- [x] Crear `agents/shared/github_client.py`
- [x] Crear `agents/tyrion/` (orquestador)
- [x] Crear `agents/varys/` (SEO & research)
- [x] Crear `agents/samwell/` (guiones & blog)
- [x] Crear `agents/bronn/` (sponsors)
- [x] Crear `agents/bran/` (infraestructura)
- [x] Crear `agents/davos/` (redes sociales)
- [x] Crear `agents/arya/` (code review)
- [x] Crear `agents/daenerys/` (visuales)
- [x] Crear `agents/jon/` (formación)
- [x] Crear `agents/docker-compose.yml`
- [x] Crear `agents/.env.example`

## Fase 3 — VPS ✅
- [x] Crear `vps/docker-compose.openwebui.yml`
- [x] Crear `vps/nginx/carlospalanca.conf`
- [x] Crear `vps/deploy.sh`

## Fase 4 — Documentación técnica ✅
- [x] `docs/setup/01-github.md` — Configuración del repositorio GitHub
- [x] `docs/setup/02-vps.md` — Provisionar y configurar el VPS
- [x] `docs/setup/03-openwebui.md` — Instalar y configurar OpenWebUI
- [x] `docs/setup/04-discord.md` — Crear las 9 Discord Apps y bots
- [x] `docs/setup/05-agents.md` — Desplegar los agentes en el VPS
- [x] `docs/architecture.md` — Arquitectura general del sistema
- [x] `docs/agents-reference.md` — Referencia de cada agente
- [x] `docs/stack-explained.md` — Qué es cada plataforma y para qué sirve
- [x] `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