@open-agent-toolkit/cli 0.2.55 → 0.2.57

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 (52) hide show
  1. package/assets/agents/oat-phase-implementer.md +123 -9
  2. package/assets/bundle-metadata.json +1 -1
  3. package/assets/docs/cli-utilities/configuration.md +12 -2
  4. package/assets/docs/docs-tooling/commands.md +36 -5
  5. package/assets/docs/reference/oat-directory-structure.md +56 -4
  6. package/assets/docs/workflows/projects/implementation-execution.md +5 -1
  7. package/assets/docs/workflows/skills/explainer-kit.md +8 -5
  8. package/assets/public-package-versions.json +4 -4
  9. package/assets/skills/analyze/SKILL.md +18 -17
  10. package/assets/skills/oat-brainstorm/SKILL.md +2 -2
  11. package/assets/skills/oat-doctor/SKILL.md +49 -36
  12. package/assets/skills/oat-idea-summarize/SKILL.md +2 -2
  13. package/assets/skills/oat-project-autonomous/SKILL.md +17 -10
  14. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +3 -3
  15. package/assets/skills/oat-project-complete/SKILL.md +18 -8
  16. package/assets/skills/oat-project-discover/SKILL.md +3 -3
  17. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +3 -3
  18. package/assets/skills/oat-project-implement/SKILL.md +1 -1
  19. package/assets/skills/oat-project-implement/references/completion-and-closeout.md +12 -3
  20. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +3 -3
  21. package/assets/skills/oat-project-implement/references/phase-execution.md +218 -4
  22. package/assets/skills/oat-project-implement/references/plan-and-resume.md +5 -2
  23. package/assets/skills/oat-project-implement/scripts/capture-dirty-tree.mjs +1069 -0
  24. package/assets/skills/oat-project-import-plan/SKILL.md +12 -6
  25. package/assets/skills/oat-project-next/SKILL.md +7 -5
  26. package/assets/skills/oat-project-plan/SKILL.md +24 -12
  27. package/assets/skills/oat-project-pr-final/SKILL.md +2 -2
  28. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +3 -3
  29. package/assets/skills/oat-project-quick-start/SKILL.md +11 -6
  30. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +3 -3
  31. package/assets/skills/oat-project-retro/SKILL.md +4 -2
  32. package/assets/skills/oat-project-review-receive/SKILL.md +9 -5
  33. package/assets/skills/oat-project-revise/SKILL.md +6 -6
  34. package/dist/commands/config/index.d.ts +1 -0
  35. package/dist/commands/config/index.d.ts.map +1 -1
  36. package/dist/commands/config/index.js +51 -4
  37. package/dist/commands/docs/index-generate/generator.d.ts +43 -1
  38. package/dist/commands/docs/index-generate/generator.d.ts.map +1 -1
  39. package/dist/commands/docs/index-generate/generator.js +169 -3
  40. package/dist/commands/docs/index-generate/index.d.ts +8 -3
  41. package/dist/commands/docs/index-generate/index.d.ts.map +1 -1
  42. package/dist/commands/docs/index-generate/index.js +340 -24
  43. package/dist/commands/docs/init/scaffold.d.ts +11 -1
  44. package/dist/commands/docs/init/scaffold.d.ts.map +1 -1
  45. package/dist/commands/docs/init/scaffold.js +11 -2
  46. package/dist/config/oat-config.d.ts +14 -0
  47. package/dist/config/oat-config.d.ts.map +1 -1
  48. package/dist/config/oat-config.js +61 -0
  49. package/dist/fs/assets.d.ts +33 -4
  50. package/dist/fs/assets.d.ts.map +1 -1
  51. package/dist/fs/assets.js +127 -12
  52. package/package.json +2 -2
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-import-plan
3
- version: 1.4.11
3
+ version: 1.4.12
4
4
  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
5
  argument-hint: '<path-to-plan.md> [--provider codex|cursor|claude] [--project <name>]'
6
6
  oat_gateable: true
@@ -189,7 +189,7 @@ contract.
189
189
 
190
190
  ### Step 3: Normalize Into Canonical OAT plan.md
191
191
 
192
- Create/update `"$PROJECT_PATH/plan.md"` using `.oat/templates/plan.md` and map imported content into the canonical structure. Apply `oat-project-plan-writing` invariants after mapping:
192
+ Create/update `"$PROJECT_PATH/plan.md"` using `.oat/templates/plan.md` and map imported content into the canonical structure. Apply `oat-project-plan-writing` invariants after mapping — load the current `oat-project-plan-writing/SKILL.md` and follow its invariants as written:
193
193
 
194
194
  Restore the exact snapshot into the resulting `plan.md` frontmatter as part of
195
195
  the first normalized plan write, before any later frontmatter rewrite and
@@ -245,7 +245,9 @@ cannot advance it to implementation.
245
245
  ### Step 4.1: Adopt Complete Ladders and Record the Named Ceiling
246
246
 
247
247
  Invoke the `Complete Dispatch Ladder Adoption Contract` from
248
- `oat-project-plan-writing`. If the effective ladder is missing or incomplete,
248
+ `oat-project-plan-writing`: load the current
249
+ `oat-project-plan-writing/SKILL.md` and follow that contract as written. If the
250
+ effective ladder is missing or incomplete,
249
251
  show the complete bundled recommendation and ask for its owning scope before
