@liriraid/agentflow-ai 1.0.10

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.
Files changed (110) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +79 -0
  3. package/bin/agentflow.mjs +332 -0
  4. package/orchestrator.js +1585 -0
  5. package/package.json +64 -0
  6. package/scripts/scaffold-agent-configs.mjs +100 -0
  7. package/scripts/scaffold-openspec-change.mjs +84 -0
  8. package/scripts/update-skill-registry.mjs +174 -0
  9. package/src/ink/app.mjs +240 -0
  10. package/src/ink/index.mjs +400 -0
  11. package/templates/en/.atl/skill-registry.md +27 -0
  12. package/templates/en/.claude/README.md +7 -0
  13. package/templates/en/.claude/skills/orchestrator-apply/SKILL.md +31 -0
  14. package/templates/en/.claude/skills/orchestrator-archive/SKILL.md +26 -0
  15. package/templates/en/.claude/skills/orchestrator-design/SKILL.md +27 -0
  16. package/templates/en/.claude/skills/orchestrator-explore/SKILL.md +29 -0
  17. package/templates/en/.claude/skills/orchestrator-init/SKILL.md +32 -0
  18. package/templates/en/.claude/skills/orchestrator-memory/SKILL.md +26 -0
  19. package/templates/en/.claude/skills/orchestrator-openspec/SKILL.md +35 -0
  20. package/templates/en/.claude/skills/orchestrator-propose/SKILL.md +26 -0
  21. package/templates/en/.claude/skills/orchestrator-queue-planning/SKILL.md +31 -0
  22. package/templates/en/.claude/skills/orchestrator-spec/SKILL.md +27 -0
  23. package/templates/en/.claude/skills/orchestrator-tasks/SKILL.md +27 -0
  24. package/templates/en/.claude/skills/orchestrator-verify/SKILL.md +27 -0
  25. package/templates/en/.codex/README.md +7 -0
  26. package/templates/en/.opencode/README.md +7 -0
  27. package/templates/en/AGENT-CONFIG.md +75 -0
  28. package/templates/en/CLAUDE.md +91 -0
  29. package/templates/en/ENGRAM.md +50 -0
  30. package/templates/en/ORCHESTRATOR.md +192 -0
  31. package/templates/en/PROJECT.md +70 -0
  32. package/templates/en/QUEUE.md +17 -0
  33. package/templates/en/README.md +188 -0
  34. package/templates/en/agents/ABACUS.md +36 -0
  35. package/templates/en/agents/BACKEND.md +37 -0
  36. package/templates/en/agents/CODEX.md +45 -0
  37. package/templates/en/agents/CURSOR.md +37 -0
  38. package/templates/en/agents/FRONTEND.md +36 -0
  39. package/templates/en/agents/GEMINI.md +37 -0
  40. package/templates/en/agents/OPENCODE.md +41 -0
  41. package/templates/en/docs/README.md +14 -0
  42. package/templates/en/docs/agents.md +33 -0
  43. package/templates/en/docs/architecture.md +43 -0
  44. package/templates/en/docs/components.md +14 -0
  45. package/templates/en/docs/engram.md +16 -0
  46. package/templates/en/docs/openspec.md +32 -0
  47. package/templates/en/docs/usage.md +66 -0
  48. package/templates/en/openspec/FLOW.md +24 -0
  49. package/templates/en/openspec/README.md +29 -0
  50. package/templates/en/openspec/changes/.gitkeep +1 -0
  51. package/templates/en/openspec/changes/archive/.gitkeep +1 -0
  52. package/templates/en/openspec/specs/.gitkeep +1 -0
  53. package/templates/en/openspec/templates/archive-report.md +21 -0
  54. package/templates/en/openspec/templates/change-metadata.yaml +9 -0
  55. package/templates/en/openspec/templates/design.md +26 -0
  56. package/templates/en/openspec/templates/proposal.md +27 -0
  57. package/templates/en/openspec/templates/spec.md +18 -0
  58. package/templates/en/openspec/templates/tasks.md +14 -0
  59. package/templates/en/openspec/templates/verify-report.md +21 -0
  60. package/templates/en/orchestrator.config.json +99 -0
  61. package/templates/es/.atl/skill-registry.md +133 -0
  62. package/templates/es/.claude/README.md +7 -0
  63. package/templates/es/.claude/skills/orchestrator-apply/SKILL.md +32 -0
  64. package/templates/es/.claude/skills/orchestrator-archive/SKILL.md +28 -0
  65. package/templates/es/.claude/skills/orchestrator-design/SKILL.md +32 -0
  66. package/templates/es/.claude/skills/orchestrator-explore/SKILL.md +31 -0
  67. package/templates/es/.claude/skills/orchestrator-init/SKILL.md +32 -0
  68. package/templates/es/.claude/skills/orchestrator-memory/SKILL.md +31 -0
  69. package/templates/es/.claude/skills/orchestrator-openspec/SKILL.md +55 -0
  70. package/templates/es/.claude/skills/orchestrator-propose/SKILL.md +33 -0
  71. package/templates/es/.claude/skills/orchestrator-queue-planning/SKILL.md +35 -0
  72. package/templates/es/.claude/skills/orchestrator-spec/SKILL.md +28 -0
  73. package/templates/es/.claude/skills/orchestrator-tasks/SKILL.md +32 -0
  74. package/templates/es/.claude/skills/orchestrator-verify/SKILL.md +31 -0
  75. package/templates/es/.codex/README.md +7 -0
  76. package/templates/es/.opencode/README.md +7 -0
  77. package/templates/es/AGENT-CONFIG.md +83 -0
  78. package/templates/es/CLAUDE.md +136 -0
  79. package/templates/es/ENGRAM.md +70 -0
  80. package/templates/es/ORCHESTRATOR.md +199 -0
  81. package/templates/es/PROJECT.md +237 -0
  82. package/templates/es/QUEUE.md +17 -0
  83. package/templates/es/README.md +568 -0
  84. package/templates/es/agents/ABACUS.md +25 -0
  85. package/templates/es/agents/BACKEND.md +28 -0
  86. package/templates/es/agents/CODEX.md +37 -0
  87. package/templates/es/agents/CURSOR.md +27 -0
  88. package/templates/es/agents/FRONTEND.md +29 -0
  89. package/templates/es/agents/GEMINI.md +26 -0
  90. package/templates/es/agents/OPENCODE.md +32 -0
  91. package/templates/es/docs/README.md +12 -0
  92. package/templates/es/docs/agents.md +57 -0
  93. package/templates/es/docs/architecture.md +41 -0
  94. package/templates/es/docs/components.md +33 -0
  95. package/templates/es/docs/engram.md +30 -0
  96. package/templates/es/docs/openspec.md +34 -0
  97. package/templates/es/docs/usage.md +54 -0
  98. package/templates/es/openspec/FLOW.md +139 -0
  99. package/templates/es/openspec/README.md +77 -0
  100. package/templates/es/openspec/changes/.gitkeep +1 -0
  101. package/templates/es/openspec/changes/archive/.gitkeep +1 -0
  102. package/templates/es/openspec/specs/.gitkeep +1 -0
  103. package/templates/es/openspec/templates/archive-report.md +23 -0
  104. package/templates/es/openspec/templates/change-metadata.yaml +9 -0
  105. package/templates/es/openspec/templates/design.md +33 -0
  106. package/templates/es/openspec/templates/proposal.md +36 -0
  107. package/templates/es/openspec/templates/spec.md +33 -0
  108. package/templates/es/openspec/templates/tasks.md +22 -0
  109. package/templates/es/openspec/templates/verify-report.md +24 -0
  110. package/templates/es/orchestrator.config.json +99 -0
