reversa-audit

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

Updated Nov 4, 2025

Search Tags:#consistency #requirements #audit #roadmap #report #actions #artifact-management

Ready to run

npx skills add https://github.com/Markson22/MKV-SYTEM --skill reversa-audit-markson22

💬 Prompt for ChatGPT / Claude Chat▼

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.