@open-agent-toolkit/cli 0.1.65 → 0.1.69

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 (40) hide show
  1. package/assets/agents/oat-reviewer.md +2 -2
  2. package/assets/docs/cli-utilities/workflow-gates.md +24 -5
  3. package/assets/docs/reference/cli-reference.md +1 -1
  4. package/assets/docs/workflows/projects/dispatch-ceiling.md +11 -3
  5. package/assets/docs/workflows/projects/pr-flow.md +12 -1
  6. package/assets/docs/workflows/projects/reviews.md +21 -1
  7. package/assets/public-package-versions.json +4 -4
  8. package/assets/skills/oat-agent-instructions-analyze/SKILL.md +3 -2
  9. package/assets/skills/oat-project-autonomous/SKILL.md +1 -1
  10. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +6 -6
  11. package/assets/skills/oat-project-complete/SKILL.md +20 -2
  12. package/assets/skills/oat-project-design/SKILL.md +88 -75
  13. package/assets/skills/oat-project-discover/SKILL.md +83 -64
  14. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +6 -6
  15. package/assets/skills/oat-project-implement/SKILL.md +1 -1
  16. package/assets/skills/oat-project-implement/references/completion-and-closeout.md +12 -1
  17. package/assets/skills/oat-project-implement/references/dispatch-and-dry-run.md +24 -9
  18. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +6 -6
  19. package/assets/skills/oat-project-implement/references/phase-execution.md +5 -2
  20. package/assets/skills/oat-project-next/SKILL.md +21 -6
  21. package/assets/skills/oat-project-plan/SKILL.md +69 -56
  22. package/assets/skills/oat-project-plan-writing/SKILL.md +19 -2
  23. package/assets/skills/oat-project-pr-final/SKILL.md +20 -5
  24. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +6 -6
  25. package/assets/skills/oat-project-pr-progress/SKILL.md +18 -3
  26. package/assets/skills/oat-project-progress/SKILL.md +4 -1
  27. package/assets/skills/oat-project-quick-start/SKILL.md +68 -55
  28. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +6 -6
  29. package/assets/skills/oat-project-review-provide/SKILL.md +7 -2
  30. package/assets/skills/oat-project-review-receive/SKILL.md +46 -18
  31. package/assets/skills/oat-project-review-receive-remote/SKILL.md +41 -8
  32. package/dist/commands/cleanup/project/project.utils.d.ts.map +1 -1
  33. package/dist/commands/cleanup/project/project.utils.js +19 -1
  34. package/dist/commands/gate/index.d.ts +2 -0
  35. package/dist/commands/gate/index.d.ts.map +1 -1
  36. package/dist/commands/gate/index.js +29 -1
  37. package/dist/commands/review/latest.d.ts +1 -0
  38. package/dist/commands/review/latest.d.ts.map +1 -1
  39. package/dist/commands/review/latest.js +96 -22
  40. package/package.json +2 -2
package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md CHANGED
@@ -218,16 +218,16 @@ remains immutable baseline evidence for the original p01-t01 verification.
218
218
  | Skill root / file | Stable prompt-site mappings |
219
219
  | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
220
220
  | `oat-project-new/SKILL.md` | `f7ca8635452f -> NG`; `b137f73db20c -> NEW-01`; `45b699c1c0b5 -> NEW-01`; `ba6d120791c1 -> NEW-01`; `33ce6a6c30aa -> NEW-02`; `0f5a90f34f63 -> NG`; `d0ea3a91261d -> NG` |
221
- | `oat-project-quick-start/SKILL.md` | `f7ca8635452f -> NG`; `c493a38b89f2 -> QS-04`; `655d61df0a8f -> NG`; `b137f73db20c -> QS-01`; `45b699c1c0b5 -> QS-01`; `ba6d120791c1 -> QS-01`; `1a5ee85164ff -> QS-02`; `af8e2bea90d7 -> QS-04`; `a823cf5aeaec -> QS-04`; `7753dc323083 -> QS-04`; `1f557da5e03c -> QS-04`; `0960c3eb1564 -> 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` |
221
+ | `oat-project-quick-start/SKILL.md` | `f7ca8635452f -> NG`; `c493a38b89f2 -> QS-04`; `655d61df0a8f -> NG`; `b137f73db20c -> QS-01`; `45b699c1c0b5 -> QS-01`; `ba6d120791c1 -> QS-01`; `1a5ee85164ff -> QS-02`; `af8e2bea90d7 -> QS-04`; `a823cf5aeaec -> QS-04`; `7753dc323083 -> QS-04`; `1f557da5e03c -> QS-04`; `0960c3eb1564 -> 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` |
222
222
  | `oat-project-quick-start/references/docs/autonomy-contract.md` | `* -> NG` |
