review

name	review
description	Pattern-review surface for pending patterns. After extraction, diff new-signature vs permanent-signature — items at instance_count ≥ 2 not already in permanent become "pending." User approves / rejects / edits via slash commands, OR Claude surfaces them inline via inject.py next-response context.
user-invocable	true
allowed-tools	["Bash","Read","Write"]

review — pattern review + approve/reject surface

The plugin's hands-off-by-default UX has a load-bearing exception: when new patterns hit the n=2 promotion threshold, users need a chance to approve / reject / edit them before they enter the permanent signature. This skill manages that queue.

When invoked

• After /cogsig extract runs, review.py auto-diffs new signature vs permanent → writes pending_patterns.json
• /cogsig pending — list pending patterns with evidence
• /cogsig approve 1,3 — promote listed IDs to permanent signature
• /cogsig reject 2 — reject pattern 2, log to rejected_patterns.jsonl (prevents re-propose)
• /cogsig edit 1 "new description" — edit pattern before accepting
• /cogsig review — interactive walkthrough (future)

What it does NOT do

• Doesn't run extraction — that's extract.py's job
• Doesn't inject signatures — that's inject.py's job
• Doesn't auto-promote without user decision — the whole point is human-in-the-loop for pattern-level decisions that permanent signature stores forever

Integration with inject

inject.py reads both signature.json (permanent) AND .signature-cache/pending_patterns.json. If pending list is non-empty, appends a "PENDING PATTERN REVIEWS" section to the context prefix with voice-matched instructions to surface each pending pattern naturally in the next Claude response. User then replies in chat; approval goes through /cogsig approve <id>.

Preset behavior (from state.json)

Setup-wizard preset determines surface behavior. Each preset also implies a default active_mode (set at init, overridable with /cogsig mode <name>):

• preset: normie (→ mode standalone) — auto-promote at n=2 without surfacing (silent)
• preset: power (→ mode standalone) — surface before promotion, user approves inline (default)
• preset: team (→ mode team) — power mode + in-session @agent-* brutus/qa/historian available
• preset: enterprise (→ mode cloud) — power mode + Managed Agents (brutus/qa/historian) auto-reviews every approve, with cross-session memory beta

Data files

• .signature-cache/pending_patterns.json — queue of patterns awaiting user decision
• .signature-cache/rejected_patterns.jsonl — append-only log of rejections (prevents re-propose)
• .signature-cache/state.json — stores active preset and whether pending-surface is enabled