@cleocode/skills 2026.5.105 → 2026.5.107
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 +1 -1
- package/skills/ct-cleo/SKILL.md +47 -0
- package/skills.json +7 -3
package/package.json
CHANGED
package/skills/ct-cleo/SKILL.md
CHANGED
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ct-cleo
|
|
3
3
|
description: CLEO task management protocol - session, task, and workflow guidance. Use when managing tasks, sessions, or multi-agent workflows with the CLEO CLI protocol.
|
|
4
|
+
metadata:
|
|
5
|
+
version: 2.1.0
|
|
6
|
+
lastReviewed: 2026-05-23
|
|
7
|
+
stability: stable
|
|
4
8
|
---
|
|
5
9
|
|
|
6
10
|
# CLEO Protocol Guide
|
|
@@ -52,6 +56,49 @@ CLEO-INJECTION.md `task-creation` section (`cleo briefing inject --section task-
|
|
|
52
56
|
|
|
53
57
|
For full decision trees and operation reference tables, emit sections above.
|
|
54
58
|
|
|
59
|
+
## Human Render Contract (ADR-077)
|
|
60
|
+
|
|
61
|
+
Every CLI command emits a typed `RenderableEnvelope<T>` from `@cleocode/contracts`.
|
|
62
|
+
Agents can route their own rendering off `envelope.data.kind` without re-parsing
|
|
63
|
+
the payload shape. Canonical patterns:
|
|
64
|
+
|
|
65
|
+
| Goal | Command |
|
|
66
|
+
|------|---------|
|
|
67
|
+
| Show one task (typed envelope; human render via core registry) | `cleo show T<id>` |
|
|
68
|
+
| Force human render when JSON is the default | `cleo show T<id> --human` |
|
|
69
|
+
| Generic hierarchy walker from any root (B9 / T10134) | `cleo tree T<id>` |
|
|
70
|
+
|
|
71
|
+
`cleo tree <id>` walks both `parent` and `task_relations.relation_type='groups'`
|
|
72
|
+
edges to full depth — useful for Saga → Epic → Task → Subtask snapshots from
|
|
73
|
+
any starting node.
|
|
74
|
+
|
|
75
|
+
### `RenderableEnvelope<T>` discriminator
|
|
76
|
+
|
|
77
|
+
`envelope.data.kind` is one of:
|
|
78
|
+
|
|
79
|
+
| `kind` | Payload shape | Renderer family |
|
|
80
|
+
|--------|---------------|-----------------|
|
|
81
|
+
| `'tree'` | `TreeResponse<T>` (flat-node form) | `renderTree` |
|
|
82
|
+
| `'table'` | `TableResponse<T>` (rows + schema) | `renderTable` |
|
|
83
|
+
| `'list'` | `ListResponse<T>` | `renderList` |
|
|
84
|
+
| `'grouped-list'` | `GroupedListResponse<T>` | `renderGroupedList` |
|
|
85
|
+
| `'section'` | `{icon, header, items}` | `renderSection` |
|
|
86
|
+
| `'single'` | single-record detail | per-command renderer |
|
|
87
|
+
| `'generic'` | fallback `Record<string, unknown>` | kv-block helper |
|
|
88
|
+
|
|
89
|
+
### Where the rendering lives
|
|
90
|
+
|
|
91
|
+
All rendering logic — registry, families, primitives — lives under
|
|
92
|
+
`packages/core/src/render/`. `packages/cleo/src/cli/renderers/index.ts` is a
|
|
93
|
+
~20-LOC thin dispatcher. Static UI primitives (Tree, Table, Section, Badge,
|
|
94
|
+
Legend) live under `packages/animations/render/`. Typed icon enums
|
|
95
|
+
(`StatusIcon`, `KindIcon`, `BadgeIcon`, `RelationIcon`) live in
|
|
96
|
+
`@cleocode/contracts/render/icon.ts`. Family renderers self-register at
|
|
97
|
+
module load via `registerRenderer(command, kind, fn)` — importing
|
|
98
|
+
`@cleocode/core/render` populates every slot via side-effect re-exports.
|
|
99
|
+
|
|
100
|
+
Full architecture + invariants: see `cleo docs fetch adr-077-human-render-contract`.
|
|
101
|
+
|
|
55
102
|
## Decomposing an epic into N tasks
|
|
56
103
|
|
|
57
104
|
When you need to bulk-create child tasks under an epic, use `cleo add-batch`. It inserts all
|
package/skills.json
CHANGED
|
@@ -4,8 +4,8 @@
|
|
|
4
4
|
"skills": [
|
|
5
5
|
{
|
|
6
6
|
"name": "ct-cleo",
|
|
7
|
-
"description": "CLEO task management protocol - core guidance for session, task, and workflow operations. Provides CLI-based workflow, session protocol, task discovery patterns, RCSD lifecycle overview, and
|
|
8
|
-
"version": "2.
|
|
7
|
+
"description": "CLEO task management protocol - core guidance for session, task, and workflow operations. Provides CLI-based workflow, session protocol, task discovery patterns, RCSD lifecycle overview, error handling, and the Human Render Contract (ADR-077). Load this skill for detailed CLEO protocol guidance.",
|
|
8
|
+
"version": "2.1.0",
|
|
9
9
|
"path": "skills/ct-cleo/SKILL.md",
|
|
10
10
|
"references": ["skills/ct-cleo/references/session-protocol.md", "skills/ct-cleo/references/loom-lifecycle.md", "skills/ct-cleo/references/anti-patterns.md"],
|
|
11
11
|
"core": true,
|
|
@@ -16,7 +16,11 @@
|
|
|
16
16
|
"sharedResources": ["task-system-integration"],
|
|
17
17
|
"compatibility": ["claude-code", "gemini-cli", "codex-cli"],
|
|
18
18
|
"license": "MIT",
|
|
19
|
-
"metadata": {
|
|
19
|
+
"metadata": {
|
|
20
|
+
"version": "2.1.0",
|
|
21
|
+
"lastReviewed": "2026-05-23",
|
|
22
|
+
"stability": "stable"
|
|
23
|
+
}
|
|
20
24
|
},
|
|
21
25
|
{
|
|
22
26
|
"name": "ct-orchestrator",
|