reversa-audit

Compare requirements.md, roadmap.md, and actions.md to identify contradictions and coverage gaps.

1.5k|383|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-audit-sandeco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-audit
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-audit
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-audit-sandeco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It detects contradictions and gaps between legacy project specifications so an AI agent workflow can be corrected safely before making changes.

Core Features & Use Cases

  • Strict, read-only auditing: Compares requirements.md, roadmap.md, and actions.md and never alters any analyzed artifacts.
  • Severity-based inconsistency reporting: Produces findings labeled CRITICAL, HIGH, MEDIUM, or LOW, focused on coverage, consistency, legacy coherence, and action sanity.
  • Human-ready cross-check report: Writes a traceable report to a feature-scoped file feature-dir/audit/cross-check.md for manual resolution.

Quick Start

Run reversa-audit to cross-check the currently active feature’s requirements, roadmap, and actions and generate a severity-ranked report without modifying the source files.

Frequently Asked Questions about reversa-audit

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

FAQPage Schema
How do I cross-check project specifications for contradictions before an AI agent executes changes?

To cross-check project specifications, you can run a read-only audit that compares requirements, roadmap, and actions files to detect contradictions, coverage gaps, and action sanity issues before execution.

What is a read-only audit for legacy feature specifications?

A read-only audit for legacy feature specifications is a strict analysis process that identifies inconsistencies across requirements, roadmap, and actions without modifying the original artifacts, generating a severity-ranked report instead.

How do I generate a consistency checking report for requirements and roadmap files?

You can generate a consistency checking report by running an audit command that compares your active feature's requirements, roadmap, and actions, writing traceable findings with CRITICAL or HIGH impact guidance to an audit markdown file.

Does the specification audit process modify my original requirements or actions files?

No, the specification audit process enforces strict read-only behavior and never alters your analyzed artifacts, ensuring humans can safely resolve spec errors from the generated cross-check report without source file corruption.

Can I use this consistency checking method for AI agent workflows in legacy projects?

Yes, you can use this consistency checking method for AI agent workflows in legacy projects to detect spec errors and coverage gaps safely, allowing you to correct the agent workflow before making any actual changes.

What are the limitations of strict read-only specification auditing?

The limitation of strict read-only specification auditing is that it only identifies contradictions and coverage gaps across artifacts, requiring humans to manually resolve the reported spec errors rather than automatically fixing them.