250
252
  running exactly one of:
251
253
 
@@ -288,7 +290,9 @@ explicit modes; `Leave Unresolved` is not implementation-ready.
288
290
 
289
291
  After normalization has produced stable phase IDs and before Step 4.5 starts
290
292
  the import-aware plan artifact review, invoke the `Shared Phase Gate Review Setup
291
- Contract` from `oat-project-plan-writing`. Provider native plan mode uses this
293
+ Contract` from `oat-project-plan-writing`: load the current
294
+ `oat-project-plan-writing/SKILL.md` and follow that contract as written.
295
+ Provider native plan mode uses this
292
296
  same import step and inherits its result.
293
297
 
294
298
  If `plan.md` already contains an explicit `oat_phase_review_gate`, preserve it
@@ -306,7 +310,9 @@ lifecycle command.
306
310
  ### Step 4.5: Run Import-Aware Plan Artifact Review Loop
307
311
 
308
312
  Before dispatching the artifact reviewer, invoke the `Managed Dispatch
309
- Readiness and Review Contract` from `oat-project-plan-writing`:
313
+ Readiness and Review Contract` from `oat-project-plan-writing` — load the
314
+ current `oat-project-plan-writing/SKILL.md` and follow that contract as
315
+ written:
310
316
 
311
317
  ```bash
312
318
  oat project dispatch-ceiling resolve --provider "$ACTIVE_PROVIDER" --role reviewer --preflight --json
@@ -317,7 +323,7 @@ If managed resolution or the complete ladder is unresolved, return to Step
317
323
  resolver. Do not set `oat_ready_for: oat-project-implement` while either
318
324
  contract is unresolved.
319
325
 
320
- Invoke the shared `Auto Artifact-Review Loop` from `oat-project-plan-writing` with target `plan` before advancing project state or handing off to implementation.
326
+ Invoke the shared `Auto Artifact-Review Loop` from `oat-project-plan-writing` with target `plan` before advancing project state or handing off to implementation. Load the current `oat-project-plan-writing/SKILL.md` and follow that loop as written.
321
327
 
322
328
  Required payload:
323
329
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-next
3
- version: 1.0.12
3
+ version: 1.0.13
4
4
  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
5
  disable-model-invocation: true
6
6
  user-invocable: true
@@ -111,7 +111,8 @@ projects, and synced records whose detached checkout is absent.
111
111
 
112
112
  - **The `projects` array is non-empty but the active pointer is missing or
113
113
  invalid:** Show the available project names with their `scope` and `checkout`
114
- state, then invoke `oat-project-open` so the user selects an existing
114
+ state, then invoke `oat-project-open` by loading the current
115
+ `oat-project-open/SKILL.md` and following it, so the user selects an existing
115
116
  project. An absent-checkout synced record and a local-only project both take
116
117
  this selection route; never suggest creating a replacement project. **STOP**
117
118
  this router after the selection workflow returns so the next invocation can
@@ -328,8 +329,9 @@ alone:
328
329
  a valid `freshness_fingerprint`. Exactly one merge base and 64-character
329
330
  lowercase hexadecimal implementation/freshness digests are mandatory.
330
331
  Missing or malformed inputs route as stale. When HEAD differs from
331
- `freshness_head`, use the full raw Git byte algorithm from
332
- `oat-project-implement` with only its literal state-carrier exclusion. Verify
332
+ `freshness_head`, use the full raw Git byte algorithm read from the current
333
+ `oat-project-implement/SKILL.md`, with only its literal state-carrier
334
+ exclusion, rather than a remembered version of that algorithm. Verify
333
335
  and ignore state-only checkpoint commits before classification. An unchanged
334
336
  qualified fingerprint preserves freshness across a merge, rebase, or base
335
337
  update but routes to `oat-project-implement` to persist the advanced rolling
@@ -438,7 +440,7 @@ Reason: {one-line explanation}
438
440
 
439
441
  The router still dispatches (blockers are informational, not gates).
440
442
 
441
- **Invoke the target skill** using the Skill tool. The agent will load the skill content and follow it directly.
443
+ **Invoke the target skill** using the Skill tool. Invoking the target means loading the target skill's current `SKILL.md` and following it directly, or dispatching a child that carries it; a remembered outcome or ambient discovery is not compliant. This step, not the Step 5 routing decisions, is this router's execution boundary.
442
444
 
443
445
  ## Success Criteria
444
446
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-plan
3
- version: 1.4.6
3
+ version: 1.4.7
4
4
  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
5
  oat_gateable: true
6
6
  disable-model-invocation: true
@@ -18,13 +18,13 @@ This skill is the plan authoring path for **spec-driven** projects only. Quick a
18
18
 
19
19
  Read `oat_workflow_mode` from `{PROJECT_PATH}/state.md` (default: `spec-driven`):
20
20
 
21
- - **`spec-driven`**: Complete design document required (`design.md` with `oat_status: complete`). If missing, run the `oat-project-design` skill first. Proceed with planning.
21
+ - **`spec-driven`**: Complete design document required (`design.md` with `oat_status: complete`). If missing, **Stop.** Tell the user: "Run the `oat-project-design` skill first, then return to planning." Otherwise proceed with planning.
22
22
  - **`quick`**: **Stop.** Plan is already produced by the quick workflow. Tell the user: "Plan already produced by quick workflow. Run `oat-project-implement` to begin execution."
23
23
  - **`import`**: **Stop.** If a normalized `plan.md` exists, tell the user: "Imported plan is ready. Run `oat-project-implement` to begin execution." If no `plan.md` exists, tell the user: "Run `oat-project-import-plan` to import and normalize the external plan first."
24
24
 
25
25
  ## Plan Format Contract
26
26
 
27
- When creating or editing `plan.md`, follow `oat-project-plan-writing` canonical format rules. This includes stable task IDs (`pNN-tNN`), required sections (`## Reviews`, `## Implementation Complete`, `## References`), required frontmatter keys (`oat_plan_source`, `oat_status`, `oat_ready_for`), and review table preservation rules. `oat_plan_hill_phases` remains optional until `oat-project-implement` confirms the checkpoint selection.
27
+ When creating or editing `plan.md`, load the current `oat-project-plan-writing/SKILL.md` and follow its canonical format rules. This includes stable task IDs (`pNN-tNN`), required sections (`## Reviews`, `## Implementation Complete`, `## References`), required frontmatter keys (`oat_plan_source`, `oat_status`, `oat_ready_for`), and review table preservation rules. `oat_plan_hill_phases` remains optional until `oat-project-implement` confirms the checkpoint selection.
28
28
 
