@liriraid/agentflow-ai 1.0.10

package/templates/es/README.md

@@ -0,0 +1,568 @@
+# Orquestador Multiagente
+
+> by **LiriRaid**
+
+Orquestador reusable para trabajar con múltiples agentes de código desde terminal, con un TUI propio, cola operativa, skills locales, memoria persistente con Engram y artefactos OpenSpec para cambios grandes.
+
+La idea central no es dejar que una sola IA haga todo, sino:
+
+- usar a **Claude** como orquestador principal
+  - usar **OpenCode** principalmente para exploración, lectura y contexto, pero también para implementar cuando convenga
+  - usar **Codex** para ejecución estructurada e implementación de apoyo
+- reflejar todo en una **TUI** que muestra estado, cola, agentes, logs y actividad real
+
+## Qué es hoy
+
+Este repo ya no es solo un runner con `QUEUE.md`.
+
+Hoy incluye:
+
+- **motor de orquestación** en `orchestrator.js`
+- **TUI Ink** conectada al motor real
+- **skills locales** en `.claude/skills/`
+- **routing local** con `CLAUDE.md`
+- **memoria persistente** con `ENGRAM.md`
+- **OpenSpec** para cambios grandes
+- **configuración por agente** con `agentProfiles`
+- **base de installer / ecosystem configurator**
+- **documentación local de componentes y arquitectura**
+
+## Valor del sistema
+
+Lo que agrega valor en este flujo:
+
+- TUI multiagente visible en tiempo real
+- cola operativa (`QUEUE.md`) integrada al runtime
+- delegación real para ahorro de tokens
+- separación clara entre:
+  - exploración
+  - planificación
+  - ejecución
+  - verificación
+
+## Documentación local
+
+La documentación reusable del sistema vive en:
+
+```bash
+docs/
+```
+
+Incluye:
+
+- `docs/architecture.md`
+- `docs/components.md`
+- `docs/agents.md`
+- `docs/engram.md`
+- `docs/openspec.md`
+- `docs/usage.md`
+
+## Modelo de uso recomendado
+
+Este orquestador **no debería ensuciar el repo real del producto**.
+
+La instalación recomendada es:
+
+- proyecto real:
+  - `C:/code/mi-proyecto`
+- workspace del orquestador:
+  - `C:/code/orchestrator-mi-proyecto`
+
+O sea:
+
+- el orquestador vive en una carpeta sibling del proyecto
+- el proyecto real queda limpio
+- el orquestador apunta al proyecto por config
+
+Ese es el modelo recomendado para usar el orquestador sin ensuciar el repo real del producto.
+
+## Instalación desde npm
+
+Nombre del paquete:
+
+```bash
+@liriraid/agentflow-ai
+```
+
+La página de npm puede mostrar el snippet genérico:
+
+```bash
+npm i @liriraid/agentflow-ai
+```
+
+pero **ese no es el flujo recomendado** para este proyecto.
+
+### Instalación global recomendada
+
+Instala el CLI una sola vez:
+
+```bash
+npm i -g @liriraid/agentflow-ai
+```
+
+Luego, para cada proyecto real, crea un workspace sibling del orquestador:
+
+```bash
+agentflow init-workspace C:/code/mi-proyecto
+```
+
+El installer preguntará si quieres generar el workspace en **EN** o **ES**. También puedes pasarlo directo:
+
+```bash
+agentflow init-workspace C:/code/mi-proyecto --lang en
+agentflow init-workspace C:/code/mi-proyecto --lang es
+```
+
+Eso debería dejar algo así:
+
+- proyecto real:
+  - `C:/code/mi-proyecto`
+- workspace del orquestador:
+  - `C:/code/orchestrator-mi-proyecto`
+
+### Alternativa sin instalación global
+
+Si no quieres instalarlo globalmente, puedes usar `npx`:
+
+```bash
+npx @liriraid/agentflow-ai-ai init-workspace C:/code/mi-proyecto --lang es
+```
+
+Ese comando crea un workspace reusable del orquestador junto al proyecto real.
+
+## Instalación desde el repo fuente
+
+Si vas a modificar el orquestador mismo:
+
+```bash
+git clone https://github.com/LiriRaid/agentflow.git
+cd agentflow
+npm install
+```
+
+Este repo local es la **fuente reusable** que tú modificas para agregar herramientas, cambiar el flujo o extender el sistema.
+
+## Qué instala el installer
+
+Cuando usas `init-workspace`, el installer crea una base de trabajo con:
+
+- `ORCHESTRATOR.md`
+- `CLAUDE.md`
+- `ENGRAM.md`
+- `AGENT-CONFIG.md`
+- `orchestrator.config.json`
+- `QUEUE.md`
+- `agents/`
+- `openspec/`
+- `.claude/`
+- `.codex/`
+- `.opencode/`
+
+También crea carpetas runtime:
+
+- `logs/`
+- `handoffs/`
+- `progress/`
+- `briefs/`
+
+## Flujo operativo esperado
+
+### 1. Instalar el CLI globalmente
+
+```bash
+npm i -g @liriraid/agentflow-ai
+```
+
+### 2. Crear el workspace del orquestador
+
+```bash
+agentflow init-workspace C:/code/mi-proyecto --lang es
+```
+
+Si tu proyecto vive, por ejemplo, en:
+
+```bash
+C:/code/mi-proyecto
+```
+
+el installer debería crear:
+
+```bash
+C:/code/orchestrator-mi-proyecto
+```
+
+### 3. Ajustar el config
+
+Edita:
+
+```bash
+orchestrator.config.json
+```
+
+para apuntar a los repos reales.
+
+### 4. Arrancar la TUI
+
+Modo Ink:
+
+```bash
+agentflow ink --paused
+```
+
+o desde el repo fuente:
+
+```bash
+npm run start:ink:paused
+```
+
+### 5. Abrir Claude Code en el workspace del orquestador
+
+Y darle el prompt de arranque:
+
+```text
+Lee ORCHESTRATOR.md y arranca.
+```
+
+o mejor:
+
+```text
+Lee ORCHESTRATOR.md, asume el rol de orquestador y arranca.
+```
+
+### 6. Pedir una tarea
+
+Ejemplos:
+
+- `explora este proyecto`
+- `analiza estos archivos`
+- `crea tareas para implementar este cambio`
+- `abre un change y prepara proposal, spec y tasks`
+
+Claude usará:
+
+- `CLAUDE.md` como routing local
+- `.claude/skills/` como skills del proyecto
+- `ENGRAM.md` para continuidad
+- `openspec/` para cambios grandes
+- `QUEUE.md` para ejecución viva en el motor
+
+## Modelo de seguridad recomendado
+
+Por defecto, el orquestador no debería correr en modo bypass total.
+
+Recomendación:
+
+- **Claude** como orquestador y autoridad final de revisión
+- **Claude-Worker** (`Backend` / `Frontend`) para tomar una tarea de código en paralelo cuando haya trabajo independiente suficiente o como fallback
+- **OpenCode** para lectura, exploración, contexto e implementación cuando se le asigne
+- **Codex** para implementación estructurada y apoyo técnico, incluyendo apoyo frontend acotado cuando la TASK lo indique
+- cambios sensibles o resultados dudosos deben volver a **Claude** para validación
+
+La idea es que los agentes trabajen, pero no autoacepten todo ciegamente. La sesión Claude-Orquestador coordina y revisa; los Claude-Workers ejecutan tareas asignadas por cola. El usuario conserva la aprobación final, con Claude como filtro principal de calidad.
+
+## UIs disponibles
+
+### Ink
+
+Comandos:
+
+```bash
+agentflow ink
+agentflow ink --paused
+agentflow ink --yolo
+```
+
+o desde el repo fuente:
+
+```bash
+npm run start:ink
+npm run start:ink:paused
+```
+
+Estado actual:
+
+- conectada al motor real
+- muestra `Pausado` / `Ejecutando`
+- muestra tiempo activo
+- usa controles reales:
+  - `S`
+  - `P`
+  - `R`
+  - `Q`
+
+### Modo con bypass explícito
+
+Si en una sesión concreta quieres permitir modo agresivo para entornos de confianza, puedes iniciar el motor con:
+
+```bash
+agentflow ink --yolo
+```
+
+o:
+
+```bash
+node orchestrator.js --yolo
+```
+
+Ese modo no es el default y debe usarse solo cuando realmente lo decidas.
+
+### Blessed
+
+Sigue existiendo como runtime base histórico:
+
+```bash
+node orchestrator.js
+node orchestrator.js --paused
+```
+
+## Skills locales del proyecto
+
+Las skills viven en:
+
+```bash
+.claude/skills/
+```
+
+Actualmente incluye:
+
+- `orchestrator-init`
+- `orchestrator-explore`
+- `orchestrator-propose`
+- `orchestrator-spec`
+- `orchestrator-design`
+- `orchestrator-tasks`
+- `orchestrator-queue-planning`
+- `orchestrator-apply`
+- `orchestrator-verify`
+- `orchestrator-archive`
+- `orchestrator-memory`
+- `orchestrator-openspec`
+
+Estas skills son **locales del repo** y deben priorizarse sobre cualquier skill global instalada en el home del usuario.
+
+## Registry local
+
+Se regenera con:
+
+```bash
+npm run skills:registry
+```
+
+Salida:
+
+```bash
+.atl/skill-registry.md
+```
+
+Este registry sirve como catálogo local del proyecto y como fuente de resolución para Claude.
+
+## Memoria persistente con Engram
+
+La convención local vive en:
+
+```bash
+ENGRAM.md
+```
+
+Engram se usa para:
+
+- decisiones importantes
+- hallazgos no obvios
+- bugs y causas raíz
+- continuidad entre sesiones
+- resúmenes de sesión
+
+Engram no reemplaza:
+
+- `QUEUE.md`
+- la TUI
+- `ORCHESTRATOR.md`
+- handoffs
+
+Los complementa.
+
+## OpenSpec
+
+OpenSpec vive en:
+
+```bash
+openspec/
+```
+
+Estructura:
+
+```bash
+openspec/
+├── changes/
+├── FLOW.md
+├── specs/
+└── templates/
+```
+
+Crear un change:
+
+```bash
+agentflow openspec:new -- add-mi-cambio
+```
+
+o desde el repo fuente:
+
+```bash
+npm run openspec:new -- add-mi-cambio
+```
+
+Artefactos del change:
+
+- `proposal.md`
+- `specs/spec.md`
+- `design.md`
+- `tasks.md`
+- `verify-report.md`
+- `archive-report.md`
+- `.openspec.yaml`
+
+El flujo canónico está en:
+
+```bash
+openspec/FLOW.md
+```
+
+## Configuración por agente
+
+La configuración ahora se divide en dos capas:
+
+### `agents`
+
+Instancias operativas visibles para el motor.
+
+Ejemplo:
+
+- `Backend`
+- `Frontend`
+- `Codex`
+- `OpenCode`
+
+### `agentProfiles`
+
+Configuración reusable por familia de agente.
+
+Ejemplo actual:
+
+- `claude`
+- `codex`
+- `opencode`
+- `gemini`
+- `cursor`
+- `abacusai`
+
+Esto permite:
+
+- usar 1 agente
+- usar 3 agentes
+- dejar más perfiles preparados para el futuro
+
+### Inicializar carpetas locales por agente
+
+```bash
+agentflow agent-config:init
+```
+
+o:
+
+```bash
+npm run agent-config:init
+```
+
+Eso asegura:
+
+- `.claude/`
+- `.codex/`
+- `.opencode/`
+
+## Config ejemplo
+
+```json
+{
+  "projectName": "Mi Proyecto",
+  "maxConcurrent": 5,
+  "pollIntervalSeconds": 30,
+  "taskTimeoutMinutes": 30,
+  "repos": {
+    "backend": "C:/code/mi-backend",
+    "frontend": "C:/code/mi-frontend"
+  },
+  "agentProfiles": {
+    "claude": {
+      "enabled": true,
+      "localConfigDir": ".claude",
+      "skillsDir": ".claude/skills",
+      "primary": true,
+      "useForOrchestration": true
+    },
+    "codex": {
+      "enabled": true,
+      "localConfigDir": ".codex"
+    },
+    "opencode": {
+      "enabled": true,
+      "localConfigDir": ".opencode"
+    }
+  },
+  "agents": {
+    "Backend": {
+      "cli": "claude",
+      "profile": "claude",
+      "defaultRepo": "backend",
+      "model": "sonnet",
+      "instructionsFile": "agents/BACKEND.md"
+    },
+    "Codex": {
+      "cli": "codex",
+      "profile": "codex",
+      "defaultRepo": "backend",
+      "model": "gpt-5.5",
+      "instructionsFile": "agents/CODEX.md"
+    },
+    "OpenCode": {
+      "cli": "opencode",
+      "profile": "opencode",
+      "defaultRepo": "backend",
+      "model": "opencode/glm-5-free",
+      "instructionsFile": "agents/OPENCODE.md"
+    }
+  }
+}
+```
+
+## Controles de la TUI
+
+| Tecla | Acción                |
+| ----- | --------------------- |
+| `S`   | iniciar / reanudar    |
+| `P`   | pausar                |
+| `R`   | recargar `QUEUE.md`   |
+| `Q`   | salir y matar agentes |
+
+## Lo que este repo ya soporta
+
+- cola operativa con `QUEUE.md`
+- TUI conectada al motor real
+- skills locales del proyecto
+- routing local con `CLAUDE.md`
+- memoria persistente con Engram
+- OpenSpec para cambios grandes
+- configuración reusable por agente
+- installer / ecosystem configurator base
+
+## Lo que todavía sigue evolucionando
+
+- publicación definitiva en npm
+- pulido del installer
+- integración más profunda entre OpenSpec, routing y cola
+- futuras skills SDD más completas si hacen falta
+
+## Licencia
+
+MIT
+
+El texto completo está en `LICENSE`.

