One-click install
npx skills add https://github.com/jsdfhasuh/emosonic --skill spec-miner-jsdfhasuh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-miner
Source: https://github.com/jsdfhasuh/emosonic/tree/main/.agents/skills/spec-miner
Command: npx skills add https://github.com/jsdfhasuh/emosonic --skill spec-miner-jsdfhasuh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Spec miner turns legacy, undocumented, or opaque implementations into clear, evidence-based requirements so teams can safely understand, document, and improve existing systems.

Core Features & Use Cases

  • Code-evidence-driven specification extraction: Grounds observations in actual code evidence (not assumptions) and records code locations for each requirement.
  • Structured reverse-engineering workflow: Follows a repeatable process across scope discovery, tracing flows, documenting observed requirements, and flagging uncertainties.
  • EARS-format requirement drafting: Produces requirements in a consistent “Easy Approach to Requirements Syntax” style suitable for downstream planning and validation.
  • Use Case: When onboarding engineers to a mature system, it helps convert scattered behaviors into a navigable specification with explicit uncertainties and recommendations.

Quick Start

Use the spec-miner skill to reverse-engineer the target repository and produce an evidence-backed requirements document that includes EARS-formatted functional observations and a list of uncertainties.

Frequently Asked Questions about spec-miner

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

FAQPage Schema
How do I extract requirements from a legacy codebase with no documentation?

Reverse engineering legacy code into specifications grounds observations in actual code evidence and records locations for each requirement. This process traces system behavior to document observed functionality without relying on assumptions.

What is EARS format for requirements engineering?

EARS (Easy Approach to Requirements Syntax) is a structured syntax for drafting consistent requirements. It formats functional observations extracted from code into a standardized style suitable for downstream planning and validation.

How do I document observed system behavior for engineering onboarding?

Documenting observed system behavior for onboarding involves tracing execution flows and converting scattered behaviors into navigable specifications. This creates explicit documentation with flagged uncertainties and recommendations.

Does spec extraction work for tracing flows in undocumented implementations?

Spec extraction works for undocumented implementations by following a structured reverse-engineering workflow across scope discovery. It traces flows to produce evidence-backed functional observations and lists identified uncertainties.

What is the best way to handle uncertainty when reverse engineering code?

The best way to handle uncertainty when reverse engineering code is to explicitly flag ambiguities encountered during flow tracing. This records gaps in observed behavior alongside generated specifications and recommendations.