29
29
  ## Mode Assertion
30
30
 
@@ -283,8 +283,6 @@ git commit -m "feat(p{NN}-t{NN}): {description}"
283
283
  ```
284
284
  ````
285
285
 
286
- ````
287
-
288
286
  ### Step 8: Apply TDD Discipline
289
287
 
290
288
  For each task that involves code:
@@ -295,6 +293,7 @@ For each task that involves code:
295
293
  4. **Refactor:** Clean up while tests pass
296
294
 
297
295
  **Task order for features:**
296
+
298
297
  1. Write test file
299
298
  2. Run tests (red)
300
299
  3. Write implementation
@@ -304,6 +303,7 @@ For each task that involves code:
304
303
  ### Step 9: Specify Exact Details
305
304
 
306
305
  For each task, include:
306
+
307
307
  - **Files:** Exact paths for create/modify/delete
308
308
  - **Signatures:** Interface definitions, function signatures, type declarations
309
309
  - **Test cases:** Test file paths and test descriptions (pseudocode OK for test bodies)
@@ -311,6 +311,7 @@ For each task, include:
311
311
  - **Commit:** Conventional commit message with task ID (e.g., `feat(p01-t03): ...`)
312
312
 
313
313
  **Avoid:**
314
+
314
315
  - Vague instructions ("update the file")
315
316
  - Missing verification steps
316
317
  - Verification shortcuts that claim file-scoped coverage but actually run a broader suite
@@ -322,6 +323,7 @@ For each task, include:
322
323
  Go back to spec.md and fill in the "Planned Tasks" column in the Requirement Index:
323
324
 
324
325
  For each requirement (FR/NFR):
326
+
325
327
  - List the stable task IDs that implement it
326
328
  - Example: "p01-t03, p02-t01, p02-t05"
327
329
 
@@ -329,7 +331,8 @@ This creates traceability: Requirement → Tasks → Implementation
329
331
 
330
332
  ### Step 10.1: Keep Reviews Table Rows
331
333
 
332
- Follow the review table preservation rules from `oat-project-plan-writing`:
334
+ Load the current `oat-project-plan-writing/SKILL.md` and follow its review table preservation rules:
335
+
333
336
  - Include both **code** rows (p01/p02/…/final) and **artifact** rows (`spec`, `design`, `plan`)
334
337
  - Add additional rows as needed (e.g., p03), but never delete existing rows
335
338
 
@@ -342,6 +345,7 @@ Do **not** ask the user to choose HiLL checkpoints during planning.
342
345
  Unless the source artifact or user already supplied a confirmed `oat_plan_hill_phases` value that should be preserved, leave `oat_plan_hill_phases` unset in `plan.md` during planning. `oat-project-implement` will confirm the checkpoint choice at implementation start and write the chosen value before task execution begins.
343
346
 
344
347
  **Required plan body update (do not skip):**
348
+
345
349
  - In `## Planning Checklist`, mark:
346
350
  - `[x] Defer HiLL checkpoint confirmation to oat-project-implement`
347
351
  - If a legacy checklist item such as `Confirmed HiLL checkpoints with user` exists, replace it with:
@@ -353,7 +357,9 @@ If `## Planning Checklist` is missing (older plans), add it before finalizing wi
353
357
 
354
358
  Before marking the plan ready for implementation, invoke the
355
359
  `Complete Dispatch Ladder Adoption Contract` from
356
- `oat-project-plan-writing` and then resolve the project named ceiling.
360
+ `oat-project-plan-writing` — load the current
361
+ `oat-project-plan-writing/SKILL.md` and follow that contract as written — and
362
+ then resolve the project named ceiling.
357
363
 
358
364
  #### A. Ensure a complete owned ladder
359
365
 
@@ -424,6 +430,7 @@ unresolved and block readiness.
424
430
  ### Step 12: Review Plan with User
425
431
 
426
432
  Present plan summary:
433
+
427
434
  - Number of phases
428
435
  - Tasks per phase
429
436
  - Key milestones
@@ -457,7 +464,8 @@ Never silently infer parallelism without explicit user confirmation.
457
464
 
