legacy-spec-writer

What problem does it solve?

The Skill takes business capabilities from the discovery stage and translates them into evidence-backed, platform-agnostic capability specifications. It aids in producing the spec.yaml and spec.md artifacts essential for modernizing legacy systems.

Core Features & Use Cases

• Capability Analysis: Merges approved BRD Package with module/flow/program analyses to identify and describe capabilities.
• Business Rules: Constructs spec.yaml containing declarative business rules confirmed by SMEs, grounded in code or SME validation.
• Modernization Decisions: Records decisions regarding the target system, ensuring alignment with business goals and technical constraints.
• Data Model Definition: Maps legacy data structures to target entities, maintaining lineage and constraints.
• Process Flow & Inputs/Outputs/Exceptions: Defines the operational behavior of the capability in terms of steps, inputs, outputs, and potential exceptions.
• Use Case: For a legacy system that needs modernization, this Skill can create a comprehensive spec for a specific capability, such as "Credit Limit Enforcement," including all business rules, data model, and process flow.

Quick Start

To generate a specification for the "Credit Limit Enforcement" capability, run the legacy-spec-writer skill on the approved BRD Package and associated analyses.