@open-agent-toolkit/cli 0.3.21 → 0.3.23

package/assets/skills/oat-project-autonomous/SKILL.md

@@ -6,7 +6,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Task
 metadata:
-  version: 1.0.21
+  version: 1.0.22
 ---
 
 # Autonomous OAT Project
@@ -99,7 +99,7 @@ If you catch yourself:
 **Recovery:**
 
 1. Persist only safe, owned bookkeeping.
-2. Record the deviation or inventory gap in the learnings log.
+2. Record the deviation or inventory gap as a learning (Step 4).
 3. Return to the earliest incomplete canonical lifecycle step, or stop with the
    structured blocker report.
 
@@ -117,7 +117,7 @@ Print each indicator only when its step begins:
 - `[2/9] Detecting persisted lifecycle state…`
 - `[3/9] Selecting workflow review density…`
 - `[4/9] Gathering external-integration evidence…`
-- `[5/9] Initializing execution learnings…`
+- `[5/9] Preparing the project-log learning write…`
 - `[6/9] Running lifecycle phases and independent reviews…`
 - `[7/9] Completing implementation closeout…`
 - `[8/9] Committing and pushing the phase boundary…`
@@ -388,18 +388,12 @@ continue with checked-out sources when that preserves integrity. Missing
 evidence that would force material product or safety assumptions is a boundary,
 not permission to guess.
 
-### Step 4: Create and Maintain the Learnings Log
+### Step 4: Record Learnings in the Project Log
 
-At run start, create `"$PROJECT_PATH/oat-execution-learnings.md"` when absent
-with `oat_generated: false` and append-only intent. Append UTC-dated entries:
-
-```markdown
-## {timestamp} - {category} - {title}
-
-**Observation:** ...
-**Impact:** ...
-**Recommendation:** ...
-```
+Learnings are category-bearing judgment entries in `project-log.md`, written
+only through `oat project log append`. Never create or append to
+`oat-execution-learnings.md`; summary and retro still read an existing legacy
+file second.
 
 Use only these categories: `gotcha`, `efficiency`, `documentation-gap`,
 `candidate-skill-content`, `decision`, and `environment-limited`. Record
@@ -407,22 +401,89 @@ degraded routes, inventory gaps, unavailable verification, and reusable
 improvements. Never record secrets, token values, signed URLs, or active
 autonomy signals.
 
-After creating the log and after every later append, persist that write before
-continuing:
+Give every observation a stable source id: one whitespace-free word that is
+unique to this run and observation, for example
+`autonomous-<run id>-<NN>`. Retain it for retries: the id is both `--source`
+and `--idempotency-key`, so a replayed write reports `already-appended` and
+appends nothing. Write the learning title as `--area`, and the body as
+`Observation:`, `Impact:`, `Recommendation:` and, when it applies,
+`Uncertainty:` lines. Define the write once and call it for every learning:
 
 ```bash
-PROJECT_SCOPE=$(oat project scope "$PROJECT_PATH" --format value) || {
-  echo "oat: cannot resolve project scope for $PROJECT_PATH; refusing to commit artifacts" >&2
-  exit 1
+# Learning write (shared by oat-project-autonomous, oat-cursor-cloud-projects
+# and oat-project-goal): oat_record_learning <category> <source-id> <title> <body>
+oat_record_learning() {
+  local category="$1" source="$2" title="$3" body="$4" type result
+  case "$category" in
+    gotcha | environment-limited) type=friction ;;
+    efficiency | candidate-skill-content) type=worked-well ;;
+    documentation-gap | decision) type=feedback ;;
+    *)
+      echo "oat: unknown learning category '$category'" >&2
+      return 1
+      ;;
+  esac
+  result=$(oat project log append --json --project "$PROJECT_PATH" \
+    --type "$type" --scope project --area "$title" \
+    --category "$category" \
+    --source "$source" \
+    --origin "${LEARNING_ORIGIN:?set to the producer skill name}" \
+    --idempotency-key "$source" \
+    --body "$body") || {
+    printf '%s\n' "$result" >&2
+    return 1
+  }
+  if printf '%s' "$result" | grep -Eq '"status": *"skipped"'; then
+    echo "oat: warning: project log disabled (workflow.projectLog=false); learning $source not recorded" >&2
+  fi
 }
-if [ "$PROJECT_SCOPE" = "synced" ]; then
-  oat project push "$PROJECT_PATH" --message "chore(oat): update autonomous execution learnings" || { echo "oat: project push failed; run oat project pull, resolve the reported state, and retry" >&2; exit 1; }
-else
-  OWNED_COMMIT_PATHS=("$PROJECT_PATH/oat-execution-learnings.md")
-  oat internal commit-paths --identity "${COMMIT_IDENTITY:?set once and retain for retries}:oat-project-autonomous:2" --message "chore(oat): update autonomous execution learnings" -- "${OWNED_COMMIT_PATHS[@]}" || exit 1
+```
+
+Set `LEARNING_ORIGIN=oat-project-autonomous`. The category is preserved
+verbatim in the entry's `**Category:**` head and maps to the judgment type:
+`gotcha` and `environment-limited` → `friction`; `efficiency` and
+`candidate-skill-content` → `worked-well`; `documentation-gap` and `decision`
+→ `feedback`.
+
+Call the write unconditionally; do not read `workflow.projectLog` yourself.
+The append consults that flag only while `project-log.md` does not exist: with
+the log disabled (`workflow.projectLog: false`) and absent, it creates nothing
+and reports `status: skipped` (`reason: projectLog=false`), the write prints
+its one warning line, records nothing, and the run continues. An existing
+`project-log.md` keeps accepting categorized learnings whatever the flag says
+(`DR-260718-automatic-create-on-first`). Disabling the log stops its creation;
+do not persist the learning anywhere else.
+
+Assign the source id before each write and pass that variable, so the commit
+below carries the id just written (`$RUN_ID` is this run's id; `NN` numbers the
+observation and is retained for retries):
+
+```bash
+LEARNING_SOURCE="autonomous-$RUN_ID-NN"
+oat_record_learning <category> "$LEARNING_SOURCE" "<title>" "<body>"
+```
+
+After every write, persist the log before continuing:
+
+```bash
+if [ -f "$PROJECT_PATH/project-log.md" ]; then
+  PROJECT_SCOPE=$(oat project scope "$PROJECT_PATH" --format value) || {
+    echo "oat: cannot resolve project scope for $PROJECT_PATH; refusing to commit artifacts" >&2
+    exit 1
+  }
+  if [ "$PROJECT_SCOPE" = "synced" ]; then
+    oat project push "$PROJECT_PATH" --message "chore(oat): record autonomous execution learning" || { echo "oat: project push failed; run oat project pull, resolve the reported state, and retry" >&2; exit 1; }
+  else
+    OWNED_COMMIT_PATHS=("$PROJECT_PATH/project-log.md")
+    oat internal commit-paths --identity "${COMMIT_IDENTITY:?set once and retain for retries}:oat-project-autonomous:learning:${LEARNING_SOURCE:?set to the source id just written}" --message "chore(oat): record autonomous execution learning" -- "${OWNED_COMMIT_PATHS[@]}" || exit 1
+  fi
 fi
 ```
 
+`LEARNING_SOURCE` is the source id just written, so each learning commits
+under its own operation identity; an unset id stops the commit rather than
+sharing one identity across learnings.
+
 ### Step 5: Invoke Lifecycle Skills and Reviews
 
 Invoke each lifecycle skill by name and let it own its complete workflow,
@@ -582,7 +643,7 @@ Take this goal from discovery to PR with OAT autonomy: add resumable exports.
 Do not create or normalize project artifacts by hand.
 
 **A lifecycle skill asks an unmapped question:** Treat it as an
-`inventory-gap` boundary, record the exact site in the learnings log, and stop
+`inventory-gap` boundary, record the exact site as a learning (Step 4), and stop
 resumably.
 
 **A review launch fails after acceptance:** Continue or retry only through the
@@ -607,4 +668,5 @@ reconciliation path. Do not guess or overwrite the tracker.
   resumable boundary.
 - ✅ Phase-boundary commits and non-force pushes are recorded.
 - ✅ The run ended with a final PR report or a structured blocker report.
-- ✅ The learnings log contains reusable, secret-free entries.
+- ✅ Learnings are reusable, secret-free, category-bearing project-log entries,
+  or the run reported that the disabled, absent log recorded none.

package/assets/skills/oat-project-autonomous/references/gate-inventory.md

@@ -324,7 +324,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-project-summary/SKILL.md`                                             | `68c197c44c18 -> NG`; `a8983fec040c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `f3e49b727752 -> NG`; `f979b2342d28 -> NG`; `803bf40ec423 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG`; `5f315ab87cb1 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | `oat-project-pr-final/SKILL.md`                                            | `601ac2b890f2 -> NG`; `c264a64398f0 -> NG`; `9efcbcee42ea -> NG`; `655d61df0a8f -> NG`; `cf317c17c586 -> PRFINAL-01`; `2de348a391c0 -> PRFINAL-03`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | `oat-project-pr-final/references/docs/autonomy-contract.md`                | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| `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`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `oat-project-complete/SKILL.md`                                            | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `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`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | `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`; `e3c08ecdab17 -> REVIEWPROVIDE-06`; `1bee61f8531c -> REVIEWPROVIDE-07`; `3d35091607a1 -> REVIEWPROVIDE-08`; `fb40c4341c4c -> NG`; `b22d16885150 -> NG`; `d2b25906242e -> REVIEWPROVIDE-08`; `fd8ebf72b3c4 -> NG`; `79c8103e8656 -> NG`; `4fbd78337e33 -> NG`; `c3d50ea7cf69 -> NG`; `09b1b8dd445c -> NG`; `7acc8f3718d2 -> REVIEWPROVIDE-09`; `b2fa883fc4a2 -> NG`; `fe4421531b4c -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `oat-project-review-receive/SKILL.md`                                      | `9b8a3743d626 -> NG`; `49ed2780983b -> NG`; `4ee8730382d3 -> NG`; `655d61df0a8f -> NG`; `765f897d67ac -> NG`; `53b58d16dd32 -> NG`; `fb8755a3bdf4 -> NG`; `1d710fb4cc66 -> NG`; `1f7dd98dff2f -> NG`; `56f78c6740e6 -> NG`; `76f5fb5a88cd -> NG`; `085abfa3599f -> REVIEWRECEIVE-01`; `92578f7df686 -> NG`; `a7d114059bb6 -> NG`; `ac88cfaa83d9 -> NG`; `594bbf70346c -> REVIEWRECEIVE-08`; `f31f07284718 -> REVIEWRECEIVE-02`; `e4c0625439f8 -> REVIEWRECEIVE-04`; `505ad8389c0a -> REVIEWRECEIVE-05`; `20e05e1a4381 -> REVIEWRECEIVE-06`; `e30e06f39281 -> REVIEWRECEIVE-07`; `f8fd58180ecf -> NG`; `c3abcdc02d9f -> NG`; `f2ebdd6abb9b -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `oat-project-review-provide/SKILL.md`                                      | `2e794bf4fc4a -> REVIEWPROVIDE-08`; `5441ab977b46 -> REVIEWPROVIDE-08`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

package/assets/skills/oat-project-brief/SKILL.md

@@ -7,7 +7,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Task
 metadata:
-  version: 1.0.2
+  version: 1.0.3
 ---
 
 # Brief Project

package/assets/skills/oat-project-brief/references/brief-contract.md

@@ -206,13 +206,13 @@ unit in document order within the active scope.
 
 ## 9. Record ownership
 
-| Record                 | Owns                                                                                                                                   |
-| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `plan.md` (the brief)  | Intent: outcomes, approach, decisions, phases, review table.                                                                           |
-| `state.md`             | Routing, dispatch policy, gate overrides, and the `oat_brief_gate` record.                                                             |
-| `implementation.md`    | The per-phase journal: status, anchors, verification results, review disposition, authority changes, deviations, next action, records. |
-| `project-log.md`       | Observations and phase amendments, when the project log is enabled.                                                                    |
-| `references/research/` | Research and imported material.                                                                                                        |
+| Record                 | Owns                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `plan.md` (the brief)  | Intent: outcomes, approach, decisions, phases, review table.                                                                                                                                                                                                                                                                                                                                                                      |
+| `state.md`             | Routing, dispatch policy, gate overrides, and the `oat_brief_gate` record.                                                                                                                                                                                                                                                                                                                                                        |
+| `implementation.md`    | The per-phase journal: status, anchors, verification results, review disposition, authority changes, next action, records; fixed slots `## Orchestration Runs` (one run line per request id), `## Reviews and Gates` (multi-phase receipts, gate lines), `## Deferred Findings` (approved deferrals, excluded phases, unmerged worktrees), `## Deviations from Plan / Design` (deviations, override lines), `## References` last. |
+| `project-log.md`       | Observations and phase amendments, when the project log is enabled.                                                                                                                                                                                                                                                                                                                                                               |
+| `references/research/` | Research and imported material.                                                                                                                                                                                                                                                                                                                                                                                                   |
 
 `pr/` and archived reviews are gitignored; nothing authoritative lives only
 there.
@@ -392,20 +392,20 @@ milestone's ordered phase set.
 
 ### 12.3 Transitions and owners
 
-| From → To                              | Owner                                 | Prerequisite                                                                                                                                                                                                                                                                 |
-| -------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| new → aligning                         | `oat-project-goal`                    | scaffold rendered `oat_plan_source: goal`                                                                                                                                                                                                                                    |
-| aligning → implementing                | `oat-project-goal`                    | artifact review passed, `plan` carrier `allowed`, approval, and the next phase and every member of the next dispatched group concrete                                                                                                                                        |
-| implementing → reviewing               | implement milestone closeout          | every unit in the milestone scope accepted; `exit` carrier `allowed` and fresh                                                                                                                                                                                               |
-| reviewing → delivering                 | `oat-project-review-receive`          | clean receive of the exact integrated review (`passed`) with scope, revisions and exit carrier still valid                                                                                                                                                                   |
-| reviewing → implementing               | `oat-project-review-receive`          | fixes queued from the integrated review                                                                                                                                                                                                                                      |
-| delivering → implementing              | `oat-project-review-receive`          | fixes queued from a delivery-time review                                                                                                                                                                                                                                     |
-| delivered \| delivering → implementing | `oat-project-revise`                  | inline feedback with an explicit active-milestone target; the appended `p-revN` joins the milestone row; delivery evidence invalidated (writes status and pointer)                                                                                                           |
-| delivering → reviewing                 | `oat-project-pr-progress`             | `oat project delivery refresh` reports the integrated review or `exit` carrier stale for the active milestone's delivery                                                                                                                                                     |
-| delivered → reviewing                  | `oat-project-pr-progress`             | `oat-project-goal` hands back a stale `delivered` milestone (Step 5.5 item 3a) and refresh or check reports its registered delivery's integrated review or `exit` carrier not fresh; `oat_phase_status` is left for the next activation to reset                             |
-| delivering → delivered                 | `oat-project-pr-progress`             | delivery registered, members open, review fresh; for an already-registered delivery, a deliverable check of that `dNN` (no new registration)                                                                                                                                 |
-| delivered → aligning                   | `oat-project-goal`                    | learnings captured (section 12.10) and fresh observations establish the previous delivery at its agreed endpoint; the activation that follows also writes `oat_phase_status: in_progress` and projects `oat_pr_status`/`oat_pr_url` from the latest member's observed status |
-| delivered → terminal                   | `oat-project-goal` (user declaration) | exhaustive outcome audit recorded (section 12.9)                                                                                                                                                                                                                             |
+| From → To                              | Owner                                 | Prerequisite                                                                                                                                                                                                                                                                                                                                                               |
+| -------------------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| new → aligning                         | `oat-project-goal`                    | scaffold rendered `oat_plan_source: goal`                                                                                                                                                                                                                                                                                                                                  |
+| aligning → implementing                | `oat-project-goal`                    | artifact review passed, `plan` carrier `allowed`, approval, and the next phase and every member of the next dispatched group concrete                                                                                                                                                                                                                                      |
+| implementing → reviewing               | implement milestone closeout          | every unit in the milestone scope accepted; `exit` carrier `allowed` and fresh                                                                                                                                                                                                                                                                                             |
+| reviewing → delivering                 | `oat-project-review-receive`          | clean receive of the exact integrated review (`passed`) with scope, revisions and exit carrier still valid                                                                                                                                                                                                                                                                 |
+| reviewing → implementing               | `oat-project-review-receive`          | fixes queued from the integrated review                                                                                                                                                                                                                                                                                                                                    |
+| delivering → implementing              | `oat-project-review-receive`          | fixes queued from a delivery-time review                                                                                                                                                                                                                                                                                                                                   |
+| delivered \| delivering → implementing | `oat-project-revise`                  | inline feedback with an explicit active-milestone target; the appended `p-revN` joins the milestone row; delivery evidence invalidated (writes status and pointer)                                                                                                                                                                                                         |
+| delivering → reviewing                 | `oat-project-pr-progress`             | `oat project delivery refresh` reports the integrated review or `exit` carrier stale for the active milestone's delivery                                                                                                                                                                                                                                                   |
+| delivered → reviewing                  | `oat-project-pr-progress`             | `oat-project-goal` hands back a stale `delivered` milestone (Step 5.5 item 3a) and refresh or check reports its registered delivery's integrated review or `exit` carrier not fresh; `oat_phase_status` is left for the next activation to reset                                                                                                                           |
+| delivering → delivered                 | `oat-project-pr-progress`             | delivery registered, members open, review fresh; for an already-registered delivery, a deliverable check of that `dNN` (no new registration)                                                                                                                                                                                                                               |
+| delivered → aligning                   | `oat-project-goal`                    | learnings captured (section 12.10: the categorized project-log write, or its warned attempt when the log is disabled and absent) and fresh observations establish the previous delivery at its agreed endpoint; the activation that follows also writes `oat_phase_status: in_progress` and projects `oat_pr_status`/`oat_pr_url` from the latest member's observed status |
+| delivered → terminal                   | `oat-project-goal` (user declaration) | exhaustive outcome audit recorded (section 12.9)                                                                                                                                                                                                                                                                                                                           |
 
 Review-provide records its Reviews event as `received` and never writes
 `delivering`; `fixes_completed` is not a passed review. The router reads only
@@ -726,18 +726,24 @@ review, the next milestone's `plan` carrier, one approval), and activates only
 once the previous delivery is observed at its agreed endpoint.
 
 **Learnings captured** (the `delivered → aligning` prerequisite) is a concrete
-write, not a reflection: one judgment entry (`worked-well` or `friction`)
-through `oat project log append` when the project log is enabled; otherwise a
-dated entry in the project's `oat-execution-learnings.md`
-(created when absent, append-only).
+write, not a reflection: at least one category-bearing judgment entry through
+`oat project log append` with `--category`, a stable per-observation
+`--source` reused as `--idempotency-key`, and `--origin oat-project-goal`
+(the goal skill's learning write). The append consults `workflow.projectLog` only while `project-log.md` does
+not exist. When the project log is disabled and absent the append skips
+(`status: skipped`); the producer prints one warning line and continues, and
+the attempt satisfies the prerequisite. An existing `project-log.md` keeps
+accepting the write whatever the flag says
+(`DR-260718-automatic-create-on-first`). No producer creates
+`oat-execution-learnings.md`.
 
 **Structural log entries.** `oat-project-goal` appends exactly one structural
 entry with `oat project log append --structural --producer oat-project-goal
 --ref mNN` at each milestone activation and one at each re-alignment entry.
 The delivery registration owners append one per registration (section 12.7
 owners: `--producer oat-project-pr-progress --ref dNN` or
-`--producer oat-project-pr-final --ref dNN`). Skills never pre-check log
-configuration: the helper no-ops when logging is disabled.
+`--producer oat-project-pr-final --ref dNN`). Skills do not read `workflow.projectLog` themselves: the append creates no
+log while it is disabled, and an existing log keeps accepting entries.
 
 ### 12.11 Extraction
 