458
465
  After the confirmed plan has stable phase IDs and before Step 12.5 starts the
459
466
  plan artifact review, invoke the `Shared Phase Gate Review Setup Contract` from
460
- `oat-project-plan-writing`.
467
+ `oat-project-plan-writing`: load the current
468
+ `oat-project-plan-writing/SKILL.md` and follow that contract as written.
461
469
 
462
470
  When that contract offers a choice, render its required question verbatim:
463
471
  "Should an additional cross-runtime phase gate review run after implementation
@@ -478,7 +486,9 @@ lifecycle command.
478
486
  ### Step 12.5: Run Plan Artifact Review Loop
479
487
 
480
488
  Before dispatching the artifact reviewer, invoke the `Managed Dispatch
481
- Readiness and Review Contract` from `oat-project-plan-writing`:
489
+ Readiness and Review Contract` from `oat-project-plan-writing` — load the
490
+ current `oat-project-plan-writing/SKILL.md` and follow that contract as
491
+ written:
482
492
 
483
493
  ```bash
484
494
  oat project dispatch-ceiling resolve --provider "$ACTIVE_PROVIDER" --role reviewer --preflight --json
@@ -489,7 +499,7 @@ If managed resolution or the complete ladder is unresolved, return to Step
489
499
  resolver. Do not mark the spec-driven plan ready while either contract is
490
500
  unresolved.
491
501
 
492
- Invoke the shared `Auto Artifact-Review Loop` from `oat-project-plan-writing` with target `plan` before setting `plan.md` to implementation-ready.
502
+ Invoke the shared `Auto Artifact-Review Loop` from `oat-project-plan-writing` with target `plan` before setting `plan.md` to implementation-ready. Load the current `oat-project-plan-writing/SKILL.md` and follow that loop as written.
493
503
 
494
504
  Required payload:
495
505
 
@@ -597,20 +607,22 @@ Reach this completion boundary only after the configured gate passes or resolves
597
607
  according to its `onFailure` policy.
598
608
 
599
609
  Before setting `oat_status: complete`, verify:
610
+
600
611
  - `## Planning Checklist` exists
601
612
  - the checklist records that checkpoint confirmation is deferred to implementation
602
613
  - if `oat_plan_hill_phases` is already present, it is intentionally preserved and valid
603
614
  - the `plan` artifact review row has been recorded by Step 12.5, unless `workflow.autoArtifactReview.plan` was explicitly disabled
604
615
 
605
616
  Update frontmatter:
617
+
606
618
  ```yaml
607
619
  ---
608
620
  oat_status: complete
609
621
  oat_ready_for: oat-project-implement
610
622
  oat_blockers: []
611
- oat_last_updated: {today}
623
+ oat_last_updated: { today }
612
624
  ---
613
- ````
625
+ ```
614
626
 
615
627
  ### Step 14: Update Project State
616
628
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-pr-final
3
- version: 1.6.0
3
+ version: 1.6.1
4
4
  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
5
  disable-model-invocation: false
6
6
  user-invocable: true
@@ -217,7 +217,7 @@ sequence step.
217
217
  Check if `{PROJECT_PATH}/summary.md` exists:
218
218
 
219
219
  - If `summary.md` is missing or stale, refresh it automatically before proceeding.
220
- - Prefer running the `oat-project-summary` skill when skill-to-skill invocation is available in the current host/runtime.
220
+ - When skill-to-skill invocation is available in the current host/runtime, load the current `oat-project-summary/SKILL.md` and follow it; never synthesize the summary from a remembered version of that skill.
221
221
  - If direct skill invocation is unavailable, generate or update `summary.md` inline by following the same synthesis rules as `oat-project-summary` (validate implementation state, read the same project artifacts, apply the same freshness checks, update the same frontmatter tracking fields, and write a complete `summary.md` before continuing).
222
222
  - Do not assume `oat-project-summary` is a shell command on `PATH`. Only execute a shell command with that name if the environment explicitly provides a real executable.
223
223
  - Do not ask whether to generate or refresh `summary.md` during pr-final.
@@ -228,10 +228,10 @@ remains immutable baseline evidence for the original p01-t01 verification.
228
228
  | `oat-project-new/SKILL.md` | `f7ca8635452f -> NG`; `dceff5cc04b5 -> NG`; `1af4957a1af2 -> NEW-01`; `45b699c1c0b5 -> NEW-01`; `ba6d120791c1 -> NEW-01`; `33ce6a6c30aa -> NEW-02`; `0f5a90f34f63 -> NG`; `d0ea3a91261d -> NG` |
