@cleocode/skills 2026.5.77 → 2026.5.78

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cleocode/skills",
3
- "version": "2026.5.77",
3
+ "version": "2026.5.78",
4
4
  "description": "CLEO skill definitions - bundled with CLEO monorepo",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",
@@ -24,8 +24,19 @@ Supported sections: `session-start` · `work-loop` · `triggers` · `task-creati
24
24
  | Complete task | `cleo verify T### --gate ... --evidence "..."` → `cleo complete T###` |
25
25
  | Save memory | `cleo memory observe "..." --title "..."` |
26
26
  | Spawn subagent | `cleo orchestrate spawn <taskId> --tier 2` |
27
+ | Create a Saga (above-Epic group, ADR-073) | `cleo saga create --title "..." --acceptance "..."` |
28
+ | Link Epic to Saga | `cleo saga add <sagaId> <epicId>` |
29
+ | List Saga members | `cleo saga members <sagaId>` |
27
30
 
28
31
  ## Skill-Specific Extensions
29
32
 
30
- (No extensions beyond CLEO-INJECTION.md canonical content as of T9148.)
33
+ ### Saga tier (since v2026.5.77 · ADR-073)
34
+
35
+ A **Saga** (`SG-` conceptual prefix; stored as a labeled top-level Epic) groups multiple Epics
36
+ into a multi-release theme. Members link via `task_relations.relation_type='groups'`, not parent
37
+ edges. `cleo list --parent <sagaId>` will NOT surface members — use `cleo saga members <id>`.
38
+
39
+ Full command surface lives in CLEO-INJECTION.md `task-creation` section. Emit with
40
+ `cleo briefing inject --section task-creation`.
41
+
31
42
  For full decision trees and operation reference tables, emit sections above.
@@ -90,6 +90,21 @@ Epic (type: epic, size: large)
90
90
  | Task | medium | 3-7 files, single feature |
91
91
  | Subtask | small | 1-2 files, single function |
92
92
 
93
+ ### Above-Epic: Sagas (ADR-073, v2026.5.77+)
94
+
95
+ A **Saga** groups multiple Epics into a multi-release theme. Use a Saga when the work spans
96
+ more than one shippable Epic and you want a stable handle for rollup/reporting. A Saga is a
97
+ labeled top-level Epic (`label='saga'`) — NOT a new TaskType — so the parent ladder (maxDepth=3)
98
+ under each member Epic is unaffected.
99
+
100
+ ```bash
101
+ cleo saga create --title "Auth Modernization" --description "..." --acceptance "ac1|ac2|ac3|ac4|ac5"
102
+ # returns SG-id (stored as T#### with label=saga)
103
+ cleo saga add <sagaId> <epicId> # links member Epic via task_relations.type='groups'
104
+ cleo saga members <sagaId> # returns member list (NOT cleo list --parent)
105
+ cleo saga rollup <sagaId> # aggregates child statuses + completionPct
106
+ ```
107
+
93
108
  ---
94
109
 
95
110
  ## Epic Creation
@@ -199,6 +199,8 @@ When operating without continuous HITL oversight, additional constraints apply:
199
199
  | `cleo orchestrate ready --epic T1575` | Parallel-safe tasks in current wave |
200
200
  | `cleo orchestrate spawn T1586 --json` | Generate resolved spawn prompt |
201
201
  | `cleo orchestrate next --epic T1575` | Suggest next task |
202
+ | `cleo saga rollup <sagaId>` | Cross-Epic status aggregation when orchestrating a multi-Epic Saga (ADR-073) |
203
+ | `cleo saga members <sagaId>` | Member Epics of a Saga (NOT `cleo list --parent` — Sagas use `task_relations.type=groups`) |
202
204
  | `cleo pipeline stage.status --epic T1575` | Current pipeline stage |
203
205
  | `cleo pipeline stage.validate T1575 implementation` | Check gate before spawn |
204
206
  | `cleo pipeline stage.gate.pass T1575 research` | Advance pipeline stage |