pragmatic-programmer

Identifies software quality issues using Pragmatic Programmer heuristics.

Updated Jun 5, 2026

Search Tags:#code quality #refactoring #software design #heuristics #architectural review

Ready to run

npx skills add https://github.com/hung-phan/system-skills --skill pragmatic-programmer-hung-phan

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: pragmatic-programmer
Source: https://github.com/hung-phan/system-skills/tree/main/skills/system-review/references/code-design/pragmatic-programmer
Command: npx skills add https://github.com/hung-phan/system-skills --skill pragmatic-programmer-hung-phan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers address common code rot, architectural decisions, and software decay issues using the heuristics from "The Pragmatic Programmer" book.

Core Features & Use Cases

Code Health Heuristics: Utilizes the heuristics from the book to identify common code quality issues.
Decision Making: Assists in making informed design and architectural decisions.
Refactoring Guidance: Provides guidance for refactoring code with minimal risk.
Use Case: When you're working on a codebase and encounter issues like deep method chains, god classes, or when refactoring decisions seem irreversible.

Quick Start

Analyze the code quality of a specific module using the Pragmatic Programmer heuristic skill.

Frequently Asked Questions about pragmatic-programmer

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

FAQPage Schema

How do I identify code rot and software decay in my codebase?▼

To identify code rot and software decay, apply Pragmatic Programmer heuristics to detect architectural issues like deep method chains and god classes. This approach uses early warning principles to prevent codebase degradation during reviews.

What is the best way to plan refactoring with minimal risk?▼

The best way to plan minimal risk refactoring is to apply software design heuristics that guide irreversible architectural decisions. This ensures code health assessments prioritize minimal changes to prevent further code decay.

How does heuristic-based architectural review work for software design?▼

Heuristic-based architectural review works by applying established programming principles to evaluate code health and design decisions. It identifies structural flaws like god classes to inform refactoring processes and prevent software decay.

Can I use code health heuristics for assessing specific modules?▼

Yes, you can use code health heuristics to assess specific modules by applying targeted software design principles. This identifies localized issues like deep method chains and provides guidance for refactoring that specific section.

When should I not use automated heuristics for code quality issues?▼

You should not rely solely on automated heuristics for code quality issues when architectural decisions seem irreversible or require contextual design trade-offs. Complex software decay often needs human judgment alongside heuristic-based refactoring guidance.