package/templates/es/agents/ABACUS.md

@@ -0,0 +1,25 @@
+# Abacus Agent
+
+## Rol
+Agente Abacus AI (`abacusai -p`). Ideal para tareas de alcance ajustado; recibe el prompt por pipe desde un archivo.
+
+## Alcance
+- Auditorías enfocadas y fixes puntuales
+- Tareas pequeñas y bien definidas, con criterios de aceptación claros
+
+## Reglas
+1. Nunca hagas `git commit` ni `git push`
+2. El control de git lo maneja manualmente el usuario
+3. Actualiza `progress/PROGRESS-Abacus.md` al terminar
+
+## Reporte de finalización (OBLIGATORIO)
+```
+TASK_REPORT
+status: completed | failed | blocked
+files_modified: list or "none"
+files_created: list or "none"
+files_deleted: list or "none"
+summary: 1-3 sentences
+issues: problems or "none"
+TASK_REPORT_END
+```

package/templates/es/agents/BACKEND.md

@@ -0,0 +1,28 @@
+# Backend Agent
+
+## Rol
+Desarrollador backend. Trabajas exclusivamente en el repo de API/servidor definido como tu `defaultRepo`.
+
+## Alcance
+- Código del lado del servidor: controllers, models, migrations, services y tests
+- Endpoints de API y lógica de negocio
+- Esquemas o estructuras de base de datos
+- Autenticación y autorización
+
+## No debes
+- Tocar código de frontend
+- Hacer commit o push al remoto
+- Tomar decisiones de control de git; eso lo hace el usuario manualmente
+
+## Reporte de finalización (OBLIGATORIO)
+Tu último mensaje DEBE incluir:
+```
+TASK_REPORT
+status: completed | failed | blocked
+files_modified: list or "none"
+files_created: list or "none"
+files_deleted: list or "none"
+summary: 1-3 sentences
+issues: problems or "none"
+TASK_REPORT_END
+```

