@open-agent-toolkit/cli 0.2.64 → 0.2.66

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 (217) hide show
  1. package/assets/bundle-metadata.json +1 -1
  2. package/assets/docs/cli-utilities/configuration.md +19 -1
  3. package/assets/docs/cli-utilities/index.md +3 -0
  4. package/assets/docs/cli-utilities/remote-project-management.md +191 -0
  5. package/assets/docs/contributing/skills.md +15 -5
  6. package/assets/docs/reference/cli-reference.md +12 -1
  7. package/assets/docs/reference/file-locations.md +22 -0
  8. package/assets/docs/reference/oat-directory-structure.md +30 -17
  9. package/assets/docs/reference/troubleshooting.md +44 -0
  10. package/assets/docs/workflows/skills/index.md +33 -0
  11. package/assets/public-package-versions.json +4 -4
  12. package/assets/skills/analyze/SKILL.md +2 -1
  13. package/assets/skills/authoring-docs/SKILL.md +2 -1
  14. package/assets/skills/compare/SKILL.md +2 -1
  15. package/assets/skills/create-agnostic-skill/SKILL.md +2 -1
  16. package/assets/skills/deep-research/SKILL.md +2 -1
  17. package/assets/skills/explainer-kit/SKILL.md +2 -1
  18. package/assets/skills/oat-agent-instructions-analyze/SKILL.md +2 -1
  19. package/assets/skills/oat-agent-instructions-apply/SKILL.md +2 -1
  20. package/assets/skills/oat-brainstorm/SKILL.md +2 -1
  21. package/assets/skills/oat-cursor-cloud-projects/SKILL.md +2 -1
  22. package/assets/skills/oat-dispatch-subagents/SKILL.md +2 -1
  23. package/assets/skills/oat-docs/SKILL.md +2 -1
  24. package/assets/skills/oat-docs-analyze/SKILL.md +2 -1
  25. package/assets/skills/oat-docs-apply/SKILL.md +2 -1
  26. package/assets/skills/oat-docs-authoring/SKILL.md +2 -1
  27. package/assets/skills/oat-docs-bootstrap/SKILL.md +2 -1
  28. package/assets/skills/oat-doctor/SKILL.md +5 -4
  29. package/assets/skills/oat-explainer-kit/SKILL.md +2 -1
  30. package/assets/skills/oat-explainer-kit/scripts/check-core.mjs +322 -2
  31. package/assets/skills/oat-idea-ideate/SKILL.md +2 -1
  32. package/assets/skills/oat-idea-new/SKILL.md +2 -1
  33. package/assets/skills/oat-idea-scratchpad/SKILL.md +2 -1
  34. package/assets/skills/oat-idea-summarize/SKILL.md +2 -1
  35. package/assets/skills/oat-pjm-add-backlog-item/SKILL.md +2 -1
  36. package/assets/skills/oat-pjm-decision/SKILL.md +2 -1
  37. package/assets/skills/oat-pjm-remote/SKILL.md +101 -0
  38. package/assets/skills/oat-pjm-remote/references/external-action-protocol.md +43 -0
  39. package/assets/skills/oat-pjm-review-backlog/SKILL.md +2 -1
  40. package/assets/skills/oat-pjm-update-repo-reference/SKILL.md +2 -1
  41. package/assets/skills/oat-project-autonomous/SKILL.md +2 -1
  42. package/assets/skills/oat-project-capture/SKILL.md +2 -1
  43. package/assets/skills/oat-project-clear-active/SKILL.md +2 -1
  44. package/assets/skills/oat-project-complete/SKILL.md +2 -1
  45. package/assets/skills/oat-project-design/SKILL.md +2 -1
  46. package/assets/skills/oat-project-discover/SKILL.md +2 -1
  47. package/assets/skills/oat-project-dispatch-subagents/SKILL.md +2 -1
  48. package/assets/skills/oat-project-document/SKILL.md +2 -1
  49. package/assets/skills/oat-project-implement/SKILL.md +2 -1
  50. package/assets/skills/oat-project-import-plan/SKILL.md +2 -1
  51. package/assets/skills/oat-project-lite/SKILL.md +2 -1
  52. package/assets/skills/oat-project-new/SKILL.md +2 -1
  53. package/assets/skills/oat-project-next/SKILL.md +2 -1
  54. package/assets/skills/oat-project-open/SKILL.md +2 -1
  55. package/assets/skills/oat-project-plan/SKILL.md +2 -1
  56. package/assets/skills/oat-project-plan-writing/SKILL.md +2 -1
  57. package/assets/skills/oat-project-pr-final/SKILL.md +2 -1
  58. package/assets/skills/oat-project-pr-progress/SKILL.md +2 -1
  59. package/assets/skills/oat-project-progress/SKILL.md +2 -1
  60. package/assets/skills/oat-project-promote-spec-driven/SKILL.md +2 -1
  61. package/assets/skills/oat-project-quick-start/SKILL.md +2 -1
  62. package/assets/skills/oat-project-reconcile/SKILL.md +2 -1
  63. package/assets/skills/oat-project-retro/SKILL.md +2 -1
  64. package/assets/skills/oat-project-retro-file/SKILL.md +2 -1
  65. package/assets/skills/oat-project-review-provide/SKILL.md +2 -1
  66. package/assets/skills/oat-project-review-provide-remote/SKILL.md +2 -1
  67. package/assets/skills/oat-project-review-receive/SKILL.md +2 -1
  68. package/assets/skills/oat-project-review-receive-remote/SKILL.md +2 -1
  69. package/assets/skills/oat-project-revise/SKILL.md +2 -1
  70. package/assets/skills/oat-project-spec/SKILL.md +2 -1
  71. package/assets/skills/oat-project-split/SKILL.md +2 -1
  72. package/assets/skills/oat-project-summary/SKILL.md +2 -1
  73. package/assets/skills/oat-repo-improve/SKILL.md +1 -1
  74. package/assets/skills/oat-repo-knowledge-index/SKILL.md +2 -1
  75. package/assets/skills/oat-repo-maintainability-review/SKILL.md +2 -1
  76. package/assets/skills/oat-review-provide/SKILL.md +2 -1
  77. package/assets/skills/oat-review-provide-remote/SKILL.md +2 -1
  78. package/assets/skills/oat-review-receive/SKILL.md +2 -1
  79. package/assets/skills/oat-review-receive-remote/SKILL.md +2 -1
  80. package/assets/skills/oat-wave-execute/SKILL.md +2 -1
  81. package/assets/skills/oat-wave-program/SKILL.md +2 -1
  82. package/assets/skills/oat-worktree-bootstrap/SKILL.md +2 -1
  83. package/assets/skills/oat-worktree-bootstrap-auto/SKILL.md +2 -1
  84. package/assets/skills/oat-wrap-up/SKILL.md +2 -1
  85. package/assets/skills/recon/SKILL.md +2 -1
  86. package/assets/skills/skeptic/SKILL.md +2 -1
  87. package/assets/skills/subagent-orchestration/SKILL.md +2 -1
  88. package/assets/skills/synthesize/SKILL.md +2 -1
  89. package/dist/commands/backlog/new.d.ts +1 -0
  90. package/dist/commands/backlog/new.d.ts.map +1 -1
  91. package/dist/commands/backlog/new.js +3 -1
  92. package/dist/commands/config/index.d.ts +1 -0
  93. package/dist/commands/config/index.d.ts.map +1 -1
  94. package/dist/commands/config/index.js +232 -1
  95. package/dist/commands/pjm/doctor.d.ts +2 -0
  96. package/dist/commands/pjm/doctor.d.ts.map +1 -1
  97. package/dist/commands/pjm/doctor.js +71 -1
  98. package/dist/commands/pjm/index.d.ts +2 -0
  99. package/dist/commands/pjm/index.d.ts.map +1 -1
  100. package/dist/commands/pjm/index.js +3 -0
  101. package/dist/commands/pjm/remote/__integration__/lifecycle-harness.d.ts +60 -0
  102. package/dist/commands/pjm/remote/__integration__/lifecycle-harness.d.ts.map +1 -0
  103. package/dist/commands/pjm/remote/__integration__/lifecycle-harness.js +151 -0
  104. package/dist/commands/pjm/remote/association.d.ts +27 -0
  105. package/dist/commands/pjm/remote/association.d.ts.map +1 -0
  106. package/dist/commands/pjm/remote/association.js +68 -0
  107. package/dist/commands/pjm/remote/authority.d.ts +210 -0
  108. package/dist/commands/pjm/remote/authority.d.ts.map +1 -0
  109. package/dist/commands/pjm/remote/authority.js +341 -0
  110. package/dist/commands/pjm/remote/batch.d.ts +15 -0
  111. package/dist/commands/pjm/remote/batch.d.ts.map +1 -0
  112. package/dist/commands/pjm/remote/batch.js +126 -0
  113. package/dist/commands/pjm/remote/closeout.d.ts +69 -0
  114. package/dist/commands/pjm/remote/closeout.d.ts.map +1 -0
  115. package/dist/commands/pjm/remote/closeout.js +208 -0
  116. package/dist/commands/pjm/remote/create-binding.d.ts +62 -0
  117. package/dist/commands/pjm/remote/create-binding.d.ts.map +1 -0
  118. package/dist/commands/pjm/remote/create-binding.js +126 -0
  119. package/dist/commands/pjm/remote/credential-safety.d.ts +7 -0
  120. package/dist/commands/pjm/remote/credential-safety.d.ts.map +1 -0
  121. package/dist/commands/pjm/remote/credential-safety.js +21 -0
  122. package/dist/commands/pjm/remote/discussion.d.ts +49 -0
  123. package/dist/commands/pjm/remote/discussion.d.ts.map +1 -0
  124. package/dist/commands/pjm/remote/discussion.js +124 -0
  125. package/dist/commands/pjm/remote/doctor.d.ts +22 -0
  126. package/dist/commands/pjm/remote/doctor.d.ts.map +1 -0
  127. package/dist/commands/pjm/remote/doctor.js +380 -0
  128. package/dist/commands/pjm/remote/external-action.d.ts +208 -0
  129. package/dist/commands/pjm/remote/external-action.d.ts.map +1 -0
  130. package/dist/commands/pjm/remote/external-action.js +367 -0
  131. package/dist/commands/pjm/remote/host-execution.d.ts +28 -0
  132. package/dist/commands/pjm/remote/host-execution.d.ts.map +1 -0
  133. package/dist/commands/pjm/remote/host-execution.js +63 -0
  134. package/dist/commands/pjm/remote/index.d.ts +41 -0
  135. package/dist/commands/pjm/remote/index.d.ts.map +1 -0
  136. package/dist/commands/pjm/remote/index.js +280 -0
  137. package/dist/commands/pjm/remote/jira-adf.d.ts +35 -0
  138. package/dist/commands/pjm/remote/jira-adf.d.ts.map +1 -0
  139. package/dist/commands/pjm/remote/jira-adf.js +169 -0
  140. package/dist/commands/pjm/remote/lifecycle.d.ts +163 -0
  141. package/dist/commands/pjm/remote/lifecycle.d.ts.map +1 -0
  142. package/dist/commands/pjm/remote/lifecycle.js +224 -0
  143. package/dist/commands/pjm/remote/local-projection.d.ts +30 -0
  144. package/dist/commands/pjm/remote/local-projection.d.ts.map +1 -0
  145. package/dist/commands/pjm/remote/local-projection.js +95 -0
  146. package/dist/commands/pjm/remote/managed-markdown.d.ts +30 -0
  147. package/dist/commands/pjm/remote/managed-markdown.d.ts.map +1 -0
  148. package/dist/commands/pjm/remote/managed-markdown.js +128 -0
  149. package/dist/commands/pjm/remote/migrate.d.ts +14 -0
  150. package/dist/commands/pjm/remote/migrate.d.ts.map +1 -0
  151. package/dist/commands/pjm/remote/migrate.js +32 -0
  152. package/dist/commands/pjm/remote/operation-state.d.ts +15 -0
  153. package/dist/commands/pjm/remote/operation-state.d.ts.map +1 -0
  154. package/dist/commands/pjm/remote/operation-state.js +143 -0
  155. package/dist/commands/pjm/remote/outbound-projection-safety.d.ts +25 -0
  156. package/dist/commands/pjm/remote/outbound-projection-safety.d.ts.map +1 -0
  157. package/dist/commands/pjm/remote/outbound-projection-safety.js +99 -0
  158. package/dist/commands/pjm/remote/output.d.ts +60 -0
  159. package/dist/commands/pjm/remote/output.d.ts.map +1 -0
  160. package/dist/commands/pjm/remote/output.js +48 -0
  161. package/dist/commands/pjm/remote/preview.d.ts +88 -0
  162. package/dist/commands/pjm/remote/preview.d.ts.map +1 -0
  163. package/dist/commands/pjm/remote/preview.js +154 -0
  164. package/dist/commands/pjm/remote/provider-conformance.d.ts +13 -0
  165. package/dist/commands/pjm/remote/provider-conformance.d.ts.map +1 -0
  166. package/dist/commands/pjm/remote/provider-conformance.js +37 -0
  167. package/dist/commands/pjm/remote/provider.d.ts +57 -0
  168. package/dist/commands/pjm/remote/provider.d.ts.map +1 -0
  169. package/dist/commands/pjm/remote/provider.js +28 -0
  170. package/dist/commands/pjm/remote/providers/github-publication-safety.d.ts +46 -0
  171. package/dist/commands/pjm/remote/providers/github-publication-safety.d.ts.map +1 -0
  172. package/dist/commands/pjm/remote/providers/github-publication-safety.js +126 -0
  173. package/dist/commands/pjm/remote/providers/github.d.ts +207 -0
  174. package/dist/commands/pjm/remote/providers/github.d.ts.map +1 -0
  175. package/dist/commands/pjm/remote/providers/github.js +1456 -0
  176. package/dist/commands/pjm/remote/providers/jira.d.ts +245 -0
  177. package/dist/commands/pjm/remote/providers/jira.d.ts.map +1 -0
  178. package/dist/commands/pjm/remote/providers/jira.js +1650 -0
  179. package/dist/commands/pjm/remote/providers/linear.d.ts +182 -0
  180. package/dist/commands/pjm/remote/providers/linear.d.ts.map +1 -0
  181. package/dist/commands/pjm/remote/providers/linear.js +1289 -0
  182. package/dist/commands/pjm/remote/purpose-policy.d.ts +29 -0
  183. package/dist/commands/pjm/remote/purpose-policy.d.ts.map +1 -0
  184. package/dist/commands/pjm/remote/purpose-policy.js +118 -0
  185. package/dist/commands/pjm/remote/reconcile.d.ts +42 -0
  186. package/dist/commands/pjm/remote/reconcile.d.ts.map +1 -0
  187. package/dist/commands/pjm/remote/reconcile.js +101 -0
  188. package/dist/commands/pjm/remote/resolution.d.ts +122 -0
  189. package/dist/commands/pjm/remote/resolution.d.ts.map +1 -0
  190. package/dist/commands/pjm/remote/resolution.js +243 -0
  191. package/dist/commands/pjm/remote/schema.d.ts +9309 -0
  192. package/dist/commands/pjm/remote/schema.d.ts.map +1 -0
  193. package/dist/commands/pjm/remote/schema.js +1503 -0
  194. package/dist/commands/pjm/remote/service.d.ts +20 -0
  195. package/dist/commands/pjm/remote/service.d.ts.map +1 -0
  196. package/dist/commands/pjm/remote/service.js +5121 -0
  197. package/dist/commands/pjm/remote/shared-storage.d.ts +36 -0
  198. package/dist/commands/pjm/remote/shared-storage.d.ts.map +1 -0
  199. package/dist/commands/pjm/remote/shared-storage.js +110 -0
  200. package/dist/commands/pjm/remote/snapshot.d.ts +32 -0
  201. package/dist/commands/pjm/remote/snapshot.d.ts.map +1 -0
  202. package/dist/commands/pjm/remote/snapshot.js +140 -0
  203. package/dist/commands/pjm/remote/storage-locator.d.ts +29 -0
  204. package/dist/commands/pjm/remote/storage-locator.d.ts.map +1 -0
  205. package/dist/commands/pjm/remote/storage-locator.js +62 -0
  206. package/dist/commands/pjm/remote/store.d.ts +85 -0
  207. package/dist/commands/pjm/remote/store.d.ts.map +1 -0
  208. package/dist/commands/pjm/remote/store.js +553 -0
  209. package/dist/commands/pjm/remote/verification.d.ts +40 -0
  210. package/dist/commands/pjm/remote/verification.d.ts.map +1 -0
  211. package/dist/commands/pjm/remote/verification.js +100 -0
  212. package/dist/commands/tools/shared/pack-manifest.d.ts.map +1 -1
  213. package/dist/commands/tools/shared/pack-manifest.js +1 -0
  214. package/dist/config/oat-config.d.ts +26 -0
  215. package/dist/config/oat-config.d.ts.map +1 -1
  216. package/dist/config/oat-config.js +186 -2
  217. package/package.json +2 -2
