retrofit-design

Generate a cohesive design document from a retrofit spec and codebase.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Retrofit-design helps teams convert existing code into formal design documentation to improve understanding, governance, and future maintenance.

Core Features & Use Cases

  • Ingests a retrofit spec and codebase to produce a comprehensive design document that captures architecture, decisions, and data flows.
  • References ADRs/DES and planning artifacts to ensure the produced design aligns with project governance and delivery goals.
  • Supports iterative refinement through user feedback and automatic surfacing of design decisions for ADR/DES documentation.

Quick Start

Run the retrofit-design skill with a feature path (e.g., auth/login) to generate a design document from the existing implementation.

Frequently Asked Questions about retrofit-design

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

FAQPage Schema
How do I turn existing code into design documentation?

To turn existing code into design documentation, ingest the current implementation alongside the feature spec, ADRs, and planning notes to synthesize a cohesive design draft capturing architecture and data flows.

What is retrofit design and when do I need it?

Retrofit design is the process of reading an existing codebase and feature specs to produce formal design documents. You need it to improve codebase understanding, governance, and future maintenance for undocumented features.

How do I generate a design document from a feature spec?

Generate a design document by running the skill with a feature path argument, which ingests the spec at docs/feature-specs/ and the codebase, then delivers the synthesized design to docs/feature-designs/.

Does retrofit design work with existing ADRs and planning notes?

Yes, retrofit design works with existing ADRs and planning notes by ingesting them alongside the codebase to ensure the produced design document aligns with project governance and delivery goals.

Can I refine a generated design document through feedback?

Yes, you can refine a generated design document through iterative user feedback. The skill also automatically surfaces design decisions that require ADR or DES creation for further documentation.