@cleocode/skills 2026.9.21 → 2026.9.23

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.
Files changed (151) hide show
  1. package/README.md +46 -63
  2. package/frontmatter.d.mts +60 -0
  3. package/frontmatter.mjs +277 -0
  4. package/index.d.ts +3 -3
  5. package/index.js +34 -9
  6. package/package.json +4 -2
  7. package/profiles/core.json +10 -3
  8. package/profiles/full.json +10 -6
  9. package/profiles/recommended.json +29 -3
  10. package/skills/_shared/manifest-operations.md +19 -40
  11. package/skills/_shared/skill-chaining-patterns.md +5 -9
  12. package/skills/_shared/subagent-protocol-base.md +6 -6
  13. package/skills/_shared/task-system-integration.md +5 -5
  14. package/skills/ct-adr-recorder/SKILL.md +18 -17
  15. package/skills/ct-artifact-publisher/SKILL.md +10 -7
  16. package/skills/ct-cleo/SKILL.md +26 -9
  17. package/skills/ct-cleo/references/loom-lifecycle.md +1 -1
  18. package/skills/{ct-memory/SKILL.md → ct-cleo/references/memory.md} +10 -23
  19. package/skills/ct-cleo/references/orchestrator-constraints.md +5 -5
  20. package/skills/ct-cleo/references/session-protocol.md +11 -8
  21. package/skills/{ct-stickynote/SKILL.md → ct-cleo/references/sticky-notes.md} +7 -29
  22. package/skills/ct-codebase-mapper/SKILL.md +62 -38
  23. package/skills/ct-consensus-voter/SKILL.md +10 -7
  24. package/skills/ct-contribution/SKILL.md +7 -5
  25. package/skills/ct-dev-workflow/SKILL.md +7 -7
  26. package/skills/ct-documentor/SKILL.md +29 -29
  27. package/skills/{ct-docs-review/__tests__/skill-docs-review.test.ts → ct-documentor/__tests__/reviewing-reference.test.ts} +4 -3
  28. package/skills/{ct-docs-write/__tests__/skill-docs-write.test.ts → ct-documentor/__tests__/writing-reference.test.ts} +4 -3
  29. package/skills/ct-documentor/references/anti-patterns.md +8 -8
  30. package/skills/{ct-docs-write → ct-documentor}/references/audience-targeting.md +5 -5
  31. package/skills/ct-documentor/references/chain-orchestration.md +19 -19
  32. package/skills/{ct-docs-write → ct-documentor}/references/cleo-style-guide.md +1 -1
  33. package/skills/ct-documentor/references/doc-types-and-templates.md +1 -1
  34. package/skills/{ct-docs-review → ct-documentor}/references/pr-review-mode.md +1 -1
  35. package/skills/{ct-docs-review/SKILL.md → ct-documentor/references/reviewing.md} +6 -26
  36. package/skills/ct-documentor/references/style-coordination.md +5 -5
  37. package/skills/{ct-docs-review → ct-documentor}/references/style-violations.md +1 -1
  38. package/skills/{ct-docs-write/SKILL.md → ct-documentor/references/writing.md} +5 -25
  39. package/skills/ct-epic-architect/SKILL.md +12 -9
  40. package/skills/ct-epic-architect/references/commands.md +5 -5
  41. package/skills/ct-epic-architect/references/output-format.md +2 -2
  42. package/skills/ct-epic-architect/references/patterns.md +2 -2
  43. package/skills/ct-epic-architect/references/skill-aware-execution.md +3 -3
  44. package/skills/ct-grade/SKILL.md +3 -4
  45. package/skills/ct-grade/agents/scenario-runner.md +1 -1
  46. package/skills/ct-ivt-looper/SKILL.md +23 -22
  47. package/skills/ct-lead/SKILL.md +52 -13
  48. package/skills/ct-lead/references/aggregation-protocol.md +44 -21
  49. package/skills/ct-lead/references/spawn-pattern.md +12 -11
  50. package/skills/ct-orchestrator/README.md +2 -2
  51. package/skills/ct-orchestrator/SKILL.md +14 -10
  52. package/skills/ct-orchestrator/references/SUBAGENT-PROTOCOL-BLOCK.md +4 -4
  53. package/skills/ct-orchestrator/references/autonomous-operation.md +4 -4
  54. package/skills/ct-orchestrator/references/orchestrator-compliance.md +3 -3
  55. package/skills/ct-orchestrator/references/orchestrator-patterns.md +20 -19
  56. package/skills/ct-orchestrator/references/orchestrator-recovery.md +13 -23
  57. package/skills/ct-orchestrator/references/orchestrator-spawning.md +9 -10
  58. package/skills/ct-orchestrator/references/orchestrator-tokens.md +9 -9
  59. package/skills/ct-provenance-keeper/SKILL.md +10 -7
  60. package/skills/ct-release-orchestrator/SKILL.md +21 -13
  61. package/skills/ct-release-orchestrator/references/composition.md +1 -1
  62. package/skills/ct-release-orchestrator/references/release-types.md +33 -15
  63. package/skills/ct-research-agent/SKILL.md +14 -12
  64. package/skills/ct-research-agent/references/triggers-and-routing.md +4 -4
  65. package/skills/{ct-skill-creator → ct-skill-author}/SKILL.md +9 -6
  66. package/skills/{ct-skill-validator → ct-skill-author}/agents/ecosystem-checker.md +1 -1
  67. package/skills/{ct-skill-validator → ct-skill-author}/evals/quality_evals.json +10 -10
  68. package/skills/{ct-skill-validator → ct-skill-author}/evals/trigger_queries.json +1 -1
  69. package/skills/{ct-skill-validator → ct-skill-author}/references/cleo-ecosystem-rules.md +8 -4
  70. package/skills/{ct-skill-creator → ct-skill-author}/references/provider-deployment.md +10 -6
  71. package/skills/{ct-skill-validator/SKILL.md → ct-skill-author/references/validating.md} +14 -21
  72. package/skills/{ct-skill-validator → ct-skill-author}/references/validation-rules.md +2 -2
  73. package/skills/{ct-skill-validator → ct-skill-author}/scripts/_skill_finder.py +2 -2
  74. package/skills/{ct-skill-validator → ct-skill-author}/scripts/check_depth.py +2 -5
  75. package/skills/{ct-skill-validator → ct-skill-author}/scripts/generate_validation_report.py +1 -1
  76. package/skills/{ct-skill-validator → ct-skill-author}/scripts/run_quality_eval.py +2 -2
  77. package/skills/ct-spec-writer/SKILL.md +9 -7
  78. package/skills/ct-task-executor/SKILL.md +19 -16
  79. package/skills/ct-task-executor/references/common-failures.md +1 -1
  80. package/skills/ct-validator/SKILL.md +11 -9
  81. package/skills/ct-validator/references/compliance-reports.md +1 -1
  82. package/skills/ct-validator/references/validation-modes.md +3 -3
  83. package/skills/manifest.json +381 -365
  84. package/dispatch-config.json +0 -983
  85. package/provider-skills-map.json +0 -97
  86. package/skills/ct-docs-lookup/SKILL.md +0 -185
  87. package/skills/ct-docs-lookup/references/ctx7-workflow.md +0 -198
  88. package/skills/ct-docs-lookup/references/library-id-resolution.md +0 -217
  89. package/skills/ct-docs-lookup/references/version-specific-docs.md +0 -220
  90. package/skills/ct-master-tac/SKILL.md +0 -120
  91. package/skills/ct-master-tac/__tests__/install.test.ts +0 -304
  92. package/skills/ct-master-tac/bundled/README.md +0 -40
  93. package/skills/ct-master-tac/bundled/protocols/architecture-decision.cant +0 -90
  94. package/skills/ct-master-tac/bundled/protocols/artifact-publish.cant +0 -105
  95. package/skills/ct-master-tac/bundled/protocols/consensus.cant +0 -85
  96. package/skills/ct-master-tac/bundled/protocols/contribution.cant +0 -92
  97. package/skills/ct-master-tac/bundled/protocols/decomposition.cant +0 -102
  98. package/skills/ct-master-tac/bundled/protocols/implementation.cant +0 -77
  99. package/skills/ct-master-tac/bundled/protocols/provenance.cant +0 -100
  100. package/skills/ct-master-tac/bundled/protocols/release.cant +0 -107
  101. package/skills/ct-master-tac/bundled/protocols/research.cant +0 -77
  102. package/skills/ct-master-tac/bundled/protocols/specification.cant +0 -77
  103. package/skills/ct-master-tac/bundled/protocols/testing.cant +0 -99
  104. package/skills/ct-master-tac/bundled/protocols/validation.cant +0 -75
  105. package/skills/ct-master-tac/bundled/teams/platform.cant +0 -115
  106. package/skills/ct-master-tac/manifest.json +0 -55
  107. package/skills/ct-skill-creator/eval-viewer/__pycache__/generate_review.cpython-314.pyc +0 -0
  108. package/skills/ct-skill-creator/manifest-entry.json +0 -17
  109. package/skills/ct-skill-creator/scripts/__pycache__/__init__.cpython-314.pyc +0 -0
  110. package/skills/ct-skill-creator/scripts/__pycache__/aggregate_benchmark.cpython-314.pyc +0 -0
  111. package/skills/ct-skill-creator/scripts/__pycache__/generate_report.cpython-314.pyc +0 -0
  112. package/skills/ct-skill-creator/scripts/__pycache__/improve_description.cpython-314.pyc +0 -0
  113. package/skills/ct-skill-creator/scripts/__pycache__/init_skill.cpython-314.pyc +0 -0
  114. package/skills/ct-skill-creator/scripts/__pycache__/quick_validate.cpython-314.pyc +0 -0
  115. package/skills/ct-skill-creator/scripts/__pycache__/run_eval.cpython-314.pyc +0 -0
  116. package/skills/ct-skill-creator/scripts/__pycache__/run_loop.cpython-314.pyc +0 -0
  117. package/skills/ct-skill-creator/scripts/__pycache__/utils.cpython-314.pyc +0 -0
  118. package/skills/ct-skill-validator/manifest-entry.json +0 -20
  119. package/skills/ct-stickynote/README.md +0 -14
  120. package/skills/signaldock-connect/SKILL.md +0 -137
  121. package/skills/signaldock-connect/assets/agent-card.json +0 -48
  122. package/skills/signaldock-connect/references/api-endpoints.md +0 -131
  123. package/skills.json +0 -495
  124. /package/skills/{ct-docs-review → ct-documentor}/references/inline-comment-patterns.md +0 -0
  125. /package/skills/{ct-docs-write → ct-documentor}/references/markdown-patterns.md +0 -0
  126. /package/skills/{ct-skill-creator → ct-skill-author}/agents/analyzer.md +0 -0
  127. /package/skills/{ct-skill-creator → ct-skill-author}/agents/comparator.md +0 -0
  128. /package/skills/{ct-skill-creator → ct-skill-author}/agents/grader.md +0 -0
  129. /package/skills/{ct-skill-creator → ct-skill-author}/assets/eval_review.html +0 -0
  130. /package/skills/{ct-skill-validator → ct-skill-author}/assets/valid-skill-example.md +0 -0
  131. /package/skills/{ct-skill-creator → ct-skill-author}/eval-viewer/generate_review.py +0 -0
  132. /package/skills/{ct-skill-creator → ct-skill-author}/eval-viewer/viewer.html +0 -0
  133. /package/skills/{ct-skill-creator → ct-skill-author}/references/dynamic-context.md +0 -0
  134. /package/skills/{ct-skill-creator → ct-skill-author}/references/frontmatter.md +0 -0
  135. /package/skills/{ct-skill-creator → ct-skill-author}/references/invocation-control.md +0 -0
  136. /package/skills/{ct-skill-creator → ct-skill-author}/references/output-patterns.md +0 -0
  137. /package/skills/{ct-skill-creator → ct-skill-author}/references/schemas.md +0 -0
  138. /package/skills/{ct-skill-creator → ct-skill-author}/references/workflows.md +0 -0
  139. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/__init__.py +0 -0
  140. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/aggregate_benchmark.py +0 -0
  141. /package/skills/{ct-skill-validator → ct-skill-author}/scripts/audit_body.py +0 -0
  142. /package/skills/{ct-skill-validator → ct-skill-author}/scripts/check_ecosystem.py +0 -0
  143. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/generate_report.py +0 -0
  144. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/improve_description.py +0 -0
  145. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/init_skill.py +0 -0
  146. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/package_skill.py +0 -0
  147. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/quick_validate.py +0 -0
  148. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/run_eval.py +0 -0
  149. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/run_loop.py +0 -0
  150. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/utils.py +0 -0
  151. /package/skills/{ct-skill-validator → ct-skill-author}/scripts/validate.py +0 -0
