@liriraid/agentflow-ai 1.0.27 → 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.
Files changed (33) hide show
  1. package/bin/agentflow.mjs +0 -1
  2. package/orchestrator.js +6 -14
  3. package/package.json +65 -64
  4. package/templates/en/CLAUDE.md +27 -75
  5. package/templates/en/ORCHESTRATOR.md +20 -18
  6. package/templates/es/CLAUDE.md +27 -120
  7. package/templates/es/ORCHESTRATOR.md +21 -22
  8. package/templates/en/.atl/skill-registry.md +0 -27
  9. package/templates/en/.claude/skills/orchestrator-apply/SKILL.md +0 -31
  10. package/templates/en/.claude/skills/orchestrator-archive/SKILL.md +0 -26
  11. package/templates/en/.claude/skills/orchestrator-design/SKILL.md +0 -27
  12. package/templates/en/.claude/skills/orchestrator-explore/SKILL.md +0 -32
  13. package/templates/en/.claude/skills/orchestrator-init/SKILL.md +0 -32
  14. package/templates/en/.claude/skills/orchestrator-memory/SKILL.md +0 -26
  15. package/templates/en/.claude/skills/orchestrator-openspec/SKILL.md +0 -35
  16. package/templates/en/.claude/skills/orchestrator-propose/SKILL.md +0 -26
  17. package/templates/en/.claude/skills/orchestrator-queue-planning/SKILL.md +0 -50
  18. package/templates/en/.claude/skills/orchestrator-spec/SKILL.md +0 -27
  19. package/templates/en/.claude/skills/orchestrator-tasks/SKILL.md +0 -27
  20. package/templates/en/.claude/skills/orchestrator-verify/SKILL.md +0 -27
  21. package/templates/es/.atl/skill-registry.md +0 -133
  22. package/templates/es/.claude/skills/orchestrator-apply/SKILL.md +0 -32
  23. package/templates/es/.claude/skills/orchestrator-archive/SKILL.md +0 -28
  24. package/templates/es/.claude/skills/orchestrator-design/SKILL.md +0 -32
  25. package/templates/es/.claude/skills/orchestrator-explore/SKILL.md +0 -34
  26. package/templates/es/.claude/skills/orchestrator-init/SKILL.md +0 -32
  27. package/templates/es/.claude/skills/orchestrator-memory/SKILL.md +0 -31
  28. package/templates/es/.claude/skills/orchestrator-openspec/SKILL.md +0 -55
  29. package/templates/es/.claude/skills/orchestrator-propose/SKILL.md +0 -33
  30. package/templates/es/.claude/skills/orchestrator-queue-planning/SKILL.md +0 -52
  31. package/templates/es/.claude/skills/orchestrator-spec/SKILL.md +0 -28
  32. package/templates/es/.claude/skills/orchestrator-tasks/SKILL.md +0 -32
  33. package/templates/es/.claude/skills/orchestrator-verify/SKILL.md +0 -31
