plan-review

Review implementation plans for conceptual drift, documentation gaps, and delivery risk.

2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/julian-pani/agconf --skill plan-review-julian-pani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/julian-pani/agconf/tree/main/.claude/skills/plan-review
Command: npx skills add https://github.com/julian-pani/agconf --skill plan-review-julian-pani

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams catch implementation problems while they are still cheap to fix, before any code is written. It is designed to spot conceptual drift, unnecessary abstractions, missing documentation work, and hidden delivery risks in a draft plan.

Core Features & Use Cases

  • Conceptual Review: Checks whether the plan fits the existing codebase and avoids introducing redundant or overlapping abstractions.
  • Documentation Impact Analysis: Identifies user-facing and agent-facing docs that need to be updated, created, or removed.
  • Completeness and Risk Review: Looks for missing requirements, edge cases, testing gaps, sequencing issues, and regression risks.
  • Use Case: A developer finishes a feature plan for a refactor or new workflow and uses this Skill to validate the approach before implementation begins.

Quick Start

Ask the plan-review skill to review the implementation plan at the provided path before any code is written.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I review an implementation plan before coding starts?

To catch plan issues before coding, you review the implementation plan text alongside related requirements and existing codebase context. This validates integrity, completeness, and implementation order to detect conceptual drift, documentation gaps, and delivery risk.

What is conceptual drift in a codebase architecture plan?

Conceptual drift occurs when an architecture plan introduces redundant or overlapping abstractions that misalign with the existing codebase. Reviewing the plan early identifies these structural inconsistencies before development begins, ensuring the proposed design fits the current system architecture.

How do I identify missing documentation in a feature proposal?

Identifying missing documentation in a feature proposal requires analyzing the plan for user-facing and agent-facing docs that need updates, creation, or removal. A documentation impact analysis catches these gaps before implementation, preventing outdated references in the codebase.

When do I need a completeness and risk review for a refactor?

You need a completeness and risk review for a refactor when the draft plan involves architecture changes or new workflows. This review identifies missing requirements, edge cases, testing gaps, sequencing issues, and regression risks while they are still cheap to fix.

Does the plan review process work without existing code context?

No, relevant code context is required to assess integrity and completeness. Reviewing implementation plans requires the plan text, related requirements, and existing codebase context to properly evaluate whether the proposed changes fit the architecture and avoid redundant abstractions.