229
229
  | `oat-project-quick-start/SKILL.md` | `f7ca8635452f -> NG`; `c493a38b89f2 -> QS-04`; `655d61df0a8f -> NG`; `dceff5cc04b5 -> NG`; `1af4957a1af2 -> QS-01`; `141d0a20099b -> QS-01`; `45b699c1c0b5 -> QS-01`; `ba6d120791c1 -> QS-01`; `1a5ee85164ff -> QS-02`; `af8e2bea90d7 -> QS-04`; `a823cf5aeaec -> QS-04`; `7753dc323083 -> QS-04`; `1f557da5e03c -> QS-04`; `1564ca151111 -> NG`; `c24787334ade -> QS-05`; `021ba03c82c5 -> QS-05`; `5d1a9d1b661d -> QS-05`; `318f304ee3b3 -> QS-05`; `cc700d4d2cab -> QS-05`; `7ef6aa642400 -> QS-05`; `4d389b234556 -> QS-05`; `84c506dac106 -> QS-05`; `caf7622a2e02 -> QS-05`; `8917190b2e98 -> QS-06`; `5a028d846aa5 -> QS-06`; `b1d92192b8ca -> QS-06`; `bdbb18955cc4 -> QS-06`; `6d159a2e8f8e -> QS-06`; `61a9849f4dfc -> QS-06`; `31cb92052ea6 -> QS-06`; `39e3fe23dd85 -> QS-07`; `2cb069a2590b -> NG`; `fd0aff270853 -> NG`; `a114b27f8b4b -> NG`; `77dc8e1b728a -> QS-08`; `d3e3fba65b96 -> QS-09`; `71c2a0ba99bf -> QS-09`; `f47f9f9c0d03 -> QS-09`; `224a4b43fb29 -> QS-10`; `744f130d4116 -> QS-12`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> QS-12`; `857e91aa3095 -> NG`; `b4af2220eb91 -> QS-12` |
230
230
  | `oat-project-quick-start/references/docs/autonomy-contract.md` | `* -> NG` |
231
- | `oat-project-discover/SKILL.md` | `8fe35bbfbcd6 -> NG`; `6acc57686847 -> NG`; `4df56b83b98e -> NG`; `660fcdb9dd0d -> NG`; `655d61df0a8f -> NG`; `302f5a4e2f7e -> DISC-03`; `8ee1861bb37c -> DISC-03`; `5c8d5f04f6e2 -> DISC-05`; `73964bb042ab -> DISC-05`; `82cc79370b80 -> DISC-05`; `ff09e8f7774f -> DISC-06`; `323e71dca05d -> DISC-06`; `012bab5b478e -> DISC-06`; `523764981692 -> DISC-06`; `7eaa40e078b9 -> DISC-07`; `b57408be1e7b -> DISC-07`; `4683ea4a7d2f -> DISC-07`; `04454a79d998 -> DISC-08`; `54444ee79fc8 -> DISC-08`; `dd3b5d3d6424 -> DISC-08`; `f64efa435cb2 -> DISC-08`; `1f802b9bc5ad -> DISC-08`; `3fad0405b2bc -> NG`; `2eeba46b7d76 -> DISC-08` |
231
+ | `oat-project-discover/SKILL.md` | `8fe35bbfbcd6 -> NG`; `6acc57686847 -> NG`; `4df56b83b98e -> NG`; `660fcdb9dd0d -> NG`; `655d61df0a8f -> NG`; `302f5a4e2f7e -> DISC-03`; `8ee1861bb37c -> DISC-03`; `50a1cdc5156b -> DISC-05`; `73964bb042ab -> DISC-05`; `82cc79370b80 -> DISC-05`; `ff09e8f7774f -> DISC-06`; `323e71dca05d -> DISC-06`; `012bab5b478e -> DISC-06`; `59b36042ba08 -> DISC-06`; `7eaa40e078b9 -> DISC-07`; `b57408be1e7b -> DISC-07`; `4683ea4a7d2f -> DISC-07`; `04454a79d998 -> DISC-08`; `54444ee79fc8 -> DISC-08`; `dd3b5d3d6424 -> DISC-08`; `f64efa435cb2 -> DISC-08`; `1f802b9bc5ad -> DISC-08`; `3fad0405b2bc -> NG`; `2eeba46b7d76 -> DISC-08` |
232
232
  | `oat-project-design/SKILL.md` | `d942bb5a75dc -> NG`; `5eb3949f32e1 -> NG`; `8bdedbff2084 -> NG`; `655d61df0a8f -> NG`; `cf317c17c586 -> DES-01`; `2fd9e4306093 -> NG`; `30aaa490f54f -> NG`; `5d39260a7350 -> DES-03`; `925238b3a9b8 -> DES-03`; `f44832c14f8f -> DES-03`; `7f6ed9174a80 -> DES-03`; `ea8a45cff484 -> DES-03`; `ae06e7f3590d -> DES-03`; `ad9715bfa9b5 -> DES-03`; `235f4eba81d9 -> DES-03`; `86d15c022ff2 -> DES-03`; `c08ee2c84186 -> DES-03`; `bd3ee332d171 -> DES-03`; `ec88b585a24d -> DES-03`; `a9595a6486f1 -> DES-04`; `accb06cd6f3c -> DES-04`; `806001c2c365 -> DES-04`; `696587b33f1e -> DES-04`; `9c3320eee2f8 -> NG`; `8b653210ce17 -> NG`; `8ad2a4dc63d2 -> DES-05`; `33cc7540d89e -> DES-05`; `51a2b698ba14 -> DES-05`; `81085592cc91 -> DES-05`; `74b952cc1121 -> DES-05`; `da7551391a41 -> DES-05`; `02c93ec05a4a -> DES-06`; `6864967fd8a4 -> DES-06`; `84e9be719156 -> DES-06`; `7ed89c44264b -> DES-06`; `dc7ba56c1cd4 -> DES-06`; `57ccefb935bf -> DES-06`; `9d27238332b2 -> NG`; `a0c758ab26aa -> NG`; `0e17c1a2de0b -> DES-07`; `e9ea8625567c -> DES-07`; `908e710e7304 -> DES-07`; `b3df7f6b838c -> DES-07`; `f2cb6d4a915e -> DES-07`; `2f4a7f0c9fe5 -> DES-07`; `feccfddbb990 -> DES-07`; `62556fd0060a -> DES-07`; `5382604ed237 -> DES-07`; `3b8724979206 -> DES-07`; `f86a1f05edb9 -> DES-07`; `65f2c8b5c7fd -> DES-07`; `96e24cf8a888 -> DES-07`; `bd3ad56d6265 -> DES-08`; `a19d9c6d7b42 -> DES-08`; `3af5412588ba -> DES-08`; `a0f1c66507d0 -> DES-08`; `a97364c2ca8b -> DES-08`; `4725e333dea4 -> DES-07`; `595d3a64c0f4 -> DES-07`; `57923a130802 -> DES-07`; `7d8fdfb4ca6f -> NG`; `033fb711de49 -> NG`; `d30bb6464138 -> DES-08` |
233
233
  | `oat-project-design/references/selective-review-pass.md` | `d4956192b82e -> DES-06`; `7d6e1f926ecb -> DES-06`; `04f918a5fcac -> DES-07` |
234
- | `oat-project-plan/SKILL.md` | `5eb3949f32e1 -> NG`; `64a08153bb9e -> NG`; `655d61df0a8f -> NG`; `56b37486f09d -> PLAN-01`; `cf317c17c586 -> PLAN-02`; `781643b0f2c3 -> NG`; `01fd7cca8253 -> PLAN-04`; `7bc7fa3f2cbb -> NG`; `da28ce0a5f2e -> NG`; `e334f94c4d35 -> NG`; `1fa55762c038 -> NG`; `c0935b5484a2 -> NG`; `6008163054f8 -> PLAN-05`; `571271f4d71b -> PLAN-06`; `746b760289e4 -> PLAN-06`; `de195590ff83 -> NG`; `49640510829a -> PLAN-07`; `4bef7afa7a71 -> PLAN-08`; `e5886632533e -> PLAN-08`; `4cfe1df14372 -> NG`; `d116c97a500c -> PLAN-10`; `aa62facff547 -> PLAN-10`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> PLAN-11`; `1734b2c85c5d -> NG`; `b4af2220eb91 -> PLAN-11` |
234
+ | `oat-project-plan/SKILL.md` | `5eb3949f32e1 -> NG`; `2f0ae331febf -> NG`; `655d61df0a8f -> NG`; `56b37486f09d -> PLAN-01`; `cf317c17c586 -> PLAN-02`; `781643b0f2c3 -> NG`; `01fd7cca8253 -> PLAN-04`; `7bc7fa3f2cbb -> NG`; `da28ce0a5f2e -> NG`; `e334f94c4d35 -> NG`; `1fa55762c038 -> NG`; `c0935b5484a2 -> NG`; `6008163054f8 -> PLAN-05`; `571271f4d71b -> PLAN-06`; `746b760289e4 -> PLAN-06`; `de195590ff83 -> NG`; `49640510829a -> PLAN-07`; `4bef7afa7a71 -> PLAN-08`; `e5886632533e -> PLAN-08`; `4cfe1df14372 -> NG`; `d116c97a500c -> PLAN-10`; `aa62facff547 -> PLAN-10`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> PLAN-11`; `1734b2c85c5d -> NG`; `b4af2220eb91 -> PLAN-11` |
235
235
  | `oat-project-import-plan/SKILL.md` | `f7ca8635452f -> NG`; `c2e5fa410069 -> NG`; `655d61df0a8f -> NG`; `dceff5cc04b5 -> NG`; `1af4957a1af2 -> IMPORT-01`; `45b699c1c0b5 -> IMPORT-01`; `ba6d120791c1 -> IMPORT-01`; `070ebc5259af -> IMPORT-03`; `c11552696e2e -> IMPORT-03`; `cfe661966baf -> IMPORT-04`; `baa91c0a0bf8 -> NG`; `e364e84b2702 -> NG`; `39031985a945 -> IMPORT-06`; `f106aa29a217 -> IMPORT-07`; `65038450aee3 -> IMPORT-07`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPORT-09` |
