How does this skill differ from a standard linter?

Unlike linters that check for syntax or style rules, this skill evaluates the design philosophy and architectural intent of your changes to prevent 'bolted-on' technical debt.

Does it follow a specific software philosophy?

Yes, it is grounded in 'A Philosophy of Software Design' by John Ousterhout, prioritizing deep abstractions and strategic programming over tactical shortcuts.

Can it help with refactoring decisions?

Absolutely. It helps you identify the 'middle path' between a minimal quick-fix and a massive rewrite, suggesting the most effective structural improvements within your constraints.

When should I use the code-evolution skill?

Use it during PR reviews, after adding new features to existing systems, or whenever a codebase feels like it is accumulating too many patches.

Code Evolution Reviewer

Name: Code Evolution Reviewer
Author: codybrom

bycodybrom

•

协作工具

Evaluates code modifications to ensure they maintain architectural integrity and avoid 'bolted-on' technical debt.

The Code Evolution Reviewer applies strategic software design principles to analyze pull requests and file modifications, ensuring every change feels natively integrated rather than patched. Inspired by 'A Philosophy of Software Design,' it helps developers move beyond the 'smallest possible change' trap by assessing whether a modification aligns with the ideal structure of the system. The skill performs deep checks for incremental complexity, logic duplication, and documentation drift, guiding teams toward a higher standard of code health and long-term maintainability.

主要功能

01Repetition Audit: Flags logic duplication and identifies opportunities for better abstraction during evolution.

023 GitHub stars

03Technical Debt Trajectory: Analyzes whether modifications are reducing or compounding existing debt.

04Incremental Complexity Detection: Identifies unnecessary special cases, flags, and dependencies introduced by changes.

05Comment Maintenance Sync: Ensures documentation and higher-level comments remain accurate and relevant after code changes.

06Designed-In Assessment: Determines if changes look native to the codebase or like superficial patches.

使用场景

01Identifying the best 'middle path' for refactoring when working under tight time constraints.

02Reviewing complex pull requests to ensure long-term architectural health and design quality.

03Evaluating the impact of a new feature on an existing legacy module to prevent degradation.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codybrom/clairvoyance code-evolution

For use in Claude.ai and ChatGPT

主要功能

01Repetition Audit: Flags logic duplication and identifies opportunities for better abstraction during evolution.

023 GitHub stars

03Technical Debt Trajectory: Analyzes whether modifications are reducing or compounding existing debt.

04Incremental Complexity Detection: Identifies unnecessary special cases, flags, and dependencies introduced by changes.

05Comment Maintenance Sync: Ensures documentation and higher-level comments remain accurate and relevant after code changes.

06Designed-In Assessment: Determines if changes look native to the codebase or like superficial patches.

使用场景

01Identifying the best 'middle path' for refactoring when working under tight time constraints.

02Reviewing complex pull requests to ensure long-term architectural health and design quality.

03Evaluating the impact of a new feature on an existing legacy module to prevent degradation.