223
- | `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`; `1195a16a0bc5 -> NG`; `d20eb00f1887 -> DISC-08`; `3f0b53056edd -> DISC-08`; `b92484ef7ca4 -> DISC-08`; `3cf10a406501 -> DISC-08` |
224
- | `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`; `8678cdb975d0 -> 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`; `38a0adf2dcd6 -> DES-07`; `16c2036990df -> DES-07`; `b23bbe0c4282 -> DES-07`; `71972778f6b8 -> DES-07`; `7f88caab1f38 -> DES-07`; `7eb6f3a2d666 -> DES-07`; `e7a364820674 -> DES-07`; `241de26a0b0b -> DES-07`; `9d7a898331a3 -> DES-07`; `686152516d78 -> DES-07`; `8ca3cff907f3 -> DES-07`; `13e6349960fb -> DES-07`; `fd3d71fade25 -> DES-07`; `8daa828dfad0 -> NG`; `d20eb00f1887 -> DES-08`; `3f0b53056edd -> DES-08`; `b92484ef7ca4 -> DES-08`; `3cf10a406501 -> DES-08`; `033fb711de49 -> NG` |
223
+ | `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` |
224
+ | `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`; `8678cdb975d0 -> 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`; `38a0adf2dcd6 -> DES-07`; `16c2036990df -> DES-07`; `b23bbe0c4282 -> DES-07`; `71972778f6b8 -> DES-07`; `7f88caab1f38 -> DES-07`; `7eb6f3a2d666 -> DES-07`; `e7a364820674 -> DES-07`; `241de26a0b0b -> DES-07`; `9d7a898331a3 -> DES-07`; `686152516d78 -> 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` |
225
225
  | `oat-project-design/references/selective-review-pass.md` | `d4956192b82e -> DES-06`; `7d6e1f926ecb -> DES-06`; `04f918a5fcac -> DES-07` |
226
- | `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`; `71d18f57db67 -> PLAN-10`; `9b6ef603b0b9 -> PLAN-10`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> PLAN-11`; `1734b2c85c5d -> NG` |
226
+ | `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` |
227
227
  | `oat-project-import-plan/SKILL.md` | `f7ca8635452f -> NG`; `c2e5fa410069 -> NG`; `655d61df0a8f -> NG`; `b137f73db20c -> 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` |
228
228
  | `oat-project-implement/SKILL.md` | `c6732295bc8c -> NG`; `ffb3af0ba8ef -> NG`; `e0355c7a05e9 -> IMPLEMENT-11+IMPLEMENT-13+IMPLEMENT-16`; `6296f41ae11c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> IMPLEMENT-01`; `8ce8a09feca4 -> NG` |
229
229
  | `oat-project-implement/references/completion-and-closeout.md` | `105600fbd045 -> IMPLEMENT-11`; `3e6055aede6c -> IMPLEMENT-11`; `0705f7533039 -> IMPLEMENT-11`; `0c39746f3cb5 -> IMPLEMENT-11`; `14d89fe39c8c -> IMPLEMENT-11`; `378a75543a72 -> IMPLEMENT-11`; `c7b25627e674 -> IMPLEMENT-11`; `51ef9a453323 -> IMPLEMENT-11`; `c67145e3fb00 -> IMPLEMENT-11`; `64fbeac64811 -> IMPLEMENT-11`; `19b13c17bddb -> NG`; `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`; `f6f24fd71da4 -> 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`; `0d86e2098cfb -> IMPLEMENT-13+IMPLEMENT-14+IMPLEMENT-15+IMPLEMENT-16`; `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`; `f56a9ce88461 -> IMPLEMENT-17`; `9ba67b50d0ba -> IMPLEMENT-17`; `39ff911760af -> IMPLEMENT-17`; `5b560b5bd6e3 -> IMPLEMENT-17`; `fa21df5e5e01 -> IMPLEMENT-17`; `0fed77bec55e -> IMPLEMENT-17`; `6d81cfb0483f -> IMPLEMENT-17`; `bee4c4aa34c6 -> NG`; `3f0b53056edd -> IMPLEMENT-18` |
230
- | `oat-project-implement/references/dispatch-and-dry-run.md` | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG` |
230
+ | `oat-project-implement/references/dispatch-and-dry-run.md` | `21b85f5e4daa -> IMPLEMENT-08`; `74c92b32bb2a -> IMPLEMENT-08`; `8efd2d0517ab -> IMPLEMENT-09`; `461ed9b3e495 -> IMPLEMENT-09`; `b5ad64fd744d -> NG`; `14ce436cfffa -> NG`; `043ca36da3e2 -> NG`; `a23e45c1dc8d -> NG`; `498143bb41a7 -> NG`; `4fe3eb179023 -> NG`; `7f75485e5a33 -> NG`; `8ec3a96df029 -> NG`; `16c3f96e758d -> NG`; `5915c41fe058 -> NG`; `f51e43eeac56 -> NG`; `fd41c25623cb -> NG`; `58a932ed6453 -> NG`; `4718bd3ce12d -> NG`; `58c444a2126b -> NG`; `2df3adae4120 -> NG`; `e75df892b55c -> NG` |
231
231
  | `oat-project-implement/references/docs/autonomy-contract.md` | `* -> NG` |
