78 lines
1.6 KiB
Markdown
78 lines
1.6 KiB
Markdown
# 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.
|
|
```
|