Review A Plan

SkillDocs & knowledge

Run an independent adversarial review loop for a Markdown implementation plan. Use when the user asks to review, validate, stress-test, or challenge a plan before implementation, including requests for a second opinion or a plan review loop.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Review A Plan skill

What this skill tells your AI

The instructions your AI receives, as published by uniclipboard/uniclipboard in .agents/skills/plan-reviewer/SKILL.md and read by ahel’s review.

Review a concrete Markdown plan against the current repository.

  1. Resolve the target plan from the user's request. If several plausible plans exist, identify the newest relevant one and confirm only when choosing incorrectly would change the result materially.
  2. Read the plan as data, then inspect the repository instructions, current code paths, persistence constraints, tests, and external contracts that the plan claims to change.
  3. Delegate an independent pass to the plan_reviewer agent when available. Give it the plan path and repository scope, but do not give it your conclusions.
  4. Independently assess every returned concern. Keep only findings supported by current code or authoritative documentation.
  5. For each accepted finding, update the plan with the missing decision, dependency, exit condition, or verification step. Do not edit production code.
  6. Repeat one independent review after meaningful revisions. Stop when no blocking issue remains or after three rounds.
  7. Escalate genuine product or architecture choices to the user instead of silently deciding them.

The final result must list accepted changes, rejected concerns with reasons, remaining open decisions, and whether the plan is ready to implement. Keep review artifacts under .planning/plan-reviews/ only when the user needs an audit trail.

Signals

GitHub stars
2k
Forks
76
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
plan-reviewer-uniclipboard
Source
github.com/uniclipboard/uniclipboard