peruse

Peruse — plan-vehicle review pipeline

This skill is the plan-vehicle counterpart of Phase 5 in /mumei:compose. It runs only against plan-vehicle features (state.json under .mumei/plans/<slug>/). For spec-vehicle review, use /mumei:compose (which drives the same pipeline as part of its lifecycle).

When to use

• After completing all TaskCreate/TaskCompleted work in a Claude plan-mode session, when pending_review=true is set in .mumei/plans/<slug>/state.json.
• The Stop hook (L-R1) and the git push PreBash hook (L-R2) will block session-end / push until a passing review JSON exists.

When NOT to use

• For spec-vehicle features (run /mumei:compose instead).
• Before all planned tasks have been marked completed (the skill aborts with a hint message).
• For projects without an active mumei feature.

Method

All steps below assume the current working directory is the project root and a git repo. The skill is conservative: it never edits source files, never spawns commits, and never auto-archives.

Step 1 — Resolve active feature and refuse non-plan-vehicle invocations

source "${CLAUDE_PLUGIN_ROOT}/hooks/_lib/state.sh"
source "${CLAUDE_PLUGIN_ROOT}/hooks/_lib/review.sh"
source "${CLAUDE_PLUGIN_ROOT}/hooks/_lib/ledger.sh"
source "${CLAUDE_PLUGIN_ROOT}/hooks/_lib/residual.sh"
source "${CLAUDE_PLUGIN_ROOT}/hooks/_lib/cost-log.sh"

slug="$(mumei_current_feature 2>/dev/null || true)"
if [[ -z "$slug" ]]; then
  echo "no active mumei feature (.mumei/current is empty); aborting" >&2
  exit 0
fi

if ! mumei_state_is_plan_vehicle "$slug"; then
  echo "/mumei:peruse is plan-vehicle only. Active feature '${slug}' is a spec-vehicle feature; use /mumei:compose to drive its review (Phase 5)." >&2
  exit 0
fi

review_dir=".mumei/plans/${slug}/reviews"
state_path=".mumei/plans/${slug}/state.json"