reversa-scout

What problem does it solve?

This Skill solves the problem of not knowing what exists inside a legacy codebase by producing an actionable inventory of the project’s structure, technologies, entry points, and basic database surface.

Core Features & Use Cases

• Legacy surface mapping: Produces a complete directory tree inventory (with well-defined exclusions) to understand what to explore next.
• Technology and dependency identification: Detects languages, frameworks, critical dependency versions, and package managers from common manifest/config files.
• Entry-point and integration discovery: Locates application startup points, configuration files, CI/CD definitions, Docker files, and key package scripts.
• Database and tests (superficial) discovery: Lists DDL/migrations/ORM models if present and estimates test coverage by identifying test frameworks and counting test-spec files.
• Spec organization suggestion: Generates organization_suggestion for surface.json using heuristics to pick the best granularity (endpoint/module/use-case/hybrid/feature).

Quick Start

Use the reversa-scout skill to generate _reversa_sdd/inventory.md, _reversa_sdd/dependencies.md, and .reversa/context/surface.json for the current legacy project based on .reversa/state.json settings.