auto-review

Auto Review — Built-in Plugin

Selection card

• Task: Operate the built-in automatic review plugin.
• Start: Identify the scope and obtain an executable before-proof or review evidence.
• Finish: apply the acceptance checks below; report observed results and unresolved constraints.

Overview

The wstack-auto-review plugin (built into @wrongstack/core) detects every git-tracked file change during a session and automatically dispatches a review subagent after a trailing file-quiet window. It extends the Chimera review pipeline with mid-session reviews while leaving any work still waiting at session.ended to the post-session Chimera path.

iteration.completed → git diff → trailing quiet window → chimera.review_needed event
                                                   ↓
                                    Director spawns review subagent
                                    (provider/model from config)
                                                  ↓
                                    Severity-ranked report → store + mailbox
                                                  ↓
                                    chimera.review_complete event
                                                  ↓
                                    chimera.report_available notification
                                                  ↓
                                    stop (with cascadeOn set: follow-up fix agents)

Status

This is a built-in plugin (packages/core/src/plugins/auto-review-plugin.ts), NOT a skill-based watcher. It is loaded automatically and enabled by default. Optional overrides in your config:

{
  "extensions": {
    "wstack-auto-review": {
      "provider": "deepseek",
      "model": "deepseek-chat",
      "fallbackProfile": "reliable",
      "modelSelection": "round-robin",
      "debounceMs": 15000,
      "maxFilesPerBatch": 15
    }
  }
}

Requirements

• --director flag (Director mode) — the subagent spawning pipeline (execution.ts) requires the Director to be active. Without it, review events are silently skipped.
• git available in the session working directory.