@hoilab/ada-cli 0.85.1 → 0.85.4

package/dist/modes/interactive/theme/dark.json

@@ -0,0 +1,90 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "dark",
+	"vars": {
+		"cyan": "#00d7ff",
+		"blue": "#5f87ff",
+		"green": "#b5bd68",
+		"red": "#cc6666",
+		"yellow": "#ffff00",
+		"text": "#d4d4d4",
+		"gray": "#808080",
+		"dimGray": "#666666",
+		"darkGray": "#505050",
+		"accent": "#8abeb7",
+		"selectedBg": "#3a3a4a",
+		"userMsgBg": "#343541",
+		"toolPendingBg": "#282832",
+		"toolSuccessBg": "#283228",
+		"toolErrorBg": "#3c2828",
+		"customMsgBg": "#2d2838"
+	},
+	"colors": {
+		"accent": "accent",
+		"border": "blue",
+		"borderAccent": "cyan",
+		"borderMuted": "darkGray",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "text",
+		"thinkingText": "gray",
+
+		"selectedBg": "selectedBg",
+		"scrollbarThumb": "selectedBg",
+		"searchMatchBg": "selectedBg",
+		"searchMatchText": "text",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "text",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "text",
+		"customMessageLabel": "#9575cd",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "text",
+		"toolOutput": "gray",
+
+		"mdHeading": "#f0c674",
+		"mdLink": "#81a2be",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "accent",
+		"mdCodeBlock": "green",
+		"mdCodeBlockBorder": "gray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "gray",
+		"mdHr": "gray",
+		"mdListBullet": "accent",
+
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "gray",
+
+		"syntaxComment": "#6A9955",
+		"syntaxKeyword": "#569CD6",
+		"syntaxFunction": "#DCDCAA",
+		"syntaxVariable": "#9CDCFE",
+		"syntaxString": "#CE9178",
+		"syntaxNumber": "#B5CEA8",
+		"syntaxType": "#4EC9B0",
+		"syntaxOperator": "#D4D4D4",
+		"syntaxPunctuation": "#D4D4D4",
+
+		"thinkingOff": "darkGray",
+		"thinkingMinimal": "#6e6e6e",
+		"thinkingLow": "#5f87af",
+		"thinkingMedium": "#81a2be",
+		"thinkingHigh": "#b294bb",
+		"thinkingXhigh": "#d183e8",
+		"thinkingMax": "#ff5fff",
+
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#18181e",
+		"cardBg": "#1e1e24",
+		"infoBg": "#3c3728"
+	}
+}

package/dist/modes/interactive/theme/light.json

@@ -0,0 +1,89 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "light",
+	"vars": {
+		"teal": "#5a8080",
+		"blue": "#547da7",
+		"green": "#588458",
+		"red": "#aa5555",
+		"yellow": "#9a7326",
+		"text": "#1f2328",
+		"mediumGray": "#6c6c6c",
+		"dimGray": "#767676",
+		"lightGray": "#b0b0b0",
+		"selectedBg": "#d0d0e0",
+		"userMsgBg": "#e8e8e8",
+		"toolPendingBg": "#e8e8f0",
+		"toolSuccessBg": "#e8f0e8",
+		"toolErrorBg": "#f0e8e8",
+		"customMsgBg": "#ede7f6"
+	},
+	"colors": {
+		"accent": "teal",
+		"border": "blue",
+		"borderAccent": "teal",
+		"borderMuted": "lightGray",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "mediumGray",
+		"dim": "dimGray",
+		"text": "text",
+		"thinkingText": "mediumGray",
+
+		"selectedBg": "selectedBg",
+		"scrollbarThumb": "selectedBg",
+		"searchMatchBg": "selectedBg",
+		"searchMatchText": "text",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "text",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "text",
+		"customMessageLabel": "#7e57c2",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "text",
+		"toolOutput": "mediumGray",
+
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "teal",
+		"mdCodeBlock": "green",
+		"mdCodeBlockBorder": "mediumGray",
+		"mdQuote": "mediumGray",
+		"mdQuoteBorder": "mediumGray",
+		"mdHr": "mediumGray",
+		"mdListBullet": "green",
+
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "mediumGray",
+
+		"syntaxComment": "#008000",
+		"syntaxKeyword": "#0000FF",
+		"syntaxFunction": "#795E26",
+		"syntaxVariable": "#001080",
+		"syntaxString": "#A31515",
+		"syntaxNumber": "#098658",
+		"syntaxType": "#267F99",
+		"syntaxOperator": "#000000",
+		"syntaxPunctuation": "#000000",
+
+		"thinkingOff": "lightGray",
+		"thinkingMinimal": "#767676",
+		"thinkingLow": "blue",
+		"thinkingMedium": "teal",
+		"thinkingHigh": "#875f87",
+		"thinkingXhigh": "#8b008b",
+		"thinkingMax": "#af005f",
+
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#f8f8f8",
+		"cardBg": "#ffffff",
+		"infoBg": "#fffae6"
+	}
+}