232
232
  | `oat-project-implement/references/phase-execution.md` | `27737e814790 -> NG`; `6dda2b8e62e2 -> IMPLEMENT-10`; `b3197086bb1e -> IMPLEMENT-10` |
233
233
  | `oat-project-implement/references/plan-and-resume.md` | `413829d31e32 -> IMPLEMENT-02`; `c7706cd8ad09 -> IMPLEMENT-03`; `a80a948df658 -> IMPLEMENT-03`; `b7ea139780ec -> IMPLEMENT-03+IMPLEMENT-04`; `8d438f2180ba -> IMPLEMENT-03`; `9e72e0518cda -> IMPLEMENT-03`; `3e177a1021e6 -> IMPLEMENT-03+IMPLEMENT-04`; `b59fc9eb9ce3 -> IMPLEMENT-03`; `a2b1d6855283 -> IMPLEMENT-03`; `44351a32e52a -> IMPLEMENT-03`; `b98b022f5523 -> IMPLEMENT-03`; `e9f5b949e214 -> IMPLEMENT-03`; `316fb6d9e980 -> IMPLEMENT-03`; `8b25a2c5c548 -> IMPLEMENT-03`; `1a59b1c0e705 -> IMPLEMENT-03`; `466cd562fc52 -> IMPLEMENT-03`; `083d896978d5 -> IMPLEMENT-03`; `f4ab11c13ae9 -> IMPLEMENT-03`; `7dc17ffcc1c4 -> IMPLEMENT-03`; `f731a90adabd -> IMPLEMENT-04`; `886ac01e7aa9 -> IMPLEMENT-04`; `b715db67df0c -> IMPLEMENT-04`; `2d9f26a539f3 -> IMPLEMENT-10`; `28384dee114f -> IMPLEMENT-05`; `f2591a4978b4 -> NG`; `8290823080b5 -> IMPLEMENT-06`; `f75789bf6c8e -> IMPLEMENT-07` |
@@ -238,7 +238,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
238
238
  | `oat-project-pr-final/references/docs/autonomy-contract.md` | `* -> NG` |
