legacy-specifier

Extract API contracts, data schemas, and behavioral rules from legacy codebases.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/LucasBiason/engineering-knowledge-base --skill legacy-specifier
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: legacy-specifier
Source: https://github.com/LucasBiason/engineering-knowledge-base/tree/main/.claude/skills/workflow/legacy-specifier
Command: npx skills add https://github.com/LucasBiason/engineering-knowledge-base --skill legacy-specifier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams reverse-engineer specifications from legacy systems where documentation is missing, turning opaque code into clear contracts.

Core Features & Use Cases

  • Extracts API contracts, data schemas, and behavioral rules from code, tests, and UI flows.
  • Produces a structured set of spec files (system context, API contracts, feature specs) to guide refactoring and maintenance.
  • Handles evidence-driven inference and explicitly marks unknowns when evidence is insufficient.

Quick Start

Run the legacy-specifier on a repository to generate structured spec artifacts from existing code.

Frequently Asked Questions about legacy-specifier

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

FAQPage Schema
How do I extract specifications from a legacy codebase with missing documentation?▼

To extract specifications from a legacy codebase, analyze repository code, API schemas, test suites, and UI flows to generate structured contract-oriented spec artifacts and open questions when evidence is insufficient.

What is reverse-engineering API contracts from existing code?▼

Reverse-engineering API contracts from existing code involves analyzing legacy systems, API schemas, and tests to reveal behavior, data schemas, and business rules, producing structured spec files under the spec/ directory.

Can I generate feature specifications from test suites and UI flows?▼

Yes, you can generate feature specifications from test suites and UI flows by applying evidence-driven inference to extract behavioral rules and system context, explicitly marking unknowns when evidence is insufficient.

Does this approach work for reverse-engineering business rules from legacy systems?▼

Yes, this approach works for reverse-engineering business rules from legacy systems by examining existing repository code and UI flows to reveal behavior and produce contract-oriented artifacts to guide refactoring.

What is the best way to document opaque legacy code for refactoring?▼

The best way to document opaque legacy code for refactoring is to extract API contracts, data schemas, and behavioral rules, generating a structured set of spec files like system context and feature specs.

How are unknown behaviors handled when extracting specifications from code?▼

When extracting specifications from code, unknown behaviors are handled through evidence-driven inference that explicitly marks open questions in the generated spec artifacts when evidence is insufficient to determine a contract.