reversa-scout

Inventory legacy project structure, technologies, entry points, and CI/CD artifacts.

1|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/Rdinda/FMA_Pontos --skill reversa-scout-rdinda
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-scout
Source: https://github.com/Rdinda/FMA_Pontos/tree/main/.agents/skills/reversa-scout
Command: npx skills add https://github.com/Rdinda/FMA_Pontos --skill reversa-scout-rdinda

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of quickly understanding a legacy codebase by mapping its folder structure, technologies, dependencies, entry points, and test signals into an initial, actionable inventory.

Core Features & Use Cases

  • Full surface mapping: Produces a comprehensive directory tree (with common exclusions) to reveal where code and configuration live.
  • Technology and dependency discovery: Detects languages, frameworks, key dependency versions, and package manager clues from config files.
  • Operational entry-point identification: Finds app entry files, configuration files, CI/CD workflows, Docker assets, and relevant build/start scripts to understand how the system runs.
  • Database schema hints (shallow): Lists candidate DDL/migration/schema/ORM model artifacts for follow-up by other agents.
  • Test coverage estimation: Detects test frameworks and provides a lightweight file-count-based estimate of test coverage.

Quick Start

Use the reversa-scout skill to generate the initial legacy inventory and surface.json for downstream analysis into the output folder specified by .reversa/state.json.

Frequently Asked Questions about reversa-scout

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

FAQPage Schema
How do I inventory a legacy codebase structure before starting a reverse engineering analysis?▼

Mapping a legacy codebase involves producing a directory tree, discovering technologies and dependencies, identifying operational entry points like Docker assets and CI/CD, and generating a structured surface.json file for downstream reverse engineering analysis.

What is codebase surface mapping and when do I need it?▼

Codebase surface mapping is the initial discovery pass that inventories a legacy project's folder structure, technologies, and entry points. You need it when you require an actionable overview before deeper automated engineering analysis.

How do I find entry points and CI/CD workflows in an unfamiliar project?▼

Finding entry points and CI/CD workflows involves scanning the project for application entry files, configuration files, build scripts, and Docker assets. This operational identification reveals how the system runs and is a core part of surface mapping.

Can I estimate test coverage and find database schema hints without running the legacy code?▼

You can estimate test coverage and find database schema hints without running code. The discovery process detects test frameworks and uses a file-count-based estimate, while shallowly listing candidate DDL, migration, and ORM model artifacts for follow-up.

What is the best way to generate an initial dependency discovery report for a legacy project?▼

The best way to generate an initial dependency discovery report is to detect languages, frameworks, and package manager clues from configuration files. This produces a comprehensive inventory report alongside a structured surface.json compliant with the surface schema.

What are the limitations of using a shallow surface mapping approach for codebase analysis?▼

The limitation of a shallow surface mapping approach is that database schema hints are only candidate artifacts requiring follow-up by other agents, and test coverage is a lightweight file-count estimate rather than a detailed execution-based metric, serving solely as an initial discovery pass.