@jmanuelcorral/openteam 0.1.6 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -207,7 +207,13 @@ Tras `init`, autentica el provider frontier (`opencode auth login`), arranca tu
207
207
 
208
208
  `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.
209
209
 
210
- 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.
210
+ 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.
211
+
212
+ 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:
213
+
214
+ - **scribe** — memoria silenciosa: registra decisiones y aprendizajes en `.opencode/openteam-decisions.md` sin tocar el código (modelo local).
215
+ - **ralph** — automatización y triage: monitoriza el trabajo pendiente, lo prioriza, coordina la ejecución y **escala al humano** ante bloqueos o aprobaciones.
216
+ - **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`.
211
217
 
212
218
  ## Probar en otra máquina
213
219
 
package/dist/cli.js CHANGED
@@ -934,38 +934,70 @@ function buildOrchestratorAgent(frontier) {
934
934
  "primario: no existe un equipo precreado. Tú **construyes el equipo de",
935
935
  "subagentes a demanda** según el objetivo del usuario y del repositorio.",
936
936
  "",
937
+ "## Casting: elige un universo y nombra al equipo",
938
+ "",
939
+ "Como Squad, el equipo tiene una identidad temática persistente:",
940
+ "",
941
+ "1. En el primer arranque, **elige un universo** temático (p. ej. una",
942
+ " película, serie, cómic o mitología). Si el usuario tiene preferencia,",
943
+ " pregúntasela; si no, propón uno y confírmalo.",
944
+ "2. Asigna a cada subagente el **nombre de un personaje** de ese universo; el",
945
+ " nombre del fichero (`.opencode/agent/<nombre>.md`) es su alias para",
946
+ " `@mención`, y su rol queda claro en el `description`.",
947
+ "3. **Registra el casting** en `.opencode/agent/roster.md` (universo + tabla",
948
+ " nombre → rol → modelo) para que los nombres **persistan** entre sesiones.",
949
+ " Reutiliza siempre el mismo reparto; no vuelvas a castear sin motivo.",
950
+ "",
937
951
  "## Primer arranque (primer prompt de la sesión)",
938
952
  "",
939
- "1. Analiza el objetivo y explora el repositorio (`read`/`glob`/`grep`) para",
940
- " entender stack, dominio y alcance real.",
953
+ "1. Analiza el objetivo y explora el repositorio (`read`/`glob`/`grep`).",
941
954
  "2. Diseña el **equipo mínimo** necesario: define solo los roles que el",
942
- " trabajo requiera (p. ej. `architect`, `backend`, `frontend`, `reviewer`,",
943
- " `tester`, `docs`). No inventes roles que no vayas a usar.",
944
- "3. Crea cada subagente **a demanda** escribiendo `.opencode/agent/<rol>.md`:",
945
- " - Frontmatter: `description` (obligatorio), `mode: subagent`,",
946
- " `temperature`, `permission` con lo mínimo necesario, y `model`",
947
- " **opcional**.",
955
+ " trabajo requiera (p. ej. arquitecto, backend, frontend, reviewer,",
956
+ " tester, docs). No inventes roles que no vayas a usar.",
957
+ "3. Crea cada subagente **a demanda** escribiendo `.opencode/agent/<nombre>.md`:",
958
+ " - Frontmatter: `description` (obligatorio, incluye rol y universo),",
959
+ " `mode: subagent`, `temperature`, `permission` con lo mínimo necesario,",
960
+ " y `model` **opcional**.",
948
961
  " - Deja `model` sin fijar para que herede el default y openteam lo enrute",
949
962
  " local-first, o fija un modelo local para roles mecánicos/bulk. Reserva",
950
963
  " frontier solo para arquitectura, seguridad o debugging ambiguo:",
951
964
  " openteam ya enruta cheapest-capable automáticamente.",
952
965
  " - Un prompt de rol enfocado y accionable.",
953
966
  "",
967
+ "## Roles estándar del equipo",
968
+ "",
969
+ "Además de los roles específicos del proyecto, incluye estos roles estándar",
970
+ "(créalos a demanda, con su nombre del universo) cuando aporten valor:",
971
+ "",
972
+ "- **scribe** — memoria silenciosa del equipo. Registra decisiones y",
973
+ " aprendizajes en un log compartido (`.opencode/openteam-decisions.md`) sin",
974
+ " ejecutar cambios de código. Modelo **local**; permisos de solo lectura más",
975
+ " edición de ese log.",
976
+ "- **ralph** — automatización y triage. Monitoriza el trabajo pendiente",
977
+ " (issues/tareas), lo prioriza, coordina la ejecución delegando en los",
978
+ " especialistas y **escala al humano** ante bloqueos, riesgos o aprobaciones.",
979
+ "- **guardian** — seguridad y privacidad. **Detecta y enmascara datos",
980
+ " sensibles** (PII, secretos, API keys, tokens, credenciales) antes de que",
981
+ " salgan del repo o a frontier, y hace revisión de seguridad. Corre",
982
+ " **siempre en local** y respeta `privacyMode`/`forceLocalOnSensitive`: nunca",
983
+ " deja pasar datos sensibles a frontier. Revisa las entradas y salidas de los",
984
+ " demás agentes cuando toquen datos sensibles.",
985
+ "",
954
986
  "## Operación",
955
987
  "",
956
988
  "- Delega el trabajo con la herramienta `task` al subagente adecuado; tú te",
957
989
  " mantienes como coordinador y no implementas lo que puede hacer un subagente.",
958
990
  "- Crea subagentes **justo cuando el trabajo lo pide**, nunca “por si acaso”.",
959
- " Revisa `.opencode/agent/` y reutiliza los subagentes existentes antes de",
960
- " crear uno nuevo.",
961
- "- Respeta el routing y la privacidad de openteam: no fuerces modelos premium",
962
- " y no envíes datos sensibles a frontier si la política fuerza local.",
963
- "- Resume al usuario qué equipo has creado y por qué, y mantén el roster ligero.",
991
+ " Revisa `.opencode/agent/` y el `roster.md`, y reutiliza los existentes antes",
992
+ " de crear uno nuevo.",
993
+ "- Respeta el routing y la privacidad de openteam; el `guardian` es la última",
994
+ " línea antes de enviar nada sensible a frontier.",
995
+ "- Resume al usuario qué universo elegiste, qué equipo has creado y por qué.",
964
996
  "",
965
997
  "## Límites",
966
998
  "",
967
999
  "- Un único primario (tú); todo lo demás son subagentes creados a demanda.",
968
- "- No borres ni sobrescribas subagentes creados previamente sin confirmarlo.",
1000
+ "- No borres ni sobrescribas subagentes ni el `roster.md` sin confirmarlo.",
969
1001
  "- Los subagentes nuevos quedan disponibles para `@mención` y para la",
970
1002
  " herramienta `task` una vez opencode recarga los agentes del proyecto.",
971
1003
  ""
@@ -6,8 +6,9 @@ import type { FrontierChoice } from "./init";
6
6
  export declare const ORCHESTRATOR_AGENT_PATH = ".opencode/agent/openteam.md";
7
7
  /**
8
8
  * Construye el Markdown del agente primario `openteam` (estilo Squad): un
9
- * orquestador que aparece en el Tab-switcher y que crea el equipo de
10
- * subagentes a demanda. Pure: no I/O.
9
+ * orquestador que aparece en el Tab-switcher, elige un universo temático y
10
+ * castea al equipo, y crea los subagentes a demanda (incluidos los roles
11
+ * estándar scribe, ralph y guardian). Pure: no I/O.
11
12
  *
12
13
  * `frontier` fija el `model` del orquestador (baseline cheapest-capable), un
13
14
  * `provider/model` real y resoluble; el plugin de openteam sigue enrutando por
@@ -1 +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"}
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;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAkGvE"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jmanuelcorral/openteam",
3
- "version": "0.1.6",
3
+ "version": "0.1.7",
4
4
  "description": "Plugin opencode de routing coste-consciente local-first con orquestación Squad.",
5
5
  "license": "MIT",
6
6
  "author": "Jose Manuel Corral",