84 lines
1.8 KiB
Markdown
84 lines
1.8 KiB
Markdown
# Instalacion por agente (flujo recomendado)
|
|
|
|
Objetivo: que el usuario solo haga `git clone`, abra OpenCode y pida al agente ejecutar esta guia.
|
|
|
|
Regla: el usuario no debe dar instrucciones adicionales.
|
|
|
|
## 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/`
|
|
|
|
8) Politica de interaccion (obligatoria):
|
|
|
|
- no pedir al usuario pasos extra
|
|
- ejecutar toda la instalacion de forma autonoma
|
|
- solo pedir aclaracion si hay bloqueo real no resoluble por el agente (por ejemplo: falta Node.js en el sistema o permisos insuficientes)
|
|
|
|
## Frase unica que debe usar el usuario
|
|
|
|
```text
|
|
Lee y ejecuta docs/INSTALACION_POR_AGENTE.md
|
|
```
|