reversa-scout

Maps legacy project structure, dependencies, and entry points into a structured inventory.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill reversa-scout-helcio-nogueira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-scout
Source: https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026/tree/main/.agents/skills/reversa-scout
Command: npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill reversa-scout-helcio-nogueira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Starting a reverse engineering analysis on an unfamiliar legacy codebase is slow and error-prone: you must manually discover the folder structure, languages, frameworks, dependencies, and entry points before any real documentation work can begin. This Skill automates that initial reconnaissance phase. ## Core Features & Use Cases - Project Surface Mapping: Lists the full directory tree (excluding noise like node_modules and build outputs), counts files by language, and identifies frameworks and package managers from config files like package.json, requirements.txt, and pom.xml. - Entry Point & Infrastructure Detection: Finds application entry files, CI/CD pipelines, Dockerfiles, database schema hints, and test coverage estimates. - Spec Organization Suggestion: Applies ordered heuristics (endpoint, module, use-case, hybrid, feature) to recommend how reverse-engineered specs should be organized, with evidence-backed rationale. - Use Case: When onboarding to an undocumented legacy system, run this Skill first to generate inventory.md, dependencies.md, and a structured surface.json that downstream analysis agents consume. ## Quick Start Ask the agent to run the reversa-scout reconnaissance on this repository to generate the initial project inventory and surface.json context file.

Frequently Asked Questions about reversa-scout

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

FAQPage Schema
How do I start a reverse engineering analysis of a legacy codebase?▼

Begin with a reconnaissance pass that maps the directory tree, languages, frameworks, and entry points. This Skill automates that step, producing an inventory document and a structured surface.json file that later analysis stages consume.

What files does the legacy project scout generate?▼

It generates inventory.md and dependencies.md in the output folder (default _reversa_sdd), plus surface.json in .reversa/context containing structured data on languages, frameworks, entry points, and modules.

How does the skill decide how to organize reverse-engineered specs?▼

It applies ordered heuristics: centralized routing suggests endpoint granularity, domain-named top-level folders suggest module, Gherkin or BDD specs suggest use-case, mixed signals suggest hybrid, and no clear signal falls back to feature.

Which dependency files does project reconnaissance detect?▼

It reads package.json, requirements.txt, pom.xml, go.mod, Gemfile, Cargo.toml, and composer.json to identify frameworks, libraries, versions, and the package manager in use.

Does the scout analyze database schemas in detail?▼

No. It only lists DDL files, migrations, schemas, and ORM models as surface-level hints. Detailed database analysis is delegated to a separate data-focused agent in the workflow.