@@ -0,0 +1,101 @@
1
+ ---
2
+ name: oat-pjm-remote
3
+ description: Use when explicitly intaking, publishing, refreshing, reconciling, or continuing an OAT PJM remote binding through a live host capability. Keeps policy, approval, state, and success verdicts in the OAT CLI while the host discovers and invokes currently granted execution capabilities.
4
+ disable-model-invocation: false
5
+ user-invocable: true
6
+ allowed-tools: Read, Bash, AskUserQuestion
7
+ metadata:
8
+ version: 1.0.2
9
+ ---
10
+
11
+ # Operate Remote Project Bindings
12
+
13
+ Use the OAT CLI as the authority for policy, approval, durable operation state,
14
+ and verified outcomes. Your role is limited to live capability discovery,
15
+ executing the exact semantic action emitted by the CLI, and returning one
16
+ bounded sanitized observation.
17
+
18
+ ## Progress Indicators (User-Facing)
19
+
20
+ Provide short updates at the durable boundaries: preflight, CLI preview or
21
+ handoff, live capability selection, observation submission, and terminal CLI
22
+ verdict. Never describe a host invocation result as success before the CLI has
23
+ verified authoritative read-back.
24
+
25
+ ```text
26
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
27
+ OAT ▸ REMOTE PROJECT MANAGEMENT
28
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
29
+ ```
30
+
31
+ - `[1/4] Verifying PJM adoption and local policy…`
32
+ - `[2/4] Discovering a matching live host capability…`
33
+ - `[3/4] Preparing the durable CLI action with bounded evidence…`
34
+ - `[4/4] Submitting evidence for CLI verification…`
35
+
36
+ ## Preflight
37
+
38
+ Run:
39
+
40
+ ```bash
41
+ oat pjm doctor --json
42
+ ```
43
+
44
+ Continue only when `adoption.state` is `declared` or `inferred-legacy`. For
45
+ `none` or `partial-initialization`, stop before any remote action and direct the
46
+ operator to `oat pjm init`.
47
+
48
+ ## Live Capability Discovery
49
+
50
+ Before the first provider-contacting remote command, inspect currently granted
51
+ MCP or connector tools and their live descriptions. Select a capability only
52
+ when its semantic operation, provider, and exact
53
+ account/workspace/site/repository context match the request.
54
+
55
+ If no capable granted connector exists, you may inspect an already configured
56
+ provider CLI and its live help before the first attempt. Do not install a tool,
57
+ request authentication material, encode or retain its command dialect, or
58
+ switch execution surfaces after an attempt begins.
59
+
60
+ Construct only the bounded provider-neutral capability evidence accepted by the
61
+ CLI: provider, exact context, surface kind, availability, semantic capabilities,
62
+ observation time, and evidence digest. Never include a native tool name, schema,
63
+ catalog, raw description, help text, request, or response.
64
+
65
+ ## Lifecycle
66
+
67
+ 1. Complete live capability discovery before the first provider-contacting
68
+ remote command.
69
+ 2. Run the requested `oat pjm remote` command in JSON mode and pass the bounded
70
+ evidence through `--capability-evidence-stdin`. For mutations, also supply
71
+ only the current caller-owned authority evidence requested by the command.
72
+ 3. Treat CLI policy, preview, approval, safety, and terminal verdicts as
73
+ authoritative. Never broaden a field mask or reconstruct publication
74
+ content from repository files.
75
+ 4. When the CLI returns `pending` with `externalAction`, follow
76
+ [the action protocol](references/external-action-protocol.md) and execute the
77
+ exact emitted semantic action at most once.
78
+ 5. Submit exactly one sanitized observation through `operation continue`.
79
+ 6. Continue only while the CLI emits another exact action for the same durable
80
+ operation. Stop on any terminal CLI envelope.
81
+
82
+ Never infer success from a connector result, process exit, or visible remote
83
+ change. Only a CLI `ok` envelope after authoritative read-back is success.
84
+
85
+ ## Discussion Reads
86
+
87
+ Discussion is read-only evidence. Honor the CLI-provided page/cursor and maximum
88
+ item limit. Return only the bounded sanitized observation. Do not persist a
89
+ thread, assignee list, activity history, or native response. A requested local
90
+ distillation is a separate local edit and never comment synchronization.
91
+
92
+ ## Safety Boundary
93
+
94
+ - Never read, request, print, or persist authentication headers or credential
95
+ values.
96
+ - Never scan the repository, worktree, Git history, or arbitrary files for
97
+ secrets.
98
+ - Never add fields to the normalized outbound projection.
99
+ - Never pass native requests, raw provider payloads, tool catalogs, or help
100
+ output into durable OAT evidence.
101
+ - Never declare remote success directly.
@@ -0,0 +1,43 @@
1
+ # External Action Protocol
2
+
3
+ The CLI emits a versioned provider-neutral action containing a durable
4
+ operation ID, step ID, action digest, provider context, semantic intent,
5
+ expected observation contract, and (for mutation) the exact outbound
6
+ projection and safety-result digests.
7
+
8
+ Initial live connector discovery (or configured-CLI-help fallback) and bounded
9
+ provider-neutral capability evidence construction happen before the first
10
+ provider-contacting remote command. The evidence is passed through
11
+ `--capability-evidence-stdin`; native tool names, schemas, catalogs,
12
+ descriptions, help text, requests, and responses are excluded.
13
+
14
+ Before execution:
15
+
16
+ 1. Confirm the action belongs to the current durable operation and step.
17
+ 2. Confirm the previously selected capability remains currently granted.
18
+ 3. Confirm semantic operation and exact provider context.
19
+ 4. For a mutation, confirm the projection and safety digests are present. Do
20
+ not reconstruct, enrich, or reinterpret the projection.
21
+
22
+ Execute at most once. Return only one observation with:
23
+
24
+ - the unchanged operation ID, step ID, and action digest;
25
+ - observation time and host-surface kind;
26
+ - bounded capability evidence digest and exact provider context;
27
+ - sanitized classification, durable identity/aliases when observed,
28
+ allowlisted fields, revision evidence, and a diagnostic code.
29
+
30
+ Do not return a native request, raw response, captured catalog, live help text,
31
+ process environment, authentication data, or provider-generated success claim.
32
+ Use:
33
+
34
+ ```bash
35
+ oat pjm remote operation continue \
36
+ --operation <operation-id> \
37
+ --observation-stdin \
38
+ --json
39
+ ```
40
+
41
+ A repeated, stale, mismatched, oversized, or unsanitized observation must be
42
+ rejected by the CLI. An ambiguous post-attempt outcome remains uncertain and
43
+ must be reconciled before any new execution choice or retry.
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: oat-pjm-review-backlog
3
- version: 1.6.1
4
3
  description: Use when prioritizing the file-backed repo backlog or evaluating roadmap alignment. Produces value-effort ratings, dependency mapping, execution recommendations, and an optional external-plan handoff.
