docs: add agent-driven installation workflow

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:

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.
+```

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/`: