reversa-audit

Compare requirements.md, roadmap.md, and actions.md for inconsistencies and coverage gaps.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/Pabloprogramador23/loja --skill reversa-audit-pabloprogramador23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-audit
Source: https://github.com/Pabloprogramador23/loja/tree/main/.agents/skills/reversa-audit
Command: npx skills add https://github.com/Pabloprogramador23/loja --skill reversa-audit-pabloprogramador23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill acts as a strict read-only auditor that compares requirements.md, roadmap.md and actions.md to reveal inconsistencies, coverage gaps, and terminology mismatches, and reports them without altering any artifacts.

Core Features & Use Cases

  • Cross-checks the three core artifacts (requirements.md, roadmap.md, actions.md) to ensure every functional requirement is traced to a roadmap decision and an action, and that terminology is consistent.
  • Generates a detailed cross-check report highlighting severities (CRITICAL, HIGH, MEDIUM, LOW) and actionable guidance for humans, while never modifying the analyzed documents.
  • Supports optional investigation steps and can be extended to verify related interfaces and legacy constraints.

Quick Start

Trigger the audit with /reversa-audit to compare the three artifacts and emit the cross-check report.

Frequently Asked Questions about reversa-audit

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

FAQPage Schema
How do I audit requirements, roadmap, and actions documents for inconsistencies?

Cross-check reporting compares requirements.md, roadmap.md, and actions.md to identify inconsistencies, coverage gaps, and terminology mismatches across feature-level documentation. It generates a non-destructive report classifying findings by severity to help teams verify alignment and traceability.

Why does my feature documentation have traceability gaps between requirements and actions?

Traceability gaps between requirements and actions occur when functional requirements lack corresponding roadmap decisions or action items. A cross-check audit identifies these missing links and reports them as coverage gaps, suggesting corrective steps to restore alignment.

Can I cross-check feature documentation without modifying the original markdown files?

Yes, you can cross-check feature documentation without modifying the original markdown files because the auditor operates in strict read-only mode. It writes findings exclusively to a separate cross-check.md report file, ensuring analyzed artifacts remain unaltered.

What is the best way to verify alignment across product lifecycle documentation?

The best way to verify alignment across product lifecycle documentation is to perform a cross-check audit that traces every functional requirement to a roadmap decision and an action. This classifies inconsistencies by severity and generates actionable corrective guidance.

Are there limitations to cross-checking terminology mismatches across multiple markdown files?

Limitations to cross-checking terminology mismatches include focusing strictly on requirements.md, roadmap.md, and actions.md, meaning files outside this core trio are not analyzed. The auditor also stops at suggesting human corrective steps rather than automatically fixing mismatches.