reversa-reviewer

Review reverse-engineering specifications for inconsistencies and reclassify confidence levels.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps validate and improve reverse-engineered specifications by finding inconsistencies, reclassifying confidence levels, and surfacing targeted questions so humans can confirm anything ambiguous or missing.

Core Features & Use Cases

  • Specification consistency review: Checks per-unit requirements/design/tasks for internal contradictions and for coverage gaps that could block reimplementation.
  • Confidence reclassification: Re-evaluates every assertion using confidence rules to move statements between 🟢 confirmed, 🟡 inferred, and 🔴 gaps.
  • Human-validation question generation: Produces structured questions for unresolved 🔴 items, optionally with cross-review support when the Codex plugin is available and the review mode requires it.

Quick Start

Run reversa-reviewer to review the generated Reversa specifications in your current output folder and generate any needed validation questions.

Frequently Asked Questions about reversa-reviewer

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

FAQPage Schema
How do I validate reverse-engineered specifications for inconsistencies?

Specification consistency review checks per-unit requirements, design, and tasks documents to detect internal contradictions and coverage gaps that could block reimplementation. It validates reverse-engineered specs by finding inconsistencies and surfacing targeted questions for ambiguous items.

What are confidence rules for classifying reverse engineering assertions?

Confidence rules classify reverse engineering assertions into three levels: confirmed, inferred, and gaps. Confidence reclassification re-evaluates every statement in requirements.md, design.md, and tasks.md to ensure all claims follow the proper confidence-rules.md classifications.

How do I generate validation questions for missing specification requirements?

Generate validation questions for missing specification requirements by identifying unresolved gap items during the review phase. The process produces structured questions for these unresolved items, optionally supporting cross-review when the review mode requires it, so humans can confirm anything ambiguous or missing.

Can I review reverse-engineered specs without a dedicated traceability matrix?

You can review reverse-engineered specs without a dedicated traceability matrix by checking per-unit requirements, design, and tasks files for coverage gaps directly. The review process validates traceability by ensuring design and tasks fully cover the specified requirements without needing a separate matrix file.

Does the Reversa reviewer work with unit folders containing only requirements.md and design.md?

The Reversa reviewer operates across unit folders containing requirements.md, design.md, and tasks.md plus optional specification artifacts. While it reviews available files, missing tasks.md may limit coverage gap detection and block full reimplementation validation, reducing the overall confidence report accuracy.

When should I not use automated spec validation for reverse engineering?

Avoid automated spec validation when your reverse-engineered specifications lack the required unit folder structure with requirements.md, design.md, and tasks.md files. The review process depends on these artifacts to detect coverage gaps and reclassify confidence levels accurately across the specification set.