reversa-extract-soul

To generate an executive overview, distill legacy intent into a single Spec document that describes system purpose, core entities, and foundational decisions using sampled domain artifacts and git history analysis.

Domain modeling synthesis for legacy modernization extracts the essential data skeleton and foundational decisions of a system, needed when you require a lightweight executive summary rather than full module-by-module excavation.

To extract a system spec from surface.json, run the synthesis process to read the context file, sample relevant domain artifacts, analyze git log history, and output a single soul.md document capturing purpose and entities.

You cannot automatically overwrite an existing soul.md file; the extraction process enforces non-overwrite safety by guiding you to either keep the current version or generate a timestamped copy to preserve architecture documentation.

Legacy spec synthesis does not replace deep excavation tools; it provides a quick executive synthesis of purpose and core entities, designed for manual overview rather than detailed business-rule or Archaeologist-level analysis.

To create a soul spec document, you need the prior output of a Scout process stored as `.reversa/context/surface.json`, which provides the foundational surface-level context for extracting system intent and core entities.