AI Session Watch Sweep

Session-Watch Sweep

Consolidates the session-watch observation backlog on demand — runs /ai-session-watch --review, gates the result, and opens a draft chore PR for human review. Use it to clear accumulated corrections; it never auto-merges, auto-files work items, or runs unattended.

Purpose

The session-watch corrections loop consolidates only when a human runs /ai-session-watch --review — no reliable trigger, so operator corrections accumulate unconsolidated (spec-165). This is a manual wrapper: run the review, gate the result, open a draft chore PR so a human reviews consolidated lessons before merge (keeps consolidation off feature branches). No scheduler — an operator runs it; the SessionStart observation-nudge (spec-165 D-165-03) surfaces the pending backlog.

Hard Rules

• Never auto-merge — the PR is always --draft.
• Never auto-file work items — run --review's extract → enrich → write steps only; the human decides what becomes an issue from the PR (spec-165 D-165-04). Unattended issue filing is forbidden.
• No corpus change → exit cleanly with a status event; never open an empty PR.

Process

Step 1 — Run the review (work-item creation suppressed). Invoke /ai-session-watch --review, running only steps 1-3 (extract → enrich → write) plus the lastReviewedAt stamp; SKIP step 5 (create work items) — D-165-04. If observations.yml is unchanged after the review, emit a framework_operation event with operation=session_watch_sweep_no_op and exit 0.

Step 2 — Gate the diff. If the corpus changed, run the standard pre-commit gate locally:

ai-eng gate run --cache-aware --json --mode=local

On failure, emit operation=session_watch_sweep_gate_failed with the failure summary and exit 1 — never open a PR with a broken corpus.

Step 3 — Commit + open draft chore PR.

/ai-commit "chore(session-watch-sweep): observation consolidation"
/ai-pr --draft --title "chore(session-watch-sweep): observation consolidation" --body "Manual session-watch consolidation. Review the consolidated corrections before merge. No work items were auto-filed (spec-165 D-165-04) — file any that warrant tracking."

The PR commits observations.yml (the tracked corpus). meta.json and observation-events.ndjson are gitignored and stay out of the PR.

Telemetry

Each run emits one framework_operation event:

Common Mistakes

• Running more frequently than weekly — sub-weekly runs flood reviewers with noisy PRs (auto-merge and auto-file are already barred by Hard Rules; D-164 board-spam risk).

Examples

User: "run the weekly observation sweep on this repo"

/ai-session-watch-sweep

Runs /ai-session-watch --review (work-items suppressed), gates the corpus change, and opens a draft PR titled chore(session-watch-sweep): observation consolidation. Add --dry-run to print the consolidated corpus diff without staging a commit or PR — a scope preview before a full run.

Integration

Called by: operator manually (or surfaced by the SessionStart observation-nudge). Calls: /ai-session-watch --review (work-items suppressed), /ai-commit, /ai-pr --draft. See also: /ai-simplify-sweep (the sibling manual sweep this mirrors), /ai-session-watch (interactive review).

• Telemetry: framework_operation events aggregated from framework-events.ndjson.

References

• Related: .claude/skills/ai-session-watch/SKILL.md, .claude/skills/ai-simplify-sweep/SKILL.md
• Manifest entry: .ai-engineering/manifest.yml skills.registry.ai-session-watch-sweep