@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,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.**
|
|
@@ -1,32 +0,0 @@
|
|
|
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.
|
|
@@ -1,31 +0,0 @@
|
|
|
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.
|