plan-consistency-review

Review planning artifacts for contradictions, coverage gaps, and stale references before implementation.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/ahsanghalib/ai-workflow --skill plan-consistency-review-ahsanghalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-consistency-review
Source: https://github.com/ahsanghalib/ai-workflow/tree/main/skills/plan-consistency-review
Command: npx skills add https://github.com/ahsanghalib/ai-workflow --skill plan-consistency-review-ahsanghalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans, requirements, architecture notes, and task lists often drift apart as a project evolves, leading to contradictions, missing acceptance criteria, and stale references that only surface during implementation. This Skill performs a read-only consistency audit across those artifacts so problems are caught before any code is written. ## Core Features & Use Cases - Traceability Matrix: Maps each requirement or acceptance criterion to its design decision, implementing tasks, and validation evidence with exact path:line citations. - Consistency Checks: Detects contradictions between sources, conflicting terminology, orphaned tasks, broken dependency ordering, and validation commands that cannot observe the stated acceptance criteria. - Classified Findings Report: Separates confirmed coverage from assumptions, unresolved decisions, contradictions, and stale references, then issues a verdict of ready, needs clarification, or plan revision required. - Use Case: After decomposing a feature into tasks, run this review to confirm every requirement has a task and test path, and that no two documents disagree, before approving implementation. ## Quick Start Review the current plan, requirements, and task artifacts for contradictions and missing coverage, and report findings without editing any files.

Frequently Asked Questions about plan-consistency-review

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

FAQPage Schema
How do I check a project plan for contradictions before implementation?▼

Run a plan consistency review that inventories requirements, design records, plans, and tasks, builds a traceability matrix, and checks for conflicting statements, missing coverage, and stale references. Findings are reported with path:line evidence and a severity rating.

What is a requirements traceability matrix and how is it built?▼

A traceability matrix maps each requirement or acceptance criterion to its source, design link, implementing tasks, and validation evidence. It is built by reading the project's existing artifacts and recording exact IDs and path:line references without inventing entries.

Does this review require a specific tool like spec-kit or a CLI?▼

No. The review is harness-neutral and works with ordinary repository Markdown artifacts. It uses the project's actual file names and does not assume a .specify directory, slash commands, or any particular agent integration.

Can the consistency review fix or rewrite the plan it finds problems in?▼

No. The review is strictly read-only and never edits plans, tasks, code, or tests. Findings are handed to a planning skill for authorized revision, a design skill for architecture decisions, or the user when a requirement is unresolved.

When should a plan consistency review run in the development workflow?▼

Run it after planning or task decomposition and before an approved task is implemented. It verifies the plan satisfies approval and test-first gates, but it does not replace final completion verification after implementation.