package/dist/modes/interactive/theme/theme-schema.json

@@ -0,0 +1,352 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "Pi Coding Agent Theme",
+	"description": "Theme schema for Pi coding agent",
+	"type": "object",
+	"required": ["name", "colors"],
+	"properties": {
+		"$schema": {
+			"type": "string",
+			"description": "JSON schema reference"
+		},
+		"name": {
+			"type": "string",
+			"pattern": "^[^/]+$",
+			"description": "Theme name. Must not contain '/' because it is reserved for automatic light/dark theme settings."
+		},
+		"vars": {
+			"type": "object",
+			"description": "Reusable color variables",
+			"additionalProperties": {
+				"oneOf": [
+					{
+						"type": "string",
+						"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+					},
+					{
+						"type": "integer",
+						"minimum": 0,
+						"maximum": 255,
+						"description": "256-color palette index (0-255)"
+					}
+				]
+			}
+		},
+		"colors": {
+			"type": "object",
+			"description": "Theme color definitions (thinkingMax, scrollbarThumb, and search highlight colors are optional and use compatible fallbacks)",
+			"required": [
+				"accent",
+				"border",
+				"borderAccent",
+				"borderMuted",
+				"success",
+				"error",
+				"warning",
+				"muted",
+				"dim",
+				"text",
+				"thinkingText",
+				"selectedBg",
+				"userMessageBg",
+				"userMessageText",
+				"customMessageBg",
+				"customMessageText",
+				"customMessageLabel",
+				"toolPendingBg",
+				"toolSuccessBg",
+				"toolErrorBg",
+				"toolTitle",
+				"toolOutput",
+				"mdHeading",
+				"mdLink",
+				"mdLinkUrl",
+				"mdCode",
+				"mdCodeBlock",
+				"mdCodeBlockBorder",
+				"mdQuote",
+				"mdQuoteBorder",
+				"mdHr",
+				"mdListBullet",
+				"toolDiffAdded",
+				"toolDiffRemoved",
+				"toolDiffContext",
+				"syntaxComment",
+				"syntaxKeyword",
+				"syntaxFunction",
+				"syntaxVariable",
+				"syntaxString",
+				"syntaxNumber",
+				"syntaxType",
+				"syntaxOperator",
+				"syntaxPunctuation",
+				"thinkingOff",
+				"thinkingMinimal",
+				"thinkingLow",
+				"thinkingMedium",
+				"thinkingHigh",
+				"thinkingXhigh",
+				"bashMode"
+			],
+			"properties": {
+				"accent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Primary accent color (logo, selected items, cursor)"
+				},
+				"border": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Normal borders"
+				},
+				"borderAccent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Highlighted borders"
+				},
+				"borderMuted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Subtle borders"
+				},
+				"success": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Success states"
+				},
+				"error": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Error states"
+				},
+				"warning": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Warning states"
+				},
+				"muted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Secondary/dimmed text"
+				},
+				"dim": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Very dimmed text (more subtle than muted)"
+				},
+				"text": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Default text color (usually empty string)"
+				},
+				"thinkingText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking block text color"
+				},
+				"selectedBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Selected item background"
+				},
+				"scrollbarThumb": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Fullscreen scrollbar thumb background (falls back to selectedBg when omitted)"
+				},
+				"searchMatchBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Transcript search match background and current-match text (falls back to selectedBg when omitted)"
+				},
+				"searchMatchText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Transcript search match text and current-match background (falls back to text when omitted)"
+				},
+				"userMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message background"
+				},
+				"userMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message text color"
+				},
+				"customMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message background (hook-injected messages)"
+				},
+				"customMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message text color"
+				},
+				"customMessageLabel": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message type label color"
+				},
+				"toolPendingBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (pending state)"
+				},
+				"toolSuccessBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (success state)"
+				},
+				"toolErrorBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (error state)"
+				},
+				"toolTitle": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box title color"
+				},
+				"toolOutput": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box output text color"
+				},
+				"mdHeading": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown heading text"
+				},
+				"mdLink": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link text"
+				},
+				"mdLinkUrl": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link URL"
+				},
+				"mdCode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown inline code"
+				},
+				"mdCodeBlock": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block content"
+				},
+				"mdCodeBlockBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block fences"
+				},
+				"mdQuote": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote text"
+				},
+				"mdQuoteBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote border"
+				},
+				"mdHr": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown horizontal rule"
+				},
+				"mdListBullet": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown list bullets/numbers"
+				},
+				"toolDiffAdded": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Added lines in tool diffs"
+				},
+				"toolDiffRemoved": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Removed lines in tool diffs"
+				},
+				"toolDiffContext": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Context lines in tool diffs"
+				},
+				"syntaxComment": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: comments"
+				},
+				"syntaxKeyword": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: keywords"
+				},
+				"syntaxFunction": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: function names"
+				},
+				"syntaxVariable": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: variable names"
+				},
+				"syntaxString": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: string literals"
+				},
+				"syntaxNumber": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: number literals"
+				},
+				"syntaxType": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: type names"
+				},
+				"syntaxOperator": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: operators"
+				},
+				"syntaxPunctuation": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: punctuation"
+				},
+				"thinkingOff": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: off"
+				},
+				"thinkingMinimal": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: minimal"
+				},
+				"thinkingLow": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: low"
+				},
+				"thinkingMedium": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: medium"
+				},
+				"thinkingHigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: high"
+				},
+				"thinkingXhigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: xhigh"
+				},
+				"thinkingMax": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: max (falls back to thinkingXhigh when omitted)"
+				},
+				"bashMode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Editor border color in bash mode"
+				}
+			},
+			"additionalProperties": false
+		},
+		"export": {
+			"type": "object",
+			"description": "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
+			"properties": {
+				"pageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Page background color"
+				},
+				"cardBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Card/container background color"
+				},
+				"infoBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Info sections background (system prompt, notices)"
+				}
+			},
+			"additionalProperties": false
+		}
+	},
+	"additionalProperties": false,
+	"$defs": {
+		"colorValue": {
+			"oneOf": [
+				{
+					"type": "string",
+					"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+				},
+				{
+					"type": "integer",
+					"minimum": 0,
+					"maximum": 255,
+					"description": "256-color palette index (0-255)"
+				}
+			]
+		}
+	}
+}

