@jmanuelcorral/openteam 0.1.5 → 0.1.7

package/README.md

@@ -9,6 +9,8 @@
 - [Requisitos](#requisitos)
 - [Instalación](#instalación)
 - [Quickstart: `openteam init`](#quickstart-openteam-init)
+- [Probar en otra máquina](#probar-en-otra-máquina)
+- [Actualizar openteam](#actualizar-openteam)
 - [Configuración](#configuración)
 - [Uso](#uso)
 - [Ejemplos en Windows](#ejemplos-en-windows)
@@ -205,7 +207,75 @@ Tras `init`, autentica el provider frontier (`opencode auth login`), arranca tu
 
 `openteam init` genera un único **agente primario** llamado `openteam` (`.opencode/agent/openteam.md`). Pulsa **Tab** en opencode para seleccionarlo: así sabes explícitamente que estás en modo openteam, mientras el plugin sigue optimizando el modelo por debajo.
 
-Ese orquestador funciona al estilo [Squad](https://bradygaster.github.io/squad/): **no trae subagentes precreados**. A partir de tu primer prompt analiza el objetivo y el repositorio, diseña el equipo mínimo de especialistas y **crea cada subagente a demanda** (escribiendo `.opencode/agent/<rol>.md` con `mode: subagent`), reutilizando los existentes antes de crear nuevos. Los roles mecánicos/bulk se dejan enrutar a modelos locales y solo se escala a frontier para arquitectura, seguridad o debugging ambiguo.
+Ese orquestador funciona al estilo [Squad](https://bradygaster.github.io/squad/): **no trae subagentes precreados**. A partir de tu primer prompt analiza el objetivo y el repositorio, diseña el equipo mínimo de especialistas y **crea cada subagente a demanda** (escribiendo `.opencode/agent/<nombre>.md` con `mode: subagent`), reutilizando los existentes antes de crear nuevos. Los roles mecánicos/bulk se dejan enrutar a modelos locales y solo se escala a frontier para arquitectura, seguridad o debugging ambiguo.
+
+Como Squad, el equipo tiene **identidad temática**: el orquestador elige (o te pregunta) un **universo** y nombra a cada agente con un personaje de ese universo, registrando el reparto en `.opencode/agent/roster.md` para que los nombres **persistan** entre sesiones. Además de los roles específicos del proyecto, contempla tres **roles estándar** creados a demanda:
+
+- **scribe** — memoria silenciosa: registra decisiones y aprendizajes en `.opencode/openteam-decisions.md` sin tocar el código (modelo local).
+- **ralph** — automatización y triage: monitoriza el trabajo pendiente, lo prioriza, coordina la ejecución y **escala al humano** ante bloqueos o aprobaciones.
+- **guardian** — seguridad y privacidad: **detecta y enmascara datos sensibles** (PII, secretos, API keys, tokens) antes de que salgan a frontier y hace revisión de seguridad; corre siempre en local y respeta `forceLocalOnSensitive`.
+
+## Probar en otra máquina
+
+Para instalar y probar openteam en otro equipo que ya tenga [opencode](https://opencode.ai) y [Bun](https://bun.sh):
+
+1. **Instala el paquete.** Global o como dependencia de desarrollo del repo que quieras usar:
+
+   ```powershell
+   # Opción global (deja el comando `openteam` en el PATH)
+   npm install -g @jmanuelcorral/openteam
+
+   # …o como dependencia de desarrollo del proyecto
+   bun add -d @jmanuelcorral/openteam   # (o: npm install -D @jmanuelcorral/openteam)
+   ```
+
+2. **Inicializa el repositorio** donde vayas a trabajar. Genera `opencode.json`, `.opencode/openteam.json` y `.opencode/agent/openteam.md`:
+
+   ```powershell
+   cd C:\ruta\a\tu\repo
+   openteam init          # global
+   # …o, si lo instalaste como dependencia del proyecto:
+   bunx openteam init
+   ```
+
+   El asistente detecta Ollama / LM Studio / Foundry Local, te deja elegir los modelos locales y el frontier baseline, y escribe la configuración.
+
+3. **Autentica el provider frontier** que hayas elegido:
+
+   ```powershell
+   opencode auth login
+   ```
+
+4. **Arranca tu runtime local** si no estaba activo (p. ej. `ollama serve`, o abre LM Studio / Foundry Local).
+
+5. **Abre opencode en el repo**, pulsa **Tab** y elige el agente `openteam`. Dale el primer prompt: creará el equipo de subagentes a demanda y enrutará local-first automáticamente.
+
+Comprueba el estado con `openteam doctor` (runtimes + config) y el ahorro con `openteam report`.
+
+## Actualizar openteam
+
+openteam se publica en npm de forma continua; cada push a `master` publica un nuevo patch. Para traer la última versión:
+
+```powershell
+# Instalación global
+npm install -g @jmanuelcorral/openteam@latest
+
+# Dependencia de desarrollo del proyecto
+bun add -d @jmanuelcorral/openteam@latest   # (o: npm install -D @jmanuelcorral/openteam@latest)
+```
+
+Comprobar versiones:
+
+```powershell
+npm view @jmanuelcorral/openteam version   # última publicada en npm
+npm ls -g @jmanuelcorral/openteam          # instalada globalmente (o `npm ls …` en el repo)
+```
+
+Notas al actualizar:
+
+- **No necesitas volver a ejecutar `openteam init`** para actualizar el plugin: opencode resuelve el paquete `@jmanuelcorral/openteam` declarado en `opencode.json` a la versión instalada. Reinicia opencode para que recargue el plugin.
+- Vuelve a ejecutar `openteam init` **solo** si quieres regenerar la configuración (cambiar runtimes, modelos o baseline). Pedirá confirmación antes de sobrescribir `opencode.json`, `.opencode/openteam.json` o `.opencode/agent/openteam.md`; **no toca los subagentes** que el orquestador haya creado a demanda.
+- Ajustes puntuales sin reinit: `openteam baseline set <provider/model>` o `openteam baseline auto`.
 
 ## Configuración
 

package/dist/cli.js

@@ -934,38 +934,70 @@ function buildOrchestratorAgent(frontier) {
     "primario: no existe un equipo precreado. Tú **construyes el equipo de",
     "subagentes a demanda** según el objetivo del usuario y del repositorio.",
     "",
+    "## Casting: elige un universo y nombra al equipo",
+    "",
+    "Como Squad, el equipo tiene una identidad temática persistente:",
+    "",
+    "1. En el primer arranque, **elige un universo** temático (p. ej. una",
+    "   película, serie, cómic o mitología). Si el usuario tiene preferencia,",
+    "   pregúntasela; si no, propón uno y confírmalo.",
+    "2. Asigna a cada subagente el **nombre de un personaje** de ese universo; el",
+    "   nombre del fichero (`.opencode/agent/<nombre>.md`) es su alias para",
+    "   `@mención`, y su rol queda claro en el `description`.",
+    "3. **Registra el casting** en `.opencode/agent/roster.md` (universo + tabla",
+    "   nombre → rol → modelo) para que los nombres **persistan** entre sesiones.",
+    "   Reutiliza siempre el mismo reparto; no vuelvas a castear sin motivo.",
+    "",
     "## Primer arranque (primer prompt de la sesión)",
     "",
-    "1. Analiza el objetivo y explora el repositorio (`read`/`glob`/`grep`) para",
-    "   entender stack, dominio y alcance real.",
+    "1. Analiza el objetivo y explora el repositorio (`read`/`glob`/`grep`).",
     "2. Diseña el **equipo mínimo** necesario: define solo los roles que el",
-    "   trabajo requiera (p. ej. `architect`, `backend`, `frontend`, `reviewer`,",
-    "   `tester`, `docs`). No inventes roles que no vayas a usar.",
-    "3. Crea cada subagente **a demanda** escribiendo `.opencode/agent/<rol>.md`:",
-    "   - Frontmatter: `description` (obligatorio), `mode: subagent`,",
-    "     `temperature`, `permission` con lo mínimo necesario, y `model`",
-    "     **opcional**.",
+    "   trabajo requiera (p. ej. arquitecto, backend, frontend, reviewer,",
+    "   tester, docs). No inventes roles que no vayas a usar.",
+    "3. Crea cada subagente **a demanda** escribiendo `.opencode/agent/<nombre>.md`:",
+    "   - Frontmatter: `description` (obligatorio, incluye rol y universo),",
+    "     `mode: subagent`, `temperature`, `permission` con lo mínimo necesario,",
+    "     y `model` **opcional**.",
     "   - Deja `model` sin fijar para que herede el default y openteam lo enrute",
     "     local-first, o fija un modelo local para roles mecánicos/bulk. Reserva",
     "     frontier solo para arquitectura, seguridad o debugging ambiguo:",
     "     openteam ya enruta cheapest-capable automáticamente.",
     "   - Un prompt de rol enfocado y accionable.",
     "",
+    "## Roles estándar del equipo",
+    "",
+    "Además de los roles específicos del proyecto, incluye estos roles estándar",
+    "(créalos a demanda, con su nombre del universo) cuando aporten valor:",
+    "",
+    "- **scribe** — memoria silenciosa del equipo. Registra decisiones y",
+    "  aprendizajes en un log compartido (`.opencode/openteam-decisions.md`) sin",
+    "  ejecutar cambios de código. Modelo **local**; permisos de solo lectura más",
+    "  edición de ese log.",
+    "- **ralph** — automatización y triage. Monitoriza el trabajo pendiente",
+    "  (issues/tareas), lo prioriza, coordina la ejecución delegando en los",
+    "  especialistas y **escala al humano** ante bloqueos, riesgos o aprobaciones.",
+    "- **guardian** — seguridad y privacidad. **Detecta y enmascara datos",
+    "  sensibles** (PII, secretos, API keys, tokens, credenciales) antes de que",
+    "  salgan del repo o a frontier, y hace revisión de seguridad. Corre",
+    "  **siempre en local** y respeta `privacyMode`/`forceLocalOnSensitive`: nunca",
+    "  deja pasar datos sensibles a frontier. Revisa las entradas y salidas de los",
+    "  demás agentes cuando toquen datos sensibles.",
+    "",
     "## Operación",
     "",
     "- Delega el trabajo con la herramienta `task` al subagente adecuado; tú te",
     "  mantienes como coordinador y no implementas lo que puede hacer un subagente.",
     "- Crea subagentes **justo cuando el trabajo lo pide**, nunca “por si acaso”.",
-    "  Revisa `.opencode/agent/` y reutiliza los subagentes existentes antes de",
-    "  crear uno nuevo.",
-    "- Respeta el routing y la privacidad de openteam: no fuerces modelos premium",
-    "  y no envíes datos sensibles a frontier si la política fuerza local.",
-    "- Resume al usuario qué equipo has creado y por qué, y mantén el roster ligero.",
+    "  Revisa `.opencode/agent/` y el `roster.md`, y reutiliza los existentes antes",
+    "  de crear uno nuevo.",
+    "- Respeta el routing y la privacidad de openteam; el `guardian` es la última",
+    "  línea antes de enviar nada sensible a frontier.",
+    "- Resume al usuario qué universo elegiste, qué equipo has creado y por qué.",
     "",
     "## Límites",
     "",
     "- Un único primario (tú); todo lo demás son subagentes creados a demanda.",
-    "- No borres ni sobrescribas subagentes creados previamente sin confirmarlo.",
+    "- No borres ni sobrescribas subagentes ni el `roster.md` sin confirmarlo.",
     "- Los subagentes nuevos quedan disponibles para `@mención` y para la",
     "  herramienta `task` una vez opencode recarga los agentes del proyecto.",
     ""

package/dist/commands/orchestratorAgent.d.ts

@@ -6,8 +6,9 @@ import type { FrontierChoice } from "./init";
 export declare const ORCHESTRATOR_AGENT_PATH = ".opencode/agent/openteam.md";
 /**
  * Construye el Markdown del agente primario `openteam` (estilo Squad): un
- * orquestador que aparece en el Tab-switcher y que crea el equipo de
- * subagentes a demanda. Pure: no I/O.
+ * orquestador que aparece en el Tab-switcher, elige un universo temático y
+ * castea al equipo, y crea los subagentes a demanda (incluidos los roles
+ * estándar scribe, ralph y guardian). Pure: no I/O.
  *
  * `frontier` fija el `model` del orquestador (baseline cheapest-capable), un
  * `provider/model` real y resoluble; el plugin de openteam sigue enrutando por

package/dist/commands/orchestratorAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestratorAgent.d.ts","sourceRoot":"","sources":["../../src/commands/orchestratorAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAErE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAkEvE"}
+{"version":3,"file":"orchestratorAgent.d.ts","sourceRoot":"","sources":["../../src/commands/orchestratorAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAErE;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAkGvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmanuelcorral/openteam",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Plugin opencode de routing coste-consciente local-first con orquestación Squad.",
   "license": "MIT",
   "author": "Jose Manuel Corral",