236
236
  | `oat-project-implement/SKILL.md` | `18980f6bc1a6 -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG`; `bd0cb4988188 -> NG`; `28af4ee0055d -> NG` |
237
237
  | `oat-project-implement/references/completion-and-closeout.md` | `f7dab9c1f96c -> IMPLEMENT-12`; `c69c17a069a8 -> IMPLEMENT-14`; `a97fa5634a68 -> IMPLEMENT-14`; `3af58881811c -> IMPLEMENT-14`; `4203e1f49d0f -> IMPLEMENT-14`; `c3bd2458a3d3 -> IMPLEMENT-13`; `95b5eafc070d -> IMPLEMENT-13`; `25ecbe9c998b -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `0a384debbbe7 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `f18283bc1cf9 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `2c1ffc4a82dd -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `3454a07aa843 -> IMPLEMENT-16`; `8d7cd69e5b09 -> NG`; `d5fe597d266f -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `55a152e944c1 -> IMPLEMENT-16`; `effac7cbd573 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d2a34d8b148 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `d27462aaed26 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `9d52ecb17268 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `5b91aabe3757 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `fd0ad919f702 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `63bf28df1474 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a4ed471dbc78 -> IMPLEMENT-16`; `6b7a64cec6e5 -> IMPLEMENT-16`; `0a4fdba0ebc0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `a5033c2aada5 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `e77609eddba0 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `351156e8dde4 -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `51d45bd2bbd1 -> IMPLEMENT-16`; `f7796ffcc804 -> IMPLEMENT-16`; `990d730cb494 -> IMPLEMENT-16`; `6ed28bb7d384 -> IMPLEMENT-16`; `8b7d4b5bcf1b -> IMPLEMENT-16`; `88aad500e6e9 -> IMPLEMENT-16`; `877e3e3f9eda -> IMPLEMENT-16`; `fc03c97f834e -> IMPLEMENT-16`; `12939a3da5e0 -> IMPLEMENT-16`; `bdb418335a88 -> IMPLEMENT-16`; `fba97e596ebd -> IMPLEMENT-16`; `3d0b5e2f14f0 -> IMPLEMENT-17`; `87f1424a8692 -> NG`; `6b1ec05182f0 -> IMPLEMENT-11`; `e6d696a27c91 -> NG`; `c77f8ccb52ad -> NG`; `48de2614c0ba -> IMPLEMENT-11`; `32d53f5212e5 -> IMPLEMENT-11`; `7cdb4a9c57b7 -> IMPLEMENT-11`; `16ffc0aa099b -> IMPLEMENT-11`; `d6868ea10b3f -> IMPLEMENT-11`; `4f05ff5567be -> IMPLEMENT-11`; `c70b47ae7a6d -> IMPLEMENT-11`; `5fafd093b58e -> NG`; `567d43ab0c2e -> NG`; `21ceaf7e658a -> NG`; `249427a9f475 -> NG`; `8a7ec13a9b7c -> NG`; `9aeb7fce2012 -> IMPLEMENT-18`; `f11a7cdda220 -> IMPLEMENT-18`; `4523ac029152 -> NG`; `6e87b08c4046 -> NG`; `baa6052c7f0a -> IMPLEMENT-18`; `27d3fad116b1 -> IMPLEMENT-18`; `2cfbeb4388a5 -> IMPLEMENT-18`; `c56ea56a56db -> NG`; `43e2e3c1380d -> IMPLEMENT-17`; `b49690277fb5 -> NG`; `df12304d6a36 -> NG`; `52eacac11fef -> IMPLEMENT-17`; `60092df6b17b -> IMPLEMENT-17`; `361872c6b00e -> IMPLEMENT-17`; `d2bc711a75fb -> IMPLEMENT-17`; `e0c2ea5032de -> NG`; `e3055dc5dcd1 -> NG`; `d26330f2299f -> NG` |
@@ -244,7 +244,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
244
244
  | `oat-project-summary/SKILL.md` | `68c197c44c18 -> NG`; `35cb2ea1d677 -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `f3e49b727752 -> NG`; `f979b2342d28 -> NG`; `803bf40ec423 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG`; `5f315ab87cb1 -> NG` |
245
245
  | `oat-project-pr-final/SKILL.md` | `601ac2b890f2 -> NG`; `c264a64398f0 -> NG`; `9efcbcee42ea -> NG`; `655d61df0a8f -> NG`; `cf317c17c586 -> PRFINAL-01`; `2de348a391c0 -> PRFINAL-03` |
246
246
  | `oat-project-pr-final/references/docs/autonomy-contract.md` | `* -> NG` |
247
- | `oat-project-complete/SKILL.md` | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `7bcbf58b54e9 -> NG`; `4c7f88a7f942 -> COMPLETE-02`; `6a1a95acc8cc -> COMPLETE-02`; `3b559956b3eb -> COMPLETE-03`; `14d161cdf99b -> COMPLETE-03`; `fffe5eea5ebd -> NG`; `e7dc6fdc4eb3 -> COMPLETE-01`; `e5460e437299 -> NG`; `882b61c9096c -> NG`; `9ffa1c752505 -> NG` |
247
+ | `oat-project-complete/SKILL.md` | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `7bcbf58b54e9 -> NG`; `4c7f88a7f942 -> COMPLETE-02`; `6a1a95acc8cc -> COMPLETE-02`; `3b559956b3eb -> COMPLETE-03`; `14d161cdf99b -> COMPLETE-03`; `fffe5eea5ebd -> NG`; `e7dc6fdc4eb3 -> COMPLETE-01`; `e5460e437299 -> NG`; `882b61c9096c -> NG`; `9ffa1c752505 -> NG`; `8c5e599f6bac -> NG` |
248
248
  | `oat-project-review-provide/SKILL.md` | `1f4b981cac8b -> NG`; `adaeca152bb2 -> NG`; `2f7c201c3c06 -> NG`; `88f79700afdc -> NG`; `655d61df0a8f -> NG`; `efafde9ef5a0 -> NG`; `d2a3861d6323 -> REVIEWPROVIDE-02`; `65f5b9cf49cd -> REVIEWPROVIDE-04`; `962cb38d246a -> REVIEWPROVIDE-04`; `1a568483ba0b -> REVIEWPROVIDE-04`; `610e27edfe85 -> REVIEWPROVIDE-04`; `bb0096e95c47 -> REVIEWPROVIDE-06`; `55f6357a987d -> REVIEWPROVIDE-06`; `1bee61f8531c -> REVIEWPROVIDE-07`; `3d35091607a1 -> REVIEWPROVIDE-08`; `fb40c4341c4c -> NG`; `b22d16885150 -> NG`; `d2b25906242e -> REVIEWPROVIDE-08`; `fd8ebf72b3c4 -> NG`; `fcb9de611ff3 -> NG`; `d2a838dfb18d -> NG`; `c3d50ea7cf69 -> NG`; `09b1b8dd445c -> NG`; `7acc8f3718d2 -> REVIEWPROVIDE-09`; `b2fa883fc4a2 -> NG`; `fe4421531b4c -> NG` |
249
249
  | `oat-project-review-receive/SKILL.md` | `9b8a3743d626 -> NG`; `df49c8c6f192 -> NG`; `4ee8730382d3 -> NG`; `655d61df0a8f -> NG`; `765f897d67ac -> NG`; `53b58d16dd32 -> NG`; `fb8755a3bdf4 -> NG`; `c8ab5dd90075 -> NG`; `1f7dd98dff2f -> NG`; `56f78c6740e6 -> NG`; `76f5fb5a88cd -> NG`; `085abfa3599f -> REVIEWRECEIVE-01`; `3ad3aadb8c60 -> NG`; `a7d114059bb6 -> NG`; `ac88cfaa83d9 -> NG`; `594bbf70346c -> REVIEWRECEIVE-08`; `f31f07284718 -> REVIEWRECEIVE-02`; `aba178a21441 -> REVIEWRECEIVE-04`; `a37e601cd731 -> REVIEWRECEIVE-05`; `20e05e1a4381 -> REVIEWRECEIVE-06`; `90001dadf75f -> REVIEWRECEIVE-07`; `f8fd58180ecf -> NG`; `c3abcdc02d9f -> NG`; `f2ebdd6abb9b -> NG` |
250
250
  | `oat-project-review-provide/SKILL.md` | `2e794bf4fc4a -> REVIEWPROVIDE-08`; `5441ab977b46 -> REVIEWPROVIDE-08` |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-quick-start
3
- version: 2.3.7
3
+ version: 2.3.8
4
4
  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
5
  argument-hint: '<project-name> ["project description"]'
6
6
  oat_gateable: true
@@ -542,7 +542,7 @@ skill pauses, is interrupted, or cannot resolve dispatch before Step 3.7,
542
542
  persist and commit this state. `oat-project-next` must route it back to the
543
543
  current planning workflow and cannot advance it to implementation.
544
544
 
545
- Plan requirements — apply `oat-project-plan-writing` canonical format invariants:
545
+ Plan requirements — apply `oat-project-plan-writing` canonical format invariants, loading the current `oat-project-plan-writing/SKILL.md` and following them as written:
546
546
 
547
547
  - Stable task IDs (`pNN-tNN`)
548
548
  - Verification step per task
@@ -566,7 +566,9 @@ Before moving the quick project to ready-for-implementation, resolve the
566
566
  complete dispatch ladder and the project named ceiling.
567
567
 
568
568
  Invoke the `Complete Dispatch Ladder Adoption Contract` from
569
- `oat-project-plan-writing`. If the effective ladder is missing or incomplete,
569
+ `oat-project-plan-writing`: load the current
570
+ `oat-project-plan-writing/SKILL.md` and follow that contract as written. If the
571
+ effective ladder is missing or incomplete,
570
572
  show the full bundled recommendation and ask the user to select its owning
571
573
  scope before running exactly one command:
572
574
 
@@ -630,7 +632,8 @@ non-interactive unresolved state are not implementation-ready.
630
632
 
631
633
  After the generated quick plan has stable phase IDs and before Step 3.6 starts
632
634
  the plan artifact review, invoke the `Shared Phase Gate Review Setup Contract` from
633
- `oat-project-plan-writing`.
635
+ `oat-project-plan-writing`: load the current
636
+ `oat-project-plan-writing/SKILL.md` and follow that contract as written.
634
637
 
635
638
  When that contract offers a choice, render its required question verbatim:
636
639
  "Should an additional cross-runtime phase gate review run after implementation
@@ -651,7 +654,9 @@ lifecycle command.
651
654
  ### Step 3.6: Run Plan Artifact Review Loop
652
655
 
653
656
  Before dispatching the artifact reviewer, invoke the `Managed Dispatch
654
- Readiness and Review Contract` from `oat-project-plan-writing`:
657
+ Readiness and Review Contract` from `oat-project-plan-writing` — load the
658
+ current `oat-project-plan-writing/SKILL.md` and follow that contract as
659
+ written:
655
660
 
656
661
  ```bash
657
662
  oat project dispatch-ceiling resolve --provider "$ACTIVE_PROVIDER" --role reviewer --preflight --json
@@ -662,7 +667,7 @@ If managed resolution or the complete ladder is unresolved, return to Step
662
667
  resolver. Do not hand the quick plan to implementation while either contract is
663
668
  unresolved.
664
669
 
665
- Invoke the shared `Auto Artifact-Review Loop` from `oat-project-plan-writing` with target `plan` before syncing project state or handing off to implementation.
670
+ Invoke the shared `Auto Artifact-Review Loop` from `oat-project-plan-writing` with target `plan` before syncing project state or handing off to implementation. Load the current `oat-project-plan-writing/SKILL.md` and follow that loop as written.
666
671
 
667
672
  Required payload:
668
673