Can I use this for decisions I am about to make?

While it is optimized for 'retrofiting' existing code, the structured workflow and drafting process are excellent for formalizing new architectural decisions as well.

How does the skill infer the reasoning behind existing code?

The skill uses a codebase analyzer to look at implementation details, code comments, and git history, then provides a draft for the user to refine based on their project knowledge.

What is the difference between an ADR and a DES in this skill?

An ADR (Architectural Decision Record) documents a significant, one-time choice like a database or framework. A DES (Design Pattern) documents a repeatable approach used across the codebase, such as a specific way to handle API responses.

Does this skill update my project documentation automatically?

Yes, it determines the next available ID, creates the markdown file in the appropriate directory, and updates the README index in your docs folder.

Retrofit Decision

Name: Retrofit Decision
Author: asermax

byasermax

•

학습 및 문서화

Documents existing architectural decisions and design patterns from source code into ADRs or design documents.

The Retrofit Decision skill helps developers capture and formalize 'tribal knowledge' by documenting choices already implemented in the codebase. By analyzing existing patterns, code comments, and git history, it automatically drafts Architectural Decision Records (ADRs) or Design Pattern (DES) documents. This ensures that legacy choices, framework selections, and repeatable implementation patterns are properly indexed and justified, making the codebase easier to maintain and onboard for new team members.

주요 기능

01Links documented decisions to the specific features they affect

02Analyzes codebase patterns to infer architectural rationale

031 GitHub stars

04Automates document indexing and unique ID assignment

05Distinguishes between one-time architectural decisions (ADR) and repeatable design patterns (DES)

06Generates structured documentation including context, alternatives, and consequences

사용 사례

01Standardizing a recurring code pattern like error handling or logging into a design doc

02Formalizing a legacy database or framework choice for team alignment

03Capturing architectural constraints before beginning a large-scale refactoring project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins retrofit-decision

For use in Claude.ai and ChatGPT

Download Skill