Subagentes livianos de Pi¶

Objetivo¶

Pi no trae subagentes nativamente. El paquete pi-subagents se retiró porque aportaba herramientas, FleetView, misiones, scheduler, watchdog y canales de supervisión que no se usan en este homelab.

El reemplazo es pi-subagents-lite, una extensión global mínima y versionada en el repo homelab-agents:

Código: /home/matias/.config/opencode/extensions/pi-subagents-lite/index.ts
Perfiles: /home/matias/.config/opencode/agents/pi-subagents-lite/
Carga global: ~/.pi/agent/settings.json → extensions

La extensión expone únicamente:

/run <agente> <tarea> para invocación manual.
run_subagent para que el agente principal delegue de forma automática.

Cada subagente es otro proceso pi aislado. No hereda extensiones, skills, archivos AGENTS.md, sesiones ni capacidad de crear subagentes. Su respuesta final vuelve al agente principal; la salida se limita a 50 KB.

Agentes disponibles¶

Agente	Propósito	Herramientas
`scout`	Reconocimiento local rápido y de solo lectura.	`read`, `grep`, `find`, `ls`
`researcher`	Investigación local y web verificable.	herramientas de lectura, `bash`, Betterwright `browser` y `browser_evidence`
`implementer`	Cambios aprobados y validación.	lectura, `bash`, `edit`, `write`
`reviewer`	Revisión de diff/plan y hallazgos verificables.	lectura y `bash`

Ejemplos:

/run scout Encontrá los archivos que controlan la autenticación.
/run reviewer Revisá el diff actual y reportá solo errores concretos.
/run researcher Investigá la documentación oficial de una dependencia.

Betterwright en `researcher`¶

Solo el hijo researcher carga explícitamente Betterwright desde el paquete ya instalado. Debe usar browser_evidence antes de navegar con browser, privilegiar fuentes primarias y verificar resultados visibles. No puede descargar archivos ni enviar formularios sin autorización explícita.

Mantenimiento¶

Tras cambiar la extensión o los perfiles, abrir una nueva sesión de Pi o ejecutar /reload. Los archivos fuente viven en homelab-agents; no editar copias bajo ~/.pi/agent/.

Skills activas¶

Las skills se mantienen deliberadamente cortas y solo guardan conocimiento local o guardas de seguridad: delegating-subagents, docker-networks, homelab-deploy y security. Los hijos se ejecutan con --no-skills; las reglas críticas de despliegue también viven en el perfil implementer.