239
239
  | `oat-project-complete/SKILL.md` | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `ffcdc9d576c0 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `9497d9f94eed -> COMPLETE-01`; `7b59c728d3fb -> COMPLETE-01`; `48e10a9636fe -> COMPLETE-01`; `c0dad37fc166 -> COMPLETE-01`; `aa9a36243ec1 -> COMPLETE-01`; `7bcbf58b54e9 -> NG`; `4c7f88a7f942 -> COMPLETE-02`; `6a1a95acc8cc -> COMPLETE-02`; `3b559956b3eb -> COMPLETE-03`; `14d161cdf99b -> COMPLETE-03`; `12f7c30a54c8 -> NG`; `fffe5eea5ebd -> NG` |
240
240
  | `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`; `fab62c510bd0 -> REVIEWPROVIDE-05`; `a9f30853c867 -> REVIEWPROVIDE-05`; `0929c916fc20 -> REVIEWPROVIDE-05`; `f9a37c63afab -> REVIEWPROVIDE-05`; `687bb9368f92 -> REVIEWPROVIDE-05`; `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` |
241
- | `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`; `3f758313fedb -> REVIEWRECEIVE-08`; `f31f07284718 -> REVIEWRECEIVE-02`; `aba178a21441 -> REVIEWRECEIVE-04`; `a37e601cd731 -> REVIEWRECEIVE-05`; `20e05e1a4381 -> REVIEWRECEIVE-06`; `90001dadf75f -> REVIEWRECEIVE-07`; `f8fd58180ecf -> NG`; `c3abcdc02d9f -> NG` |
241
+ | `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`; `3f758313fedb -> REVIEWRECEIVE-08`; `f31f07284718 -> REVIEWRECEIVE-02`; `aba178a21441 -> REVIEWRECEIVE-04`; `a37e601cd731 -> REVIEWRECEIVE-05`; `20e05e1a4381 -> REVIEWRECEIVE-06`; `90001dadf75f -> REVIEWRECEIVE-07`; `f8fd58180ecf -> NG`; `c3abcdc02d9f -> NG`; `f2ebdd6abb9b -> NG` |
242
242
  | `oat-dispatch-subagents/SKILL.md` | `cb4f86157fd6 -> DISPATCH-01`; `f165b1626192 -> DISPATCH-01`; `7ed5e2b1eb71 -> PDISPATCH-01`; `11c72bcdebad -> DISPATCH-02`; `0834ee701e12 -> DISPATCH-02`; `7fda54e1d519 -> PDISPATCH-01` |
243
243
  | `oat-dispatch-subagents/references/provider-claude.md` | `fbe3a21e9533 -> NG` |
244
244
  | `oat-dispatch-subagents/references/provider-codex.md` | `95b0f82018c7 -> NG` |
package/assets/skills/oat-project-implement/references/phase-execution.md CHANGED
@@ -218,8 +218,11 @@ After each phase or parallel group:
218
218
  - append an Orchestration Run with phase outcomes, task commits, phase/root
219
219
  review result, fix iterations, dispatch stamps, selection reasons,
220
220
  candidates, optional nested dispatches, worktrees, and outstanding items;
221
- - update the plan review row through `fixes_added` / `fixes_completed` /
222
- `passed` as appropriate;
221
+ - update only the plan review event whose Scope + Type + artifact filename
222
+ identifies the review being dispositioned, through `fixes_added` /
223
+ `fixes_completed` / `passed` as appropriate;
224
+ - never select review bookkeeping by scope alone, replace an earlier event, or
225
+ move an event status backward;
223
226
  - update `state.md` current task, last commit, and timestamp;
224
227
  - remove legacy `oat_execution_mode: subagent-driven`; and
225
228
  - preserve any configured retry override.
package/assets/skills/oat-project-next/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-next
3
- version: 1.0.7
3
+ version: 1.0.9
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
@@ -244,6 +244,8 @@ Before dispatching the target skill, check for unprocessed review artifacts:
244
244
 
245
245
  **Step 2:** Cross-reference against plan.md Reviews table (if it exists):
246
246
 
247
+ - For each active artifact, match the event by Scope + Type + artifact filename;
248
+ never infer its status from another row that shares only the scope.
247
249
  - Status `"passed"` → processed (review completed successfully)
248
250
  - Status `"fixes_added"` or `"fixes_completed"` → processed (review-receive already converted findings to tasks)
249
251
  - Any other status (blank, `"pending"`, `"in_progress"`, `"received"`) → **UNPROCESSED**
@@ -280,21 +282,34 @@ Run the Review Safety Check (Step 4 above). If unprocessed reviews exist:
280
282
 
281
283
  **5.3: Final code review not passed**
282
284
 
283
- Parse plan.md Reviews table for a row with `Scope="final"` and `Type="code"`:
285
+ Extract only the exact level-two `## Reviews` ledger, stopping before the next
286
+ level-two heading, then select its latest appended event with `Scope="final"`
287
+ and `Type="code"`:
284
288
 
285
- - If no such row exists, OR row exists with `Status="pending"`:
289
+ ```bash
290
+ REVIEWS_SECTION=$(awk '
291
+ /^## Reviews[[:space:]]*$/ { in_reviews = 1; next }
292
+ in_reviews && /^##[[:space:]]/ { exit }
293
+ in_reviews { print }
294
+ ' "$PROJECT_PATH/plan.md" 2>/dev/null)
295
+ FINAL_ROW=$(printf '%s\n' "$REVIEWS_SECTION" | grep -E "^\\|\\s*final\\s*\\|\\s*code\\s*\\|" | tail -1 || true)
296
+ ```
297
+
298
+ Ignore matching rows outside `REVIEWS_SECTION`; they are not review events.
299
+
300
+ - If `FINAL_ROW` is empty, OR it has `Status="pending"`:
286
301
  → Route to `oat-project-review-provide` (with scope hint: "code final")
287
302
  → Announce: "Implementation complete — triggering final code review"
