@liriraid/agentflow-ai 1.0.28 → 1.0.29
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/bin/agentflow.mjs +0 -1
- package/package.json +65 -64
- package/templates/en/CLAUDE.md +27 -75
- package/templates/en/ORCHESTRATOR.md +20 -18
- package/templates/es/CLAUDE.md +27 -120
- package/templates/es/ORCHESTRATOR.md +21 -22
- package/templates/en/.atl/skill-registry.md +0 -27
- package/templates/en/.claude/skills/orchestrator-apply/SKILL.md +0 -31
- package/templates/en/.claude/skills/orchestrator-archive/SKILL.md +0 -26
- package/templates/en/.claude/skills/orchestrator-design/SKILL.md +0 -27
- package/templates/en/.claude/skills/orchestrator-explore/SKILL.md +0 -32
- package/templates/en/.claude/skills/orchestrator-init/SKILL.md +0 -32
- package/templates/en/.claude/skills/orchestrator-memory/SKILL.md +0 -26
- package/templates/en/.claude/skills/orchestrator-openspec/SKILL.md +0 -35
- package/templates/en/.claude/skills/orchestrator-propose/SKILL.md +0 -26
- package/templates/en/.claude/skills/orchestrator-queue-planning/SKILL.md +0 -50
- package/templates/en/.claude/skills/orchestrator-spec/SKILL.md +0 -27
- package/templates/en/.claude/skills/orchestrator-tasks/SKILL.md +0 -27
- package/templates/en/.claude/skills/orchestrator-verify/SKILL.md +0 -27
- package/templates/es/.atl/skill-registry.md +0 -133
- package/templates/es/.claude/skills/orchestrator-apply/SKILL.md +0 -32
- package/templates/es/.claude/skills/orchestrator-archive/SKILL.md +0 -28
- package/templates/es/.claude/skills/orchestrator-design/SKILL.md +0 -32
- package/templates/es/.claude/skills/orchestrator-explore/SKILL.md +0 -34
- package/templates/es/.claude/skills/orchestrator-init/SKILL.md +0 -32
- package/templates/es/.claude/skills/orchestrator-memory/SKILL.md +0 -31
- package/templates/es/.claude/skills/orchestrator-openspec/SKILL.md +0 -55
- package/templates/es/.claude/skills/orchestrator-propose/SKILL.md +0 -33
- package/templates/es/.claude/skills/orchestrator-queue-planning/SKILL.md +0 -52
- package/templates/es/.claude/skills/orchestrator-spec/SKILL.md +0 -28
- package/templates/es/.claude/skills/orchestrator-tasks/SKILL.md +0 -32
- package/templates/es/.claude/skills/orchestrator-verify/SKILL.md +0 -31
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: orchestrator-openspec
|
|
3
|
-
description: >
|
|
4
|
-
Abre, crea o actualiza artefactos de OpenSpec para cambios grandes o de varias fases.
|
|
5
|
-
license: MIT
|
|
6
|
-
metadata:
|
|
7
|
-
owner: agentflow
|
|
8
|
-
version: "0.1"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Skill: orchestrator-openspec
|
|
12
|
-
|
|
13
|
-
Trigger: "crea un change", "abre openspec", "haz proposal", "haz spec", "haz design", "prepara tasks del cambio"
|
|
14
|
-
|
|
15
|
-
## Propósito
|
|
16
|
-
|
|
17
|
-
Usar `openspec/` como capa persistente para cambios relevantes antes de delegar implementación al motor.
|
|
18
|
-
|
|
19
|
-
## Cuándo usar esta skill
|
|
20
|
-
|
|
21
|
-
- Cuando el cambio tiene varias fases o varios agentes
|
|
22
|
-
- Cuando el usuario pide proposal, spec, design o tasks explícitamente
|
|
23
|
-
- Cuando el cambio es lo bastante grande para no dejarlo solo en conversación
|
|
24
|
-
- Cuando hace falta mantener trazabilidad durable del cambio
|
|
25
|
-
|
|
26
|
-
## Reglas críticas
|
|
27
|
-
|
|
28
|
-
- Si no existe un change para el trabajo actual, crea uno en `openspec/changes/<change-name>/`.
|
|
29
|
-
- Usa nombres de change claros, en kebab-case y alineados con el objetivo del usuario.
|
|
30
|
-
- Usa `openspec/FLOW.md` como guía de fases y criterio de avance.
|
|
31
|
-
- Mantén consistencia entre:
|
|
32
|
-
- `proposal.md`
|
|
33
|
-
- `specs/spec.md`
|
|
34
|
-
- `design.md`
|
|
35
|
-
- `tasks.md`
|
|
36
|
-
- `verify-report.md`
|
|
37
|
-
- Mantén `.openspec.yaml` actualizado con `status`, `current_phase` y `queue_synced` cuando el change evolucione.
|
|
38
|
-
- `tasks.md` debe poder traducirse luego a `QUEUE.md`.
|
|
39
|
-
- No llenes `QUEUE.md` de implementación grande sin haber aterrizado primero el cambio en OpenSpec cuando el trabajo lo justifique.
|
|
40
|
-
- Si el cambio es pequeño y directo, no fuerces OpenSpec innecesariamente.
|
|
41
|
-
|
|
42
|
-
## Flujo recomendado
|
|
43
|
-
|
|
44
|
-
1. Definir o confirmar el `change-name`
|
|
45
|
-
2. Crear el change con `npm run openspec:new -- <change-name>` si no existe
|
|
46
|
-
3. Completar o actualizar `proposal.md`
|
|
47
|
-
4. Completar o actualizar `specs/spec.md`
|
|
48
|
-
5. Completar o actualizar `design.md` si el cambio lo requiere
|
|
49
|
-
6. Completar o actualizar `tasks.md`
|
|
50
|
-
7. Convertir las tareas listas en entradas concretas para `QUEUE.md`
|
|
51
|
-
8. Actualizar `verify-report.md` y `archive-report.md` cuando el cambio madure o cierre
|
|
52
|
-
|
|
53
|
-
## Resultado esperado
|
|
54
|
-
|
|
55
|
-
Un change de OpenSpec coherente, reutilizable y listo para alimentar el flujo de delegación del orquestador.
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: orchestrator-propose
|
|
3
|
-
description: >
|
|
4
|
-
Crea o actualiza la propuesta inicial de un cambio grande antes de delegar implementación.
|
|
5
|
-
Trigger: "haz proposal", "crea propuesta", "propone este cambio", "documenta el alcance"
|
|
6
|
-
license: MIT
|
|
7
|
-
metadata:
|
|
8
|
-
owner: agentflow
|
|
9
|
-
version: "1.0"
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Skill: orchestrator-propose
|
|
13
|
-
|
|
14
|
-
## Propósito
|
|
15
|
-
|
|
16
|
-
Crear la propuesta base del cambio para que el orquestador tenga claro qué se quiere hacer, por qué y con qué alcance.
|
|
17
|
-
|
|
18
|
-
## Reglas críticas
|
|
19
|
-
|
|
20
|
-
- Lee primero el contexto del usuario, `ORCHESTRATOR.md`, `QUEUE.md` y `openspec/FLOW.md` si existe.
|
|
21
|
-
- Si el cambio aún no tiene `change-name`, propón uno en kebab-case claro y estable.
|
|
22
|
-
- Crea o actualiza `openspec/changes/<change-name>/proposal.md`.
|
|
23
|
-
- La propuesta debe dejar claro:
|
|
24
|
-
- objetivo
|
|
25
|
-
- alcance
|
|
26
|
-
- restricciones
|
|
27
|
-
- riesgos iniciales
|
|
28
|
-
- qué no entra en este cambio
|
|
29
|
-
- Si el cambio es pequeño y directo, no fuerces una propuesta demasiado larga.
|
|
30
|
-
|
|
31
|
-
## Resultado esperado
|
|
32
|
-
|
|
33
|
-
Una propuesta clara que permita pasar a spec o design sin ambigüedad.
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: orchestrator-queue-planning
|
|
3
|
-
description: >
|
|
4
|
-
Convierte contexto y hallazgos en tareas concretas para QUEUE.md, con prioridades, agente objetivo y dependencias claras.
|
|
5
|
-
Trigger: "crea tareas", "planifica en queue", "divide el trabajo", "delegar tareas", "llenar queue"
|
|
6
|
-
license: MIT
|
|
7
|
-
metadata:
|
|
8
|
-
owner: agentflow
|
|
9
|
-
version: "0.2"
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Orchestrator Queue Planning
|
|
13
|
-
|
|
14
|
-
## Propósito
|
|
15
|
-
|
|
16
|
-
Traducir una necesidad del usuario o hallazgos de exploración en tareas concretas para el motor del orquestador.
|
|
17
|
-
|
|
18
|
-
## Reglas de asignación de agentes
|
|
19
|
-
|
|
20
|
-
### OpenCode — análisis solamente
|
|
21
|
-
- Úsalo para exploración, auditorías, lectura de contexto y reportes estructurados
|
|
22
|
-
- **No le asignes implementación** — OpenCode no modifica archivos del proyecto
|
|
23
|
-
- Si el trabajo necesita análisis previo, crea primero una TASK de OpenCode y luego una de Codex con dependencia `> after:TASK-NNN`
|
|
24
|
-
|
|
25
|
-
### Codex — implementación principal
|
|
26
|
-
- Úsalo para implementación, cambios de código, tests y docs técnicas cuando la spec esté clara
|
|
27
|
-
- Es el agente primario de ejecución
|
|
28
|
-
- Si Codex falla persistentemente, la TUI reasigna automáticamente a Claude-Worker (Frontend/Backend)
|
|
29
|
-
|
|
30
|
-
### Claude-Worker (Frontend / Backend)
|
|
31
|
-
- Es el fallback automático cuando Codex falla
|
|
32
|
-
- También puede tomar trabajo cuando Codex y OpenCode están ambos ocupados y hay más tareas pendientes
|
|
33
|
-
- Para proyectos solo frontend: usar siempre `Frontend`; para backend: `Backend`
|
|
34
|
-
|
|
35
|
-
## Reglas críticas
|
|
36
|
-
|
|
37
|
-
- Escribe TASKs pequeñas, concretas y ejecutables.
|
|
38
|
-
- Cada tarea debe tener agente, prioridad, repo y descripción clara.
|
|
39
|
-
- Usa dependencias `> after:TASK-NNN` cuando una tarea no pueda arrancar todavía.
|
|
40
|
-
- No sobrecargues una sola IA con demasiadas tareas si puedes paralelizar sin riesgo.
|
|
41
|
-
- Distribución según cantidad de TASKs independientes:
|
|
42
|
-
- **1 tarea de análisis**: OpenCode
|
|
43
|
-
- **1 tarea de implementación**: Codex
|
|
44
|
-
- **2 tareas paralelas**: OpenCode (análisis) + Codex (implementación si la spec ya es clara)
|
|
45
|
-
- **3+ tareas** y Codex ocupado: el excedente va a `Frontend` (repo FE) o `Backend` (repo BE)
|
|
46
|
-
- Si existe un `openspec/changes/<change-name>/tasks.md`, úsalo como fuente de verdad.
|
|
47
|
-
- Mantén `QUEUE.md` coherente con el objetivo actual del usuario.
|
|
48
|
-
- **No asignes implementación a OpenCode** bajo ninguna circunstancia.
|
|
49
|
-
|
|
50
|
-
## Resultado esperado
|
|
51
|
-
|
|
52
|
-
Una cola clara y accionable que el motor pueda despachar de inmediato.
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: orchestrator-spec
|
|
3
|
-
description: >
|
|
4
|
-
Crea o actualiza la especificación funcional del cambio con requerimientos y escenarios.
|
|
5
|
-
Trigger: "haz spec", "crea especificación", "documenta requerimientos", "define escenarios"
|
|
6
|
-
license: MIT
|
|
7
|
-
metadata:
|
|
8
|
-
owner: agentflow
|
|
9
|
-
version: "1.0"
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Skill: orchestrator-spec
|
|
13
|
-
|
|
14
|
-
## Propósito
|
|
15
|
-
|
|
16
|
-
Traducir la propuesta del cambio en una especificación clara para que la implementación y la verificación tengan una referencia estable.
|
|
17
|
-
|
|
18
|
-
## Reglas críticas
|
|
19
|
-
|
|
20
|
-
- Lee la propuesta antes de escribir la spec.
|
|
21
|
-
- Crea o actualiza `openspec/changes/<change-name>/specs/spec.md`.
|
|
22
|
-
- Expresa requerimientos y escenarios de forma verificable.
|
|
23
|
-
- No mezcles demasiado diseño técnico dentro de la spec salvo que sea necesario para entender el comportamiento.
|
|
24
|
-
- Si faltan datos del usuario, deja explícitas las suposiciones.
|
|
25
|
-
|
|
26
|
-
## Resultado esperado
|
|
27
|
-
|
|
28
|
-
Una spec que permita pasar a design, tasks o verify sin depender de la conversación.
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: orchestrator-tasks
|
|
3
|
-
description: >
|
|
4
|
-
Descompone un cambio en tareas de implementación concretas y listas para traducirse a QUEUE.md.
|
|
5
|
-
Trigger: "haz tasks", "descompón el cambio", "crea tareas del cambio", "plan de tareas"
|
|
6
|
-
license: MIT
|
|
7
|
-
metadata:
|
|
8
|
-
owner: agentflow
|
|
9
|
-
version: "1.0"
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Skill: orchestrator-tasks
|
|
13
|
-
|
|
14
|
-
## Propósito
|
|
15
|
-
|
|
16
|
-
Convertir la propuesta, la spec y el diseño en tareas claras que el orquestador pueda delegar a agentes concretos.
|
|
17
|
-
|
|
18
|
-
## Reglas críticas
|
|
19
|
-
|
|
20
|
-
- Lee propuesta, spec y design antes de escribir tareas.
|
|
21
|
-
- Crea o actualiza `openspec/changes/<change-name>/tasks.md`.
|
|
22
|
-
- Las tareas deben ser:
|
|
23
|
-
- pequeñas
|
|
24
|
-
- delegables
|
|
25
|
-
- ordenables
|
|
26
|
-
- entendibles por un agente sin contexto infinito
|
|
27
|
-
- Marca si `tasks.md` ya fue traducido a `QUEUE.md`.
|
|
28
|
-
- Si el usuario quiere ejecución inmediata, el siguiente paso natural es `orchestrator-queue-planning`.
|
|
29
|
-
|
|
30
|
-
## Resultado esperado
|
|
31
|
-
|
|
32
|
-
Una lista de tareas lista para convertirse en cola viva del motor.
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: orchestrator-verify
|
|
3
|
-
description: >
|
|
4
|
-
Verifica que la implementación realmente cumpla la propuesta, la spec, el diseño y las tareas definidas.
|
|
5
|
-
Trigger: "verifica", "valida el cambio", "review contra spec", "confirma la implementación"
|
|
6
|
-
license: MIT
|
|
7
|
-
metadata:
|
|
8
|
-
owner: agentflow
|
|
9
|
-
version: "1.0"
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Skill: orchestrator-verify
|
|
13
|
-
|
|
14
|
-
## Propósito
|
|
15
|
-
|
|
16
|
-
Validar que lo implementado coincide con lo que el orquestador planeó y que Claude lo puede aceptar con criterio.
|
|
17
|
-
|
|
18
|
-
## Reglas críticas
|
|
19
|
-
|
|
20
|
-
- Lee proposal, spec, design, tasks y el estado real de implementación.
|
|
21
|
-
- Crea o actualiza `openspec/changes/<change-name>/verify-report.md`.
|
|
22
|
-
- Clasifica hallazgos como:
|
|
23
|
-
- crítico
|
|
24
|
-
- advertencia
|
|
25
|
-
- sugerencia
|
|
26
|
-
- Si el resultado no está alineado, no lo cierres como correcto.
|
|
27
|
-
- Claude debe seguir siendo quien valida si el resultado coincide con lo pedido en la task.
|
|
28
|
-
|
|
29
|
-
## Resultado esperado
|
|
30
|
-
|
|
31
|
-
Un verify-report útil para decidir si el cambio se acepta, se corrige o se archiva.
|