reversa-scout

Map legacy project structure, technologies, and entry points into inventory files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Reversa-scout turns unknown legacy codebases into an actionable starting inventory so downstream agents can analyze intent and structure instead of guessing.

Core Features & Use Cases

  • Surface mapping: Captures the full directory tree (with targeted exclusions) to expose what exists in the project.
  • Technology discovery: Detects languages, frameworks, and dependency versions from common manifests and config files.
  • Entry-point identification: Finds likely application entry points, configuration locations, CI/CD pipelines, and container definitions so behavior can be traced.
  • Quick quality signals: Produces a superficial view of database schema presence and estimates test coverage to guide the next reverse-engineering steps.

Quick Start

Ask the AI to run reversa-scout to generate the initial legacy project inventory, then inspect the resulting _reversa_sdd/inventory.md and .reversa/context/surface.json.

Frequently Asked Questions about reversa-scout

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

FAQPage Schema
How do I map the directory structure and entry points of a legacy codebase?

Mapping a legacy codebase involves enumerating the directory structure and identifying probable application entry points by reading standard configuration and dependency manifests. The process generates an inventory and structured surface context to accelerate intent reconstruction.

What is the fastest way to create a project inventory and dependency discovery for reverse engineering?

Project inventory and dependency discovery for reverse engineering is achieved by scanning configuration files and manifests to detect technologies and dependency versions. This generates an inventory document and a structured surface profile highlighting routing and CI/CD definitions.

Can I use surface mapping to detect frameworks and CI/CD pipelines in an unknown project?

Yes, surface mapping detects languages, frameworks, and dependency versions from common manifests and config files. It specifically finds likely application entry points, configuration locations, and CI/CD pipeline definitions so behavior can be traced.

How do I exclude irrelevant directories when performing reconnaissance on a large legacy system?

Reconnaissance on a large legacy system requires excluding irrelevant directories to capture the full directory tree accurately. This targeted surface mapping exposes what exists in the project while reducing noise for downstream analysis.

What is the best way to generate a structured surface.json file for early-stage governance analysis?

Generating a structured surface.json file for governance analysis involves enumerating the project surface and reading dependency manifests. This produces a structured context file conforming to the required schema, providing inventories and routing hints for downstream agents.

Does reversa-scout perform deep code analysis or only superficial project reconnaissance?

Reversa-scout performs superficial project reconnaissance rather than deep code analysis. It provides a superficial view of database schema presence and estimates test coverage to produce an actionable starting inventory that guides the next reverse-engineering steps.