Roadmap Auditor

Audit roadmap claims against code, tests, and documentation for mismatches.

1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/jimmymalhan/codereview-pilot --skill roadmap-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Roadmap Auditor
Source: https://github.com/jimmymalhan/codereview-pilot/tree/main/.claude/skills/roadmap-auditor
Command: npx skills add https://github.com/jimmymalhan/codereview-pilot --skill roadmap-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that roadmap progress claims are accurate by comparing them against actual code, tests, and documentation, preventing misleading status updates.

Core Features & Use Cases

  • Evidence-based Verification: Compares stated roadmap progress against tangible evidence in the codebase and documentation.
  • Mismatch Identification: Produces a precise list of discrepancies between claimed status and actual implementation.
  • Use Case: Before closing a project milestone, use this Skill to confirm that all "completed" features are indeed implemented, tested, and documented, catching any potential oversights or inaccuracies.

Quick Start

Audit the current roadmap progress against the project's code and documentation.

Frequently Asked Questions about Roadmap Auditor

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

FAQPage Schema
How do I verify roadmap progress claims against actual codebase implementation?

To verify roadmap progress claims, audit progress statements in files like README.md and CHANGELOG.md against the actual state of the codebase and checkpoint files. This identifies mismatches and confirms evidence for completed items, catching inaccurate status updates.

What is the best way to audit project documentation for unverified feature claims?

Auditing project documentation for unverified claims involves comparing stated progress in files like .github/PROJECT_*.md against tangible code and test evidence. This mismatch identification process prevents misleading status updates before closing a project milestone.

Can I use project management files to check if completed features have corresponding tests?

Yes, you can check if completed features have corresponding tests by comparing roadmap claims in documentation against actual code and test evidence. This verification process identifies discrepancies where features are marked completed but lack implementation or test proof.

How does evidence-based verification work for project milestones?

Evidence-based verification for project milestones works by comparing roadmap progress statements against tangible evidence in the codebase. It verifies evidence for completed items and identifies unverified or contradictory claims by checking the actual state of the codebase and checkpoint files.

When should I audit my roadmap to prevent misleading status updates?

You should audit your roadmap to prevent misleading status updates before closing a project milestone. This confirms that all features marked as completed are indeed implemented, tested, and documented, catching potential oversights or inaccuracies in progress statements.

Why does my roadmap status contradict the actual codebase state?

Your roadmap status may contradict the actual codebase state due to unverified or contradictory claims. Auditing compares progress statements in README.md and CHANGELOG.md against code, tests, and checkpoint files to identify these mismatches and prevent inaccurate documentation.