288
303
 
289
- - If row exists with `Status="fixes_completed"`:
304
+ - If `FINAL_ROW` has `Status="fixes_completed"`:
290
305
  → Route to `oat-project-review-provide` (with scope hint: "code final")
291
306
  → Announce: "Review fixes implemented — triggering re-review"
292
307
 
293
- - If row exists with other non-passed status (e.g., `"received"`, `"fixes_added"`) and Step 5.2 did not find an active top-level review artifact:
308
+ - If `FINAL_ROW` has another non-passed status (e.g., `"received"`, `"fixes_added"`) and Step 5.2 did not find an active top-level review artifact:
294
309
  → Route to `oat-project-review-provide` (with scope hint: "code final")
295
310
  → Announce: "Final review is not passed and no active review artifact exists — rerunning final review"
296
311
 
297
- - If row exists with `Status="passed"`:
312
+ - If `FINAL_ROW` has `Status="passed"`:
298
313
  → Continue to 5.4
299
314
 
300
315
  **5.4: Summary not done**
package/assets/skills/oat-project-plan/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-plan
3
- version: 1.3.14
3
+ version: 1.4.1
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
@@ -417,12 +417,36 @@ Ask: "Does this breakdown make sense? Any tasks missing?"
417
417
 
418
418
  Iterate until user confirms.
419
419
 
420
+ ### Step 12.1: Propose Parallel Groups (Optional)
421
+
422
+ After all phases are drafted, evaluate whether any phases have non-overlapping file boundaries:
423
+
424
+ 1. For each pair of adjacent phases in the plan, check the `Files:` section of all tasks in each phase.
425
+ 2. If no file appears in both phases' task files sections, they are candidates for a parallel group.
426
+ 3. Propose to the user:
427
+
428
+ ```
429
+ I noticed phases p02 and p03 have disjoint file boundaries (no overlap).
430
+ Declare them as a parallel group? This lets oat-project-implement run them
431
+ concurrently in worktrees, cutting wall-clock time.
432
+ ```
433
+
434
+ 4. If the user confirms, update `oat_plan_parallel_groups` in the plan frontmatter.
435
+ 5. If no phases are obviously independent, skip this step silently — do not invent parallelism.
436
+
437
+ Never silently infer parallelism without explicit user confirmation.
438
+
420
439
  ### Step 12.25: Configure Optional Phase Gate Review
421
440
 
422
441
  After the confirmed plan has stable phase IDs and before Step 12.5 starts the
423
442
  plan artifact review, invoke the `Shared Phase Gate Review Setup Contract` from
424
443
  `oat-project-plan-writing`.
425
444
 
445
+ When that contract offers a choice, render its required question verbatim:
446
+ "Should an additional cross-runtime phase gate review run after implementation
447
+ phases? Built-in per-phase root reviews and the final review run regardless of
448
+ this choice." Do not add a bare `(Recommended)` option label.
449
+
426
450
  If `plan.md` already contains an explicit `oat_phase_review_gate`, preserve it
427
451
  through the shared contract without probing, prompting, or mutation. Otherwise
428
452
  let the contract probe qualifying targets and offer all phases, selected
@@ -481,8 +505,52 @@ Apply the shared loop exactly:
481
505
  - Re-dispatch after rewrites until clean or the retry bound is exhausted.
482
506
  - Update the `plan` artifact row in the `## Reviews` table to `passed` when clean. If residual findings remain, preserve the row and surface the residual findings before downstream handoff.
483
507
 
