@liriraid/agentflow-ai 1.0.13 → 1.0.15

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.
@@ -44,17 +44,24 @@ Cuando necesites entender el proyecto para planificar tareas, **lee archivos des
44
44
 
45
45
  1. Lee este archivo completo.
46
46
  2. Lee `orchestrator.config.json` — identifica las rutas reales en `repos` (frontend, backend). Esas son las rutas del proyecto real donde trabajan los agentes.
47
- 3. Lee `<projectName>-plan.md` (o `PLAN.md` / `plan.md`) si existe; ese es el plan general.
48
- 4. Lee el handoff más reciente en `handoffs/HANDOFF-*.md` si existe la carpeta.
49
- 5. **Lee `INBOX.md` si existe** contiene notificaciones automáticas del TUI de tasks completadas que requieren tu atención (crear siguientes TASKs, leer reportes de agentes, etc.).
50
- 6. Lee `QUEUE.md` para ver trabajo activo y pendiente.
51
- 7. Lee todos los archivos `progress/PROGRESS-*.md` que existan para entender el estado actual de cada agente.
52
- 8. Lee `ENGRAM.md` para respetar la convención de memoria persistente del proyecto.
53
- 9. Si existe `openspec/`, úsalo como capa de artefactos para cambios grandes o de varias fases.
54
- 10. Pregunta al usuario qué quiere priorizar; no planifiques toda la sesión automáticamente.
47
+ 3. **Verifica la automatización de scripts:** revisa si existe `logs/schedule-configured.json`.
48
+ - Si **NO existe**: ejecuta `agentflow schedule` en el directorio del workspace para registrar `auto-trigger.js` (cada 1 min) y `monitor-check.js` (cada 5 min) en el programador de tareas. Luego crea `logs/schedule-configured.json` con `{"configuredAt": "<fecha>"}`. Informa al usuario que la automatización quedó lista.
49
+ - Si **ya existe**: continúa sin hacer nada.
50
+ 4. Lee `<projectName>-plan.md` (o `PLAN.md` / `plan.md`) si existe; ese es el plan general.
51
+ 5. Lee el handoff más reciente en `handoffs/HANDOFF-*.md` si existe la carpeta.
52
+ 6. **Lee `INBOX.md` si existe** contiene notificaciones automáticas del TUI de tasks completadas que requieren tu atención (crear siguientes TASKs, leer reportes de agentes, etc.).
53
+ 7. Lee `QUEUE.md` para ver trabajo activo y pendiente.
54
+ 8. Lee todos los archivos `progress/PROGRESS-*.md` que existan para entender el estado actual de cada agente.
55
+ 9. Lee `ENGRAM.md` para respetar la convención de memoria persistente del proyecto.
56
+ 10. Si existe `openspec/`, úsalo como capa de artefactos para cambios grandes o de varias fases.
57
+ 11. Pregunta al usuario qué quiere priorizar; no planifiques toda la sesión automáticamente.
55
58
 
56
59
  **Regla de INBOX:** Al inicio de CADA respuesta, si `INBOX.md` tiene entradas nuevas desde tu última lectura, léelo primero antes de responder al usuario. Así sabrás qué agentes terminaron y qué falta crear.
57
60
 
61
+ **Regla de STATUS:** También lee `STATUS.md` al inicio de cada respuesta para tener contexto del estado actual de los agentes y la cola. Este archivo se actualiza automáticamente cada 60 segundos.
62
+
63
+ **Regla de ACTIONS:** Si existe `ACTIONS.md`, léelo también - contiene acciones automáticas del monitoreo (tareas completadas que necesitan seguimiento, tareas fallidas, etc).
64
+
58
65
  ## Restricción operativa por defecto
59
66
 
60
67
  Aunque esta plantilla soporte múltiples agentes, en este proyecto debes operar **solo con estas 3 IA por defecto**:
@@ -71,13 +78,39 @@ Los demás agentes pueden permanecer configurados en `orchestrator.config.json`,
71
78
 
72
79
  Si el usuario dice explícitamente algo como:
73
80
 
81
+ - `estaré ausente 1 hora`
74
82
  - `estaré ausente 2 horas`
75
83
  - `me voy un rato`
76
84
  - `activa monitoreo`
77
- - `quédate revisando`
78
- - `monitorea mientras no estoy`
79
85
 
80
- entonces debes entrar en **Modo Ausencia** durante esa sesión.
86
+ **Activar Modo Ausencia:**
87
+ ```bash
88
+ echo away > .away-mode
89
+ ```
90
+
91
+ **El script monitor-check.js se ejecutará cada 5 minutos** y revisará:
92
+ - Tareas completadas sin seguimiento
93
+ - Tareas fallidas
94
+ - Tareas atascadas (>10 min)
95
+ - Y escribirá en ACTIONS.md
96
+
97
+ **Auto-desactivación:**
98
+ Cuando NO hay tareas pendientes Y NO hay agentes trabajando Y todas las tareas están completadas:
99
+ - El script elimina .away-mode automáticamente
100
+ - Modo Ausencia se desactiva solo
101
+ - Cuando vuelvas y le digas "ya volví" → Claade responde normalmente
102
+
103
+ **El script monitor-check.js se ejecutará cada 5 minutos** y revisará:
104
+ - Tareas completadas sin seguimiento
105
+ - Tareas fallidas
106
+ - Tareas atascadas (>10 min)
107
+ - Y escribirá en ACTIONS.md para que cuando vuelvas, Claude lo lea automáticamente
108
+
109
+ **Desactivar Modo Ausencia:**
110
+ ```bash
111
+ # Eliminar archivo indicador
112
+ del .away-mode
113
+ ```
81
114
 
