inverted-spec

Reverse-engineer codebases into provenance-annotated SDD pipeline specifications.

2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/sequenzia/agent-tools --skill inverted-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: inverted-spec
Source: https://github.com/sequenzia/agent-tools/tree/main/plugins/sdd/skills/inverted-spec
Command: npx skills add https://github.com/sequenzia/agent-tools --skill inverted-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inverted-spec analyzes an existing codebase to derive a comprehensive specification that can drive the SDD pipeline, transforming code structure and behavior into a documented, testable artifact.

Core Features & Use Cases

  • Interactive codebase analysis to extract architecture, flows, and constraints
  • Phase-guided interactive curation to validate findings and fill gaps via interviews
  • Output a complete inverted-spec document with provenance markers for traceability
  • Optional research stage to enrich findings with external best practices
  • Seamless mapping from analysis to spec templates across all depth levels

Quick Start

Specify the codebase path and start the inverted-spec workflow to generate the spec.

Frequently Asked Questions about inverted-spec

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

FAQPage Schema
How do I extract requirements and specifications from an existing codebase?▼

To extract specifications from an existing codebase, you can use a reverse-engineering process that analyzes code structure and behavior to generate a comprehensive, testable spec document. This approach transforms implemented logic into documented requirements with traceable provenance.

What is the best way to document hidden requirements in legacy code?▼

Documenting hidden requirements in legacy code works best through interactive curation and gap-filling interviews. This process validates extracted architecture and flows, surfacing implicit constraints to produce a structured, provenance-annotated specification with traceable decisions.

How do I generate a spec compatible with the SDD pipeline from source code?▼

Generating an SDD-compatible spec from source code involves analyzing the codebase to map architecture and constraints directly into spec templates. The output is a structured document designed to seamlessly drive the SDD pipeline across all depth levels.

Can I trace specific code structures back to their generated requirements?▼

Yes, tracing code structures to generated requirements is possible using provenance markers. The reverse-engineering process outputs a provenance-annotated document, ensuring every decision and derived requirement remains traceable to the original codebase.

Does reverse-engineering specifications work for complex codebases with missing documentation?▼

Reverse-engineering specifications effectively handles complex codebases with missing documentation by using phase-guided interactive curation. It analyzes existing flows to fill gaps via interviews, optionally enriching findings with external best practices.