508
+ ### Gate Execution
509
+
510
+ After the plan artifact is finalized and reviewed, run the configured gate as
511
+ the last check before the completion boundary:
512
+
513
+ 1. Resolve the gate for this skill:
514
+
515
+ ```bash
516
+ oat gate resolve <this-skill> --json
517
+ ```
518
+
519
+ If the command returns JSON `null`, no gate is configured; proceed directly to the completion steps in Step 13 below.
520
+
521
+ 2. Export the resolved project path into the command shell:
522
+
523
+ ```bash
524
+ export PROJECT_PATH
525
+ ```
526
+
527
+ If the resolved command invokes `oat gate review`, the configured review command must already include `--project "$PROJECT_PATH"` and must not include `--target <id>`. A valid reusable shape is `oat gate review --project "$PROJECT_PATH" ...`. If the declaration is missing, stop and migrate the stored gate command; do not inject or append arguments at execution time.
528
+
529
+ 3. Execute the resolved command exactly as configured. Capture stdout, stderr, the exit code, and the structured JSON result. A zero exit code means the review passed its threshold, but it does not by itself authorize artifact receipt or complete the handoff.
530
+
531
+ 4. Review-artifact handoff:
532
+ - Parse the structured gate result. An exit code or artifact path alone never authorizes `oat-project-review-receive`.
533
+ - Invoke receive only when all three conditions hold: `status` is `ok` or `blocked`, the envelope explicitly sets `receiveEligible: true`, and a non-null `handoff` confirms the artifact was corroborated.
534
+ - `receiveEligible: false` is a hard stop even when `artifactPath` is present. Never receive `targeting_correlation_failed`; correct the project/run routing and run a new gate.
535
+ - Keep `artifact_validation_failed` outside receive until the artifact is corrected and the gate successfully revalidates it. Treat `review_failed`, unknown statuses, null handoffs, and contradictory eligibility fields as operational failures.
536
+ - `blocked` exits nonzero but is receive-eligible; `ok` exits zero and still requires durable receive disposition. Route by structured status and eligibility, not by exit code.
537
+
538
+ 5. If the command exits nonzero, use `description` to orient the next steps and handle `onFailure`:
539
+ - `block`: read gate feedback, remediate, and re-run the gate up to `maxAttempts` attempts (default `2`). If attempts are exhausted, escalate to the human with accumulated feedback and append that feedback to `implementation.md`. Treat a launch failure, missing CLI, or no eligible runtime as escalation-biased and do not spend it as a remediation attempt.
540
+ - `prompt`: surface the gate failure and ask the human how to proceed.
541
+ - `warn`: record the gate failure and continue.
542
+
543
+ 6. Runtime selection note (V1): the step runs the gate `command` as-is and reads no OAT runtime env var. By default, `oat gate review` and `oat gate cross-provider-exec` resolve the current host from built-in `hostDetectionCommand`s and avoid the same runtime when no exact target is supplied. Reusable lifecycle skill-gate commands must not include `--target <id>` so independent review stays provider-neutral. Use explicit targets only for manual/debug commands or deliberate local/user-specific overrides; do not hardcode provider/model targets in bundled skill guidance or shared lifecycle gate examples.
544
+
545
+ A gate that ends in `block` after attempts are exhausted, or at an unresolved
546
+ `prompt` boundary, means the completion steps below MUST NOT run; the phase
547
+ stays `in_progress` and resumable.
548
+
484
549
  ### Step 13: Mark Plan Complete
485
550
 
551
+ Reach this completion boundary only after the configured gate passes or resolves
552
+ according to its `onFailure` policy.
553
+
486
554
  Before setting `oat_status: complete`, verify:
487
555
  - `## Planning Checklist` exists
488
556
  - the checklist records that checkpoint confirmation is deferred to implementation
@@ -499,25 +567,6 @@ oat_last_updated: {today}
499
567
  ---
500
568
  ````
501
569
 
502
- ### Step 14.5: Propose Parallel Groups (Optional)
503
-
504
- After all phases are drafted, evaluate whether any phases have non-overlapping file boundaries:
505
-
506
- 1. For each pair of adjacent phases in the plan, check the `Files:` section of all tasks in each phase.
507
- 2. If no file appears in both phases' task files sections, they are candidates for a parallel group.
508
- 3. Propose to the user:
509
-
510
- ```
511
- I noticed phases p02 and p03 have disjoint file boundaries (no overlap).
512
- Declare them as a parallel group? This lets oat-project-implement run them
513
- concurrently in worktrees, cutting wall-clock time.
514
- ```
515
-
516
- 4. If the user confirms, update `oat_plan_parallel_groups` in the plan frontmatter.
517
- 5. If no phases are obviously independent, skip this step silently — do not invent parallelism.
518
-
519
- Never silently infer parallelism without explicit user confirmation.
520
-
521
570
  ### Step 14: Update Project State
522
571
 
523
572
  Update `"$PROJECT_PATH/state.md"`:
@@ -579,42 +628,6 @@ Total: {N} tasks
579
628
  Next: Run oat-project-implement to begin execution.
580
629
  ```
581
630
 
582
- ### Gate Execution
583
-
584
- Before reporting this skill as complete, run the configured gate as the final step:
585
-
586
- 1. Resolve the gate for this skill:
587
-
588
- ```bash
589
- oat gate resolve <this-skill> --json
590
- ```
591
-
592
- If the command returns JSON `null`, no gate is configured; the skill is complete.
593
-
594
- 2. Export the resolved project path into the command shell:
595
-
596
- ```bash
597
- export PROJECT_PATH
598
- ```
599
-
600
- If the resolved command invokes `oat gate review`, the configured review command must already include `--project "$PROJECT_PATH"` and must not include `--target <id>`. A valid reusable shape is `oat gate review --project "$PROJECT_PATH" ...`. If the declaration is missing, stop and migrate the stored gate command; do not inject or append arguments at execution time.
601
-
602
- 3. Execute the resolved command exactly as configured. Capture stdout, stderr, the exit code, and the structured JSON result. A zero exit code means the review passed its threshold, but it does not by itself authorize artifact receipt or complete the handoff.
603
-
604
- 4. Review-artifact handoff:
605
- - Parse the structured gate result. An exit code or artifact path alone never authorizes `oat-project-review-receive`.
606
- - Invoke receive only when all three conditions hold: `status` is `ok` or `blocked`, the envelope explicitly sets `receiveEligible: true`, and a non-null `handoff` confirms the artifact was corroborated.
607
- - `receiveEligible: false` is a hard stop even when `artifactPath` is present. Never receive `targeting_correlation_failed`; correct the project/run routing and run a new gate.
608
- - Keep `artifact_validation_failed` outside receive until the artifact is corrected and the gate successfully revalidates it. Treat `review_failed`, unknown statuses, null handoffs, and contradictory eligibility fields as operational failures.
609
- - `blocked` exits nonzero but is receive-eligible; `ok` exits zero and still requires durable receive disposition. Route by structured status and eligibility, not by exit code.
610
-
611
- 5. If the command exits nonzero, use `description` to orient the next steps and handle `onFailure`:
612
- - `block`: read gate feedback, remediate, and re-run the gate up to `maxAttempts` attempts (default `2`). If attempts are exhausted, escalate to the human with accumulated feedback and append that feedback to `implementation.md`. Treat a launch failure, missing CLI, or no eligible runtime as escalation-biased and do not spend it as a remediation attempt.
613
- - `prompt`: surface the gate failure and ask the human how to proceed.
614
- - `warn`: record the gate failure and continue.
615
-
616
- 6. Runtime selection note (V1): the step runs the gate `command` as-is and reads no OAT runtime env var. By default, `oat gate review` and `oat gate cross-provider-exec` resolve the current host from built-in `hostDetectionCommand`s and avoid the same runtime when no exact target is supplied. Reusable lifecycle skill-gate commands must not include `--target <id>` so independent review stays provider-neutral. Use explicit targets only for manual/debug commands or deliberate local/user-specific overrides; do not hardcode provider/model targets in bundled skill guidance or shared lifecycle gate examples.
617
-
618
631
  ## Success Criteria
619
632
 
620
633
  - All design components covered by tasks
package/assets/skills/oat-project-plan-writing/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-plan-writing
3
- version: 1.2.13
3
+ version: 1.2.14
4
4
  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
5
  disable-model-invocation: true
6
6
  user-invocable: false
@@ -265,12 +265,23 @@ Do not invent enablement in either branch.
265
265
  ### 3. Offer the canonical choice
266
266
 
267
267
  When at least one target qualifies and an interactive user-response channel is
268
- available, offer exactly these outcomes:
268
+ available, the calling skill must ask:
269
+
270
+ ```text
271
+ Should an additional cross-runtime phase gate review run after implementation
272
+ phases? Built-in per-phase root reviews and the final review run regardless of
273
+ this choice.
274
+ ```
275
+
276
+ Then offer exactly these outcomes:
269
277
 
270
278
  1. **All phases** - enable the independent Phase gate review after every implementation phase.
271
279
  2. **Selected phases** - enable the independent Phase gate review only after chosen stable phase IDs.
272
280
  3. **Disabled** - leave Phase gate review disabled.
273
281
 
282
+ Do not attach a bare `(Recommended)` label to any option. If the caller offers
283
+ a recommendation, it must state the cost/coverage tradeoff explicitly.
284
+
274
285
  Phase gate review is non-pausing when it passes and is distinct from both HiLL
275
286
  approval and final artifact review.
276
287
 
@@ -446,10 +457,16 @@ If any required section is missing when a skill edits `plan.md`, it must be rest
446
457
  ### Review Table Preservation Rules
447
458
 
448
459
  - The `## Reviews` table includes both **code** rows (`p01`, `p02`, …, `final`) and **artifact** rows (`spec`, `design`, `plan`).
