spec-miner

Reverse-engineer codebases into formal EARS specification artifacts.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/dieu-donnee/luxtrax --skill spec-miner-dieu-donnee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-miner
Source: https://github.com/dieu-donnee/luxtrax/tree/main/.agent/skills/spec-miner
Command: npx skills add https://github.com/dieu-donnee/luxtrax --skill spec-miner-dieu-donnee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Reverse-engineer specifications from an existing codebase to reveal its intended behavior, interfaces, and constraints.

Core Features & Use Cases

  • Extract API surface maps from source to produce accurate documentation.
  • Identify undocumented business logic and data flows, bridging gaps between implementation and requirements.
  • Generate architecture-level documentation from implementation details to support onboarding and maintenance.

Quick Start

Provide a codebase path and run the spec-miner to generate a reverse-engineered specification report.

Frequently Asked Questions about spec-miner

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

FAQPage Schema
How do I reverse-engineer specifications from an undocumented legacy codebase?

Reverse-engineer specifications from legacy code by applying the spec-miner to the source codebase to reveal intended behavior, interfaces, and constraints. It analyzes the code to generate a formal specification artifact documenting structure, API surfaces, and data flows.

What is the best way to extract API surface maps and document data flows from inherited code?

Extracting API surface maps and documenting data flows from inherited code is done by reverse-engineering the codebase to bridge gaps between implementation and requirements. The process identifies undocumented business logic and generates architecture-level documentation for maintenance.

Can I generate architecture-level documentation for downstream consumption using EARS format?

Yes, you can generate architecture-level documentation for downstream consumption using EARS format. The tool reverse-engineers implementation details to document non-functional constraints, API surfaces, and system structure into a formal specification artifact.

Does spec-miner work with codebases that have little or no formal documentation?

Yes, spec-miner is designed for codebases with little or no formal documentation. You provide the codebase path, and it reverse-engineers the source to produce accurate specifications revealing intended behavior, data flows, and non-functional constraints.

What are the limitations of reverse-engineering specifications for legacy systems?

Reverse-engineering specifications for legacy systems is limited by the accuracy of the existing implementation details. The generated artifact documents structure and API surfaces, but heavily obscured or dynamically executed business logic may be difficult to capture comprehensively.