feat: Add docs

INDEX.md

@@ -0,0 +1,66 @@
+# 📚 Índice Rápido
+
+## 🚀 Punto de partida
+
+| Necesito | Archivo |
+|----------|---------|
+| Entender el proyecto | [README.md](README.md) |
+| Entender las tools | [README_TOOLS.md](README_TOOLS.md) |
+| Ver la estructura | [STRUCTURE.txt](STRUCTURE.txt) |
+
+## 📖 Documentación (en `docs/`)
+
+| Archivo | Tiempo | Descripción |
+|---------|--------|-------------|
+| **[docs/INICIO.txt](docs/INICIO.txt)** | 2 min | Bienvenida y guía visual |
+| **[docs/TOOLS_DOCUMENTATION_INDEX.md](docs/TOOLS_DOCUMENTATION_INDEX.md)** | 10 min | Índice maestro de toda la documentación |
+| **[docs/QUICK_START.py](docs/QUICK_START.py)** | 5 min | Tutorial interactivo para empezar |
+| [docs/TOOLS_GUIDE.md](docs/TOOLS_GUIDE.md) | 20 min | Guía completa del patrón Registry |
+| [docs/AGENDA_TOOLS_EXAMPLE.py](docs/AGENDA_TOOLS_EXAMPLE.py) | 15 min | 5 herramientas reales de ejemplo |
+| [docs/REGISTRY_IMPLEMENTATION_SUMMARY.md](docs/REGISTRY_IMPLEMENTATION_SUMMARY.md) | 10 min | Resumen de implementación |
+| [docs/README_REGISTRY.md](docs/README_REGISTRY.md) | 10 min | Resumen ejecutivo |
+| [docs/TOOL_REGISTRY_GUIDE.md](docs/TOOL_REGISTRY_GUIDE.md) | 15 min | Patrones y mejores prácticas |
+| [docs/CHANGES_SUMMARY.md](docs/CHANGES_SUMMARY.md) | 5 min | Qué cambió en el sistema |
+
+## 🎯 Buscar rápidamente
+
+**¿Cómo creo una tool?**
+→ [docs/TOOLS_GUIDE.md](docs/TOOLS_GUIDE.md#2-crear-una-herramienta-personalizada)
+
+**¿Cómo registro tools?**
+→ [docs/TOOLS_GUIDE.md](docs/TOOLS_GUIDE.md#3-registrar-y-usar-herramientas)
+
+**¿Qué métodos tiene ToolRegistry?**
+→ [docs/TOOLS_GUIDE.md](docs/TOOLS_GUIDE.md#4-métodos-disponibles-del-toolregistry)
+
+**¿Necesito ejemplos?**
+→ [docs/AGENDA_TOOLS_EXAMPLE.py](docs/AGENDA_TOOLS_EXAMPLE.py)
+
+**¿Cómo conecto con BD?**
+→ [docs/TOOLS_GUIDE.md](docs/TOOLS_GUIDE.md#5-ejemplo-completo-herramienta-para-gestionar-agenda)
+
+**¿Dónde escribo mis herramientas?**
+→ `src/naliiabot/bot/tools/tools.py`
+
+## ⏱️ Ruta rápida (20 minutos)
+
+```
+1. Lee:   README.md                           (2 min)
+2. Lee:   docs/TOOLS_DOCUMENTATION_INDEX.md   (10 min)
+3. Sigue: docs/QUICK_START.py                 (5 min)
+4. Listo: Ahora puedes crear tools ✅
+```
+
+## ✨ Beneficios del patrón Registry
+
+✅ Centralizado  
+✅ Extensible  
+✅ Testeable  
+✅ Mantenible  
+✅ Escalable  
+✅ Validado  
+✅ Documentado  
+
+---
+
+**Última actualización:** 15 Feb 2026