What are the four goals of high-quality code in this skill?

The four goals are: It works (solves the problem), It keeps working (survives changes), It's adaptable (handles new requirements), and It doesn't reinvent the wheel (uses proven solutions).

How does this skill help with the decision to abstract code?

It provides a signal-based decision table, suggesting abstractions when logic appears in multiple places or functions are too complex to describe simply, while warning against premature abstraction for single use cases.

What is the Principle of Least Astonishment (POLA)?

POLA means behavior should always match expectations. If a function does something a reasonable caller wouldn't expect—like hidden side effects—it's considered a design bug.

Can this skill be used for legacy codebases?

Yes, it includes specific strategies for legacy code, focusing on testing and readability to help developers understand the system before attempting to make safe changes.

Code Quality Foundations

Name: Code Quality Foundations
Author: smileynet

bysmileynet

0•

開発者ツール

Establishes architectural standards and decision frameworks to ensure code is readable, modular, and maintainable.

Code Quality Foundations provides Claude with a comprehensive framework for engineering excellence, focusing on the four primary goals of software: functionality, longevity, adaptability, and efficiency. By implementing the Principle of Least Astonishment (POLA) and providing structured decision tables for abstraction and effort allocation, this skill helps developers move beyond code that simply 'works' toward production-grade systems that are easy to test, hard to misuse, and built for long-term maintenance.

主な機能

01Structured pre-coding and self-review quality checklists

02Quality investment guidance tailored to project stage (Greenfield vs. Legacy)

03Decision matrices for identifying when to abstract or modularize code

04Six Pillars of Code Quality including POLA principles

05Four Goals framework for high-quality software engineering

060 GitHub stars

ユースケース

01Auditing existing codebases for technical debt and architectural antipatterns

02Designing robust API interfaces and module boundaries to prevent future refactors

03Evaluating tradeoffs between speed of delivery and long-term code maintainability

主な機能

01Structured pre-coding and self-review quality checklists

02Quality investment guidance tailored to project stage (Greenfield vs. Legacy)

03Decision matrices for identifying when to abstract or modularize code

04Six Pillars of Code Quality including POLA principles

05Four Goals framework for high-quality software engineering

060 GitHub stars

ユースケース

01Auditing existing codebases for technical debt and architectural antipatterns

02Designing robust API interfaces and module boundaries to prevent future refactors

03Evaluating tradeoffs between speed of delivery and long-term code maintainability