review-issue-implementation

Validate code diffs against issue cards and ExecPlans using AGENTS.md and PLANS.md.

2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/EEstevanell/codex-planning-kit --skill review-issue-implementation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-issue-implementation
Source: https://github.com/EEstevanell/codex-planning-kit/tree/main/.codex/skills/review-issue-implementation
Command: npx skills add https://github.com/EEstevanell/codex-planning-kit --skill review-issue-implementation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams verify that code changes satisfy issue cards and ExecPlans by comparing implementations to documented requirements, using diffs, and cross-checking against AGENTS.md and PLANS.md to ensure alignment.

Core Features & Use Cases

  • Diff-based validation: Analyze git diffs against issue cards and ExecPlans to ensure coverage of defined outcomes.
  • Requirements mapping: Map each requirement from the issue card and ExecPlan to the corresponding code changes, flagging gaps or divergences.
  • Risk assessment and reporting: Produce prioritized findings with file paths and line references, plus a clear risk and regression summary.

Quick Start

Provide ISSUE_PATH and EXECPLAN_PATH (and an optional DIFF_RANGE like STAGED or WORKING_TREE) to initiate a review. The skill will load governing documents (AGENTS.md, PLANS.md) and generate findings, a rating, and a concise change summary.

Frequently Asked Questions about review-issue-implementation

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

FAQPage Schema
How do I validate code changes against issue cards and ExecPlans?

To validate code changes against issue cards, provide the ISSUE_PATH and EXECPLAN_PATH to initiate a review. The skill analyzes git diffs against documented requirements to ensure coverage and flag divergences.

How does mapping requirements to a git diff work for compliance validation?

Mapping requirements to a git diff works by cross-referencing AGENTS.md and PLANS.md artifacts with code changes. It matches each requirement from the issue card to corresponding modifications, flagging gaps or divergences.

What's the best way to check if my staged changes align with PLANS.md requirements?

The best way to check if staged changes align with PLANS.md requirements is to run a review using the STAGED diff range. The skill loads governing documents and generates prioritized findings with file paths and line references.

Do I need AGENTS.md and PLANS.md files to perform a diff-based code review?

Yes, you need AGENTS.md and PLANS.md files to perform a diff-based code review. These repository governance artifacts provide the explicit requirements used to map changes and assess compliance.

Can I use the working tree diff range for requirements mapping and risk assessment?

Yes, you can use the WORKING_TREE diff range for requirements mapping and risk assessment. The skill analyzes uncommitted changes against issue cards and produces a concise change summary with a regression overview.

What limitations exist when analyzing git diffs for ExecPlan coverage?

A limitation when analyzing git diffs for ExecPlan coverage is that the review relies entirely on AGENTS.md and PLANS.md. The skill cannot validate requirements that are missing or undocumented within these governance artifacts.