implementation-plan-review

Critique implementation plans against GitHub issues and repository code.

43|21|Updated Jun 3, 2025
One-click install
npx skills add https://github.com/blockscout/mcp-server --skill implementation-plan-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implementation-plan-review
Source: https://github.com/blockscout/mcp-server/tree/main/.codex/skills/implementation-plan-review
Command: npx skills add https://github.com/blockscout/mcp-server --skill implementation-plan-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides expert review of implementation plans, ensuring they are correct, complete, aligned with the codebase, and ready for testing and rollout, without actually implementing the plan.

Core Features & Use Cases

  • Plan Validation: Critiques implementation plans against GitHub issues and the current repository codebase.
  • Codebase Alignment: Verifies that the plan's assumptions match the reality of the codebase.
  • Risk Assessment: Identifies potential risks, testing gaps, and rollout concerns.
  • Use Case: Before a developer starts coding, use this Skill to have an AI review their proposed implementation plan for a new feature, ensuring it addresses all requirements and potential issues.

Quick Start

Use the implementation-plan-review skill to critique the plan in '/path/to/plan.md' against issue number 123.

Frequently Asked Questions about implementation-plan-review

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

FAQPage Schema
How do I review an implementation plan against a GitHub issue?

To review an implementation plan against a GitHub issue, use this skill to critique the plan document for correctness, completeness, and codebase alignment. It validates the proposed feature against the issue and repository without actually writing the code.

What is the best way to check if my implementation plan aligns with the codebase?

Checking codebase alignment involves verifying that the plan's assumptions match the current repository reality. This skill performs that verification by analyzing the plan against the codebase to identify discrepancies and potential risks before development begins.

Can I identify testing gaps and rollout risks before coding starts?

Yes, you can identify testing gaps and rollout risks by running an implementation plan review. The skill assesses the plan's test and rollout readiness, providing actionable feedback on potential issues without executing the implementation.

Does implementation plan review write or modify the actual code?

Implementation plan review does not write or modify code. It focuses exclusively on critiquing the plan's correctness, completeness, and risks, providing actionable feedback rather than generating the implementation itself.

How do I critique a plan document for a specific GitHub issue number?

To critique a plan document for a specific GitHub issue, point the skill to your plan file and issue number. It evaluates the plan against the issue requirements and the current codebase to ensure complete feature coverage.

When do I need an implementation plan validation?

You need implementation plan validation before a developer starts coding a new feature. It ensures the proposed plan addresses all GitHub issue requirements, matches codebase assumptions, and identifies potential testing or rollout concerns.