5
4
  argument-hint: '[backlog-root] [--roadmap=<path>] [--output=<path>]'
6
5
  disable-model-invocation: true
7
6
  allowed-tools: Read, Write, Glob, Grep, Bash(git:*), AskUserQuestion, Task
8
7
  user-invocable: true
8
+ metadata:
9
+ version: 1.6.2
9
10
  ---
10
11
 
11
12
  # Review Backlog
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-pjm-update-repo-reference
3
- version: 1.4.0
4
3
  description: Use when repo reference artifacts need updating — roadmap, decision records, backlog status, or completed history. Frequently invoked at project completion, often chained from `oat-project-document`, to ensure active `.oat/repo/pjm/` state and durable `.oat/repo/reference/` records reflect what shipped.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.4.1
8
9
  ---
9
10
 
10
11
  # Update Repo Reference
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: oat-project-autonomous
3
- version: 1.0.13
4
3
  description: Use when a user explicitly asks to run an OAT project autonomously end-to-end. Activates session-only autonomy, resumes the correct lifecycle phase, and drives the existing OAT skills through final PR or a reported boundary.
5
4
  argument-hint: '<goal | project-slug | ticket-ref>'
6
5
  disable-model-invocation: true
7
6
  user-invocable: true
8
7
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Task
8
+ metadata:
9
+ version: 1.0.14
9
10
  ---
