ai-session-watch-sweep

name	ai-session-watch-sweep
description	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. Trigger for 'run the observation sweep', 'consolidate observations', 'session-watch sweep'. Never auto-merges, never auto-files work items, never runs unattended. Not for interactive review; use /ai-session-watch --review instead.
effort	cheap
argument-hint	[--dry-run] [--no-pr]
tags	["meta","session-watch"]
model_tier	haiku
mirror_family	antigravity-skills
generated_by	ai-eng sync
canonical_source	.claude/skills/ai-session-watch-sweep/SKILL.md
edit_policy	generated-do-not-edit

Session-Watch Sweep

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:

operation	when
session_watch_sweep_started	at invocation
session_watch_sweep_no_op	no corpus change, no PR opened
session_watch_sweep_gate_failed	corpus changed but gate refused
session_watch_sweep_pr_opened	happy path, includes pr_url

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: .agents/skills/ai-session-watch/SKILL.md, .agents/skills/ai-simplify-sweep/SKILL.md
• Manifest entry: .ai-engineering/manifest.yml skills.registry.ai-session-watch-sweep