@cleocode/skills 2026.10.6 → 2026.10.7
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/README.md +1 -0
- package/package.json +1 -1
- package/profiles/core.json +3 -2
- package/skills/ct-cleo/SKILL.md +8 -9
- package/skills/ct-dev-workflow/SKILL.md +32 -3
- package/skills/ct-documentor/SKILL.md +9 -3
- package/{LICENSE → skills/ct-lean/LICENSE-ponytail} +1 -1
- package/skills/ct-lean/SKILL.md +91 -0
- package/skills/ct-lean/references/examples.md +47 -0
- package/skills/ct-lean/references/never-cut.md +18 -0
- package/skills/ct-lean/references/reviewing.md +22 -0
- package/skills/ct-orchestrator/SKILL.md +7 -4
- package/skills/ct-task-executor/SKILL.md +8 -3
- package/skills/manifest.json +24 -6
package/README.md
CHANGED
|
@@ -43,6 +43,7 @@ installability and every documented `cleo` command honest.
|
|
|
43
43
|
| **ct-cleo** | CLEO task management protocol - session, task, and workflow guidance. |
|
|
44
44
|
| **ct-dev-workflow** | Development workflow orchestration for task-driven development with atomic commits, conventional commit messag… |
|
|
45
45
|
| **ct-documentor** | Documentation coordinator with CLEO style guide compliance. |
|
|
46
|
+
| **ct-lean** | Lean change discipline for CLEO work: the smallest change that fully solves the task, and a reply a busy … |
|
|
46
47
|
| **ct-lead** | Phase Lead orchestration playbook for spawning and supervising a parallel worker swarm in one wave. |
|
|
47
48
|
| **ct-orchestrator** | Pipeline-aware orchestration skill for managing complex workflows through subagent delegation. |
|
|
48
49
|
| **ct-task-executor** | General implementation task execution for completing assigned CLEO tasks by following instructions and produci… |
|
package/package.json
CHANGED
package/profiles/core.json
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "core",
|
|
3
|
-
"description": "The
|
|
3
|
+
"description": "The seven core skills (D11157, T13422): CLEO protocol, orchestration, phase leads, task execution, dev workflow, documentation and lean change",
|
|
4
4
|
"extends": "minimal",
|
|
5
5
|
"skills": [
|
|
6
6
|
"ct-orchestrator",
|
|
7
7
|
"ct-lead",
|
|
8
8
|
"ct-dev-workflow",
|
|
9
|
-
"ct-documentor"
|
|
9
|
+
"ct-documentor",
|
|
10
|
+
"ct-lean"
|
|
10
11
|
],
|
|
11
12
|
"includeProtocols": [
|
|
12
13
|
"agent-protocol"
|
package/skills/ct-cleo/SKILL.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
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
4
|
metadata:
|
|
5
|
-
version: 2.24.
|
|
5
|
+
version: 2.24.10
|
|
6
6
|
tier: core
|
|
7
7
|
install: harness
|
|
8
8
|
covers:
|
|
@@ -33,12 +33,13 @@ instruction checks do not establish live Codex, Claude, or Kimi behavior.
|
|
|
33
33
|
|
|
34
34
|
## Asking the owner (HITL ask tool)
|
|
35
35
|
|
|
36
|
-
Whenever you need the owner to answer, decide, approve or choose ANYTHING, use the
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
ask inside a response
|
|
40
|
-
|
|
41
|
-
|
|
36
|
+
Whenever you need the owner to answer, decide, approve or choose ANYTHING, use the ask
|
|
37
|
+
tool (`AskUserQuestion` in Claude Code, or the provider equivalent listed in CAAMP's
|
|
38
|
+
`PROVIDER_ASK_TOOLS`) with 2-4 concrete, selectable options, recommended first, each stating
|
|
39
|
+
what happens and its trade-offs. Never ask inside a response or bury a question in prose.
|
|
40
|
+
Answer first in every reply: the first line is the result, answer or decision; then only the
|
|
41
|
+
evidence the reader needs and what was skipped or unverified. No preamble, recap or routine
|
|
42
|
+
status chatter: report only when done or when a decision is needed.
|
|
42
43
|
|
|
43
44
|
- **Subagents never ask the human.** Return the question with its options to your
|
|
44
45
|
orchestrator (`blocked` plus `{question, options[{label, description}], recommended}`
|
|
@@ -66,8 +67,6 @@ unreachable, or nexus hits `ENOENT` on an old path, run and report:
|
|
|
66
67
|
harness CLEO skill install must resolve (a `~/.cleo` link carried by dotfiles from
|
|
67
68
|
Linux dangles on macOS and silences all of them). `--repair` relinks with a receipt.
|
|
68
69
|
|
|
69
|
-
Never delete registry rows for projects that may have moved.
|
|
70
|
-
|
|
71
70
|
## Guarded knowledge repair
|
|
72
71
|
|
|
73
72
|
Use `cleo doctor knowledge --dry-run` to inspect findings and sourced proposals.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ct-dev-workflow
|
|
3
3
|
description: Development workflow orchestration for task-driven development with atomic commits, conventional commit messages, and systematic release processes. Enforces task traceability, branch discipline, smart test scope selection, and GitHub Actions integration. Use when committing code, creating releases, managing branches, or following contribution protocols. Triggers on commit operations, release preparation, or workflow compliance needs.
|
|
4
|
-
version: 3.1.
|
|
4
|
+
version: 3.1.9
|
|
5
5
|
protocol: contribution
|
|
6
6
|
dependencies: []
|
|
7
7
|
sharedResources:
|
|
@@ -14,12 +14,18 @@ compatibility:
|
|
|
14
14
|
- gemini-cli
|
|
15
15
|
license: MIT
|
|
16
16
|
metadata:
|
|
17
|
-
version: 3.1.
|
|
17
|
+
version: 3.1.9
|
|
18
18
|
tier: core
|
|
19
19
|
install: harness
|
|
20
20
|
covers:
|
|
21
21
|
- .github/workflows/release-prepare.yml
|
|
22
|
-
|
|
22
|
+
- packages/core/src/init.ts
|
|
23
|
+
- packages/cleo/src/cli/commands/init.ts
|
|
24
|
+
- packages/core/src/hooks.ts
|
|
25
|
+
- packages/core/src/git/hooks-install.ts
|
|
26
|
+
- packages/core/templates/git-hooks/**
|
|
27
|
+
- packages/contracts/src/git-hooks.ts
|
|
28
|
+
lastReviewed: 2026-10-10
|
|
23
29
|
stability: stable
|
|
24
30
|
---
|
|
25
31
|
|
|
@@ -68,6 +74,29 @@ Every commit MUST be traceable to a CLEO task. This ensures:
|
|
|
68
74
|
|
|
69
75
|
---
|
|
70
76
|
|
|
77
|
+
## Git Hook Delivery (T13349)
|
|
78
|
+
|
|
79
|
+
Init, upgrade and explicit Git hook installation share the ownership-aware installer.
|
|
80
|
+
Resolve the effective hook directory through Git, including `core.hooksPath` and
|
|
81
|
+
linked worktrees. Preserve foreign hooks and customized managed hooks; a CLEO
|
|
82
|
+
marker alone never authorizes replacement. Refresh only exact shipped legacy
|
|
83
|
+
bodies or receipt-owned content, using locked atomic writes and hash-guarded
|
|
84
|
+
rollback. Report conflicts with the suggested integration snippet.
|
|
85
|
+
|
|
86
|
+
Receipts and locks stay in Git-private common metadata, including when
|
|
87
|
+
`core.hooksPath` selects tracked files. Default installation preserves hook
|
|
88
|
+
paths inside the checkout. Use `cleo init --git-hooks-only --allow-tracked-hooks-path` only after
|
|
89
|
+
reviewing the tracked destination; this opt-in still preserves foreign and
|
|
90
|
+
customized hooks. Init warnings carry the exact opt-in command.
|
|
91
|
+
|
|
92
|
+
The standalone pre-push template enforces task IDs from Git ref-update stdin.
|
|
93
|
+
Shared project-runner integration belongs to the unified hooks feature and must
|
|
94
|
+
ship with its implemented CLI verb. Verify nested checkout paths, linked
|
|
95
|
+
worktrees, custom hook paths, historical release bodies and corrupt receipts
|
|
96
|
+
with focused Git fixtures before changing this delivery path.
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
71
100
|
## Task Tracking Integration
|
|
72
101
|
|
|
73
102
|
### Before Any Work
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ct-documentor
|
|
3
3
|
description: Documentation coordinator with CLEO style guide compliance. Routes every canonical-doc write (spec, adr, research, handoff, note, llm-readme) through the docs SSoT via `cleo docs add` / `cleo docs publish` / `cleo docs fetch` — never raw filesystem writes. Carries the CLEO writing and review guides as references and coordinates ct-spec-writer and ct-adr-recorder. Use when creating or updating documentation files, consolidating scattered documentation, or validating documentation against style standards. Triggers on documentation tasks, doc update requests, or style guide compliance checks.
|
|
4
|
-
version: 3.17.
|
|
4
|
+
version: 3.17.7
|
|
5
5
|
protocol: null
|
|
6
6
|
dependencies:
|
|
7
7
|
- ct-spec-writer
|
|
@@ -16,7 +16,7 @@ compatibility:
|
|
|
16
16
|
- gemini-cli
|
|
17
17
|
license: MIT
|
|
18
18
|
metadata:
|
|
19
|
-
version: 3.17.
|
|
19
|
+
version: 3.17.7
|
|
20
20
|
tier: core
|
|
21
21
|
install: harness
|
|
22
22
|
covers:
|
|
@@ -53,7 +53,13 @@ surfaces** — do not present them as the default path to agents.
|
|
|
53
53
|
`supersede`, `find --similar`, `graph`, `versions`, `sync`, `search`,
|
|
54
54
|
`merge`, `rank`, `generate`, `export`, `schema`, `list-types`,
|
|
55
55
|
`serve`/`open`/`stop`/`viewer-status`, `status`/`gap-check`, `import`,
|
|
56
|
-
`publish-pr`.
|
|
56
|
+
`publish-pr`, `doctor`.
|
|
57
|
+
|
|
58
|
+
`cleo docs doctor` (T13447) audits the docs store — dangling `local-file`
|
|
59
|
+
pointers, docVersion skew vs the audit log, empty topics/related_tasks,
|
|
60
|
+
`docs_wikilinks` drift, legacy store surfaces, stale drafts — and with
|
|
61
|
+
`--apply` repairs them after creating a backup automatically. Use it for
|
|
62
|
+
store hygiene checks; it never edits doc content.
|
|
57
63
|
|
|
58
64
|
For discovery (`find`, `search`, `schema`, `list-types`), prefer `cleo docs list`
|
|
59
65
|
first — it returns slug + owner + type without forcing a filesystem walk. Use
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ct-lean
|
|
3
|
+
description: >-
|
|
4
|
+
Lean change discipline for CLEO work: the smallest change that fully solves the task, and
|
|
5
|
+
a reply a busy owner understands in one read. Use on every coding task (writing, fixing,
|
|
6
|
+
refactoring, reviewing, choosing dependencies) and when the owner asks for the simplest
|
|
7
|
+
solution, YAGNI, or complains about over-engineering or bloat. Never trades away evidence
|
|
8
|
+
gates, package boundaries, validation, data safety or anything the task asked for.
|
|
9
|
+
license: MIT
|
|
10
|
+
metadata:
|
|
11
|
+
version: 1.0.0
|
|
12
|
+
tier: core
|
|
13
|
+
install: harness
|
|
14
|
+
covers:
|
|
15
|
+
- packages/core/src/orchestration/lean-change.ts
|
|
16
|
+
lastReviewed: 2026-10-10
|
|
17
|
+
stability: stable
|
|
18
|
+
attribution: Adapted from Ponytail 5.1.0 by DietrichGebert (MIT) — https://github.com/DietrichGebert/ponytail
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
# ct-lean — the smallest complete change
|
|
22
|
+
|
|
23
|
+
The best code is the code never written. Solve the whole task with the least new code,
|
|
24
|
+
then end the reply with one or two lines: what you skipped or did not check, and any risk
|
|
25
|
+
the owner must know.
|
|
26
|
+
|
|
27
|
+
## Before you write
|
|
28
|
+
|
|
29
|
+
Read the task (`cleo show <id> --full`) and the code it touches. List every place the
|
|
30
|
+
change must reach: callers, tests, fixtures, config, exports, contracts. Run
|
|
31
|
+
`cleo nexus impact <symbol>` before editing a symbol, and grep for runtime callers static
|
|
32
|
+
analysis cannot see. Check what the change could break: data it would destroy or expose,
|
|
33
|
+
callers that stop working, stores it would migrate. That is scope. Extra features are not.
|
|
34
|
+
|
|
35
|
+
## Take the first option that fully works
|
|
36
|
+
|
|
37
|
+
1. **Does it need to exist?** Skip features, options and flexibility nobody asked for, and
|
|
38
|
+
name them in one line. A vague request gets the smallest version that does the core job.
|
|
39
|
+
2. **Already in this codebase?** A helper, accessor, contract or pattern: use it the way the
|
|
40
|
+
surrounding code does. Search `packages/core/src` and `packages/contracts/src` first.
|
|
41
|
+
3. **Standard library or platform feature?** Use it, unless the repo has its own (a house
|
|
42
|
+
chokepoint such as `openDualScopeDb` or `cleo run` beats a raw primitive).
|
|
43
|
+
4. **An installed dependency?** Use it. Never add a dependency for a few lines.
|
|
44
|
+
5. **One line a reader gets at a glance?** One line.
|
|
45
|
+
6. **Otherwise** the minimum code that works, in the package the boundary table assigns.
|
|
46
|
+
|
|
47
|
+
## Rules
|
|
48
|
+
|
|
49
|
+
- Lazy about the solution, never about the change: finish every part the task needs,
|
|
50
|
+
including the callers, tests, fixtures and docs the change breaks.
|
|
51
|
+
- No abstraction, wrapper, type conversion, option, config, boilerplate or "for later" code
|
|
52
|
+
nobody asked for. Deletion beats addition. Keep the layers, contracts and conventions the
|
|
53
|
+
repo already has.
|
|
54
|
+
- The shortest working diff wins once you know everything it must touch. A one-liner that
|
|
55
|
+
needs decoding is not short.
|
|
56
|
+
- Comment only the why the code cannot show, in one line. Exported symbols still get TSDoc.
|
|
57
|
+
- Bug fix: grep every caller of the function you touch, then fix the root cause once in the
|
|
58
|
+
shared code. No workaround at a call site.
|
|
59
|
+
- Code you move or merge keeps its error handling and validation.
|
|
60
|
+
- Between options of equal size, take the one that is correct on edge cases.
|
|
61
|
+
- New non-trivial logic (a branch, a loop, a parser, a store write, security) leaves one
|
|
62
|
+
small test. Trivial changes need none. Run single test files through `cleo run --wait`.
|
|
63
|
+
- A shortcut with a known limit gets a comment: `shortcut: <the limit>, <when to upgrade>`.
|
|
64
|
+
|
|
65
|
+
## Never cut
|
|
66
|
+
|
|
67
|
+
- Validation at trust boundaries, error handling that prevents data loss, security,
|
|
68
|
+
accessibility, and anything the task or owner asked for.
|
|
69
|
+
- CLEO evidence: every gate gets programmatic evidence (`cleo verify`), never self-attested.
|
|
70
|
+
- Type safety: no `any`, no `as unknown as X`; shared types live in `packages/contracts/`.
|
|
71
|
+
- The package boundary and the `cleo check arch` gates; a smaller diff in the wrong package
|
|
72
|
+
is not smaller.
|
|
73
|
+
- Store safety: the DB chokepoint, migrations, backups, and the tracked identity files.
|
|
74
|
+
|
|
75
|
+
## Replies
|
|
76
|
+
|
|
77
|
+
Answer first: the first line is the result, answer or decision. Then only the evidence the
|
|
78
|
+
reader needs (bullets or a small table), then the skipped/unchecked line. No preamble,
|
|
79
|
+
recap or restated request. Owner questions go through the ask tool with populated options,
|
|
80
|
+
never in the reply (CLEO-INJECTION.md universal protocol step 7).
|
|
81
|
+
|
|
82
|
+
## References
|
|
83
|
+
|
|
84
|
+
- `references/examples.md` — worked CLEO examples, over-built vs lean.
|
|
85
|
+
- `references/never-cut.md` — the never-cut list with the gate that enforces each row.
|
|
86
|
+
- `references/reviewing.md` — a lean review checklist for PRs and your own diff.
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
Adapted from [Ponytail](https://github.com/DietrichGebert/ponytail) 5.1.0, Copyright (c) 2026
|
|
91
|
+
DietrichGebert, MIT License. Levels, statusline and plugin hooks are not carried over.
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# ct-lean worked examples
|
|
2
|
+
|
|
3
|
+
Each example names the request, the over-built answer agents tend to write, and the lean
|
|
4
|
+
answer. The lean answer is complete: it touches every place the change must reach.
|
|
5
|
+
|
|
6
|
+
## 1. "Add a `--json` flag to a CLI command"
|
|
7
|
+
|
|
8
|
+
- **Over-built:** a new formatter module, an `OutputMode` enum, a config key for the default.
|
|
9
|
+
- **Lean:** none of it. Every `cleo` command already emits one LAFS envelope and supports
|
|
10
|
+
`--output`/`--field` (ADR-086). Answer with the existing flag. If one is truly missing, wire
|
|
11
|
+
the command through `defineCommand` so it inherits the flag; never hand-roll JSON.
|
|
12
|
+
|
|
13
|
+
## 2. "The import fails when the file has a BOM"
|
|
14
|
+
|
|
15
|
+
- **Over-built:** a try/catch at the one failing call site that strips ``.
|
|
16
|
+
- **Lean:** grep every caller of the shared reader, then strip the BOM once inside it. Add one
|
|
17
|
+
test with a BOM fixture. The call-site patch is a workaround that the next caller repeats.
|
|
18
|
+
|
|
19
|
+
## 3. "Cache the provider lookup, it is slow"
|
|
20
|
+
|
|
21
|
+
- **Over-built:** an LRU class with TTL, size options and invalidation hooks.
|
|
22
|
+
- **Lean:** measure first. If the lookup is a pure function of static data, a module-level
|
|
23
|
+
`Map` (or computing the table once) is enough. Add the TTL only when a test shows stale
|
|
24
|
+
data. Leave `shortcut: no invalidation, data is static per process; add TTL if it becomes
|
|
25
|
+
config-driven`.
|
|
26
|
+
|
|
27
|
+
## 4. "Write rows to a new table"
|
|
28
|
+
|
|
29
|
+
- **Over-built:** a raw `new DatabaseSync(...)` with hand-written `INSERT OR REPLACE`.
|
|
30
|
+
- **Lean, and the only correct option:** go through `openDualScopeDb` and the canonical
|
|
31
|
+
accessor, and use `INSERT … ON CONFLICT … DO UPDATE`. Gates 3 and 28 reject the short
|
|
32
|
+
version. A smaller diff that breaks a gate is not smaller.
|
|
33
|
+
|
|
34
|
+
## 5. "Fix the flaky test"
|
|
35
|
+
|
|
36
|
+
- **Over-built:** a retry wrapper, or a larger timeout.
|
|
37
|
+
- **Lean:** find the race (shared temp dir, unawaited promise, real clock) and fix it at the
|
|
38
|
+
source. Never edit the expectation to match broken behaviour.
|
|
39
|
+
|
|
40
|
+
## 6. Reply shape
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
Fixed: the BOM is stripped once in readJsonFile (packages/core/src/store/json.ts).
|
|
44
|
+
- 1 new test (json.test.ts > strips a UTF-8 BOM); 14/14 pass
|
|
45
|
+
- tsc -b and biome clean
|
|
46
|
+
Skipped: did not audit the two callers in studio (they read via the same function).
|
|
47
|
+
```
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# ct-lean never-cut list (CLEO edition)
|
|
2
|
+
|
|
3
|
+
Lean means less *unrequested* code. These are always in scope, however small the task.
|
|
4
|
+
|
|
5
|
+
| Never cut | Why | CLEO enforcement |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Validation at trust boundaries | Input from users, agents, harness hooks and synced peers is untrusted | Zod schemas in `packages/contracts`; sync write invariants (gate 38) |
|
|
8
|
+
| Error handling that prevents data loss | A silent catch around a store write loses rows | `catch (err: unknown)` is banned; killed writes have unknown outcome |
|
|
9
|
+
| Security | Secrets, shell quoting, path traversal | `tool:security-scan` evidence; no secrets in output |
|
|
10
|
+
| Evidence | A gate without programmatic proof is self-attestation | `cleo verify --gate … --evidence …` (ADR-051), re-validated at `cleo complete` |
|
|
11
|
+
| Type safety | `any` and cast chains hide the bug the type would have caught | Project rule; shared types live in `packages/contracts/` |
|
|
12
|
+
| Package boundary | Code in the wrong package becomes the next relocation task | AGENTS.md boundary table; `cleo check arch` gates 4, 6, 10, 11 |
|
|
13
|
+
| Store safety | The DB chokepoint, migrations, backups, tracked identity files | Gates 3, 17, 28, 36, 37; never `git add` `.cleo/*.db` |
|
|
14
|
+
| Accessibility | UI that only works for some users is not done | Studio review checks |
|
|
15
|
+
| Anything the task or owner asked for | Lean trims extras, never the request | The task's acceptance criteria |
|
|
16
|
+
|
|
17
|
+
When a lean option conflicts with a row above, the row wins. Say so in the reply's
|
|
18
|
+
skipped/risk line instead of silently choosing the bigger diff.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Reviewing a diff with ct-lean
|
|
2
|
+
|
|
3
|
+
Use this when reviewing a PR or your own diff before `cleo verify`.
|
|
4
|
+
|
|
5
|
+
1. **Scope.** Does every changed file serve the task's acceptance criteria? Name anything
|
|
6
|
+
that does not, such as an unrelated refactor or a speculative option.
|
|
7
|
+
2. **Reuse.** Was there an existing helper, accessor, contract or chokepoint for this? Check
|
|
8
|
+
`packages/core/src` and `packages/contracts/src`. A new utility that duplicates one is a
|
|
9
|
+
finding.
|
|
10
|
+
3. **Abstraction.** Count the new interfaces, options, config keys and wrappers. Each one
|
|
11
|
+
needs a caller today; "for later" is a finding.
|
|
12
|
+
4. **Completeness.** Grep the callers of every changed exported symbol. A caller, fixture or
|
|
13
|
+
doc left behind is a finding. Lean never means half-done.
|
|
14
|
+
5. **Root cause.** Is a bug fixed in the shared code, or patched at one call site?
|
|
15
|
+
6. **Checks.** New non-trivial logic has one focused test. Test expectations were not edited
|
|
16
|
+
to match broken code.
|
|
17
|
+
7. **Never-cut list.** Validation, data safety, security, evidence, type safety, package
|
|
18
|
+
boundary: confirm none were trimmed to shorten the diff.
|
|
19
|
+
8. **Shortcuts.** Each known limit carries `shortcut: <limit>, <when to upgrade>`.
|
|
20
|
+
|
|
21
|
+
Report findings as the reply format says: verdict first, then one line per finding with its
|
|
22
|
+
file and line, then what you did not check.
|
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
name: ct-orchestrator
|
|
3
3
|
description: "Pipeline-aware orchestration skill for managing complex workflows through subagent delegation. Use when the user asks to \"orchestrate\", \"orchestrator mode\", \"run as orchestrator\", \"delegate to subagents\", \"coordinate agents\", \"spawn subagents\", \"multi-agent workflow\", \"context-protected workflow\", \"agent farm\", \"HITL orchestration\", \"pipeline management\", or needs to manage complex workflows by delegating work to subagents while protecting the main context window. Enforces ORC-001 through ORC-009 constraints. Provider-neutral — works with any AI agent runtime."
|
|
4
4
|
metadata:
|
|
5
|
-
version: 4.0.
|
|
5
|
+
version: 4.0.12
|
|
6
6
|
tier: core
|
|
7
7
|
install: harness
|
|
8
8
|
covers:
|
|
9
9
|
- packages/cleo/src/cli/commands/orchestrate.ts
|
|
10
10
|
- packages/core/src/orchestration/spawn-prompt.ts
|
|
11
|
-
lastReviewed: 2026-10-
|
|
11
|
+
lastReviewed: 2026-10-10
|
|
12
12
|
stability: stable
|
|
13
13
|
---
|
|
14
14
|
|
|
@@ -252,14 +252,17 @@ On an idle host every ready task is `admitted` and behaviour is unchanged.
|
|
|
252
252
|
|
|
253
253
|
After each wave or on request: what completed, blockers needing HITL, next actions.
|
|
254
254
|
Report only when work is done or a decision is needed; no routine status chatter.
|
|
255
|
+
Answer first: the first line is the result or the decision needed, then only the
|
|
256
|
+
evidence the owner needs (bullets or a small table) and what is unverified.
|
|
255
257
|
|
|
256
258
|
## Asking the Owner (HITL ask tool)
|
|
257
259
|
|
|
258
260
|
Whenever the owner must answer, decide, approve or choose ANYTHING, ask through
|
|
259
261
|
the ask tool (`AskUserQuestion` in Claude Code, or the provider equivalent from
|
|
260
262
|
CAAMP's `PROVIDER_ASK_TOOLS`) with concrete, detailed, selectable options. Never
|
|
261
|
-
ask inside a response, and never bury a question or decision in prose.
|
|
262
|
-
|
|
263
|
+
ask inside a response, and never bury a question or decision in prose. Give 2-4
|
|
264
|
+
options, recommended first, each stating what happens and its trade-offs. A relayed
|
|
265
|
+
subagent question with thin options gets filled in before you ask, never passed on bare.
|
|
263
266
|
|
|
264
267
|
- **Subagent relay.** Subagents never ask the human (most harnesses deny them the
|
|
265
268
|
ask tool). A subagent that needs a decision returns `blocked` with
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ct-task-executor
|
|
3
3
|
description: General implementation task execution for completing assigned CLEO tasks by following instructions and producing concrete deliverables. Handles coding, configuration, documentation work with quality verification against acceptance criteria and progress reporting. Use when executing implementation tasks, completing assigned work, or producing task deliverables. Triggers on implementation tasks, general execution needs, or task completion work.
|
|
4
|
-
version: 2.7.
|
|
4
|
+
version: 2.7.9
|
|
5
5
|
protocol: implementation
|
|
6
6
|
adrRefs:
|
|
7
7
|
- ADR-070
|
|
@@ -17,7 +17,7 @@ compatibility:
|
|
|
17
17
|
- gemini-cli
|
|
18
18
|
license: MIT
|
|
19
19
|
metadata:
|
|
20
|
-
version: 2.7.
|
|
20
|
+
version: 2.7.9
|
|
21
21
|
tier: core
|
|
22
22
|
install: harness
|
|
23
23
|
covers:
|
|
@@ -126,7 +126,12 @@ Context injection for implementation tasks spawned via cleo-subagent. Provides d
|
|
|
126
126
|
|
|
127
127
|
### Post-Execution
|
|
128
128
|
|
|
129
|
-
1. **Verify against criteria** - Check each acceptance criterion
|
|
129
|
+
1. **Verify against criteria** - Check each acceptance criterion. `cleo verify <id> --run`
|
|
130
|
+
executes the typed gates; `--run --req REQ-A,REQ-B` runs only those gates and leaves
|
|
131
|
+
the other gates' cached passes as they are. A typed gate whose command is wrong (an
|
|
132
|
+
absolute path into a removed worktree, say) is fixed in place with
|
|
133
|
+
`cleo req replace <id> <REQ-ID> --gate '<json>'`. Prefer a repo-relative command and
|
|
134
|
+
`cwd`; a locked stage also needs `--reason`. Then verify that gate again.
|
|
130
135
|
2. **Document completion** - Write detailed output file
|
|
131
136
|
3. **Update manifest** - Append summary entry
|
|
132
137
|
4. **Complete task** - Mark task done in task system
|
package/skills/manifest.json
CHANGED
|
@@ -62,7 +62,7 @@
|
|
|
62
62
|
"_meta": {
|
|
63
63
|
"schemaVersion": "2.7.0",
|
|
64
64
|
"lastUpdated": "2026-05-19",
|
|
65
|
-
"totalSkills":
|
|
65
|
+
"totalSkills": 22,
|
|
66
66
|
"generatedFrom": "T260 — lifecycle pipeline rework: dedicated skills for ADR, IVT loop, consensus, release, artifact-publish, provenance. T9664/T9665/T9672 (epic T9568) — adds loomStage + adrRefs fields on every LOOM-stage skill entry (underscored canonical form matching `cleo lifecycle` stage names; ADR refs point at .cleo/adrs/). T9672 reconciled dispatch_matrix.by_protocol key 'architecture-decision' → 'architecture_decision' matching the lifecycle CLI source of truth; the dashed form is retained as a keyword alias.",
|
|
67
67
|
"architectureNote": "Universal Subagent Architecture: All spawns use provider-neutral delegation with skill/protocol injection. Pipeline stages and cross-cutting protocols each have a dedicated skill — no overloading.",
|
|
68
68
|
"loomStageContract": "Each of the 10 LOOM lifecycle stages (research, consensus, architecture_decision, specification, decomposition, implementation, validation, testing, release, contribution) MUST have a bound skill whose manifest entry declares loomStage matching the lifecycle CLI stage name. The legacy `protocol` field is retained as an alias; dispatch_matrix.by_protocol is the authoritative routing table. See docs/skills/loom-coverage-matrix.md.",
|
|
@@ -226,7 +226,7 @@
|
|
|
226
226
|
},
|
|
227
227
|
{
|
|
228
228
|
"name": "ct-cleo",
|
|
229
|
-
"version": "2.24.
|
|
229
|
+
"version": "2.24.10",
|
|
230
230
|
"description": "CLEO task management protocol - session, task, and workflow guidance. Use when managing tasks, sessions, or multi-agent workflows with the CLEO CLI protocol.",
|
|
231
231
|
"path": "skills/ct-cleo",
|
|
232
232
|
"tier": 0,
|
|
@@ -566,7 +566,7 @@
|
|
|
566
566
|
},
|
|
567
567
|
{
|
|
568
568
|
"name": "ct-dev-workflow",
|
|
569
|
-
"version": "3.1.
|
|
569
|
+
"version": "3.1.9",
|
|
570
570
|
"description": "Development workflow orchestration for task-driven development with atomic commits, conventional commit messages, and systematic release processes. Enforces task traceability, branch discipline, smart test scope selection, and GitHub Actions integration. Use when committing code, creating releases, managing branches, or following contribution protocols. Triggers on commit operations, release preparation, or workflow compliance needs.",
|
|
571
571
|
"path": "skills/ct-dev-workflow",
|
|
572
572
|
"tier": 0,
|
|
@@ -642,7 +642,7 @@
|
|
|
642
642
|
},
|
|
643
643
|
{
|
|
644
644
|
"name": "ct-documentor",
|
|
645
|
-
"version": "3.17.
|
|
645
|
+
"version": "3.17.7",
|
|
646
646
|
"description": "Documentation coordinator with CLEO style guide compliance. Routes every canonical-doc write (spec, adr, research, handoff, note, llm-readme) through the docs SSoT via `cleo docs add` / `cleo docs publish` / `cleo docs fetch` — never raw filesystem writes. Carries the CLEO writing and review guides as references and coordinates ct-spec-writer and ct-adr-recorder. Use when creating or updating documentation files, consolidating scattered documentation, or validating documentation against style standards. Triggers on documentation tasks, doc update requests, or style guide compliance checks.",
|
|
647
647
|
"path": "skills/ct-documentor",
|
|
648
648
|
"tier": 0,
|
|
@@ -981,9 +981,27 @@
|
|
|
981
981
|
"compatibility": [],
|
|
982
982
|
"license": "MIT"
|
|
983
983
|
},
|
|
984
|
+
{
|
|
985
|
+
"name": "ct-lean",
|
|
986
|
+
"version": "1.0.0",
|
|
987
|
+
"description": "Lean change discipline for CLEO work: the smallest change that fully solves the task, and a reply a busy owner understands in one read. Use on every coding task (writing, fixing, refactoring, reviewing, choosing dependencies) and when the owner asks for the simplest solution, YAGNI, or complains about over-engineering or bloat. Never trades away evidence gates, package boundaries, validation, data safety or anything the task asked for.",
|
|
988
|
+
"path": "skills/ct-lean",
|
|
989
|
+
"tier": 0,
|
|
990
|
+
"deliveryTier": "core",
|
|
991
|
+
"install": "harness",
|
|
992
|
+
"status": "active",
|
|
993
|
+
"core": true,
|
|
994
|
+
"category": "core",
|
|
995
|
+
"dependencies": [],
|
|
996
|
+
"references": [],
|
|
997
|
+
"protocol": null,
|
|
998
|
+
"sharedResources": [],
|
|
999
|
+
"compatibility": [],
|
|
1000
|
+
"license": "MIT"
|
|
1001
|
+
},
|
|
984
1002
|
{
|
|
985
1003
|
"name": "ct-orchestrator",
|
|
986
|
-
"version": "4.0.
|
|
1004
|
+
"version": "4.0.12",
|
|
987
1005
|
"description": "Pipeline-aware orchestration skill for managing complex workflows through subagent delegation. Use when the user asks to \\\"orchestrate\\\", \\\"orchestrator mode\\\", \\\"run as orchestrator\\\", \\\"delegate to subagents\\\", \\\"coordinate agents\\\", \\\"spawn subagents\\\", \\\"multi-agent workflow\\\", \\\"context-protected workflow\\\", \\\"agent farm\\\", \\\"HITL orchestration\\\", \\\"pipeline management\\\", or needs to manage complex workflows by delegating work to subagents while protecting the main context window. Enforces ORC-001 through ORC-009 constraints. Provider-neutral — works with any AI agent runtime.",
|
|
988
1006
|
"path": "skills/ct-orchestrator",
|
|
989
1007
|
"tier": 0,
|
|
@@ -1472,7 +1490,7 @@
|
|
|
1472
1490
|
},
|
|
1473
1491
|
{
|
|
1474
1492
|
"name": "ct-task-executor",
|
|
1475
|
-
"version": "2.7.
|
|
1493
|
+
"version": "2.7.9",
|
|
1476
1494
|
"description": "General implementation task execution for completing assigned CLEO tasks by following instructions and producing concrete deliverables. Handles coding, configuration, documentation work with quality verification against acceptance criteria and progress reporting. Use when executing implementation tasks, completing assigned work, or producing task deliverables. Triggers on implementation tasks, general execution needs, or task completion work.",
|
|
1477
1495
|
"path": "skills/ct-task-executor",
|
|
1478
1496
|
"tier": 0,
|