retrofit-existing

Generate feature specs, designs, and decisions from existing code.

1|1|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/asermax/claude-plugins --skill retrofit-existing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retrofit-existing
Source: https://github.com/asermax/claude-plugins/tree/main/katachi/skills/retrofit-existing
Command: npx skills add https://github.com/asermax/claude-plugins --skill retrofit-existing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Load existing code into formal framework documentation by creating specs, designs, and decisions that capture current implementation and enable gradual adoption.

Core Features & Use Cases

  • Retrofit Spec: Generate a feature spec from existing code to document requirements and scope.
  • Retrofit Design: Create a design document with integrated decision discovery for mapped implementations.
  • Integrated Decisions: Surface undocumented decisions for formal ADR/DES documentation.
  • Guided Adoption: Aligns codebases with documentation structure to ease future changes.

Quick Start

Run the retrofit-spec command on a target module to generate an initial feature spec.

Frequently Asked Questions about retrofit-existing

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

FAQPage Schema
How do I generate design documentation from an existing codebase?

You can generate design documentation from an existing codebase by analyzing a target module to retroactively produce draft specifications, designs, and decisions that capture the current implementation for review.

What is retrofitting framework documentation and when do I need it?

Retrofitting framework documentation is the process of creating formal specs and designs for existing code. You need it when a codebase lacks documentation but seeks gradual adoption into a formal documentation structure.

How do I document undocumented architectural decisions in existing code?

You can document undocumented architectural decisions by analyzing existing implementation code to surface hidden choices, producing formal artifacts that reference the original code for ADR or DES documentation.

Can I create a feature spec from an existing module without rewriting the code?

Yes, you can create a feature spec from an existing module without rewriting code by running a retrofit-spec command that analyzes the implementation and outputs a draft specification capturing current requirements and scope.

What prerequisites are needed to retrofit specs from existing implementation code?

Prerequisites for retrofitting specs include having existing implementation code available and an available retrofitted spec structure to ensure the generated artifacts align properly with the documentation integration process.

Does retrofitting documentation work for codebases seeking gradual adoption?

Yes, retrofitting documentation works for codebases seeking gradual adoption by aligning existing code with a documentation structure, producing specs and designs that guide integration and ease future changes.