package/dist/skills/ada-engine/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: ada-engine
+description: >
+  Orquestación autónoma: goal engine (objetivo de largo plazo con fases TDD y
+  juez con evidencia), workflows (deep-research, code-review, product-build,
+  codebase-audit, multi-perspective, scripts custom), grafo de trabajo
+  AUTÓNOMO. Cárgala SIEMPRE que el usuario pida: un objetivo grande o "goal",
+  investigación web profunda, revisión de código sistemática, construir un
+  producto con criterios, auditoría del repo, o análisis desde N perspectivas.
+  Si la tarea es una sola pasada (un fix, un script, responder algo), NO la
+  cargues — usa las tools normales.
+---
+
+# Ada Intelligence Engine — Opera SIN pensar
+
+Regla #1: **DECIDE tú, sin preguntar.** Si el usuario describe un objetivo,
+tú eliges goal, workflow o tools normales según el árbol de abajo, y ejecutas
+el procedimiento completo. Nunca respondas "¿quieres que lo haga con goal o
+workflow?" — ya lo decides tú.
+
+## Árbol de decisión (evalúa el pedido del usuario, elige el primero que aplique)
+
+```
+¿El usuario pide un OBJETIVO de largo plazo, iterativo, con criterios de éxito?
+   (ej: "arregla el login y verifícalo", "construye X", "mejora Y hasta que...")
+   → GOAL ENGINE. Ve a la Sección A.
+
+¿El usuario pide INVESTIGACIÓN / REVISIÓN / AUDITORÍA / ANÁLISIS MULTI-ÁNGULO?
+   (ej: "investiga Z", "revisa este código", "audita el repo", "compara A y B")
+   → WORKFLOW. Ve a la Sección B.
+
+¿El usuario pide UNA TAREA CONCRETA de una pasada?
+   (ej: "crea un script", "corrige este bug", "explica X", "escribe un test")
+   → TOOLS NORMALES. No hagas nada especial del engine.
+
+¿El usuario menciona "goal"/"workflow" EXPLÍCITAMENTE aunque la tarea parezca
+simple? → Respeta su elección y ve a la sección correspondiente.
+```
+
+## Sección A — GOAL (objetivo de largo plazo)
+
+### Procedimiento exacto (en este orden, sin saltarte pasos)
+
+1. **Crea el contrato** con la tool `goal_new`:
+   - `goal`: el objetivo verbatim del usuario.
+   - `doneCriteria`: 2-5 criterios **medibles y observables** (nunca vagos).
+     Si el usuario no los dio, **inventalos tú** a partir de su pedido.
+   - `verifyCommand`: comando de verificación si aplica (si no, "").
+2. **El goal queda en estado `setup`** — NO empieces a trabajar todavía.
+3. **Responde al usuario EXACTAMENTE con este formato** (corto, una línea):
+   ```
+   🎯 Goal creado: <id>
+   Criterios: <c1> · <c2> …
+   Apruebalo con: /goal approve <id>
+   ```
+   O si el usuario puede aprobar desde el panel: "Pulsa Approve en el panel Engine".
+4. **Cuando el goal esté aprobado** (estado `active`), el engine lanza un
+   **workflow dinámico por sub-tarea** (uno a la vez). El goal es el
+   CONTENEDOR — los pasos viven en los workflows. Tu trabajo:
+   - Si el plan (sub-tareas) está vacío: **divídelo tú** con la tool `todo`/
+     planificación — cada sub-tarea es UN paso concreto y verificable.
+   - El engine lanza el workflow de cada sub-tarea automáticamente; NO lo
+     lances tú a mano.
+   - Escribe código, corre tests, edita archivos. **El grafo se registra
+     SOLO** — no hagas nada para el grafo.
+5. **Cuando todas las sub-tareas estén done**, el juez evalúa los criterios.
+   Solo si emite `done`, el goal se completa. Nunca completes sin evidencia
+   real (archivo:línea, URL o salida de comando).
+
+### Cómo responder durante el goal (sin sobre-explicar)
+
+- Al completar una sub-tarea: `✓ <sub-tarea> — <1 línea de qué se hizo>`
+- Si algo bloquea: usa `goal_blocked` con el motivo y dile al usuario qué
+  necesitas.
+- Si una decisión necesita al usuario: `ask_user_question` (no adivines
+  criterios irreversibles como borrar datos o gastar dinero).
+
+## Sección B — WORKFLOW (investigación/revisión/auditoría)
+
+### Elegir el workflow (sin preguntar, según el pedido)
+
+| El usuario pide… | Lanzas… |
+|---|---|
+| Investigar algo con fuentes | `workflow run deep_research question="..."` |
+| Revisar código | `workflow run code_review` |
+| Construir un producto con criterios | `workflow run product_build brief="..."` |
+| Auditar el repo | `workflow run codebase_audit` |
+| Analizar desde N perspectivas | `workflow run multi_perspective problem="..."` |
+| Un flujo custom tuyo/guardado | `workflow run <nombre_script>` |
+
+### Procedimiento exacto
+
+1. Llama la tool `workflow` con `command: "run"` y el `name` + args.
+2. **La confirmación de coste es automática** (fail-closed 15s). No la
+   simules — el sistema la maneja. Si se confirma, el run arranca.
+3. **Responde al usuario EXACTAMENTE**:
+   ```
+   ⚡ Workflow lanzado: <name> (<runId>)
+   Fases: <f1> → <f2> → …
+   Sigue el progreso en el panel Engine o con /workflow status <runId>
+   ```
+4. Durante el run no bloquees esperando — el run es en background. Si el
+   usuario pregunta, usa `workflow status <runId>` y reporta fase actual,
+   agentes, tokens y coste.
+
+## Sección C — TOOLS NORMALES (una pasada)
+
+No cargues nada del engine. Haz la tarea con las tools normales
+(write/edit/bash/read). El grafo se registra solo si escribes archivos — no
+hagas nada especial. Responde normal.
+
+## Comportamiento global (aplica siempre)
+
+1. **Decide y ejecuta** — nunca preguntes "¿goal o workflow?".
+2. **Responde corto**: una línea de estado + el siguiente paso que el usuario
+   debe dar (si lo hay). No expliques el engine.
+3. **No registres el grafo manualmente** — es automático (escribir archivo →
+   ARTIFACT + implemented_by; test que pasa → verified_by; goal → spine).
+4. **Solo usa `graph_add_nodes`** cuando estés haciendo una auditoría y
+   quieras marcar `QA_FINDING`/`RISK`/`DECISION` concretos con su contexto.
+5. **Respeta los frenos**: si el bucle del goal se repite (3 turnos iguales),
+   pausa con `goal_blocked`/`goal_wait` y pide claridad. No fuerces.
+6. **Evidencia antes de done**: nunca declares un goal completado sin
+   `archivo:línea`/URL/comando que lo pruebe.
+
+## Referencia rápida (no la repitas al usuario)
+
+- **Modelo**: el goal es un CONTENEDOR; cada sub-tarea lanza un workflow
+  dinámico (goal_subtask). Cuando todas las sub-tareas done → juez → done.
+- **Tools del goal**: `goal_new` (crear contrato), `goal_complete` (cerrar con
+  evidencia), `goal_blocked`, `goal_wait`, `todo` (ver/crear sub-tareas),
+  `ask_user_question`.
+- **Tool `workflow`**: run/list/status/abort. Args: question=, brief=, problem=,
+  verifyCommand=, k=v custom.
+- **Scripts custom**: `~/.ada/agent/workflows/<nombre>.js` — se lanzan con
+  `workflow run <nombre>`. Cualquier JS con la API agent/parallel/pipeline/
+  phase/store/checkpoint/args/cwd/runId/log.
+- **Modelo**: los subagentes HEREDAN el modelo de la sesión principal por
+  defecto (misma auth → misma API key del chat). Los tiers cheap/main/judge
+  configuran overrides.
+- **Grafo**: autónomo (GraphSync). Consultas: `/graph gaps|context|search|gate`.
+- **Modelos**: tiers cheap/main/judge configurables; jueces intermedios baratos.
+
+## Prohibido
+
+- ✗ Responder "¿goal o workflow?" — decide tú.
+- ✗ Completar un goal sin evidencia citada.
+- ✗ Registrar el grafo manualmente (FILE/TASK) — automático.
+- ✗ Lanzar un workflow sin confirmación de coste (el sistema la pide; no la
+  eludas inventando resultados).
+- ✗ Crear goals o workflows desde un subagente — solo la sesión principal.
+- ✗ Inventar fuentes en deep_research — cada claim necesita ≥2 fuentes reales.
+- ✗ Consenso falso en multi_perspective — señala desacuerdos.