reversa-audit

Audit requirements.md, roadmap.md, and actions.md for contradictions and gaps.

Updated Nov 4, 2025
One-click install
npx skills add https://github.com/Markson22/MKV-SYTEM --skill reversa-audit-markson22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-audit
Source: https://github.com/Markson22/MKV-SYTEM/tree/main/.agents/skills/reversa-audit
Command: npx skills add https://github.com/Markson22/MKV-SYTEM --skill reversa-audit-markson22

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill is a strict, read-only auditor that identifies contradictions and gaps across the requirements.md, roadmap.md, and actions.md, and reports them to the human without ever modifying artifacts.

Core Features & Use Cases

  • Cross-file Consistency: Detects mismatches in terminology and references across requirements, roadmap, and actions.
  • Gap Analysis: Highlights missing or misaligned decisions, providing a single source of truth for the feature's forward cycle.
  • Report-First: Outputs a comprehensive cross-check report to feature-dir/audit/cross-check.md for human resolution, preserving original artifacts.

Quick Start

Run the audit to generate the cross-check report and review feature-dir/audit/cross-check.md.

Frequently Asked Questions about reversa-audit

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

FAQPage Schema
How do I audit consistency across requirements, roadmap, and actions markdown files?

A cross-check audit identifies contradictions and gaps across requirements.md, roadmap.md, and actions.md without modifying the original artifacts, generating a severity-based report detailing CRITICAL to LOW findings for human resolution.

What is a read-only cross-check audit for project artifacts?

A read-only cross-check audit identifies contradictions and gaps across requirements.md, roadmap.md, and actions.md without modifying artifacts, outputting a comprehensive cross-check report for human resolution.

How do I generate a cross-check report for feature directory artifacts?

The audit applies a standardized before-audit step, checks for the presence of all three artifacts, and generates a cross-check report placed at feature-dir/audit/cross-check.md detailing severity-based findings.

Does the artifact management audit modify my original markdown files?

No, the artifact management audit is strictly read-only and preserves original artifacts by identifying mismatches and missing decisions across requirements.md, roadmap.md, and actions.md without modifying them.

What gap analysis is performed on roadmap and actions documents?

Gap analysis highlights missing or misaligned decisions and terminology mismatches across requirements, roadmap, and actions documents, providing a single source of truth for the feature's forward cycle.

When do I need a cross-file consistency audit for my feature roadmap?

You need a cross-file consistency audit when you must ensure alignment across requirements.md, roadmap.md, and actions.md, detecting terminology mismatches and gaps to preserve a single source of truth.