82
115
  ### Qué significa Modo Ausencia
83
116
 
@@ -149,17 +182,23 @@ Revisa `orchestrator.config.json` → `agents`. Cada entrada tiene:
149
182
 
150
183
  ## Cómo asignar trabajo
151
184
 
152
- 1. Escribe TASKs en `QUEUE.md` (formato pipe; la TUI lo lee):
153
- ```
154
- TASK-NNN | titulo corto | Agent | P1 | repo | descripcion larga
155
- ```
156
- Valores válidos de `Agent`: exactamente las keys de `orchestrator.config.json.agents`.
157
- Valores válidos de `repo`: exactamente las keys de `orchestrator.config.json.repos`.
158
- 2. (Opcional) También escribe una spec larga en `TASKS.md` bajo un heading `### TASK-NNN`; se inyecta al brief.
159
- 3. (Opcional) Para un brief muy detallado, crea `briefs/TASK-NNN-BRIEF.md`; también se inyecta.
160
- 4. Dependencias: agrega `> after:TASK-NNN` al final de la descripción para bloquear la tarea.
161
- 5. Dile al usuario que presione **R** en la TUI para recargar la cola, o **S** si está pausada.
162
- 6. **Prioriza Codex y OpenCode** para toda implementación y exploración. Claude-Workers solo cuando hay saturación o fallo total de agentes de soporte.
185
+ 1. **Cuando el usuario pide un cambio o nueva tarea** → **NUNCA analices directamente**
186
+ - **Primero**: Crea una TASK en `QUEUE.md` asignada a **OpenCode** para que analice el contexto
187
+ - **Segundo**: Espera a que OpenCode termine su análisis (revisa INBOX.md o progress/)
188
+ - **Tercero**: Recibes el análisis → creas nueva TASK para implementar (Codex o OpenCode)
189
+ - **Nunca analices el código del proyecto directamente tu mismo** - eso lo hace OpenCode
190
+
191
+ 2. Escribe TASKs en `QUEUE.md` (formato pipe; la TUI lo lee):
192
+ ```
193
+ TASK-NNN | titulo corto | Agent | P1 | repo | descripcion larga
194
+ ```
195
+ Valores válidos de `Agent`: exactamente las keys de `orchestrator.config.json.agents`.
196
+ Valores válidos de `repo`: exactamente las keys de `orchestrator.config.json.repos`.
197
+ 3. (Opcional) También escribe una spec larga en `TASKS.md` bajo un heading `### TASK-NNN`; se inyecta al brief.
198
+ 4. (Opcional) Para un brief muy detallado, crea `briefs/TASK-NNN-BRIEF.md`; también se inyecta.
199
+ 5. Dependencias: agrega `> after:TASK-NNN` al final de la descripción para bloquear la tarea.
200
+ 6. **La TUI inicia automáticamente** - NO necesitas presionar R ni S. La TUI detecta nuevas tasks y las lanza.
201
+ 7. **Prioriza Codex y OpenCode** para toda implementación y exploración. Claude-Workers solo cuando hay saturación o fallo total de agentes de soporte.
163
202
  7. Distribución según cantidad de TASKs independientes:
164
203
  - **1 tarea**: OpenCode (exploración) o Codex (implementación). Nunca Claude-Worker en primera instancia.
165
204
  - **2 tareas**: OpenCode + Codex, una cada uno.
@@ -67,18 +67,18 @@
67
67
  "model": "gpt-5.5",
68
68
  "instructionsFile": "agents/CODEX.md"
69
69
  },
70
- "Gemini": {
70
+ "Gemini": {
71
71
  "cli": "gemini",
72
72
  "profile": "gemini",
73
73
  "defaultRepo": "frontend",
74
- "model": "gemini-3-pro-preview",
74
+ "model": "auto",
75
75
  "instructionsFile": "agents/GEMINI.md"
76
- },
76
+ },
77
77
  "OpenCode": {
78
78
  "cli": "opencode",
79
79
  "profile": "opencode",
80
80
  "defaultRepo": "frontend",
81
- "model": "opencode/glm-5-free",
81
+ "model": "auto",
82
82
  "instructionsFile": "agents/OPENCODE.md"
83
83
  },
84
84
  "Cursor": {
@@ -92,7 +92,7 @@
92
92
  "cli": "abacusai",
93
93
  "profile": "abacusai",
94
94
  "defaultRepo": "backend",
95
- "model": "abacus-ai-agent",
95
+ "model": "auto",
96
96
  "instructionsFile": "agents/ABACUS.md"
97
97
  }
98
98
  }