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.