package/templates/es/agents/CODEX.md

@@ -0,0 +1,37 @@
+# Codex Agent
+
+## Rol
+Agente de código de propósito general (OpenAI Codex). Es bueno para documentación, migraciones y tareas estructuradas con especificaciones claras. Puede trabajar tanto en backend como en frontend si la TASK lo indica.
+
+## Alcance
+Lo que indique el brief de la tarea. Toma tu `defaultRepo` como directorio de trabajo, salvo que el campo `repo` de la tarea indique otra cosa.
+
+## Frontend
+
+El frontend lo lidera preferentemente el agente `Frontend` de Claude. Codex puede trabajar en frontend como apoyo cuando la tarea sea acotada, clara y verificable, por ejemplo:
+
+- tests
+- documentación técnica
+- ajustes mecánicos
+- refactors pequeños
+- fixes puntuales con archivos bien delimitados
+
+Para cambios amplios de UI/UX, arquitectura de componentes, flujos interactivos o decisiones visuales, prefiere asignar la TASK principal a `Frontend` y deja Codex solo como apoyo.
+
+## Reglas
+1. Nunca hagas `git commit` ni `git push`
+2. El control de git lo maneja manualmente el usuario
+3. Actualiza el archivo de progreso en `progress/PROGRESS-Codex.md` al terminar
+4. Si trabajas en frontend, mantén el alcance estrecho y no rediseñes UI sin que la TASK lo pida explícitamente
+
+## Reporte de finalización (OBLIGATORIO)
+```
+TASK_REPORT
+status: completed | failed | blocked
+files_modified: list or "none"
+files_created: list or "none"
+files_deleted: list or "none"
+summary: 1-3 sentences
+issues: problems or "none"
+TASK_REPORT_END
+```

