reversa-paradigm-advisor

Detects legacy system paradigms and guides migration decisions for target stacks.

Updated May 22, 2026
One-click install
npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill reversa-paradigm-advisor-gleisonoliveira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-paradigm-advisor
Source: https://github.com/GleisonOliveira/dockerpilot-mcp/tree/main/.agents/skills/reversa-paradigm-advisor
Command: npx skills add https://github.com/GleisonOliveira/dockerpilot-mcp --skill reversa-paradigm-advisor-gleisonoliveira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Migrating a legacy system to a new language or framework often hides a deeper shift in programming paradigm (procedural, OO, functional, event-driven), which teams discover too late. This Skill detects the legacy paradigm from specification artifacts, infers the natural paradigm of the target stack, and forces a conscious, documented decision before any code is written. ## Core Features & Use Cases - Paradigm Detection: Classifies the legacy system as procedural, OO, functional, event-driven, actor model, dataflow, or hybrid, with citable evidence and confidence levels (confirmed, inferred, gap, ambiguous). - Gap Analysis: Maps the legacy-to-target paradigm pair against a catalog of typical gaps and presents at least four concrete implications drawn from the actual legacy system. - Decision Recording: Presents three options (adopt target paradigm, force legacy paradigm, hybrid) and writes a structured paradigm_decision.md artifact consumed by downstream migration agents. - Use Case: When migrating a Rails monolith to Node.js, the Skill detects classic OO with Active Record, infers event-driven as Node's natural paradigm, explains implications like synchronous flows becoming sagas, and records the user's chosen strategy. ## Quick Start Run /reversa-paradigm-advisor after the migration brief exists to analyze the legacy paradigm and record a paradigm decision for the target stack.

Frequently Asked Questions about reversa-paradigm-advisor

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

FAQPage Schema
How do I detect the programming paradigm of a legacy system before migration?▼

Analyze specification artifacts like domain models, architecture documents, and process flows for signals such as aggregates, inheritance, immutability, or event usage. This Skill classifies the system as procedural, OO, functional, event-driven, actor model, dataflow, or hybrid with cited evidence and confidence levels.

What is the natural paradigm of a target stack like Node.js or Go?▼

Each stack has a natural paradigm: Node.js is event-driven asynchronous, Go favors CSP-style concurrency, Elixir uses the actor model, and Spring or .NET favor OO with dependency injection. The Skill's catalog maps common stacks to their natural paradigms with viable alternatives.

What prerequisites does the paradigm advisor need to run?▼

It requires a migration_brief.md file declaring the target stack and a populated _reversa_sdd directory produced by the discovery team agents. If prerequisites are missing, it stops and directs the user to run the orchestrating migration command first.

What happens when the legacy and target paradigms differ?▼

The Skill presents at least four concrete implications using examples from the actual legacy system, then offers three options: adopt the target paradigm, force the legacy paradigm, or use a hybrid approach. The user's choice and justification are recorded in paradigm_decision.md.

Can the paradigm advisor handle hybrid legacy systems?▼

Yes, it detects hybrid systems by identifying the paradigm of each component with supporting evidence. It then asks the user for a per-component decision or a unifying decision across the whole system.