proposal-reviewer

Audit final plans against the codebase for correctness and regressions.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/SirTheOracle/forge-toolkit --skill proposal-reviewer-sirtheoracle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proposal-reviewer
Source: https://github.com/SirTheOracle/forge-toolkit/tree/main/codex-skills/proposal-reviewer
Command: npx skills add https://github.com/SirTheOracle/forge-toolkit --skill proposal-reviewer-sirtheoracle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Independent review skill for critiquing a final-plan produced by the adversarial proposal framework. Performs a fresh pass over the problem statement, relevant code, and final plan to find incorrect root-cause assumptions, missing steps, hidden regressions, rollout gaps, and weak tests before implementation begins. Use this skill after adversarial-proposal, when the user wants an independent plan review, or when pointed at a proposals directory or final-plan.md.

Core Features & Use Cases

  • Fresh, independent critique of final plans against the codebase
  • Identifies root-cause gaps, missing steps, and regressions
  • Produces actionable guidance and a final review document

Quick Start

Point the skill at a proposals directory or a final-plan.md path to generate a review-codex.md after validating the plan against the code.

Frequently Asked Questions about proposal-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a final-plan.md against my codebase for missed root causes?

A proposal review audits your final plan against actual code to catch missed root causes and hidden regressions. It performs a fresh, independent critique of the problem statement and implementation steps to verify correctness before you proceed with development.

How do I validate testing coverage and rollout steps before implementing a proposal?

You validate testing coverage by pointing an independent critique process at your proposals directory or final-plan.md path. It verifies the implementation steps, testing coverage, and documentation against the actual codebase to produce actionable guidance and a final review document.

Does proposal review work without a specific proposals directory structure?

Yes, proposal review works by pointing directly at a specific file path like final-plan.md. You do not need a complex proposals directory structure; the skill performs an independent critique against the codebase as long as the final plan document is accessible.

What is the best way to find incorrect root-cause assumptions in a code review plan?

The best way to find incorrect root-cause assumptions is to run an independent critique of the final plan against the actual codebase. This validates root-cause accuracy and identifies missing steps or hidden regressions before you proceed with implementation.

When should I not use an independent plan critique for code implementation?

You should not use an independent plan critique if you lack a finalized final-plan.md or comparable proposals directory. The skill requires a completed plan to audit for root-cause accuracy, implementation steps, and testing coverage against the actual codebase.