From d0808c4f9f2dc14e1ca2d39af3b68b9bfe4bc4d1 Mon Sep 17 00:00:00 2001
From: Paco <soporte@por-correo.com>
Date: Sat, 25 Apr 2026 00:26:01 +0200
Subject: [PATCH] docs: add agent-driven installation workflow

---
 README.md                      |  7 +++
 docs/INSTALACION_POR_AGENTE.md | 78 ++++++++++++++++++++++++++++++++++
 docs/QUICKSTART.md             |  4 ++
 3 files changed, 89 insertions(+)
 create mode 100644 docs/INSTALACION_POR_AGENTE.md

diff --git a/README.md b/README.md
index 372207b..1770e30 100644
--- a/README.md
+++ b/README.md
@@ -76,6 +76,7 @@ opencode-browser-tool/
 - `docs/VALIDACION_ENTORNO_LIMPIO.md`
 - `docs/PLAN_CIERRE_INSTALABLE.md`
 - `docs/INSTALACION_WINDOWS.md`
+- `docs/INSTALACION_POR_AGENTE.md`
 - `docs/REGISTRO_SITUACIONES.md`
 - `docs/contexto_workspace/` (snapshot de docs globales clave para continuidad)
 
@@ -88,6 +89,12 @@ La idea es que este proyecto pueda copiarse o descargarse en un PC con OpenCode
 - una guia de instalacion clara
 - o instrucciones que un agente de OpenCode pueda ejecutar
 
+Flujo recomendado para operario (minimo manual):
+
+1. `git clone ...`
+2. abrir OpenCode en esa carpeta
+3. pedir al agente que siga `docs/INSTALACION_POR_AGENTE.md`
+
 ### Que hace el setup
 
 El setup ejecuta, en orden:
diff --git a/docs/INSTALACION_POR_AGENTE.md b/docs/INSTALACION_POR_AGENTE.md
new file mode 100644
index 0000000..57c4b01
--- /dev/null
+++ b/docs/INSTALACION_POR_AGENTE.md
@@ -0,0 +1,78 @@
+# Instalacion por agente (flujo recomendado)
+
+Objetivo: que el usuario solo haga `git clone`, abra OpenCode y pida al agente ejecutar esta guia.
+
+## Flujo de usuario (minimo)
+
+1. Clonar el repo.
+2. Abrir OpenCode en la carpeta del proyecto clonado.
+3. Pedir al agente: "Lee `docs/INSTALACION_POR_AGENTE.md` y ejecuta la instalacion completa".
+
+Nada mas.
+
+## Instrucciones para el agente OpenCode (ejecutar en orden)
+
+1) Verificar entorno:
+
+- comprobar `node --version` (Node 20+)
+- comprobar `npm --version`
+
+2) Ejecutar setup neutral:
+
+```bash
+npm run setup
+```
+
+3) Verificar instalacion:
+
+```bash
+./check.sh
+```
+
+4) Crear config MCP local del proyecto en `.opencode/opencode.json` usando ruta absoluta dinamica:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "browser-tool": {
+      "type": "local",
+      "command": [
+        "node",
+        "<ABSOLUTE_PATH>/dist/server.js"
+      ]
+    }
+  }
+}
+```
+
+Donde `<ABSOLUTE_PATH>` es la ruta real de la carpeta clonada (obtenida con `pwd`).
+
+5) Confirmar conexion MCP:
+
+```bash
+opencode mcp list
+```
+
+Resultado esperado: `browser-tool` conectado.
+
+6) Smoke test minimo con la tool:
+
+- abrir navegador visible
+- navegar a `https://example.com`
+- tomar snapshot con label `install-smoke`
+- cerrar navegador
+
+7) Entregar resumen al usuario:
+
+- estado final (ok/fallo)
+- ruta usada en `.opencode/opencode.json`
+- evidencia de snapshot en `artifacts/`
+
+## Prompt sugerido para el usuario
+
+```text
+Lee y ejecuta exactamente lo indicado en docs/INSTALACION_POR_AGENTE.md.
+No me pidas pasos manuales adicionales salvo que falte un requisito de entorno.
+Al final, dame resultado y evidencia.
+```
diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md
index af1097e..94f3779 100644
--- a/docs/QUICKSTART.md
+++ b/docs/QUICKSTART.md
@@ -2,6 +2,10 @@
 
 Guia corta para dejar la herramienta lista y ejecutar una prueba minima.
 
+Si quieres minimizar pasos manuales, usa directamente:
+
+- `docs/INSTALACION_POR_AGENTE.md`
+
 ## 1) Instalar
 
 Desde `opencode-browser-tool/`: