@open-agent-toolkit/cli 0.3.21 → 0.3.23

package/assets/skills/oat-project-quick-start/SKILL.md

@@ -7,7 +7,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Task
 metadata:
-  version: 2.3.21
+  version: 2.3.22
 ---
 
 # Quick Start Project

package/assets/skills/oat-project-quick-start/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`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

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

@@ -5,7 +5,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
 metadata:
-  version: 1.0.6
+  version: 1.0.7
 ---
 
 # Reconcile Manual Implementation
@@ -737,34 +737,28 @@ oat_project_state_updated: '{ISO 8601 UTC timestamp}'
 # may advance to complete after the final review passes.
 ```
 
-**5f. Append to Implementation Log:**
+**5f. Record the reconciliation session:**
 
-Add a reconciliation session entry to the `## Implementation Log` section:
+Write the reconciliation entry into the owning phase section of
+`implementation.md` (the phase whose task blocks 5d updated), after that
+phase's task blocks and before the next `##` heading. When no single phase
+owns it (unplanned work across phases, or no reconciled task), write it under
+`## Deviations from Plan / Design` instead. Never append it after
+`## References`.
 
 ```markdown
-### {today's date}
-
-**Session Start:** reconciliation
+### Reconciliation — {today's date}
 
 {For each reconciled task:}
 
-- [x] {task_id}: {task_name} - {sha} (reconciled, confidence: {level})
+- {task_id}: {task_name} - {sha} (reconciled, confidence: {level})
 
 {For each unplanned entry:}
 
-- [x] unplanned: {summary} - {sha}
-
-**What changed (high level):**
-
-- Reconciled {N} manually-implemented tasks from {M} commits
-- Logged {K} unplanned work entries
-
-**Decisions:**
-
-- Mapping confidence breakdown: {high_count} high, {medium_count} medium, {low_count} low
-- Skipped commits: {skip_count}
+- unplanned: {summary} - {sha}
 
-**Session End:** reconciliation complete
+- Reconciled {N} manually-implemented tasks from {M} commits; logged {K} unplanned work entries.
+- Mapping confidence: {high_count} high, {medium_count} medium, {low_count} low; skipped commits: {skip_count}.
 ```
 
 ### Step 6: Commit and Report

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

@@ -5,7 +5,7 @@ disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Bash(jq:*), Bash(mkdir:*), Bash(pnpm:*), Bash(oat config:*), Bash(oat decision:*), Bash(oat project log:*), Bash(oat project push:*), Bash(oat project scope:*), Bash(oat template:*), Bash(oat tools:*), Glob, Grep, AskUserQuestion
 metadata:
-  version: 1.0.9
+  version: 1.0.10
 ---
 
 # Project Retrospective
@@ -88,7 +88,10 @@ The output is always:
 ### Step 2: Inventory Evidence Honestly
 
 Follow the reading order and environment detection in
-[references/evidence-and-lanes.md](references/evidence-and-lanes.md).
+[references/evidence-and-lanes.md](references/evidence-and-lanes.md): the
+unified project log (including its category-bearing learnings) first, the
+legacy `oat-execution-learnings.md` second, then lifecycle artifacts and
+session evidence. Evidence order and evidence-strength rules are unchanged.
 
 Create an inventory before synthesis. Record every source in
 `oat_retro_evidence_sources` with `status: used | unavailable`; name unavailable

package/assets/skills/oat-project-retro/references/evidence-and-lanes.md

@@ -5,9 +5,15 @@
 Inventory and read available evidence in this order:
 
 1. `project-log.md` — always check first; use its append-only entries as
-   workflow evidence.
-2. `oat-execution-learnings.md` — when present, extract observations, impact,
-   and recommendations without treating them as already proven.
+   workflow evidence. Judgment entries whose body opens with a `**Category:**`
+   head are the unified learnings: extract their observation, impact,
+   recommendation and uncertainty without treating them as already proven.
+2. `oat-execution-learnings.md` — the legacy learnings file, read second when
+   present, with the same treatment. Skip a legacy entry only when it is a
+   proven twin of a unified entry (same `**Recorded:**` timestamp, category and
+   title, each exactly); keep a distinct lesson that only shares a title. Its
+   absence is recorded as `oat-execution-learnings: unavailable`, which is the
+   normal state for projects whose learnings live in the log.
 3. Lifecycle artifacts — at minimum `implementation.md`, `state.md`, and
    `plan.md`; also read load-bearing `discovery.md`, `design.md`, `spec.md`,
    reviews, references, and evidence ledgers when present.

package/assets/skills/oat-project-review-provide/SKILL.md

@@ -5,7 +5,7 @@ disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Glob, Grep, Write, Edit, Bash(git:*), Bash(oat:*), Bash(pnpm:*), Bash(mkdir:*), Bash(date:*), Bash(realpath:*), Bash(awk:*), AskUserQuestion
 metadata:
-  version: 1.5.15
+  version: 1.5.16
 ---
 
 # Request Review
@@ -902,8 +902,8 @@ If `review type == code` and `scope == final`, gather unresolved deferred findin
 
 Preferred sources:
 
-- `implementation.md` sections titled `Deferred Findings (...)`
-- prior review artifacts under `reviews/archived/` when implementation notes are incomplete (plus the current active review file in `reviews/`, if one exists for the in-flight cycle)
+- the lines under `implementation.md`'s `## Deferred Findings` section (older journals: sections titled `Deferred Findings (...)`)
+- prior review artifacts under `reviews/archived/` when implementation notes are incomplete and the files are still on this machine (plus the current active review file in `reviews/`, if one exists for the in-flight cycle); review files are local-only, so a missing one is never a finding
 
 Build:
 
@@ -916,6 +916,29 @@ Rules:
 - Include this ledger in review metadata so final review explicitly re-evaluates carry-forward debt.
 - Final review should call out whether each deferred Medium remains acceptable or should now be fixed.
 
+### Step 4.6: Journal Check for the Review Scope (Code Reviews)
+
+For a `code` review whose scope resolves to phases, run the read-only journal
+check with that explicit phase scope (`pNN-pMM` expands to every phase in the
+range; `final` passes every phase the plan declares):
+
+```bash
+JOURNAL_CHECK_JSON=$(oat project journal check --project "$PROJECT_PATH" --at review --scope "{comma-separated phase ids}" --json) || true
+```
+
+The review boundary ignores future phases and only warns for live run lines.
+Put each refused reason (`code`, `path:line`, `owner`) in the Review Scope under
+`**Journal check:**` so the reviewer reports the evidence defects among them
+(a missing or duplicate task block, missing commit evidence, a pasted dispatch
+payload, a misplaced receipt or deferral).
+
+**Refresh-only findings are not tasks.** A finding that a mechanical pointer or
+projection refresh resolves (stale Progress Overview totals, a run line that
+needs re-rendering, a phase status line or resume pointer that lags the
+recorded evidence) is reported as a refresh-only note owned by closeout's
+refresh, never as a fix task. Substantive evidence corrections and accepted
+design changes remain traceable fix tasks with commits.
+
 ### Step 5: Prepare Review Metadata Block
 
 Build the "Review Scope" metadata for the reviewer:
@@ -939,6 +962,8 @@ Build the "Review Scope" metadata for the reviewer:
 - Discovery: {PROJECT_PATH}/discovery.md
 - Imported Plan Reference: {PROJECT_PATH}/references/imported-plan.md (optional; import mode)
 
+**Journal check (code review only):** {status and each refused reason from Step 4.6, or "ok"}
+
 **Tasks in Scope (code review only):** {task IDs from plan.md matching scope; in brief modes, the execution-record IDs under the phases in scope in implementation.md, which label commits and never narrow the range}
 
 **Files Changed ({FILE_COUNT}):**

package/assets/skills/oat-project-review-receive/SKILL.md

@@ -5,7 +5,7 @@ disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Bash(oat:*), Glob, Grep, AskUserQuestion, Task
 metadata:
-  version: 1.6.11
+  version: 1.6.12
 ---
 
 # Receive Review
@@ -365,7 +365,7 @@ Read `oat_review_type` and `oat_review_invocation` from review artifact frontmat
   - **Judgment-sweep mode.** The phase gate already passed at its `exit_nonzero_on` threshold, so the phase does not stop. Consume the artifact anyway, so its sub-threshold findings become durable, ordered dispositions in `implementation.md` instead of evaporating. Fully non-pausing; no user prompts.
     - The gate verdict decided whether the phase stops; it did **not** decide whether Medium/Low findings are ignored. There are, by definition, no unresolved Critical/High findings in a passing gate (if there were, the gate would have blocked).
     - Make a per-finding **judgment call** for each Medium/Low — do not mechanically dump them all:
-      - **Defer to final** (default): record under "Deferred Findings" (Mediums under "Deferred Findings (Medium)" so Step 8.5 resurfacing picks them up) with concrete rationale.
+      - **Defer to final** (default): record one line under the journal's `## Deferred Findings` section (Mediums tagged `Medium` so Step 8.5 resurfacing picks them up) with the finding ID and substance and concrete rationale.
       - **Address now:** only for small, contained, low-risk fixes. Apply the fix, commit it with the phase bookkeeping, and record the disposition. Do **not** re-run the standard reviewer or re-gate the phase for address-now fixes.
       - **Reject** as false-positive / out-of-scope, with concrete rationale.
     - `address now` is an **exception, not the norm** — when in doubt, defer. Do not let a passing gate drift into behaving like a Medium-blocking gate by habit.
@@ -662,34 +662,48 @@ moves to `passed`, citing the revision review in the implementation note.
 
 ### Step 7: Update Implementation.md
 
-Add a note to implementation.md:
+Write one receipt per received review. Placement is fixed:
+
+- a phase-scoped review (`pNN`): inside that phase's section of
+  `implementation.md`, after its task blocks and before the next `##` heading;
+- a revision-phase review (`p-revN`): inside the `## Phase p-revN` section that
+  `oat-project-revise` creates (never in the phase it corrects), or under
+  `## Reviews and Gates`;
+- a task-scoped review (`pNN-tNN`, `prevN-tNN`): inside that task's phase
+  section, after its task blocks;
+- a final, multi-phase (`pNN-pMM`), milestone or spec/design/plan review: under
+  `## Reviews and Gates`;
+- never after `## References`, which stays the journal's last section.
+
+The receipt carries everything a reader needs without the review file, which
+is a local-only citation (reviews are not archived, so an unresolved review
+path is never a completion defect):
 
 ```markdown
 ### Review Received: {scope}
 
 **Date:** {today}
-**Review artifact:** reviews/archived/$REVIEW_FILENAME
-
-**Findings:**
+**Review artifact (local-only):** reviews/archived/$REVIEW_FILENAME
 
-- Critical: {N}
-- High: {N}
-- Medium: {N}
-- Low: {N}
+**Findings:** Critical {N} · High {N} · Medium {N} · Low {N}
 
-**New tasks added:** {task_ids}
+- {finding_id} ({severity}): {one-line substance} → {disposition: fix task {task_id} | approved deferral (see Deferred Findings) | rejected | accepted drift}; {rationale}
 
 **Design drift / artifact alignment notes:**
 
 - {finding_id}: {review found stale design/spec/plan relative to shipped implementation; why the implementation is accepted; source of truth; artifact-alignment task ID or explicit deferral}
 
-**Next:** Execute fix tasks via the `oat-project-implement` skill.
+**Outcome:** {fixes queued: {task_ids} | passed | deferred items only}
+```
+
+Each approved deferral is also one line under `## Deferred Findings`, and each
+fix task is a plan task whose journal block lands in its phase as usual.
 
 After the fix tasks are complete:
 
 - Update this same artifact-identified review event to `fixes_completed`
 - Re-run `oat-project-review-provide {type} {scope}` then `oat-project-review-receive` to reach `passed`
-```
+- Update the receipt's **Outcome** line in place when the re-review passes
 
 **Restart safety (required):**
 
@@ -699,7 +713,7 @@ After the fix tasks are complete:
   - If any finding is resolved by accepting the shipped implementation and aligning stale artifacts instead of changing code, add an explicit review note under the current "Review Received" section and update `## Deviations from Plan / Design` when that table exists.
     - For existing project artifacts, treat any `## Deviations...` heading as the deviations section; migrate to the preferred `## Deviations from Plan / Design` heading and table shape when already touching the section.
     - The note must say the review found design/spec/plan drift, why the shipped implementation is accepted, which source is now authoritative, and which artifact-alignment task will update the stale artifact.
-    - If the artifact update is intentionally deferred, record the deferral rationale and follow-up trigger in `implementation.md`.
+    - If the artifact update is intentionally deferred, record the deferral rationale and follow-up trigger as a line under `## Deferred Findings` in `implementation.md`.
   - Update `{PROJECT_PATH}/state.md` frontmatter so routing/UI is accurate:
     - `oat_phase: implement`
     - `oat_phase_status: in_progress`
@@ -786,7 +800,7 @@ Before showing the menu, dispatch the complexity review that
 `references/docs/complexity-review-fallback.md` defines for this scope's
 exhausted loop, then show its decision message with the menu below; under
 `OAT_AUTONOMOUS=1`, put the same content in the boundary report instead.
