webbrain-one · Aug 6, 2026
diff --git a/README.es-ES.md b/README.es-ES.md
@@ -0,0 +1,107 @@
+
+
+# claude-colab
+
+Convierte Google Colab en un entorno de desarrollo impulsado por Claude Code.
+
+`claude-colab` es un **mercado de complementos para Claude Code** que incluye un cuaderno de Colab con autoconfiguración. Instala Claude Code y configura el complemento `claude-colab` con habilidades, agentes, ganchos y comandos.
+
+## Inicio rápido
+
+1. **Descarga el cuaderno** desde la [última versión](https://github.com/ali/claude-colab/releases/latest)
+2. Ábrelo en Google Colab
+3. Obtén un token OAuth de larga duración: `claude setup-token` (en tu máquina local)
+4. Agrega el token a los Secretos de Colab como `CLAUDE_CODE_OAUTH_TOKEN`
+5. Ejecuta todas las celdas
+6. Abre la terminal: `source ~/.bashrc && cd /content/claude-workspaces/my-project && claude`
+
+## Características del complemento
+
+El complemento **claude-colab** proporciona:
+
+| Tipo | Nombre | Descripción |
+|------|------|-------------|
+| **Comando** | `/claude-colab:colab-status` | Verificar estado de GPU, Drive y espacio de trabajo |
+| **Comando** | `/claude-colab:checkpoint` | Guardar espacio de trabajo en Google Drive |
+| **Comando** | `/claude-colab:colab-update` | Buscar actualizaciones del complemento |
+| **Habilidad** | claude-expert | Referencia y mejores prácticas de Claude Code |
+| **Habilidad** | ipynb | Manipulación de cuadernos Jupyter |
+| **Habilidad** | customize | Personalización del entorno |
+| **Habilidad** | docs-updater | Gestión de documentación |
+| **Habilidad** | skill-builder | Crear nuevas habilidades |
+| **Agente** | colab | Experto en entornos de Colab |
+| **Agente** | notebook-doctor | Diagnosticar y corregir problemas |
+| **Gancho** | SessionStart | Verificación automática de actualizaciones |
+| **Gancho** | PreToolUse | Verificación de seguridad para comandos peligrosos |
+
+## Características de seguridad
+
+El complemento incluye un gancho de seguridad que bloquea comandos peligrosos:
+- `rm -rf /` o `rm -rf ~` - Evita eliminar root/home
+- `rm -rf /content/drive` - Protege el montaje de Google Drive
+- Bombas fork y eliminadores de sistema
+- Escrituras directas en disco
+
+## Modos de almacenamiento
+
+- **Efímero (predeterminado)**: Espacio de trabajo en `/content/claude-workspaces/` - se reinicia en cada sesión
+- **Persistente**: Habilita Google Drive para guardar el espacio de trabajo entre sesiones
+
+## Flujos de trabajo comunes
+
+- **Editar repositorios cargados**: Sube un zip, descomprímelo, ejecuta `cd` en su carpeta y ejecuta `claude`
+- **Editar cuadernos**: Usa la habilidad `ipynb` para crear/editar archivos `.ipynb`
+- **Verificar estado**: Ejecuta `/claude-colab:colab-status` para obtener información del entorno
+- **Guardar trabajo**: Ejecuta `/claude-colab:checkpoint` para guardar en Drive
+
+## Arquitectura
+
+Este repositorio tiene un doble propósito:
+
+1. **Mercado de complementos** - Claude Code puede descargar el complemento directamente desde este repositorio de GitHub
+2. **Cuaderno de inicialización** - Descarga, configura el mercado y habilita el complemento
+
+```
+.claude-plugin/
+  marketplace.json     # Manifiesto del mercado
+src/plugin/
+  .claude-plugin/
+    plugin.json        # Manifiesto del complemento
+  skills/              # 5 habilidades
+  agents/              # 2 agentes
+  commands/            # 3 comandos
+  hooks/               # SessionStart, PreToolUse, PostToolUse
+  scripts/             # Implementaciones de ganchos
+```
+
+## Desarrollo
+
+### Configuración
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv sync
+```
+
+### Compilación
+
+```bash
+uv run python build.py
+# Genera dist/claude-colab.ipynb
+```
+
+### Pruebas
+
+```bash
+uv run python -m pytest tests/ -v
+```
+
+## Seguimiento de incidencias
+
+Este proyecto utiliza [beads](https://github.com/steveyegge/beads) para el seguimiento de incidencias. Las incidencias se almacenan en la rama `beads-sync`.
+
+```bash
+bd list          # Listar incidencias
+bd ready         # Encontrar trabajo desbloqueado
+bd create "..."  # Crear incidencia
+```