reversa-audit

Compare requirements, roadmap, and actions to produce a severity-ranked audit report.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents costly implementation mistakes by detecting contradictions and coverage gaps between the feature’s requirements, roadmap, and action plans before work proceeds.

Core Features & Use Cases

  • Strict cross-check audit: Compares requirements.md, roadmap.md, and actions.md to ensure every requirement and scenario is reflected by decisions and actions.
  • Terminology and identifier validation: Flags inconsistent terms, missing referenced IDs, and references that don’t exist.
  • Legacy and contract coherence: Checks roadmap decisions against legacy domain rules and verifies referenced external/interface contracts exist.

Quick Start

Run /reversa-audit when you want an audit report for the currently active feature’s three documents without changing any of them.

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 and roadmap documents for contradictions?

To audit requirements and roadmap documents for contradictions, run a strict cross-check that compares requirements.md, roadmap.md, and actions.md to detect coverage gaps and conflicting decisions before implementation proceeds.

What is a cross-check audit for engineering planning?

A cross-check audit for engineering planning validates that every requirement and scenario is reflected by roadmap decisions and actions, while also checking terminology consistency, missing referenced IDs, and legacy domain rule coherence.

How do I validate coverage gaps and identifier consistency in feature planning?

You validate coverage gaps and identifier consistency by performing a read-only audit that flags inconsistent terms, missing referenced IDs, and verifies that referenced external and interface contracts actually exist.

Can I automatically generate a severity-ranked audit report for feature governance?

Yes, you can generate a severity-ranked audit report for feature governance that categorizes findings into CRITICAL, HIGH, MEDIUM, and LOW levels, writing the cross-check markdown directly to the feature directory.

Does the requirements and roadmap consistency audit modify the source documents?

No, the requirements and roadmap consistency audit enforces read-only behavior, meaning it produces a severity-ranked finding report without changing any of the original requirements, roadmap, or actions documents.