-Record the operator's choice with the report path in `implementation.md`.
+Record the operator's choice with the report path as one line under `## Reviews and Gates` in `implementation.md`.
 Agents never select the disposition. The loop history in the brief includes
 this scope's gate-originated artifacts even though the count excludes them. To
 launch the review, load the current `oat-project-dispatch-subagents/SKILL.md`
@@ -818,7 +832,7 @@ Choose an option:
 
 If `scope == final`, resurface previously deferred Medium findings from prior review cycles before marking final as `passed`.
 
-- Source of truth: `implementation.md` review notes ("Deferred Findings"), plus prior review artifacts in `reviews/archived/` (and any still-active top-level `reviews/` file for the current cycle).
+- Source of truth: the `## Deferred Findings` lines in `implementation.md` (older journals: review notes headed "Deferred Findings"), plus prior review artifacts in `reviews/archived/` when they are still on this machine (and any still-active top-level `reviews/` file for the current cycle). Review files are local-only: the journal line must stand without them.
 - Build a "Deferred Medium Ledger" with each item and current disposition state.
 
 Ask user to decide each deferred Medium:
@@ -830,7 +844,7 @@ Rules:
 
 - Do not silently keep deferred Mediums in final scope.
 - If any deferred Medium remains undecided, final review cannot be marked `passed`.
-- Record user decisions + rationale in `implementation.md` under the final review notes.
+- Record user decisions + rationale on each item's `## Deferred Findings` line, and the summary in the final receipt under `## Reviews and Gates`.
 
 ### Step 9: Handle Medium Deferral Requests and Low Findings
 
@@ -842,7 +856,7 @@ If any Medium is proposed for deferral:
 
 - Ask user explicitly for approval per finding.
 - If user declines deferral, convert that Medium to a fix task now.
-- If user approves deferral, record rationale in `implementation.md` under "Deferred Findings (Medium)".
+- If user approves deferral, record one line under `## Deferred Findings` in `implementation.md`: severity `Medium`, finding ID and substance, rationale, who approved, and the follow-up trigger.
 
 Design drift handling applies before Medium/Low convenience deferrals:
 

package/assets/skills/oat-project-review-receive-remote/SKILL.md

@@ -5,7 +5,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
 metadata:
-  version: 1.5.4
+  version: 1.5.5
 ---
 
 # Project Remote Review Receive
@@ -249,12 +249,16 @@ Update `plan.md`:
 
 Update `implementation.md`:
 
-- Add "Remote Review Received" section with:
-  - date
-  - PR number
+- Add a `### Remote Review Received: PR #<N>` receipt under `## Reviews and Gates`
+  (never after `## References`) with:
+  - date and PR number (the PR comments are the citation; nothing local is
+    required to read the receipt)
   - severity counts
-  - new task IDs
-  - deferred/dismissed notes
+  - one line per finding: identity (comment author and anchor) and one-line
+    substance, disposition and rationale, and the fix task ID or approved
+    deferral it links to
+  - final outcome (fixes queued, dismissed, or passed)
+- Write each approved deferral as one line under `## Deferred Findings`.
 - Set `oat_current_task_id` to first new review-fix task ID when tasks were added.
 - If no new tasks: keep current task pointer unchanged or set `null` if all work is complete.
 

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

@@ -5,7 +5,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
 metadata:
-  version: 1.0.7
+  version: 1.0.8
 ---
 
 # Project Revise
@@ -257,13 +257,20 @@ Update frontmatter to point at the first revision task so `oat-project-implement
 
 Update the Progress Overview table to include the new revision phase (e.g., add a `Phase p-rev{N}` row with task count and `in_progress` status).
 
+In task modes add a `## Phase p-rev{N}: Revision {N}` section after the last
+phase section (before `## Orchestration Runs`) with `**Status:** in_progress`
+and one `### Task prev{N}-tNN:` block per revision task (`**Status:** pending`,
+`**Commit:** -`), so every revision task has its block in its own phase.
+
 In brief modes point the journal at the phase instead of a task: set
 `oat_current_task_id: p-rev{N}`, add a `## Phase p-rev{N}: Revision {N}`
 section after the last phase section with `**Status:** pending` directly under
 the heading (the root writes `**Base:**` when the phase starts), and add a
 `p-rev{N}` Progress Overview row with one unit, `0/1` accepted.
 
-Add a "Revision Received" entry:
+Add a "Revision Received" entry inside the new revision phase's section, after
+its status line (brief: after its markers) and before its first task block;
+never after `## References`:
 
 ```markdown
 ### Revision Received: Inline Feedback