460
+ - Rows are append-ordered review events. Duplicate `Scope` + `Type` rows are valid; readers use the latest appended matching event when they need current lifecycle state.
461
+ - `Scope` + `Type` + `Artifact` filename form the event identity:
462
+ - The first event for a scope/type may claim an unbound `pending` placeholder whose Artifact is `-`.
463
+ - When a new review has a distinct artifact filename and no unbound placeholder remains, append a new row. Never overwrite a bound row merely because its scope/type matches.
464
+ - Later mutations, including archive-path rewrites, must select the event by scope/type and artifact filename. A path move from `reviews/` to `reviews/archived/` keeps the same event identity.
449
465
  - Skills must **never delete** existing review rows.
450
466
  - New rows may be appended (e.g., `p03` for a newly added phase).
451
467
  - Status semantics: `pending` → `received` → `fixes_added` → `fixes_completed` → `passed`.
452
468
  - `received`: review artifact exists but findings have not yet been converted into fix tasks.
469
+ - An event status must never move backward in this ladder. A later event may start at `received` without changing an earlier event that already reached `passed`.
453
470
 
454
471
  ### Implementation Complete Section
455
472
 
package/assets/skills/oat-project-pr-final/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: oat-project-pr-final
3
- version: 1.5.1
3
+ version: 1.5.3
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
@@ -169,10 +169,20 @@ If `WORKFLOW_MODE` is `quick` or `import`, proceed without spec/design and inclu
169
169
  Preferred source of truth (v1): `plan.md` `## Reviews` table.
170
170
 
171
171
  ```bash
172
- FINAL_ROW=$(grep -E "^\\|\\s*final\\s*\\|" "$PROJECT_PATH/plan.md" 2>/dev/null | head -1)
172
+ REVIEWS_SECTION=$(awk '
173
+ /^## Reviews[[:space:]]*$/ { in_reviews = 1; next }
174
+ in_reviews && /^##[[:space:]]/ { exit }
175
+ in_reviews { print }
176
+ ' "$PROJECT_PATH/plan.md" 2>/dev/null)
177
+ FINAL_ROW=$(printf '%s\n' "$REVIEWS_SECTION" | grep -E "^\\|\\s*final\\s*\\|\\s*code\\s*\\|" | tail -1)
173
178
  echo "$FINAL_ROW"
174
179
  ```
175
180
 
181
+ `REVIEWS_SECTION` is strictly the `## Reviews` section through the next
182
+ level-two heading. Use the latest appended event in that ledger whose Scope is
183
+ `final` and Type is `code`. Earlier final-review events remain history and do
184
+ not determine the current gate.
185
+
176
186
  If `FINAL_ROW` is missing or does not contain `passed`:
177
187
 
178
188
  - If `OAT_AUTONOMOUS=1`, gate `PRFINAL-03` is a boundary stop. Never select
@@ -403,7 +413,7 @@ After writing the PR artifact and creating the PR, update `"$PROJECT_PATH/state.
403
413
  **Content updates:**
404
414
 
405
415
  - In `## Current Phase`, set:
406
- - `Implementation — PR open, awaiting human review.`
416
+ - `Implementation — PR open; completion may run before or after merge.`
407
417
  - In `## Progress`, add:
408
418
  - `- ✓ PR created`
409
419
  - `- ⧗ Awaiting human review`
@@ -413,9 +423,14 @@ After writing the PR artifact and creating the PR, update `"$PROJECT_PATH/state.
413
423
  PR is open for review.
414
424
 
415
425
  - To incorporate feedback: run `oat-project-revise`
416
- - When approved: run `oat-project-complete`
426
+ - Complete before merge: run `oat-project-complete` now, then merge the PR.
427
+ - Merge before completion: merge the PR, then run `oat-project-complete`.
417
428
  ```
418
429
 
430
+ Both orderings are supported. An open PR is not a blocker for
431
+ `oat-project-complete`; when completion archives project artifacts, it
432
+ regenerates and syncs the open PR body.
433
+
419
434
  If `state.md` is missing, skip with a warning.
420
435
 
421
436
  ## Success Criteria
@@ -425,4 +440,4 @@ If `state.md` is missing, skip with a warning.
425
440
  - Final review status checked and referenced
426
441
  - User has clear next step to open PR (manual or gh)
427
442
  - Project `state.md` shows `oat_phase_status: pr_open`
428
- - Next milestone references both `oat-project-revise` (for feedback) and `oat-project-complete` (when approved)
443
+ - Next milestone references both `oat-project-revise` (for feedback) and both supported `oat-project-complete` orderings