@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.
- package/LICENSE +21 -0
- package/README.md +79 -0
- package/bin/agentflow.mjs +332 -0
- package/orchestrator.js +1585 -0
- package/package.json +64 -0
- package/scripts/scaffold-agent-configs.mjs +100 -0
- package/scripts/scaffold-openspec-change.mjs +84 -0
- package/scripts/update-skill-registry.mjs +174 -0
- package/src/ink/app.mjs +240 -0
- package/src/ink/index.mjs +400 -0
- package/templates/en/.atl/skill-registry.md +27 -0
- package/templates/en/.claude/README.md +7 -0
- package/templates/en/.claude/skills/orchestrator-apply/SKILL.md +31 -0
- package/templates/en/.claude/skills/orchestrator-archive/SKILL.md +26 -0
- package/templates/en/.claude/skills/orchestrator-design/SKILL.md +27 -0
- package/templates/en/.claude/skills/orchestrator-explore/SKILL.md +29 -0
- package/templates/en/.claude/skills/orchestrator-init/SKILL.md +32 -0
- package/templates/en/.claude/skills/orchestrator-memory/SKILL.md +26 -0
- package/templates/en/.claude/skills/orchestrator-openspec/SKILL.md +35 -0
- package/templates/en/.claude/skills/orchestrator-propose/SKILL.md +26 -0
- package/templates/en/.claude/skills/orchestrator-queue-planning/SKILL.md +31 -0
- package/templates/en/.claude/skills/orchestrator-spec/SKILL.md +27 -0
- package/templates/en/.claude/skills/orchestrator-tasks/SKILL.md +27 -0
- package/templates/en/.claude/skills/orchestrator-verify/SKILL.md +27 -0
- package/templates/en/.codex/README.md +7 -0
- package/templates/en/.opencode/README.md +7 -0
- package/templates/en/AGENT-CONFIG.md +75 -0
- package/templates/en/CLAUDE.md +91 -0
- package/templates/en/ENGRAM.md +50 -0
- package/templates/en/ORCHESTRATOR.md +192 -0
- package/templates/en/PROJECT.md +70 -0
- package/templates/en/QUEUE.md +17 -0
- package/templates/en/README.md +188 -0
- package/templates/en/agents/ABACUS.md +36 -0
- package/templates/en/agents/BACKEND.md +37 -0
- package/templates/en/agents/CODEX.md +45 -0
- package/templates/en/agents/CURSOR.md +37 -0
- package/templates/en/agents/FRONTEND.md +36 -0
- package/templates/en/agents/GEMINI.md +37 -0
- package/templates/en/agents/OPENCODE.md +41 -0
- package/templates/en/docs/README.md +14 -0
- package/templates/en/docs/agents.md +33 -0
- package/templates/en/docs/architecture.md +43 -0
- package/templates/en/docs/components.md +14 -0
- package/templates/en/docs/engram.md +16 -0
- package/templates/en/docs/openspec.md +32 -0
- package/templates/en/docs/usage.md +66 -0
- package/templates/en/openspec/FLOW.md +24 -0
- package/templates/en/openspec/README.md +29 -0
- package/templates/en/openspec/changes/.gitkeep +1 -0
- package/templates/en/openspec/changes/archive/.gitkeep +1 -0
- package/templates/en/openspec/specs/.gitkeep +1 -0
- package/templates/en/openspec/templates/archive-report.md +21 -0
- package/templates/en/openspec/templates/change-metadata.yaml +9 -0
- package/templates/en/openspec/templates/design.md +26 -0
- package/templates/en/openspec/templates/proposal.md +27 -0
- package/templates/en/openspec/templates/spec.md +18 -0
- package/templates/en/openspec/templates/tasks.md +14 -0
- package/templates/en/openspec/templates/verify-report.md +21 -0
- package/templates/en/orchestrator.config.json +99 -0
- package/templates/es/.atl/skill-registry.md +133 -0
- package/templates/es/.claude/README.md +7 -0
- package/templates/es/.claude/skills/orchestrator-apply/SKILL.md +32 -0
- package/templates/es/.claude/skills/orchestrator-archive/SKILL.md +28 -0
- package/templates/es/.claude/skills/orchestrator-design/SKILL.md +32 -0
- package/templates/es/.claude/skills/orchestrator-explore/SKILL.md +31 -0
- package/templates/es/.claude/skills/orchestrator-init/SKILL.md +32 -0
- package/templates/es/.claude/skills/orchestrator-memory/SKILL.md +31 -0
- package/templates/es/.claude/skills/orchestrator-openspec/SKILL.md +55 -0
- package/templates/es/.claude/skills/orchestrator-propose/SKILL.md +33 -0
- package/templates/es/.claude/skills/orchestrator-queue-planning/SKILL.md +35 -0
- package/templates/es/.claude/skills/orchestrator-spec/SKILL.md +28 -0
- package/templates/es/.claude/skills/orchestrator-tasks/SKILL.md +32 -0
- package/templates/es/.claude/skills/orchestrator-verify/SKILL.md +31 -0
- package/templates/es/.codex/README.md +7 -0
- package/templates/es/.opencode/README.md +7 -0
- package/templates/es/AGENT-CONFIG.md +83 -0
- package/templates/es/CLAUDE.md +136 -0
- package/templates/es/ENGRAM.md +70 -0
- package/templates/es/ORCHESTRATOR.md +199 -0
- package/templates/es/PROJECT.md +237 -0
- package/templates/es/QUEUE.md +17 -0
- package/templates/es/README.md +568 -0
- package/templates/es/agents/ABACUS.md +25 -0
- package/templates/es/agents/BACKEND.md +28 -0
- package/templates/es/agents/CODEX.md +37 -0
- package/templates/es/agents/CURSOR.md +27 -0
- package/templates/es/agents/FRONTEND.md +29 -0
- package/templates/es/agents/GEMINI.md +26 -0
- package/templates/es/agents/OPENCODE.md +32 -0
- package/templates/es/docs/README.md +12 -0
- package/templates/es/docs/agents.md +57 -0
- package/templates/es/docs/architecture.md +41 -0
- package/templates/es/docs/components.md +33 -0
- package/templates/es/docs/engram.md +30 -0
- package/templates/es/docs/openspec.md +34 -0
- package/templates/es/docs/usage.md +54 -0
- package/templates/es/openspec/FLOW.md +139 -0
- package/templates/es/openspec/README.md +77 -0
- package/templates/es/openspec/changes/.gitkeep +1 -0
- package/templates/es/openspec/changes/archive/.gitkeep +1 -0
- package/templates/es/openspec/specs/.gitkeep +1 -0
- package/templates/es/openspec/templates/archive-report.md +23 -0
- package/templates/es/openspec/templates/change-metadata.yaml +9 -0
- package/templates/es/openspec/templates/design.md +33 -0
- package/templates/es/openspec/templates/proposal.md +36 -0
- package/templates/es/openspec/templates/spec.md +33 -0
- package/templates/es/openspec/templates/tasks.md +22 -0
- package/templates/es/openspec/templates/verify-report.md +24 -0
- 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 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -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,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.
|