10
11
 
11
12
  # Autonomous OAT Project
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-capture
3
- version: 1.0.2
4
3
  description: Use when work happened outside the OAT project workflow and needs retroactive project tracking. Creates a full project from an existing branch and conversation context.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.0.3
8
9
  ---
9
10
 
10
11
  # Capture Untracked Work
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-clear-active
3
3
  description: Use when switching context or cleaning up project state. Clears the active OAT project.
4
- version: 1.2.0
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash, AskUserQuestion
7
+ metadata:
8
+ version: 1.2.1
8
9
  ---
9
10
 
10
11
  # Clear Active Project
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-complete
3
- version: 1.7.8
4
3
  description: Use when all implementation work is finished and the project is ready to close. Marks the OAT project lifecycle as complete.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash, AskUserQuestion
7
+ metadata:
8
+ version: 1.7.9
8
9
  ---
9
10
 
10
11
  # Complete Project
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-design
3
- version: 2.3.4
4
3
  description: Use when discovery is complete and implementation-ready decisions are needed. Runs a collaborative, selective collaborative, or draft-and-review design flow, confirms requirements and produces both `spec.md` and `design.md`, and commits artifacts before the user-review gate.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 2.3.5
8
9
  ---
9
10
 
10
11
  # Design Phase
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-discover
3
- version: 2.2.5
4
3
  description: Use when the user explicitly asks to continue discovery for an active spec-driven OAT project — e.g. "continue discovery", "run discovery", or confirms a previously offered discovery step. Do NOT auto-invoke for new ideas or quick/lite-mode projects. Gathers requirements and context before spec/design.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Bash(oat:*), Bash(pnpm:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 2.2.6
8
9
  ---
9
10
 
10
11
  # Discovery Phase
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-dispatch-subagents
3
- version: 1.1.4
4
3
  description: Use when an OAT project lifecycle skill needs to translate project state, phase or task scope, gates, and write authority into a provider-neutral subagent dispatch.
5
4
  disable-model-invocation: true
6
5
  user-invocable: false
7
6
  allowed-tools: Read, Bash
7
+ metadata:
8
+ version: 1.1.5
8
9
  ---
9
10
 
10
11
  # Dispatching OAT Project Subagents
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: oat-project-document
3
- version: 1.8.2
4
3
  description: Use when the user requests or confirms documenting an active OAT project — e.g. "document the project", "update the docs", "run oat-project-document", or confirms a previously offered documentation run. Do NOT auto-invoke when implementation completes. Analyzes project artifacts, presents a documentation delta plan, and applies approved changes.
5
4
  argument-hint: '[project-path] [--auto]'
6
5
  disable-model-invocation: false
7
6
  user-invocable: true
8
7
  allowed-tools: Read, Write, Edit, Bash(git:*), Bash(jq:*), Bash(oat pjm:*), Bash(oat project push:*), Bash(oat project scope:*), Bash(oat tools:*), Glob, Grep, AskUserQuestion, Skill
8
+ metadata:
9
+ version: 1.8.3
9
10
  ---
10
11
 
11
12
  # Project Documentation Sync
@@ -1,12 +1,13 @@
1
1
  ---
2
2
  name: oat-project-implement
3
- version: 2.3.6
4
3
  description: Use when plan.md is ready for execution. Dispatches one phase implementer per phase, owns independent phase review and bounded fix routing, and supports plan-declared worktree-isolated parallel phases.
5
4
  oat_gateable: true
6
5
  argument-hint: '[--retry-limit <N>] [--dry-run]'
7
6
  disable-model-invocation: true
8
7
  user-invocable: true
9
8
  allowed-tools: Read, Write, Bash(git:*), Bash(oat:*), Bash(oat project log:*), Glob, Grep, AskUserQuestion, Task
9
+ metadata:
10
+ version: 2.3.7
10
11
  ---
11
12
 
12
13
  # Implementation Phase
@@ -1,12 +1,13 @@
1
1
  ---
2
2
  name: oat-project-import-plan
3
- version: 1.4.14
4
3
  description: Use when you have an external markdown plan to execute with OAT. Preserves the source plan and normalizes it into canonical plan.md format.
5
4
  argument-hint: '<path-to-plan.md> [--provider codex|cursor|claude] [--project <name>]'
6
5
  oat_gateable: true
7
6
  disable-model-invocation: true
8
7
  user-invocable: true
9
8
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
9
+ metadata:
10
+ version: 1.4.15
10
11
  ---
11
12
 
12
13
  # Import External Plan
@@ -1,12 +1,13 @@
1
1
  ---
2
2
  name: oat-project-lite
3
- version: 1.1.1
4
3
  description: Use when a single-sitting change needs a critical interview, an approved single-phase plan, and resumable OAT implementation with minimal ceremony.
5
4
  argument-hint: '<project-name> ["project description"]'
6
5
  oat_gateable: true
7
6
  disable-model-invocation: true
8
7
  user-invocable: true
9
8
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
9
+ metadata:
10
+ version: 1.1.2
10
11
  ---
11
12
 
12
13
  # Lite Project
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: oat-project-new
3
- version: 1.4.0
4
3
  description: Use when starting a spec-driven OAT project from scratch. Scaffolds a new project under PROJECTS_ROOT and sets it active.
5
4
  argument-hint: '<project-name> [--scope shared|local|synced] [--force]'
6
5
  disable-model-invocation: true
7
6
  user-invocable: true
8
7
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
8
+ metadata:
9
+ version: 1.4.1
9
10
  ---
10
11
 
11
12
  # New OAT Project
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-next
3
- version: 1.1.1
4
3
  description: Use when continuing work on the active OAT project. Reads project state, determines the next lifecycle action, and invokes the appropriate skill automatically.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Glob, Grep, Bash(git:*), Bash(oat:*), Skill
7
+ metadata:
8
+ version: 1.1.2
8
9
  ---
9
10
 
10
11
  # Project Next
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-open
3
3
  description: Use when switching to or resuming a specific OAT project. Delegates to `oat project open` for validation and activation.
4
- version: 1.2.0
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash, AskUserQuestion
7
+ metadata:
8
+ version: 1.2.1
8
9
  ---
9
10
 
10
11
  # Open Project
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: oat-project-plan
3
- version: 1.4.10
4
3
  description: Use when design.md is complete and executable implementation tasks are needed. Breaks design into bite-sized TDD tasks in canonical plan.md format.
5
4
  oat_gateable: true
6
5
  disable-model-invocation: true
7
6
  user-invocable: true
8
7
  allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
8
+ metadata:
9
+ version: 1.4.11
9
10
  ---
10
11
 
11
12
  # Planning Phase
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-plan-writing
3
- version: 1.2.23
4
3
  description: Use when authoring or mutating plan.md in any OAT workflow. Defines canonical format invariants — stable task IDs, required sections, review table rules, and resume guardrails.
5
4
  disable-model-invocation: true
6
5
  user-invocable: false
7
6
  allowed-tools: Read, Write, Glob, Grep
7
+ metadata:
8
+ version: 1.2.24
8
9
  ---
9
10
 
10
11
  # Plan Writing Contract
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-pr-final
3
- version: 1.6.3
4
3
  description: Use when the user requests or confirms opening the final PR for an active OAT project — e.g. "open the final PR", "ship it", "run oat-project-pr-final", or confirms a previously offered final-PR step. Do NOT auto-invoke when phases are marked complete. Generates the final lifecycle PR description from artifacts and creates the PR.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(awk:*), Bash(gh:*), Bash(git:*), Bash(mktemp:*), Bash(oat:*), Bash(rm:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.6.4
8
9
  ---
9
10
 
10
11
  # Project PR (Final)
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-pr-progress
3
- version: 1.3.1
4
3
  description: Use when an active OAT project needs a mid-project PR for a completed phase (pNN). Generates a phase-scoped progress PR description from OAT artifacts and commit history, with optional PR creation.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(awk:*), Bash(gh:*), Bash(git:*), Bash(mktemp:*), Bash(oat:*), Bash(rm:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.3.2
8
9
  ---
9
10
 
10
11
  # Progress PR
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-progress
3
- version: 1.4.1
4
3
  description: Use when the user explicitly asks to check OAT project progress — e.g. "check progress", "what's next", "where are we", or confirms a previously offered progress check. Do NOT auto-invoke just because a workflow step completed. Reads project status and offers the next route.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Glob, Grep, Bash(git:*), Bash(oat:*), AskUserQuestion
7
+ metadata:
8
+ version: 1.4.2
8
9
  ---
9
10
 
10
11
  # Progress Router
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: oat-project-promote-spec-driven
3
- version: 1.2.2
4
3
  description: Use when a quick or imported project now needs Spec-Driven lifecycle rigor. Backfills missing discovery, spec, and design artifacts in place.
5
4
  argument-hint: '[--project <name>]'
6
5
  disable-model-invocation: true
7
6
  user-invocable: true
8
7
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
8
+ metadata:
9
+ version: 1.2.3
9
10
  ---
10
11
 
11
12
  # Promote Project To Spec-Driven Lifecycle
@@ -1,12 +1,13 @@
1
1
  ---
2
2
  name: oat-project-quick-start
3
- version: 2.3.10
4
3
  description: Use when a task is small enough for quick mode or rapid iteration is preferred. Scaffolds a lightweight OAT project from discovery directly to a runnable plan, with optional brainstorming and lightweight design.
5
4
  argument-hint: '<project-name> ["project description"]'
6
5
  oat_gateable: true
7
6
  disable-model-invocation: true
8
7
  user-invocable: true
9
8
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
9
+ metadata:
10
+ version: 2.3.11
10
11
  ---
11
12
 
12
13
  # Quick Start Project
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-reconcile
3
- version: 1.0.2
4
3
  description: Use when human-implemented commits need to be mapped back to planned tasks. Reconciles implementation.md and state.md after manual work outside the OAT workflow.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.0.3
8
9
  ---
9
10
 
10
11
  # Reconcile Manual Implementation
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-retro
3
- version: 1.0.4
4
3
  description: Use when the user requests or confirms a project retrospective — e.g. "run the project retro", "write project-retro.md", "retrospective this project", or confirms a previously offered retro. Do NOT auto-invoke merely because implementation or summary completed. Produces references/project-retro.md from project logs, execution learnings, and session/transcript evidence, with repo improvements and OAT upstream feedback.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Bash(jq:*), Bash(pnpm:*), Bash(oat config:*), Bash(oat decision:*), Bash(oat project log:*), Bash(oat project push:*), Bash(oat project scope:*), Bash(oat tools:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.0.5
8
9
  ---
9
10
 
10
11
  # Project Retrospective
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-retro-file
3
- version: 1.0.2
4
3
  description: Use when the user requests or confirms filing proposed feedback from a project retro into repository or upstream GitHub issues and OAT backlog items. Runs destination capability, duplicate, approval, and sanitization checks before filing, then writes destinations and statuses back to the retro artifact.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Bash(jq:*), Bash(pnpm:*), Bash(gh:*), Bash(oat backlog:*), Bash(oat config:*), Bash(oat project push:*), Bash(oat project scope:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.0.3
8
9
  ---
9
10
 
10
11
  # File Project Retro Feedback
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-review-provide
3
- version: 1.5.5
4
3
  description: Use when the user explicitly asks to review an OAT project — e.g. "review project", "review the project", "run project review", or confirms a previously offered review. Do NOT auto-invoke on completed work alone. Resolves a project review scope and offers before running.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Glob, Grep, Write, Edit, Bash(git:*), Bash(oat:*), Bash(pnpm:*), Bash(mkdir:*), Bash(date:*), Bash(realpath:*), Bash(awk:*), AskUserQuestion
7
+ metadata:
8
+ version: 1.5.6
8
9
  ---
9
10
 
10
11
  # Request Review
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-review-provide-remote
3
- version: 1.1.3
4
3
  description: Use when reviewing a GitHub PR opened on another machine for an active OAT project and posting findings back as a single PR review. Resolves the project from the PR diff, reads project artifacts for mode-aware review, and posts via gh api.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash, Glob, Grep, Task, AskUserQuestion
7
+ metadata:
8
+ version: 1.1.4
8
9
  ---
9
10
 
10
11
  # Remote Review Provide (Project-Scoped GitHub PR)
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-review-receive
3
- version: 1.6.2
4
3
  description: Use when the user explicitly asks to receive review findings for an OAT project — e.g. "receive review", "process review", "process the project review", or confirms a previously offered review-receive step. Do NOT auto-invoke merely because a review file exists. Resolves the latest review and offers before acting.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Bash(oat:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.6.3
8
9
  ---
9
10
 
10
11
  # Receive Review
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-review-receive-remote
3
- version: 1.5.1
4
3
  description: Use when processing GitHub PR review comments within project context. Fetches PR comments, creates plan tasks, and updates project artifacts.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.5.2
8
9
  ---
9
10
 
10
11
  # Project Remote Review Receive
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-revise
3
- version: 1.0.2
4
3
  description: Use when a project has an open PR and human feedback needs to be incorporated. Creates revision tasks and re-enters implementation.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.0.3
8
9
  ---
9
10
 
10
11
  # Project Revise
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-spec
3
- version: 2.0.2
4
3
  description: Use when discovery is complete but you're not ready to design yet, and you want to formalize requirements into a structured spec.md as an optional standalone step. Independent of the design workflow — oat-project-design confirms requirements automatically and does not require this skill to be run first.
5
4
  disable-model-invocation: true
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 2.0.3
8
9
  ---
9
10
 
10
11
  # Specification Phase
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: oat-project-split
3
- version: 1.1.0
4
3
  description: Use when a discovery or brainstorm should split one broad scope into coordinated OAT child projects.
5
4
  argument-hint: '--plan-file <path>'
6
5
  disable-model-invocation: true
7
6
  user-invocable: true
8
7
  allowed-tools: Read, Write, Bash(oat:*), Bash(pnpm:*), Glob, Grep, AskUserQuestion
8
+ metadata:
9
+ version: 1.1.1
9
10
  ---
10
11
 
11
12
  # Split OAT Project
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: oat-project-summary
3
- version: 1.5.3
4
3
  description: Use when the user requests or confirms summarizing an active OAT project — e.g. "summarize the project", "generate the summary", "run oat-project-summary", or confirms a previously offered summary run. Do NOT auto-invoke when implementation completes. Generates summary.md from project artifacts as institutional memory.
5
4
  disable-model-invocation: false
6
5
  user-invocable: true
7
6
  allowed-tools: Read, Write, Bash(git:*), Bash(jq:*), Bash(oat config:*), Bash(oat decision:*), Bash(oat pjm:*), Bash(oat project log:*), Bash(oat project push:*), Bash(oat project scope:*), Bash(oat tools:*), Glob, Grep, AskUserQuestion
7
+ metadata:
8
+ version: 1.5.4
8
9
  ---
9
10
 
10
11
  # Project Summary
@@ -1,6 +1,5 @@
1
1
  ---
2
2
  name: oat-repo-improve
3
- version: 2.1.3
4
3
  description: Use when auditing a repository or turning maintainability reviews, backlog reviews, backlog directories, or backlog items into self-contained external implementation plans.
5
4
  argument-hint: '[repo-audit|maintainability-review|backlog-review|backlog-directory|backlog-item] [path-or-id] [quick|standard|deep] [focus] [--backlog-items] [--issues]'
6
5
  disable-model-invocation: false
@@ -9,6 +8,7 @@ allowed-tools: Read, Write, Glob, Grep, Bash, AskUserQuestion
9
8
  license: MIT
10
9
  metadata:
11
10
  author: shadcn
11
+ version: 2.1.4
12
12
  ---
13
13
 
14
14
  # OAT Repo Improve