Do I need to have a spec file before running this?

It is highly recommended to run the /katachi:retrofit-spec skill first, as this skill uses the spec to understand the intended functionality while analyzing the code.

What does it mean to 'retrofit' a design?

Retrofitted design is the process of creating technical documentation for code that is already written. This ensures that documentation reflects the actual implementation rather than outdated plans.

Can it help create Architecture Decision Records (ADRs)?

Absolutely. During the analysis, the skill identifies key architectural choices and prompts you to formalize them into ADR or DES (Design Pattern) documents.

Does this skill work on any codebase?

Yes, it is designed to analyze implementation code and infer logic regardless of the framework, though it integrates best with projects following the Katachi framework structure.

Retrofit Design

Name: Retrofit Design
Author: asermax

byasermax

•

学習とドキュメンテーション

Generates comprehensive technical design documentation and architectural rationales by analyzing existing implementation code.

Retrofit Design is a specialized Claude Code skill designed to bridge the gap between undocumented code and high-quality technical documentation. It reverses the standard development lifecycle by analyzing source code to infer design patterns, entity modeling, and data flows. The skill identifies undocumented architectural decisions (ADRs) and design patterns (DES), allowing teams to formalize tribal knowledge and create a source of truth for legacy features. It includes a collaborative iteration process and an automated review phase to ensure the generated documentation accurately reflects the 'as-built' state of the software.

主な機能

01Support for updating existing documentation or creating new design files

02Integration with design-reviewer subagents for quality assurance

03Automated design extraction from source code and feature specifications

04Inference of entity relationships and system data flows

05Identification of undocumented Architecture Decision Records (ADRs)

061 GitHub stars

ユースケース

01Onboarding new developers by generating clear design overviews of complex modules

02Standardizing architecture by discovering and formalizing existing design patterns

03Documenting legacy features that were implemented without formal design specs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins retrofit-design

For use in Claude.ai and ChatGPT

Download Skill