@@ -1,27 +0,0 @@
1
- # Skill Registry
2
-
3
- **Project-local only.** This registry prioritizes skills inside `./.claude/skills/` so the workflow does not depend on global installations.
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
- ## Resolution Policy
23
-
24
- - Always prefer local skills from `./.claude/skills/`.
25
- - Do not depend on global skills for the main orchestrator workflow.
26
- - If a global skill has the same name, the project-local skill wins.
27
- - Regenerate this file after creating, deleting, or changing local skills.
@@ -1,31 +0,0 @@
1
- ---
2
- name: orchestrator-apply
3
- description: >
4
- Guide the implementation phase by translating ready work into queued worker tasks.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-apply
12
-
13
- ## Purpose
14
-
15
- Run implementation through the orchestrator, not through the interactive Claude session.
16
-
17
- ## Critical Rules
18
-
19
- - Read proposal, spec, design, tasks, and queue state when present.
20
- - Respect `QUEUE.md` as the execution boundary.
21
- - Do not implement code directly as Claude-Orchestrator.
22
- - Add or update TASKs so workers can implement.
23
- - Use Codex and OpenCode first when they fit the task.
24
- - Use Claude-Worker for fallback, extra capacity, broad implementation, or explicit user request.
25
- - Keep Claude as final reviewer.
26
- - Do not commit or push.
27
- - If implementation is partial, leave clear state for verify or the next apply pass.
28
-
29
- ## Expected Result
30
-
31
- Implementation work is queued for workers and remains reviewable by Claude-Orchestrator.
@@ -1,26 +0,0 @@
1
- ---
2
- name: orchestrator-archive
3
- description: >
4
- Close and archive a completed OpenSpec change after implementation and verification.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-archive
12
-
13
- ## Purpose
14
-
15
- Close a change with a durable summary of what was done and what remains.
16
-
17
- ## Critical Rules
18
-
19
- - Confirm proposal, spec, design, tasks, and verify report are coherent.
20
- - Write or update `archive-report.md`.
21
- - Note completed work, remaining risks, and follow-ups.
22
- - Do not archive incomplete work as complete.
23
-
24
- ## Expected Result
25
-
26
- A closed change with a useful archive report.
@@ -1,27 +0,0 @@
1
- ---
2
- name: orchestrator-design
3
- description: >
4
- Create or update the technical design for a change.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-design
12
-
13
- ## Purpose
14
-
15
- Document the technical approach, tradeoffs, affected files, risks, and rollout plan.
16
-
17
- ## Critical Rules
18
-
19
- - Use `openspec/changes/<change-name>/design.md`.
20
- - Prefer existing project patterns.
21
- - Capture tradeoffs and risks clearly.
22
- - Keep design aligned with the proposal and spec.
23
- - Do not implement code directly.
24
-
25
- ## Expected Result
26
-
27
- A technical design that can be broken into executable tasks.
@@ -1,32 +0,0 @@
1
- ---
2
- name: orchestrator-explore
3
- description: >
4
- Explore, analyze, or investigate the project before proposing or delegating implementation.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.1"
9
- ---
10
-
11
- # Skill: orchestrator-explore
12
-
13
- ## Purpose
14
-
15
- Gather useful context before creating TASKs or OpenSpec artifacts.
16
-
17
- ## Critical Rules
18
-
19
- - Understand the user's exact scope first — clarify by asking the user directly, **NOT by reading project files yourself**.
20
- - Prefer exploration before implementation when context is unclear.
21
- - Use **ONLY OpenCode** as the exploration agent when deep codebase analysis is needed — its role is **EXCLUSIVELY analysis**, **NEVER implementation**.
22
- - When delegating exploration to OpenCode, include in the brief exactly what it must report: flows, dependencies, architecture findings, inconsistencies, etc.
23
- - Do not fill `QUEUE.md` with implementation tasks until enough context exists.
24
- - Summarize findings in actionable terms: what exists, what is missing, what risks exist, and what tasks follow.
25
- - If the change is large or multi-phase, move toward OpenSpec.
26
- - If work is clear, convert findings into concrete TASKs using `orchestrator-queue-planning`.
27
- - **STRICT RULE: When OpenCode delivers its report in INBOX.md, use THOSE findings to create implementation TASKs (assigned to Codex or Claude-Worker). Under NO circumstances should Claude-Orchestrator re-analyze the code itself if OpenCode has already done so. Read the report in `progress/PROGRESS-OpenCode.md` or INBOX.md and base your decisions on that analysis.**
28
- - If OpenCode's report is insufficient, ask OpenCode to deepen analysis on a specific area with a new analysis TASK, but **DO NOT do it yourself**.
29
-
30
- ## Expected Result
31
-
32
- The orchestrator can decide whether to plan TASKs or continue investigation. **The final result MUST be one or more TASKs in QUEUE.md assigned to Codex or Claude-Worker for implementation, NOT more analysis by Claude-Orchestrator.**
@@ -1,32 +0,0 @@
1
- ---
2
- name: orchestrator-init
3
- description: >
4
- Initialize the orchestrator session: read ORCHESTRATOR.md, config, queue, progress, handoffs, and visible state before asking for the next priority.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-init
12
-
13
- Trigger examples: "start", "start orchestrator", "read ORCHESTRATOR.md and start", "lee ORCHESTRATOR.md y arranca".
14
-
15
- ## Purpose
16
-
17
- Prepare a new orchestrator session without executing project work directly.
18
-
19
- ## Critical Rules
20
-
21
- - Read `ORCHESTRATOR.md` completely before responding.
22
- - Read `orchestrator.config.json` to understand repos, agents, and models.
23
- - Read `QUEUE.md` to detect pending, active, and completed work.
24
- - Read the newest handoff if present.
25
- - Read progress files if present.
26
- - Use `PROJECT.md` and `openspec/` as context when available.
27
- - Do not implement code during startup.
28
- - Reply that the orchestrator is ready and ask what the user wants to prioritize.
29
-
30
- ## Expected Result
31
-
32
- Claude is ready as Claude-Orchestrator and has not performed project implementation directly.
@@ -1,26 +0,0 @@
1
- ---
2
- name: orchestrator-memory
3
- description: >
4
- Use persistent memory for decisions, discoveries, bugs, setup notes, and session summaries.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-memory
12
-
13
- ## Purpose
14
-
15
- Preserve durable context for future sessions.
16
-
17
- ## Critical Rules
18
-
19
- - Follow `ENGRAM.md`.
20
- - Save decisions, bug fixes, discoveries, setup changes, and session summaries.
21
- - Do not save secrets, credentials, API keys, or private customer data.
22
- - Memory complements `QUEUE.md`, OpenSpec, and handoffs. It does not replace them.
23
-
24
- ## Expected Result
25
-
26
- Future sessions can resume with useful context instead of rediscovering everything.
@@ -1,35 +0,0 @@
1
- ---
2
- name: orchestrator-openspec
3
- description: >
4
- Create or update OpenSpec artifacts for large or multi-phase changes.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-openspec
12
-
13
- ## Purpose
14
-
15
- Use `openspec/` as the durable planning layer before delegating larger implementation work.
16
-
17
- ## When To Use
18
-
19
- - Multi-phase changes
20
- - Multi-agent changes
21
- - User explicitly asks for proposal, spec, design, or tasks
22
- - The change needs durable traceability
23
-
24
- ## Critical Rules
25
-
26
- - Create changes under `openspec/changes/<change-name>/`.
27
- - Use clear kebab-case change names.
28
- - Keep proposal, spec, design, tasks, verify report, and archive report consistent.
29
- - `tasks.md` should be translatable into `QUEUE.md`.
30
- - Do not queue large implementation work before the OpenSpec artifacts are clear.
31
- - Do not force OpenSpec for tiny direct changes.
32
-
33
- ## Expected Result
34
-
35
- A coherent OpenSpec change that can feed the live queue.
@@ -1,26 +0,0 @@
1
- ---
2
- name: orchestrator-propose
3
- description: >
4
- Create or update the proposal for a significant change before implementation.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-propose
12
-
13
- ## Purpose
14
-
15
- Define what the change is, why it matters, what is in scope, and what is explicitly out of scope.
16
-
17
- ## Critical Rules
18
-
19
- - Read the user's request and current project context.
20
- - Use `openspec/changes/<change-name>/proposal.md`.
21
- - Keep the proposal short, actionable, and durable.
22
- - Do not implement code while writing the proposal.
23
-
24
- ## Expected Result
25
-
26
- A proposal that can move into spec, design, tasks, and queue planning.
@@ -1,50 +0,0 @@
1
- ---
2
- name: orchestrator-queue-planning
3
- description: >
4
- Convert user requests, specs, or findings into concrete TASK entries for QUEUE.md.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.1"
9
- ---
10
-
11
- # Skill: orchestrator-queue-planning
12
-
13
- ## Purpose
14
-
15
- Turn the user's request into executable queue work for the TUI.
16
-
17
- ## Agent Assignment Rules
18
-
19
- ### OpenCode — analysis only
20
- - Use for exploration, audits, context reading, and structured reports.
21
- - **Do not assign implementation** — OpenCode does not modify project files.
22
- - If work needs prior analysis, create an OpenCode TASK first, then a Codex TASK with `> after:TASK-NNN`.
23
-
24
- ### Codex — primary implementation
25
- - Use for implementation, code changes, tests, and docs when the spec is clear.
26
- - It is the primary execution agent.
27
- - If Codex fails persistently, the TUI automatically reassigns to Claude-Worker (Frontend/Backend).
28
-
29
- ### Claude-Worker (Frontend / Backend)
30
- - Automatic fallback when Codex fails.
31
- - Also takes overflow work when both Codex and OpenCode are busy and more tasks are pending.
32
- - Frontend-only projects: always use `Frontend`; backend work: use `Backend`.
33
-
34
- ## Critical Rules
35
-
36
- - Create small, concrete, executable TASKs.
37
- - Every TASK must include agent, priority, repo, and a clear description.
38
- - Use `> after:TASK-NNN` for dependencies.
39
- - Do not implement the task directly as Claude-Orchestrator.
40
- - Distribution by task count:
41
- - **1 analysis task**: OpenCode
42
- - **1 implementation task**: Codex
43
- - **2 parallel tasks**: OpenCode (analysis) + Codex (implementation when spec is clear)
44
- - **3+ tasks** with Codex busy: overflow goes to `Frontend` (FE repo) or `Backend` (BE repo)
45
- - Keep `QUEUE.md` aligned with the user's current objective.
46
- - **Never assign implementation to OpenCode.**
47
-
48
- ## Expected Result
49
-
50
- `QUEUE.md` contains clear TASKs ready for the TUI to run.
@@ -1,27 +0,0 @@
1
- ---
2
- name: orchestrator-spec
3
- description: >
4
- Create or update the behavioral specification for a change.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-spec
12
-
13
- ## Purpose
14
-
15
- Turn the proposal into clear required behavior and acceptance criteria.
16
-
17
- ## Critical Rules
18
-
19
- - Use `openspec/changes/<change-name>/specs/spec.md`.
20
- - Focus on observable behavior.
21
- - Include acceptance criteria when useful.
22
- - Do not mix implementation details into the spec unless needed for clarity.
23
- - Do not implement code directly.
24
-
25
- ## Expected Result
26
-
27
- A spec that can guide design, tasks, implementation, and verification.
@@ -1,27 +0,0 @@
1
- ---
2
- name: orchestrator-tasks
3
- description: >
4
- Break a change into implementation tasks that can later be translated into QUEUE.md.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-tasks
12
-
13
- ## Purpose
14
-
15
- Convert proposal, spec, and design into concrete implementation tasks.
16
-
17
- ## Critical Rules
18
-
19
- - Use `openspec/changes/<change-name>/tasks.md`.
20
- - Tasks should be small, ordered, and delegable.
21
- - Mark dependencies clearly.
22
- - Mark which tasks are ready to become `QUEUE.md` entries.
23
- - Do not implement tasks directly.
24
-
25
- ## Expected Result
26
-
27
- A task list ready for queue planning.
@@ -1,27 +0,0 @@
1
- ---
2
- name: orchestrator-verify
3
- description: >
4
- Verify that implementation matches proposal, spec, design, tasks, and user intent.
5
- license: MIT
6
- metadata:
7
- owner: agentflow
8
- version: "1.0"
9
- ---
10
-
11
- # Skill: orchestrator-verify
12
-
13
- ## Purpose
14
-
15
- Let Claude-Orchestrator review worker output before accepting it.
16
-
17
- ## Critical Rules
18
-
19
- - Read proposal, spec, design, tasks, queue entries, logs, and reports when present.
20
- - Compare implementation against the requested behavior.
21
- - Identify gaps, regressions, missing tests, or unclear results.
22
- - Do not accept worker output blindly.
23
- - Create follow-up TASKs in `QUEUE.md` if verification finds work to do.
24
-
25
- ## Expected Result
26
-
27
- A clear verification decision and any required follow-up tasks.
@@ -1,133 +0,0 @@
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.
@@ -1,32 +0,0 @@
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.
@@ -1,28 +0,0 @@
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.
@@ -1,32 +0,0 @@
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.
@@ -1,34 +0,0 @@
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.2"
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 — acláralo preguntándole directamente, **NO leyendo archivos del proyecto tú mismo**.
21
- - Si hace falta lectura amplia, prioriza exploración y análisis antes de planear implementación.
22
- - Usa **SOLO OpenCode** como agente de exploración cuando necesites análisis profundo del codebase — su rol es **EXCLUSIVAMENTE análisis**, **NUNCA implementación**.
23
- - Al delegar exploración a OpenCode, incluye en el brief exactamente qué debe reportar: flujos, dependencias, hallazgos de arquitectura, inconsistencias, etc.
24
- - No llenes `QUEUE.md` con implementación hasta tener suficiente contexto.
25
- - Resume hallazgos en términos accionables: qué existe, qué falta, qué riesgo hay y qué tareas salen de eso.
26
- - Si la exploración revela un cambio grande o multifase, el siguiente paso natural es abrir o actualizar un change en `openspec/`.
27
- - Si descubres una línea clara de trabajo, el siguiente paso natural es convertir hallazgos en TASKs concretas con `orchestrator-queue-planning`.
28
- - Mantén el foco dentro del alcance pedido; explorar no es rediseñar todo el sistema.
29
- - **REGLA ESTRICTA: Cuando OpenCode entregue su reporte en INBOX.md, usa ESOS hallazgos para crear las TASKs de implementación (asignadas a Codex o Claude-Worker). NUNCA, bajo ninguna circunstancia, vuelvas a analizar el código tú mismo (Claude-Orquestador) si OpenCode ya lo hizo. Lee el reporte en `progress/PROGRESS-OpenCode.md` o el INBOX.md y basa tus decisiones en ese análisis.**
30
- - Si el reporte de OpenCode es insuficiente, pide a OpenCode que profundice en un área específica con una nueva TASK de análisis, pero NO lo hagas tú directamente.
31
-
32
- ## Resultado esperado
33
-
34
- Una exploración útil que permita al orquestador decidir si ya puede crear TASKs o si necesita una investigación adicional. **El resultado final DEBE ser una o más TASKs en QUEUE.md asignadas a Codex o Claude-Worker para implementación, NO más análisis por parte de Claude-Orquestador.**