@@ -0,0 +1,24 @@
1
+ # OpenSpec Flow
2
+
3
+ Use this flow for durable changes:
4
+
5
+ 1. **Explore**
6
+ - Understand existing code and constraints.
7
+ 2. **Proposal**
8
+ - Define the user goal, motivation, scope, and non-goals.
9
+ 3. **Spec**
10
+ - Describe required behavior and acceptance criteria.
11
+ 4. **Design**
12
+ - Document technical approach and tradeoffs.
13
+ 5. **Tasks**
14
+ - Break the work into executable pieces.
15
+ 6. **Queue**
16
+ - Convert ready tasks into `QUEUE.md`.
17
+ 7. **Apply**
18
+ - Let worker agents implement queued tasks.
19
+ 8. **Verify**
20
+ - Check implementation against proposal, spec, design, and tasks.
21
+ 9. **Archive**
22
+ - Close the change with a concise summary.
23
+
24
+ Small direct changes do not need the full flow.
@@ -0,0 +1,29 @@
1
+ # OpenSpec Workspace
2
+
3
+ This folder stores durable change artifacts.
4
+
5
+ Use it when a change is large, multi-phase, or needs traceability beyond the current chat.
6
+
7
+ ## Flow
8
+
9
+ ```text
10
+ proposal -> spec -> design -> tasks -> queue -> verify -> archive
11
+ ```
12
+
13
+ ## Structure
14
+
15
+ ```text
16
+ openspec/
17
+ FLOW.md
18
+ changes/
19
+ <change-name>/
20
+ proposal.md
21
+ specs/
22
+ spec.md
23
+ design.md
24
+ tasks.md
25
+ verify-report.md
26
+ archive-report.md
27
+ ```
28
+
29
+ Translate ready tasks into `QUEUE.md` when execution begins.
@@ -0,0 +1,21 @@
1
+ # Archive Report: <change-name>
2
+
3
+ ## Final Status
4
+
5
+ Status: completed | partial | abandoned
6
+
7
+ ## Summary
8
+
9
+ Summarize what changed.
10
+
11
+ ## Completed Work
12
+
13
+ - Completed item 1
14
+
15
+ ## Remaining Risks
16
+
17
+ - Risk 1
18
+
19
+ ## Follow-Ups
20
+
21
+ - Follow-up 1
@@ -0,0 +1,9 @@
1
+ name: <change-name>
2
+ status: draft
3
+ current_phase: proposal
4
+ owner: claude-orchestrator
5
+ created_at: YYYY-MM-DD
6
+ related_queue_tasks: []
7
+ related_specs: []
8
+ queue_synced: false
9
+ notes: ""
@@ -0,0 +1,26 @@
1
+ # Design: <change-name>
2
+
3
+ ## Approach
4
+
5
+ Describe the technical approach.
6
+
7
+ ## Affected Areas
8
+
9
+ - File or module 1
10
+ - File or module 2
11
+
12
+ ## Data Flow
13
+
14
+ Describe important data flow changes.
15
+
16
+ ## Tradeoffs
17
+
18
+ - Tradeoff 1
19
+
20
+ ## Risks
21
+
22
+ - Risk 1
23
+
24
+ ## Verification Plan
25
+
26
+ - Verification step 1
@@ -0,0 +1,27 @@
1
+ # Proposal: <change-name>
2
+
3
+ ## Summary
4
+
5
+ Describe the change in one or two short paragraphs.
6
+
7
+ ## Problem
8
+
9
+ What user or system problem does this solve?
10
+
11
+ ## Goals
12
+
13
+ - Goal 1
14
+ - Goal 2
15
+
16
+ ## Non-Goals
17
+
18
+ - Out-of-scope item 1
19
+ - Out-of-scope item 2
20
+
21
+ ## Impact
22
+
23
+ List affected users, flows, modules, or repos.
24
+
25
+ ## Open Questions
26
+
27
+ - Question 1
@@ -0,0 +1,18 @@
1
+ # Spec: <change-name>
2
+
3
+ ## Required Behavior
4
+
5
+ Describe the observable behavior that must exist after the change.
6
+
7
+ ## Acceptance Criteria
8
+
9
+ - Criterion 1
10
+ - Criterion 2
11
+
12
+ ## Edge Cases
13
+
14
+ - Edge case 1
15
+
16
+ ## Constraints
17
+
18
+ - Constraint 1
@@ -0,0 +1,14 @@
1
+ # Tasks: <change-name>
2
+
3
+ ## Ready For Queue
4
+
5
+ - [ ] TASK-001 candidate: describe a small executable task
6
+ - [ ] TASK-002 candidate: describe a dependent task
7
+
8
+ ## Dependencies
9
+
10
+ - TASK-002 depends on TASK-001
11
+
12
+ ## Notes
13
+
14
+ Translate ready tasks into `QUEUE.md` when execution begins.
@@ -0,0 +1,21 @@
1
+ # Verify Report: <change-name>
2
+
3
+ ## Result
4
+
5
+ Status: pending | passed | failed | partial
6
+
7
+ ## Checked Against
8
+
9
+ - Proposal
10
+ - Spec
11
+ - Design
12
+ - Tasks
13
+ - Queue results
14
+
15
+ ## Findings
16
+
17
+ - Finding 1
18
+
19
+ ## Follow-Up Tasks
20
+
21
+ - Follow-up 1
@@ -0,0 +1,99 @@
1
+ {
2
+ "projectName": "PROJECT_NAME_HERE",
3
+ "workspaceLanguage": "en",
4
+ "maxConcurrent": 5,
5
+ "pollIntervalSeconds": 30,
6
+ "taskTimeoutMinutes": 30,
7
+
8
+ "repos": {
9
+ "backend": "ABSOLUTE_PATH_TO_BACKEND",
10
+ "frontend": "ABSOLUTE_PATH_TO_FRONTEND"
11
+ },
12
+ "agentProfiles": {
13
+ "claude": {
14
+ "enabled": true,
15
+ "localConfigDir": ".claude",
16
+ "skillsDir": ".claude/skills",
17
+ "primary": true,
18
+ "useForOrchestration": true,
19
+ "notes": "Main project profile. Prioritizes local repo configuration."
20
+ },
21
+ "codex": {
22
+ "enabled": true,
23
+ "localConfigDir": ".codex",
24
+ "primary": false,
25
+ "useForOrchestration": false,
26
+ "notes": "Support profile for structured implementation and focused work."
27
+ },
28
+ "opencode": {
29
+ "enabled": true,
30
+ "localConfigDir": ".opencode",
31
+ "primary": false,
32
+ "useForOrchestration": false,
33
+ "notes": "Support profile for exploration, audits, context, and scoped implementation."
34
+ },
35
+ "gemini": {
36
+ "enabled": false,
37
+ "localConfigDir": ".gemini"
38
+ },
39
+ "cursor": {
40
+ "enabled": false,
41
+ "localConfigDir": ".cursor"
42
+ },
43
+ "abacusai": {
44
+ "enabled": false,
45
+ "localConfigDir": ".abacus"
46
+ }
47
+ },
48
+ "agents": {
49
+ "Backend": {
50
+ "cli": "claude",
51
+ "profile": "claude",
52
+ "defaultRepo": "backend",
53
+ "model": "sonnet",
54
+ "instructionsFile": "agents/BACKEND.md"
55
+ },
56
+ "Frontend": {
57
+ "cli": "claude",
58
+ "profile": "claude",
59
+ "defaultRepo": "frontend",
60
+ "model": "sonnet",
61
+ "instructionsFile": "agents/FRONTEND.md"
62
+ },
63
+ "Codex": {
64
+ "cli": "codex",
65
+ "profile": "codex",
66
+ "defaultRepo": "backend",
67
+ "model": "gpt-5.5",
68
+ "instructionsFile": "agents/CODEX.md"
69
+ },
70
+ "Gemini": {
71
+ "cli": "gemini",
72
+ "profile": "gemini",
73
+ "defaultRepo": "backend",
74
+ "model": "gemini-3-pro-preview",
75
+ "instructionsFile": "agents/GEMINI.md"
76
+ },
77
+ "OpenCode": {
78
+ "cli": "opencode",
79
+ "profile": "opencode",
80
+ "defaultRepo": "backend",
81
+ "model": "opencode/glm-5-free",
82
+ "instructionsFile": "agents/OPENCODE.md"
83
+ },
84
+ "Cursor": {
85
+ "cli": "cursor",
86
+ "profile": "cursor",
87
+ "defaultRepo": "backend",
88
+ "model": "auto",
89
+ "instructionsFile": "agents/CURSOR.md"
90
+ },
91
+ "Abacus": {
92
+ "cli": "abacusai",
93
+ "profile": "abacusai",
94
+ "defaultRepo": "backend",
95
+ "model": "abacus-ai-agent",
96
+ "instructionsFile": "agents/ABACUS.md"
97
+ }
98
+ }
99
+ }
@@ -0,0 +1,133 @@
1
+ # Skill Registry
2
+
3
+ **Project-local only.** This registry prioritizes skills inside `./.claude/skills/` so the workflow does not depend on global installations such as `gentle-ai`.
4
+
5
+ ## User Skills
6
+
7
+ | Trigger | Skill | Path |
8
+ |---------|-------|------|
9
+ | manual | orchestrator-apply | `.claude/skills/orchestrator-apply/SKILL.md` |
10
+ | manual | orchestrator-archive | `.claude/skills/orchestrator-archive/SKILL.md` |
11
+ | manual | orchestrator-design | `.claude/skills/orchestrator-design/SKILL.md` |
12
+ | manual | orchestrator-explore | `.claude/skills/orchestrator-explore/SKILL.md` |
13
+ | manual | orchestrator-init | `.claude/skills/orchestrator-init/SKILL.md` |
14
+ | manual | orchestrator-memory | `.claude/skills/orchestrator-memory/SKILL.md` |
15
+ | manual | orchestrator-openspec | `.claude/skills/orchestrator-openspec/SKILL.md` |
16
+ | manual | orchestrator-propose | `.claude/skills/orchestrator-propose/SKILL.md` |
17
+ | manual | orchestrator-queue-planning | `.claude/skills/orchestrator-queue-planning/SKILL.md` |
18
+ | manual | orchestrator-spec | `.claude/skills/orchestrator-spec/SKILL.md` |
19
+ | manual | orchestrator-tasks | `.claude/skills/orchestrator-tasks/SKILL.md` |
20
+ | manual | orchestrator-verify | `.claude/skills/orchestrator-verify/SKILL.md` |
21
+
22
+ ## Compact Rules
23
+
24
+ ### orchestrator-apply
25
+ - Read proposal, spec, design, tasks, and queue state when present.
26
+ - Respect `QUEUE.md` as the execution boundary.
27
+ - Do not implement code directly as Claude-Orchestrator.
28
+ - Add or update TASKs so workers can implement.
29
+ - Use Codex and OpenCode first when they fit the task.
30
+ - Use Claude-Worker for fallback, extra capacity, broad implementation, or explicit user request.
31
+ - Keep Claude as final reviewer.
32
+ - Do not commit or push.
33
+
34
+ ### orchestrator-archive
35
+ - Confirm proposal, spec, design, tasks, and verify report are coherent.
36
+ - Write or update `archive-report.md`.
37
+ - Note completed work, remaining risks, and follow-ups.
38
+ - Do not archive incomplete work as complete.
39
+
40
+ ### orchestrator-design
41
+ - Use `openspec/changes/<change-name>/design.md`.
42
+ - Prefer existing project patterns.
43
+ - Capture tradeoffs and risks clearly.
44
+ - Keep design aligned with the proposal and spec.
45
+ - Do not implement code directly.
46
+
47
+ ### orchestrator-explore
48
+ - Understand the user's exact scope first.
49
+ - Prefer exploration before implementation when context is unclear.
50
+ - Use OpenCode as the first support worker for broad reading, audits, and structured findings when appropriate.
51
+ - Do not fill `QUEUE.md` with implementation tasks until enough context exists.
52
+ - Summarize findings in actionable terms: what exists, what is missing, what risks exist, and what tasks follow.
53
+ - If the change is large or multi-phase, move toward OpenSpec.
54
+ - If work is clear, convert findings into concrete TASKs.
55
+
56
+ ### orchestrator-init
57
+ - Read `ORCHESTRATOR.md` completely before responding.
58
+ - Read `orchestrator.config.json` to understand repos, agents, and models.
59
+ - Read `QUEUE.md` to detect pending, active, and completed work.
60
+ - Read the newest handoff if present.
61
+ - Read progress files if present.
62
+ - Use `PROJECT.md` and `openspec/` as context when available.
63
+ - Do not implement code during startup.
64
+ - Reply that the orchestrator is ready and ask what the user wants to prioritize.
65
+
66
+ ### orchestrator-memory
67
+ - Follow `ENGRAM.md`.
68
+ - Save decisions, bug fixes, discoveries, setup changes, and session summaries.
69
+ - Do not save secrets, credentials, API keys, or private customer data.
70
+ - Memory complements `QUEUE.md`, OpenSpec, and handoffs. It does not replace them.
71
+
72
+ ### orchestrator-openspec
73
+ - Multi-phase changes
74
+ - Multi-agent changes
75
+ - User explicitly asks for proposal, spec, design, or tasks
76
+ - The change needs durable traceability
77
+ - Create changes under `openspec/changes/<change-name>/`.
78
+ - Use clear kebab-case change names.
79
+ - Keep proposal, spec, design, tasks, verify report, and archive report consistent.
80
+ - `tasks.md` should be translatable into `QUEUE.md`.
81
+
82
+ ### orchestrator-propose
83
+ - Read the user's request and current project context.
84
+ - Use `openspec/changes/<change-name>/proposal.md`.
85
+ - Keep the proposal short, actionable, and durable.
86
+ - Do not implement code while writing the proposal.
87
+
88
+ ### orchestrator-queue-planning
89
+ - Create small, concrete, executable TASKs.
90
+ - Every TASK must include agent, priority, repo, and a clear description.
91
+ - Use `> after:TASK-NNN` for dependencies.
92
+ - Do not implement the task directly as Claude-Orchestrator.
93
+ - Prefer assigning first executable work to `Codex` or `OpenCode` when they are suitable.
94
+ - Use Claude-Worker only for fallback, extra capacity, sensitive work, broad implementation, or when explicitly requested.
95
+ - Codex can work in `repo=frontend`, but only for narrow, clear, verifiable tasks.
96
+ - Broad frontend work should go to `Frontend`/Claude-Worker.
97
+
98
+ ### orchestrator-spec
99
+ - Use `openspec/changes/<change-name>/specs/spec.md`.
100
+ - Focus on observable behavior.
101
+ - Include acceptance criteria when useful.
102
+ - Do not mix implementation details into the spec unless needed for clarity.
103
+ - Do not implement code directly.
104
+
105
+ ### orchestrator-tasks
106
+ - Use `openspec/changes/<change-name>/tasks.md`.
107
+ - Tasks should be small, ordered, and delegable.
108
+ - Mark dependencies clearly.
109
+ - Mark which tasks are ready to become `QUEUE.md` entries.
110
+ - Do not implement tasks directly.
111
+
112
+ ### orchestrator-verify
113
+ - Read proposal, spec, design, tasks, queue entries, logs, and reports when present.
114
+ - Compare implementation against the requested behavior.
115
+ - Identify gaps, regressions, missing tests, or unclear results.
116
+ - Do not accept worker output blindly.
117
+ - Create follow-up TASKs in `QUEUE.md` if verification finds work to do.
118
+
119
+ ## Project Conventions
120
+
121
+ | File | Path | Notes |
122
+ |------|------|-------|
123
+ | CLAUDE.md | `CLAUDE.md` | |
124
+ | ORCHESTRATOR.md | `ORCHESTRATOR.md` | Orchestrator session entry point |
125
+ | PROJECT.md | `PROJECT.md` | |
126
+ | README.md | `README.md` | |
127
+
128
+ ## Resolution Policy
129
+
130
+ - Always prefer local skills from `./.claude/skills/`.
131
+ - Do not depend on `~/.claude/skills/` for the main orchestrator workflow.
132
+ - If a global skill has the same name as a project-local skill, the local skill wins.
133
+ - Regenerate this file after creating, deleting, or changing local skills.
@@ -0,0 +1,7 @@
1
+ # Claude Local Config
2
+
3
+ Esta carpeta contiene la configuración local del proyecto para Claude.
4
+
5
+ - `skills/` guarda skills propias del repo
6
+ - `CLAUDE.md` en la raíz define el routing del proyecto
7
+ - esta capa local debe priorizarse sobre configuración global del usuario
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: orchestrator-apply
3
+ description: >
4
+ Guía la fase de implementación de un cambio siguiendo proposal, spec, design y tasks.
5
+ Trigger: "implementa", "aplica el cambio", "ejecuta las tareas", "ponlo en marcha"
6
+ license: MIT
7
+ metadata:
8
+ owner: agentflow
9
+ version: "1.0"
10
+ ---
11
+
12
+ # Skill: orchestrator-apply
13
+
14
+ ## Propósito
15
+
16
+ Ejecutar implementación de forma controlada y alineada al cambio documentado, sin dejar que una sola IA improvise todo sin control.
17
+
18
+ ## Reglas críticas
19
+
20
+ - Lee proposal, spec, design y tasks antes de implementar.
21
+ - Respeta `QUEUE.md` y el reparto de trabajo del orquestador.
22
+ - Usa agentes de apoyo para ejecutar, pero mantén a Claude como árbitro principal de revisión.
23
+ - Si hay tareas independientes suficientes, no esperes pasivamente a que Codex u OpenCode terminen: asigna también una TASK a un Claude-Worker (`Backend` o `Frontend`) para que Claude avance trabajo de código en paralelo.
24
+ - OpenCode puede implementar código además de explorar y auditar cuando la TASK esté claramente definida.
25
+ - Los cambios no deben darse por aceptados automáticamente; Claude debe revisarlos antes de darlos por buenos si la tarea lo requiere.
26
+ - No hagas commit ni push.
27
+ - Si la implementación queda parcial, deja el estado claro para verify o una siguiente tanda de apply.
28
+ - Si el cambio se desvía del plan, documenta la desviación antes de seguir.
29
+
30
+ ## Resultado esperado
31
+
32
+ Implementación alineada al cambio, con estado claro para la siguiente fase.
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: orchestrator-archive
3
+ description: >
4
+ Cierra y archiva un cambio cuando ya fue implementado y verificado.
5
+ Trigger: "archiva el cambio", "cierra el change", "finaliza el cambio", "mueve al archive"
6
+ license: MIT
7
+ metadata:
8
+ owner: agentflow
9
+ version: "1.0"
10
+ ---
11
+
12
+ # Skill: orchestrator-archive
13
+
14
+ ## Propósito
15
+
16
+ Cerrar formalmente un cambio para que el orquestador mantenga un historial limpio y reusable.
17
+
18
+ ## Reglas críticas
19
+
20
+ - Confirma que proposal, spec, design, tasks y verify-report estén en estado razonable.
21
+ - Crea o actualiza `archive-report.md`.
22
+ - Mueve el change al área de archivo cuando corresponda.
23
+ - Si el cambio deja aprendizajes importantes, sugiere guardarlos también en Engram.
24
+ - No hagas commit ni push como parte del archive.
25
+
26
+ ## Resultado esperado
27
+
28
+ Un cambio cerrado correctamente y listo para futuras referencias.
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: orchestrator-design
3
+ description: >
4
+ Crea o actualiza el diseño técnico del cambio con decisiones de arquitectura y enfoque de implementación.
5
+ Trigger: "haz design", "diseño técnico", "arquitectura del cambio", "enfoque técnico"
6
+ license: MIT
7
+ metadata:
8
+ owner: agentflow
9
+ version: "1.0"
10
+ ---
11
+
12
+ # Skill: orchestrator-design
13
+
14
+ ## Propósito
15
+
16
+ Definir cómo debería implementarse el cambio dentro del sistema real, respetando el flujo del orquestador y del proyecto objetivo.
17
+
18
+ ## Reglas críticas
19
+
20
+ - Lee propuesta y spec antes de escribir diseño.
21
+ - Crea o actualiza `openspec/changes/<change-name>/design.md`.
22
+ - Documenta:
23
+ - capas afectadas
24
+ - archivos probables
25
+ - riesgos técnicos
26
+ - decisiones de arquitectura
27
+ - tradeoffs
28
+ - Si una decisión es importante y reusable, recomienda guardarla también en Engram.
29
+
30
+ ## Resultado esperado
31
+
32
+ Un diseño técnico accionable que permita dividir tareas sin perder consistencia.
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: orchestrator-explore
3
+ description: >
4
+ Explora, analiza o investiga el proyecto antes de proponer cambios. Ideal cuando el usuario pide entender archivos, flujos o arquitectura antes de delegar implementación.
5
+ Trigger: "explora", "analiza", "investiga", "revisa este proyecto", "revisa estos archivos"
6
+ license: MIT
7
+ metadata:
8
+ owner: agentflow
9
+ version: "0.1"
10
+ ---
11
+
12
+ # Skill: orchestrator-explore
13
+
14
+ ## Propósito
15
+
16
+ Guiar la fase de exploración del orquestador para reunir contexto útil antes de crear o delegar tareas.
17
+
18
+ ## Reglas críticas
19
+
20
+ - Empieza por entender el alcance exacto del pedido del usuario.
21
+ - Si hace falta lectura amplia, prioriza exploración y análisis antes de planear implementación.
22
+ - Usa `OpenCode` como primer apoyo para lectura, contexto y hallazgos estructurados cuando aplique.
23
+ - No llenes `QUEUE.md` con implementación hasta tener suficiente contexto.
24
+ - Resume hallazgos en términos accionables: qué existe, qué falta, qué riesgo hay y qué tareas salen de eso.
25
+ - Si la exploración revela un cambio grande o multifase, el siguiente paso natural es abrir o actualizar un change en `openspec/`.
26
+ - Si descubres una línea clara de trabajo, el siguiente paso natural es convertir hallazgos en TASKs concretas.
27
+ - Mantén el foco dentro del alcance pedido; explorar no es rediseñar todo el sistema.
28
+
29
+ ## Resultado esperado
30
+
31
+ Una exploración útil que permita al orquestador decidir si ya puede crear TASKs o si necesita una investigación adicional.
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: orchestrator-init
3
+ description: >
4
+ Inicializa la sesión del orquestador para este proyecto: lee ORCHESTRATOR.md, la configuración, la cola y el estado visible antes de pedir la siguiente prioridad.
5
+ license: MIT
6
+ metadata:
7
+ owner: agentflow
8
+ version: "0.1"
9
+ ---
10
+
11
+ # Skill: orchestrator-init
12
+
13
+ Trigger: "arranca", "inicia el orquestador", "lee ORCHESTRATOR.md y arranca", "start orchestrator"
14
+
15
+ ## Propósito
16
+
17
+ Preparar una sesión nueva del orquestador sin ejecutar trabajo del proyecto directamente.
18
+
19
+ ## Reglas críticas
20
+
21
+ - Lee `ORCHESTRATOR.md` completo antes de responder.
22
+ - Lee `orchestrator.config.json` para saber agentes y repos disponibles.
23
+ - Lee `QUEUE.md` para detectar trabajo pendiente, en progreso y completado.
24
+ - Si existe `PROJECT.md`, úsalo como contexto del sistema.
25
+ - Si existe `openspec/`, revisa si ya hay changes activos que deban continuarse.
26
+ - No ejecutes cambios de código durante init; solo establece el contexto operativo.
27
+ - Al terminar, responde que la sesión está iniciada y pregunta qué quiere priorizar el usuario.
28
+ - Si el proyecto restringe agentes por defecto, respeta esa restricción desde el primer mensaje.
29
+
30
+ ## Resultado esperado
31
+
32
+ El usuario debe sentir que Claude ya quedó actuando como orquestador y está listo para recibir una tarea o prioridad.
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: orchestrator-memory
3
+ description: >
4
+ Recupera o guarda contexto persistente del proyecto usando Engram. Úsala cuando el usuario pide recordar trabajo previo, cuando aparece una decisión importante, o cuando se necesita cerrar sesión con continuidad.
5
+ license: MIT
6
+ metadata:
7
+ owner: agentflow
8
+ version: "0.1"
9
+ ---
10
+
11
+ # Skill: orchestrator-memory
12
+
13
+ Trigger: "recuerda", "qué hicimos", "cómo quedó", "guarda esto", "save memory", "session summary", "contexto anterior"
14
+
15
+ ## Propósito
16
+
17
+ Usar Engram como memoria persistente del orquestador para continuidad real entre sesiones.
18
+
19
+ ## Reglas críticas
20
+
21
+ - Si el usuario pide recordar algo, consulta Engram antes de responder.
22
+ - Si haces una decisión importante, guarda esa decisión.
23
+ - Si descubres algo no obvio del proyecto, guárdalo.
24
+ - Si corriges un bug o cambias el flujo del orquestador, guárdalo.
25
+ - Al cerrar sesión, guarda un resumen útil para la siguiente sesión.
26
+ - Usa topic keys consistentes para no fragmentar la memoria del proyecto.
27
+ - Engram complementa el flujo del orquestador; no reemplaza `QUEUE.md` ni la TUI.
28
+
29
+ ## Resultado esperado
30
+
31
+ La siguiente sesión debe poder recuperar contexto útil sin volver a explorar todo desde cero.