reversa-paradigm-advisor

Classify legacy programming paradigms and map them to target stack paradigms.

Updated May 13, 2026
One-click install
npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-paradigm-advisor-cliffthelin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-paradigm-advisor
Source: https://github.com/cliffthelin/AXiomEngine/tree/main/skills/reversa/reversa-paradigm-advisor
Command: npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-paradigm-advisor-cliffthelin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents migration teams from treating a paradigm shift as a surface-level language change by detecting the legacy programming paradigm, mapping it to the target stack’s natural paradigm, and making the user choose an explicit strategy for the gap.

Core Features & Use Cases

  • Legacy paradigm detection from specifications: Classifies legacy behavior into procedural, classic OO, OO with DI, functional, event-driven, actor model, dataflow, or hybrid, using evidence from _reversa_sdd/ artifacts rather than source code.
  • Target natural paradigm inference: Infers the natural paradigm of the declared target stack via the local paradigm catalog mapping and proposes viable alternatives.
  • Gap articulation with concrete implications: Translates paradigm mismatch into at least four concrete, citeable implications (with severity) that future migration agents must honor.
  • Human decision gate with required artifact output: Records the user’s choice and justification into _reversa_sdd/migration/paradigm_decision.md, then enumerates pending implications for subsequent agents (Curator/Strategist/Designer/Inspector).

Quick Start

Invoke the agent with /reversa-paradigm-advisor after running /reversa-migrate to populate _reversa_sdd/.

Frequently Asked Questions about reversa-paradigm-advisor

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

FAQPage Schema
How do I prevent programming paradigm mismatches during a legacy system migration?

To prevent paradigm mismatches during legacy system migration, you must detect the source programming paradigm and map it to the target stack's natural paradigm, documenting concrete implications and requiring a human decision to bridge the gap.

How do I classify legacy architecture paradigms from design specifications instead of source code?

You can classify legacy architecture paradigms by analyzing specification artifacts to detect procedural, classic OO, functional, event-driven, actor model, dataflow, or hybrid behaviors using documented evidence rather than direct source code reading.

What happens when the target stack's natural paradigm differs from the legacy system's paradigm?

When target natural paradigms differ from legacy systems, the mismatch translates into at least four concrete, citeable implications with severity ratings that future migration agents must honor, requiring an explicit human strategy decision to proceed.

Can I map a legacy procedural paradigm to a functional target stack without rewriting the architecture?

Mapping a legacy procedural paradigm to a functional target stack requires proposing viable paradigm alternatives and articulating the concrete gap implications, which typically necessitates an explicit architectural strategy decision rather than a direct code translation.

What is the best way to document paradigm shift decisions for agent-based migration workflows?

The best way to document paradigm shift decisions is to record the user's choice and justification into a dedicated paradigm decision artifact, enumerating pending implications for subsequent migration agents like Curators, Strategists, Designers, and Inspectors.

Do I need migration briefing artifacts to analyze target stack paradigm implications?

Yes, you need existing migration briefing and specification artifacts within your SDD directory structure to infer the target natural paradigm and generate the required paradigm decision documentation accurately.