@@ -1,107 +0,0 @@
1
- ---
2
- kind: protocol
3
- version: 1.0.0
4
- id: REL
5
- title: "Release Protocol"
6
- status: active
7
- type: conditional
8
- audience: "llm-agent, orchestrator"
9
- tags: "release, semver, changelog"
10
- skillRef: ct-release-orchestrator
11
- lastUpdated: 2026-04-08
12
- enforcement: strict
13
- stage: "release"
14
- consult-when: "Shipping a new version; running 'cleo release ship'; promoting a completed epic to released status; any task with 'release', 'version bump', 'changelog', 'tag', 'publish'"
15
- input:
16
- version: "string — CalVer YYYY.MM.patch target version"
17
- changelog_entries: "string[] — summarized changes since last release"
18
- artifact_config: "object | null — artifact publish config; null for source-only releases"
19
- output:
20
- release_tag: "string — git tag created (e.g. v2026.4.5)"
21
- changelog_path: "string — path to updated CHANGELOG file"
22
- artifacts_published: "boolean — true when artifact phase ran"
23
- release_manifest: "object — release summary for pipeline_manifest via cleo manifest append"
24
- ---
25
-
26
- # Release Protocol
27
- #
28
- # Provenance: @task T3155, @epic T3147
29
- # Type: Conditional Protocol
30
- # Max Active: 3 protocols (including base)
31
- #
32
- # Trigger Conditions
33
- #
34
- # This protocol activates when the task involves:
35
- # Version: "release", "version", "v1.x.x"
36
- # Publish: "publish", "deploy", "ship"
37
- # Changelog: "changelog", "release notes"
38
- # Tag: "tag", "milestone", "GA"
39
- #
40
- # Explicit Override: --protocol release flag on task creation.
41
- #
42
- # Requirements (RFC 2119)
43
- #
44
- # MUST:
45
- # RLSE-001: MUST follow semantic versioning (semver)
46
- # RLSE-002: MUST update changelog with all changes
47
- # RLSE-003: MUST pass all validation gates before release
48
- # RLSE-004: MUST tag release in version control
49
- # RLSE-005: MUST document breaking changes with migration path
50
- # RLSE-006: MUST verify version consistency across files
51
- # RLSE-007: MUST set agent_type: "documentation" in manifest
52
- #
53
- # SHOULD:
54
- # RLSE-010: SHOULD include upgrade instructions
55
- # RLSE-011: SHOULD verify documentation is current
56
- # RLSE-012: SHOULD test installation process
57
- # RLSE-013: SHOULD create backup before release
58
- # RLSE-014: SHOULD run test suite for major/minor releases
59
- # RLSE-015: SHOULD verify tests pass before tagging
60
- #
61
- # MAY:
62
- # RLSE-020: MAY include performance benchmarks
63
- # RLSE-021: MAY announce on communication channels
64
- # RLSE-022: MAY batch minor fixes into single release
65
- #
66
- # State Machine:
67
- # create -> planned -> active -> released (immutable)
68
- #
69
- # Ship Workflow (10 steps):
70
- # 1. Auto-populate release tasks
71
- # 1.5. Run release guards
72
- # 2. Bump version (if --bump-version)
73
- # 3. Ensure [Unreleased] section in CHANGELOG.md
74
- # 4. Generate changelog from task metadata
75
- # 5. Validate changelog content
76
- # 6. Append to CHANGELOG.md + platform outputs
77
- # 7. Run validation gates
78
- # 8. Create release commit
79
- # 9. Create annotated tag (if --create-tag)
80
- # 10. Push to remote (if --push)
81
- # 11. Update release status to released
82
- #
83
- # Composition with Sub-Protocols:
84
- # artifact-publish: Conditional, triggered when release config has artifact handlers
85
- # provenance: Conditional, invoked transitively via artifact-publish for signing
86
- #
87
- # Error Codes (50-59):
88
- # 50: E_RELEASE_NOT_FOUND
89
- # 51: E_RELEASE_EXISTS
90
- # 52: E_RELEASE_LOCKED
91
- # 53: E_INVALID_VERSION
92
- # 54: E_VALIDATION_FAILED
93
- # 55: E_VERSION_BUMP_FAILED
94
- # 56: E_TAG_CREATION_FAILED
95
- # 57: E_CHANGELOG_GENERATION_FAILED
96
- # 58: E_TAG_EXISTS
97
- # 59: E_TASKS_INCOMPLETE
98
- #
99
- # Anti-Patterns:
100
- # - Skipping version bump (version confusion)
101
- # - Missing changelog entry (lost history)
102
- # - Undocumented breaking changes (user frustration)
103
- # - No release tag (cannot reference version)
104
- # - Incomplete checklist (missed steps)
105
- # - Major releases without --run-tests (quality risk)
106
- # - Ignoring epic completeness warnings
107
- # - Overusing --force (bypasses guards)
@@ -1,77 +0,0 @@
1
- ---
2
- kind: protocol
3
- version: 1.0.0
4
- id: RSCH
5
- title: "Research Protocol"
6
- status: active
7
- type: base
8
- audience: "llm-agent, orchestrator"
9
- tags: "research, investigation, evidence"
10
- skillRef: ct-research-agent
11
- lastUpdated: 2026-04-08
12
- enforcement: strict
13
- stage: "research"
14
- consult-when: "Investigating unknown territory; gathering evidence before a consensus or specification; any task with 'research', 'investigate', 'explore', 'study', 'discover', 'analyze'; tasks that explicitly must NOT modify code"
15
- input:
16
- topic: "string — subject of investigation"
17
- scope: "string — boundaries of the research (what to include/exclude)"
18
- output_dir: "string — directory for findings (default: .cleo/agent-outputs/)"
19
- output:
20
- findings_path: "string — path to the research output markdown file"
21
- manifest_entry: "object — 3–7 key findings for pipeline_manifest via cleo manifest append"
22
- confidence_levels: "object — per-finding confidence 0.0–1.0"
23
- sources: "string[] — cited URLs or file paths"
24
- ---
25
-
26
- # Research Protocol
27
- #
28
- # Provenance: @task T3155, @epic T3147
29
- # Type: Conditional Protocol
30
- # Max Active: 3 protocols (including base)
31
- #
32
- # Trigger Conditions
33
- #
34
- # This protocol activates when the task involves:
35
- # Investigation: "research", "investigate", "explore", "study"
36
- # Analysis: "analyze", "compare", "evaluate", "assess"
37
- # Discovery: "find out", "discover", "learn about"
38
- # Documentation: "document findings", "report on"
39
- #
40
- # Explicit Override: --protocol research flag on task creation.
41
- #
42
- # Requirements (RFC 2119)
43
- #
44
- # MUST:
45
- # RSCH-001: MUST NOT implement code or make changes to codebase
46
- # RSCH-002: MUST document all sources with citations
47
- # RSCH-003: MUST write findings to .cleo/agent-outputs/
48
- # RSCH-004: MUST append entry via `cleo manifest append`
49
- # RSCH-005: MUST return only completion message (no content in response)
50
- # RSCH-006: MUST include 3-7 key findings in manifest entry
51
- # RSCH-007: MUST set agent_type: "research" in manifest
52
- #
53
- # SHOULD:
54
- # RSCH-010: SHOULD use multiple independent sources
55
- # RSCH-011: SHOULD cross-reference findings for accuracy
56
- # RSCH-012: SHOULD include confidence levels for claims
57
- # RSCH-013: SHOULD identify gaps or areas needing further research
58
- # RSCH-014: SHOULD link research to relevant tasks
59
- #
60
- # MAY:
61
- # RSCH-020: MAY propose follow-up research tasks
62
- # RSCH-021: MAY include visual diagrams or tables
63
- # RSCH-022: MAY compare multiple approaches or solutions
64
- #
65
- # Tool Allowlist:
66
- # Allowed: Read, Grep, Glob, Bash (read-only commands only)
67
- # Prohibited: Write, Edit, any code compilation or execution
68
- #
69
- # Exit Codes:
70
- # EXIT_PROTOCOL_RESEARCH (60) - Research protocol violation
71
- #
72
- # Anti-Patterns:
73
- # - Implementing code during research (pollutes context, mixes concerns)
74
- # - Returning findings in response (wastes orchestrator context)
75
- # - Single-source conclusions (risk of bias or error)
76
- # - Vague findings without evidence (not actionable)
77
- # - Skipping manifest entry (breaks orchestrator workflow)
@@ -1,77 +0,0 @@
1
- ---
2
- kind: protocol
3
- version: 1.0.0
4
- id: SPEC
5
- title: "Specification Protocol"
6
- status: active
7
- type: conditional
8
- audience: "llm-agent, orchestrator"
9
- tags: "specification, requirements, rfc2119"
10
- skillRef: ct-spec-writer
11
- lastUpdated: 2026-04-08
12
- enforcement: strict
13
- stage: "specification"
14
- consult-when: "Writing technical specifications, API contracts, or requirements documents; any task with 'spec', 'specification', 'requirements', 'rfc'; Specification stage only unlocks after an accepted ADR"
15
- input:
16
- adr_id: "string — accepted ADR that governs this specification"
17
- scope: "string — what the spec covers"
18
- audience: "llm-agent | human | both — intended readers"
19
- output:
20
- spec_path: "string — path to the written specification file"
21
- requirement_count: "number — total MUST/SHOULD/MAY requirements"
22
- testable_criteria: "string[] — acceptance criteria derivable from the spec"
23
- ---
24
-
25
- # Specification Protocol
26
- #
27
- # Provenance: @task T3155, @epic T3147
28
- # Type: Conditional Protocol
29
- # Max Active: 3 protocols (including base)
30
- #
31
- # Trigger Conditions
32
- #
33
- # This protocol activates when the task involves:
34
- # Design: "spec", "specification", "design", "architect"
35
- # Contract: "contract", "interface", "API", "schema"
36
- # Definition: "define", "formalize", "standardize"
37
- # Protocol: "protocol", "workflow", "process"
38
- #
39
- # Explicit Override: --protocol specification flag on task creation.
40
- #
41
- # Requirements (RFC 2119)
42
- #
43
- # MUST:
44
- # SPEC-001: MUST use RFC 2119 keywords for requirements
45
- # SPEC-002: MUST include version number and status
46
- # SPEC-003: MUST define scope and authority
47
- # SPEC-004: MUST include conformance criteria
48
- # SPEC-005: MUST document related specifications
49
- # SPEC-006: MUST use structured format (tables, schemas)
50
- # SPEC-007: MUST set agent_type: "specification" in manifest
51
- #
52
- # SHOULD:
53
- # SPEC-010: SHOULD include examples for each requirement
54
- # SPEC-011: SHOULD document failure modes
55
- # SPEC-012: SHOULD specify error handling
56
- # SPEC-013: SHOULD include changelog
57
- #
58
- # MAY:
59
- # SPEC-020: MAY include implementation guidance
60
- # SPEC-021: MAY reference external standards
61
- # SPEC-022: MAY define extension points
62
- #
63
- # Version Semantics:
64
- # Major (X.0.0): Breaking changes to requirements
65
- # Minor (X.Y.0): New requirements, backward compatible
66
- # Patch (X.Y.Z): Clarifications, typo fixes
67
- #
68
- # Status Lifecycle:
69
- # DRAFT -> ACTIVE -> DEPRECATED
70
- # \-> SUPERSEDED (by new spec)
71
- #
72
- # Anti-Patterns:
73
- # - Vague requirements without levels (cannot verify compliance)
74
- # - Missing version number (cannot track changes)
75
- # - Undefined scope (unclear authority)
76
- # - No examples (hard to implement correctly)
77
- # - Skipping RFC 2119 declaration (ambiguous requirement levels)
@@ -1,99 +0,0 @@
1
- ---
2
- kind: protocol
3
- version: 2.0.0
4
- id: TEST
5
- title: "Testing Protocol (Project-Agnostic IVT Loop)"
6
- status: active
7
- type: base
8
- audience: "llm-agent, orchestrator"
9
- tags: "testing, ivt-loop, autonomous, framework-agnostic, compliance"
10
- skillRef: ct-ivt-looper
11
- lastUpdated: 2026-04-08
12
- enforcement: strict
13
- stage: "testing"
14
- consult-when: "Running the IVT loop after implementation; verifying acceptance criteria; any task with 'implement and verify', 'run IVT', 'ship this task', 'verify against spec', or implementation tasks with acceptance criteria"
15
- input:
16
- task_id: "string — task under test"
17
- spec_ref: "string | null — specification or acceptance criteria reference"
18
- worktree: "string — git worktree path for test execution"
19
- output:
20
- test_framework: "vitest | jest | mocha | pytest | cargo-test | go-test | rspec | phpunit | bats | other"
21
- convergence_iterations: "number — IVT loop iterations to convergence"
22
- test_results: "object — {passed, failed, skipped} counts"
23
- manifest_entry: "object — convergence metrics for pipeline_manifest via cleo manifest append"
24
- ---
25
-
26
- # Testing Protocol - Project-Agnostic IVT Loop
27
- #
28
- # Provenance: @task T260 (replaces T3155 BATS-locked v1)
29
- # Type: Base Protocol
30
- # Stage: IVTR - T (Testing, the closure of the IVT loop)
31
- # Skill: ct-ivt-looper
32
- #
33
- # Core Principle:
34
- # The loop converges on the spec, not on "tests pass".
35
- # Passing tests that don't cover the spec are a failure.
36
- #
37
- # Project-Agnostic Mandate:
38
- # MUST work in any project. MUST NOT assume a specific language,
39
- # test framework, directory layout, or test command.
40
- #
41
- # Trigger Conditions
42
- #
43
- # This protocol activates when the task involves:
44
- # Loop Closure: "ivt loop", "implement and verify", "ship this task"
45
- # Test Execution: "run tests", "verify", "test this"
46
- # Coverage: "coverage", "test coverage", "missing tests"
47
- # Spec Compliance: "satisfy spec", "verify against spec"
48
- # Release Gate: "before release", "pre-PR validation", "ship verified"
49
- #
50
- # Explicit Override: --protocol testing flag on task creation.
51
- # Lifecycle Position: After Validation (V), before Release (R)
52
- #
53
- # Requirements (RFC 2119)
54
- #
55
- # MUST:
56
- # TEST-001: MUST identify project test framework via dynamic detection
57
- # TEST-002: MUST run IVT loop with explicit iteration counter and MAX_ITERATIONS cap (default 5)
58
- # TEST-003: MUST trace each MUST requirement from upstream spec to at least one passing test
59
- # TEST-004: MUST achieve 100% pass rate before exiting with ivtLoopConverged: true
60
- # TEST-005: MUST exit only when spec is satisfied or MAX_ITERATIONS reached
61
- # TEST-006: MUST write test summary to manifest key_findings array
62
- # TEST-007: MUST set agent_type: "testing" in manifest
63
- # TEST-008: MUST run on feature branch - never on main/master
64
- # TEST-009: MUST escalate non-convergence to HITL via exit code 65
65
- #
66
- # SHOULD:
67
- # TEST-010: SHOULD test edge cases and error paths
68
- # TEST-011: SHOULD include setup/teardown fixtures appropriate to framework
69
- # TEST-012: SHOULD use descriptive test names tied to spec requirement codes
70
- # TEST-013: SHOULD report coverage percentage when framework supports it
71
- # TEST-014: SHOULD prefer .cleo/project-context.json testing.command when present
72
- #
73
- # MAY:
74
- # TEST-020: MAY add golden tests for output verification
75
- # TEST-021: MAY add performance benchmarks
76
- # TEST-022: MAY add stress/concurrency tests
77
- # TEST-023: MAY parallelize IVT loop across independent specs
78
- #
79
- # Framework Detection Priority:
80
- # 1. .cleo/project-context.json testing.command (highest)
81
- # 2. Auto-detection signals (vitest, jest, pytest, cargo test, go test, etc.)
82
- # 3. Fallback: ask operator to declare in project-context.json
83
- #
84
- # Exit Codes:
85
- # 0: SUCCESS - Loop converged, manifest recorded
86
- # 65: HANDOFF_REQUIRED - Non-convergence after MAX_ITERATIONS
87
- # 67: CONCURRENT_SESSION - Generic testing protocol violation
88
- # 80: LIFECYCLE_GATE_FAILED - Required gate failed
89
- #
90
- # Anti-Patterns:
91
- # - Hardcoding vitest/jest/pytest (violates project-agnostic mandate)
92
- # - Running tests once and reporting result (testing is a LOOP)
93
- # - Skipping validation between iterations
94
- # - Bailing silently on non-convergence (must escalate to HITL)
95
- # - Marking task complete with failed > 0
96
- # - Modifying main/master branch
97
- # - Ignoring spec-requirement traceability
98
- # - Treating coverage as the convergence metric
99
- # - Editing test expectations to match broken code
@@ -1,75 +0,0 @@
1
- ---
2
- kind: protocol
3
- version: 1.0.0
4
- id: VALID
5
- title: "Validation Protocol"
6
- status: active
7
- type: base
8
- audience: "llm-agent, orchestrator"
9
- tags: "validation, quality, compliance"
10
- skillRef: ct-validator
11
- lastUpdated: 2026-04-08
12
- enforcement: strict
13
- stage: "validation"
14
- consult-when: "Validating compliance against a schema, spec, or standard; running quality checks; any task with 'validate', 'compliance', 'verify', 'audit'; post-implementation quality gate"
15
- input:
16
- target: "string — file path, document, or system under validation"
17
- schema_ref: "string | null — schema or standard reference"
18
- validation_type: "schema | code-style | protocol | document | custom"
19
- output:
20
- passed: "boolean — overall validation result"
21
- violations: "object[] — array of {rule, severity, location, message}"
22
- report_path: "string — path to detailed validation report"
23
- ---
24
-
25
- # Validation Protocol
26
- #
27
- # Provenance: @task T3155, @epic T3147
28
- # Type: Conditional Protocol
29
- # Stage: IVTR - V (Validation)
30
- # Max Active: 3 protocols (including base)
31
- #
32
- # Trigger Conditions
33
- #
34
- # This protocol activates when the task involves:
35
- # Verification: "validate", "verify", "check", "audit"
36
- # Quality: "quality", "qa", "review"
37
- # Compliance: "compliance", "conform", "standard"
38
- # Smoke Test: "smoke", "sanity", "basic test"
39
- #
40
- # Explicit Override: --protocol validation flag on task creation.
41
- # Lifecycle Position: After Implementation (I), before Testing (T)
42
- #
43
- # Requirements (RFC 2119)
44
- #
45
- # MUST:
46
- # VALID-001: MUST verify implementation matches specification
47
- # VALID-002: MUST run existing test suite and report results
48
- # VALID-003: MUST check protocol compliance via lib/protocol-validation.sh
49
- # VALID-004: MUST document pass/fail status for each validation check
50
- # VALID-005: MUST write validation summary to manifest
51
- # VALID-006: MUST set agent_type: "validation" in manifest
52
- # VALID-007: MUST block progression if critical validations fail
53
- #
54
- # SHOULD:
55
- # VALID-010: SHOULD verify edge cases identified in specification
56
- # VALID-011: SHOULD check for regressions in related functionality
57
- # VALID-012: SHOULD validate error handling paths
58
- # VALID-013: SHOULD measure against acceptance criteria
59
- #
60
- # MAY:
61
- # VALID-020: MAY perform performance validation
62
- # VALID-021: MAY verify security constraints
63
- # VALID-022: MAY suggest additional test cases
64
- #
65
- # Exit Codes:
66
- # 62: Specification mismatch (fix implementation)
67
- # 64: Implementation protocol violation (fix provenance)
68
- # 67: Generic protocol violation (review and fix)
69
- # 68: EXIT_VALIDATION_INCOMPLETE (validation not finished)
70
- #
71
- # Anti-Patterns:
72
- # - Skipping spec compliance check (missed requirements)
73
- # - Not documenting validation results (lost audit trail)
74
- # - Ignoring non-critical failures (quality regression)
75
- # - Running partial validation suite (false confidence)
@@ -1,115 +0,0 @@
1
- # @source .cleo/teams.cant (canonical seed — copied by ct-master-tac T430)
2
- # @task T430 @epic T382
3
- # Canonical platform team for CleoOS multi-agent hierarchy.
4
- #
5
- # Mirrors the 3-tier structure from ULTRAPLAN §10 and the Pi multi-team config
6
- # at /mnt/projects/agentic-engineer/lead-agents/.pi/multi-team/multi-team-config.yaml.
7
- #
8
- # Three leads map to the RCASD-IVTR+C lifecycle:
9
- # - planning-lead: research, consensus, architecture-decision, specification, decomposition
10
- # - engineering-lead: implementation
11
- # - validation-lead: validation, testing, release
12
- #
13
- # Workers under each lead are listed in the `workers:` sub-block.
14
- # Enforcement is strict — the tool_call hook rejects Edit/Write/Bash on lead-role agents.
15
-
16
- team platform:
17
- name: Platform Team
18
- orchestrator: cleo-prime
19
- enforcement: strict
20
- consult-when: "Orchestrator-level escalation when a request crosses team boundaries or requires human-in-the-loop governance"
21
- stages: [research, consensus, architecture-decision, specification, decomposition, implementation, validation, testing, release]
22
-
23
- leads:
24
- planning: planning-lead
25
- engineering: engineering-lead
26
- validation: validation-lead
27
-
28
- workers:
29
- planning: [product-manager, ux-researcher, spec-writer]
30
- engineering: [backend-dev, frontend-dev, platform-engineer]
31
- validation: [qa-engineer, security-reviewer, release-manager]
32
-
33
- agent planning-lead:
34
- role: lead
35
- description: "Decides WHAT to build and why — owns research, consensus, ADRs, specs, and decomposition. Dispatches to planning workers. MUST NOT execute Edit/Write/Bash directly."
36
- consult-when: "Deciding WHAT to build and why — research, consensus, ADRs, specs, decomposition"
37
- stages: [research, consensus, architecture-decision, specification, decomposition]
38
- workers:
39
- - product-manager
40
- - ux-researcher
41
- - spec-writer
42
-
43
- agent engineering-lead:
44
- role: lead
45
- description: "Decides HOW to build — owns implementation strategy, code review, and refactoring direction. Dispatches to engineering workers. MUST NOT execute Edit/Write/Bash directly."
46
- consult-when: "Deciding HOW to build — implementation, code writing, refactoring, API design"
47
- stages: [implementation]
48
- workers:
49
- - backend-dev
50
- - frontend-dev
51
- - platform-engineer
52
-
53
- agent validation-lead:
54
- role: lead
55
- description: "Verifies it works — owns validation, testing strategy, security review, and release gating. Dispatches to validation workers. MUST NOT execute Edit/Write/Bash directly."
56
- consult-when: "Does it work — validation, testing, security review, release"
57
- stages: [validation, testing, release]
58
- workers:
59
- - qa-engineer
60
- - security-reviewer
61
- - release-manager
62
-
63
- agent product-manager:
64
- role: worker
65
- description: "Requirements, feature prioritization, user stories, acceptance criteria"
66
- tier: mid
67
- consult-when: "Requirements, feature prioritization, user stories, acceptance criteria"
68
-
69
- agent ux-researcher:
70
- role: worker
71
- description: "User behavior, personas, journey mapping, usability, friction points"
72
- tier: mid
73
- consult-when: "User behavior, personas, journey mapping, usability, friction points"
74
-
75
- agent spec-writer:
76
- role: worker
77
- description: "Authoring ADRs, technical specifications, and RFC 2119 protocol documents"
78
- tier: mid
79
- consult-when: "ADR authoring, specification writing, protocol documents"
80
-
81
- agent backend-dev:
82
- role: worker
83
- description: "APIs, databases, infrastructure, background jobs, third-party integrations"
84
- tier: mid
85
- consult-when: "APIs, databases, infrastructure, background jobs, third-party integrations"
86
-
87
- agent frontend-dev:
88
- role: worker
89
- description: "UI components, layouts, client-side state, browser APIs, CSS"
90
- tier: mid
91
- consult-when: "UI components, layouts, client-side state, browser APIs, CSS"
92
-
93
- agent platform-engineer:
94
- role: worker
95
- description: "Build systems, CI/CD, monorepo tooling, deployment pipelines"
96
- tier: mid
97
- consult-when: "Build systems, CI/CD, monorepo tooling, deployment pipelines"
98
-
99
- agent qa-engineer:
100
- role: worker
101
- description: "Test cases, regression testing, automation, bug reproduction"
102
- tier: mid
103
- consult-when: "Test cases, regression testing, automation, bug reproduction"
104
-
105
- agent security-reviewer:
106
- role: worker
107
- description: "Threat modeling, authentication, authorization, data protection, OWASP"
108
- tier: mid
109
- consult-when: "Threat modeling, authentication, authorization, data protection, OWASP"
110
-
111
- agent release-manager:
112
- role: worker
113
- description: "Version gating, changelog authoring, npm publish, CalVer policy enforcement"
114
- tier: mid
115
- consult-when: "Version gating, changelog, npm publish, release notes"
@@ -1,55 +0,0 @@
1
- {
2
- "_comment": "ct-master-tac manifest — merge into packages/skills/skills/manifest.json skills[] array",
3
- "name": "ct-master-tac",
4
- "version": "1.0.0",
5
- "description": "Master Tactical Bundle: installs all 12 CANT protocol files + platform team definition for a batteries-included CleoOS autonomous execution environment.",
6
- "path": "skills/ct-master-tac",
7
- "tags": ["bundle", "bootstrap", "protocols", "cant", "meta", "install"],
8
- "status": "active",
9
- "tier": 1,
10
- "token_budget": 4000,
11
- "protocol": null,
12
- "files": [
13
- "bundled/protocols/research.cant",
14
- "bundled/protocols/consensus.cant",
15
- "bundled/protocols/architecture-decision.cant",
16
- "bundled/protocols/specification.cant",
17
- "bundled/protocols/decomposition.cant",
18
- "bundled/protocols/implementation.cant",
19
- "bundled/protocols/validation.cant",
20
- "bundled/protocols/testing.cant",
21
- "bundled/protocols/contribution.cant",
22
- "bundled/protocols/release.cant",
23
- "bundled/protocols/artifact-publish.cant",
24
- "bundled/protocols/provenance.cant",
25
- "bundled/teams/platform.cant"
26
- ],
27
- "install_targets": {
28
- "protocols": "packages/core/src/validation/protocols/cant/",
29
- "teams": ".cleo/"
30
- },
31
- "capabilities": {
32
- "inputs": ["--verify", "--force"],
33
- "outputs": ["install-summary", "verification-report"],
34
- "dependencies": [],
35
- "dispatch_triggers": [
36
- "install master tac",
37
- "bootstrap protocols",
38
- "tools.skill.install ct-master-tac",
39
- "verify protocol bundle",
40
- "repair protocol files",
41
- "fresh CleoOS install"
42
- ],
43
- "compatible_subagent_types": ["general-purpose"],
44
- "chains_to": ["ct-cleo"],
45
- "dispatch_keywords": {
46
- "primary": ["master-tac", "bootstrap", "install", "protocol-bundle"],
47
- "secondary": ["cant", "protocols", "team", "fresh-install", "recover"]
48
- }
49
- },
50
- "constraints": {
51
- "max_context_tokens": 20000,
52
- "requires_session": false,
53
- "requires_epic": false
54
- }
55
- }
@@ -1,17 +0,0 @@
1
- {
2
- "name": "ct-skill-creator",
3
- "version": "1.0.0",
4
- "description": "Guide for creating effective CLEO skills with the full v2 standard.",
5
- "path": "packages/skills/skills/ct-skill-creator",
6
- "status": "active",
7
- "tier": 3,
8
- "core": false,
9
- "category": "meta",
10
- "protocol": null,
11
- "dependencies": [],
12
- "sharedResources": [],
13
- "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
14
- "token_budget": 12000,
15
- "capabilities": ["skill-creation", "eval-loop", "description-optimization", "quality-eval"],
16
- "constraints": ["requires-claude-api-for-eval-loop"]
17
- }
@@ -1,20 +0,0 @@
1
- {
2
- "_comment": "CLEO-only metadata -- add to packages/skills/skills/manifest.json",
3
- "name": "ct-skill-validator",
4
- "version": "1.0.0",
5
- "tier": 2,
6
- "token_budget": 6000,
7
- "capabilities": {
8
- "inputs": [],
9
- "outputs": [],
10
- "dispatch_triggers": [],
11
- "compatible_subagent_types": ["general-purpose"],
12
- "chains_to": [],
13
- "dispatch_keywords": { "primary": [], "secondary": [] }
14
- },
15
- "constraints": {
16
- "max_context_tokens": 60000,
17
- "requires_session": false,
18
- "requires_epic": false
19
- }
20
- }