reversa-audit

Cross-check requirements, roadmap, and actions for contradictions and coverage gaps.

Updated May 13, 2026
One-click install
npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-audit-cliffthelin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-audit
Source: https://github.com/cliffthelin/AXiomEngine/tree/main/skills/reversa/reversa-audit
Command: npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-audit-cliffthelin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you detect contradictions and coverage gaps between what a feature claims it will do (requirements), how it plans to do it (roadmap), and what it actually performs (actions), so humans can fix the mismatch safely.

Core Features & Use Cases

  • Strict read-only cross-check: Compares requirements.md, roadmap.md, and actions.md and never modifies them or related artifacts.
  • Severity-ranked inconsistency reporting: Flags issues as CRITICAL, HIGH, MEDIUM, or LOW based on conflicts with legacy rules, coverage failures, identifier problems, and terminology drift.
  • Traceable audit output: Writes a complete findings report to feature-dir/audit/cross-check.md with stable internal IDs and “verified items” grouped by axis.

Quick Start

Run reversa-audit to produce feature-dir/audit/cross-check.md with severity-ranked inconsistencies across the active feature’s requirements, roadmap, and actions.

Frequently Asked Questions about reversa-audit

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

FAQPage Schema
How do I audit intent drift between requirements, roadmap, and actions files?

Auditing intent drift involves cross-checking requirements.md, roadmap.md, and actions.md to identify contradictions and coverage gaps. This process flags severity-ranked inconsistencies for human review without modifying the original files.

What is a read-only cross-check for feature governance reporting?

A read-only cross-check compares your feature's requirements, roadmap, and actions artifacts to validate coverage and consistency without modifying them. It generates a traceable audit report classifying issues by severity.

How do I validate requirements coverage and action traceability for a feature?

You validate requirements coverage by cross-checking the documented roadmap and actions against the initial requirements. This identifies legacy coherence failures and terminology drift, outputting a full report to feature-dir/audit/cross-check.md.

Can I generate a severity-ranked inconsistency report without changing my project files?

Yes, you can generate a severity-ranked inconsistency report using strict read-only behavior. It compares your governance artifacts and writes atomic findings to a separate audit directory, ensuring your source files remain untouched.

What are the limitations of read-only policy alignment audits?

The limitation of read-only policy alignment audits is that they only identify and report contradictions without automatically fixing them. Humans must manually resolve the flagged mismatches between requirements, roadmaps, and actions.

Do I need a state file to perform a Reversa feature audit?

Yes, you need a .reversa/state.json file to perform a Reversa feature audit. The audit process requires this state file to derive the correct output_folder and forward_folder paths for writing the cross-check report.