package/assets/skills/oat-project-brief/references/docs/autonomy-contract.md

@@ -324,7 +324,7 @@ remains immutable baseline evidence for the original p01-t01 verification.
 | `oat-project-summary/SKILL.md`                                             | `68c197c44c18 -> NG`; `a8983fec040c -> NG`; `a167d03559fa -> NG`; `cf317c17c586 -> SUMMARY-01`; `f3e49b727752 -> NG`; `f979b2342d28 -> NG`; `803bf40ec423 -> NG`; `c8fced47ef8e -> NG`; `d7ea1e2a4f5f -> NG`; `5f315ab87cb1 -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | `oat-project-pr-final/SKILL.md`                                            | `601ac2b890f2 -> NG`; `c264a64398f0 -> NG`; `9efcbcee42ea -> NG`; `655d61df0a8f -> NG`; `cf317c17c586 -> PRFINAL-01`; `2de348a391c0 -> PRFINAL-03`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | `oat-project-pr-final/references/docs/autonomy-contract.md`                | `* -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| `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`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `oat-project-complete/SKILL.md`                                            | `6ed459f9e462 -> NG`; `a167d03559fa -> NG`; `79c2eeed668c -> COMPLETE-01`; `2c1514b9d9af -> COMPLETE-01`; `31c750b4fea7 -> COMPLETE-01`; `cfba413b1293 -> COMPLETE-01`; `7fcfce0423ac -> COMPLETE-01`; `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`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | `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`; `e3c08ecdab17 -> REVIEWPROVIDE-06`; `1bee61f8531c -> REVIEWPROVIDE-07`; `3d35091607a1 -> REVIEWPROVIDE-08`; `fb40c4341c4c -> NG`; `b22d16885150 -> NG`; `d2b25906242e -> REVIEWPROVIDE-08`; `fd8ebf72b3c4 -> NG`; `79c8103e8656 -> NG`; `4fbd78337e33 -> NG`; `c3d50ea7cf69 -> NG`; `09b1b8dd445c -> NG`; `7acc8f3718d2 -> REVIEWPROVIDE-09`; `b2fa883fc4a2 -> NG`; `fe4421531b4c -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `oat-project-review-receive/SKILL.md`                                      | `9b8a3743d626 -> NG`; `49ed2780983b -> NG`; `4ee8730382d3 -> NG`; `655d61df0a8f -> NG`; `765f897d67ac -> NG`; `53b58d16dd32 -> NG`; `fb8755a3bdf4 -> NG`; `1d710fb4cc66 -> NG`; `1f7dd98dff2f -> NG`; `56f78c6740e6 -> NG`; `76f5fb5a88cd -> NG`; `085abfa3599f -> REVIEWRECEIVE-01`; `92578f7df686 -> NG`; `a7d114059bb6 -> NG`; `ac88cfaa83d9 -> NG`; `594bbf70346c -> REVIEWRECEIVE-08`; `f31f07284718 -> REVIEWRECEIVE-02`; `e4c0625439f8 -> REVIEWRECEIVE-04`; `505ad8389c0a -> REVIEWRECEIVE-05`; `20e05e1a4381 -> REVIEWRECEIVE-06`; `e30e06f39281 -> REVIEWRECEIVE-07`; `f8fd58180ecf -> NG`; `c3abcdc02d9f -> NG`; `f2ebdd6abb9b -> NG`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `oat-project-review-provide/SKILL.md`                                      | `2e794bf4fc4a -> REVIEWPROVIDE-08`; `5441ab977b46 -> REVIEWPROVIDE-08`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |