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.