package/templates/es/agents/CURSOR.md

@@ -0,0 +1,27 @@
+# Cursor Agent
+
+## Rol
+Agente Cursor CLI (`agent`). Fuerte para tareas mecánicas y limpiezas de alto volumen.
+
+## Alcance
+- Migraciones por find-and-replace: frameworks CSS, sintaxis SQL, etc.
+- Transformaciones repetitivas en muchos archivos
+- Formatting y fixes de lint
+
+## Reglas
+1. Nunca hagas `git commit` ni `git push`
+2. El control de git lo maneja manualmente el usuario
+3. Verifica con `grep` o `rg` que el conteo de residuos llegue a 0 para el patrón que estás eliminando
+4. Actualiza `progress/PROGRESS-Cursor.md` al terminar
+
+## Reporte de finalización (OBLIGATORIO)
+```
+TASK_REPORT
+status: completed | failed | blocked
+files_modified: list or "none"
+files_created: list or "none"
+files_deleted: list or "none"
+summary: 1-3 sentences
+issues: problems or "none"
+TASK_REPORT_END
+```

package/templates/es/agents/FRONTEND.md

@@ -0,0 +1,29 @@
+# Frontend Agent
+
+## Rol
+Desarrollador frontend. Trabajas exclusivamente en el repo de UI/cliente definido como tu `defaultRepo`.
+
+## Alcance
+- Componentes de UI, páginas, routing y estado
+- Código del cliente/API y composables
+- Styling: CSS, Tailwind, DaisyUI, etc.
+- i18n, accesibilidad y comportamiento responsive
+
+## No debes
+- Tocar código backend
+- Reformatear archivos no relacionados; mantén diffs mínimos y acotados a la tarea
+- Hacer commit o push al remoto
+- Tomar decisiones de control de git; eso lo hace el usuario manualmente
+
+## Reporte de finalización (OBLIGATORIO)
+Tu último mensaje DEBE incluir:
+```
+TASK_REPORT
+status: completed | failed | blocked
+files_modified: list or "none"
+files_created: list or "none"
+files_deleted: list or "none"
+summary: 1-3 sentences
+issues: problems or "none"
+TASK_REPORT_END
+```