skills.rest
mathur-exe
mathur-exeCOMMUNITY
Explore all skills by this author →
Website𝕏@gaurang__mathurGitHub

plan-review

Identify gaps between a plan and the current codebase.

Updated Sep 1, 2025
Search Tags:#codebase#alignment#quality-assurance#code-review#software-engineering#plan-review
One-click install
npx skills add https://github.com/mathur-exe/annotation-notes --skill plan-review-mathur-exe
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/mathur-exe/annotation-notes/tree/main/PaperNotes/dotfiles/codex/skills/plan-review
Command: npx skills add https://github.com/mathur-exe/annotation-notes --skill plan-review-mathur-exe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the evaluation of a plan against the current codebase to identify gaps, misalignments, and missing constraints.

Core Features & Use Cases

  • Plan-codebase alignment checks: verify that the plan references all relevant files, patterns, and constraints in the repository.
  • Scope clarity and boundary definitions: ensure the plan defines in-scope and out-of-scope elements, and avoids future-use leftovers.
  • Quality criteria: detects potential code smells or caveats, and assesses performance, security, and privacy considerations.
  • Decision gateway: recommends GREEN LIGHT only when the analysis indicates >90% satisfaction.

Quick Start

Apply the plan-review skill to the provided plan and verify its completeness against the repository.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I validate a software plan against a codebase to find gaps?▼

Plan review analyzes files, patterns, and constraints to identify misalignments. It enforces that plans reflect the codebase, avoid fallbacks and feature flags, cover full refactors, define scope clearly, and list code smells before implementation.

What is the best way to check plan completeness for a monorepo?▼

Plan completeness for multi-package repositories involves verifying references to relevant files and constraints. The analysis assesses performance, security, and privacy impacts, yielding a green light only when satisfaction exceeds 90%.

Can I use code review automation to enforce scope boundaries in a refactor?▼

Code review automation enforces scope boundaries by ensuring plans define in-scope and out-of-scope elements. It prevents future-use leftovers and requires full changes or refactors only, avoiding fallbacks and feature flags.

Does plan review work with evolving plans in software engineering?▼

Plan review works with evolving plans by analyzing the current codebase to identify gaps and missing constraints. It ensures updated plans reflect existing repository patterns and assesses security, privacy, and performance impacts.

What are the limitations of automated plan-codebase alignment checks?▼

Automated alignment checks require plans to cover full changes only and explicitly avoid fallbacks. A key limitation is yielding a green light exclusively when analysis indicates over 90% satisfaction with codebase constraints.

Related Skills

Explore More Software Engineering Skills→
Patasse97Patasse97

monorepo-navigator

Detect and map monorepo tooling, workspace layout, and internal dependency graphs.

Community
Intermediate
kurkokurko
14

tdd-bug-fix

Enforce Test-Driven Bug Fix workflow with failing tests before production changes.

Community
Advanced
prof-danielcprof-danielc

speckit.checker

Run static analysis tools and aggregate results into a prioritized issue report.

Community
Advanced
sjinkssjinks

security-review-owasp-virtual-patching

Identify virtual patching security review gaps in code, configuration, architecture, and operations.

Community
Advanced