skills.rest
hung-phan
hung-phanCOMMUNITY
Explore all skills by this author →
GitHub

pragmatic-programmer

Identifies software quality issues using Pragmatic Programmer heuristics.

Updated Jun 5, 2026
Search Tags:#code quality#refactoring#software design#heuristics#architectural review
One-click install
npx skills add https://github.com/hung-phan/system-skills --skill pragmatic-programmer-hung-phan
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
1toe1toe

critique

Critique web or app designs for usability, visual hierarchy, and quality.

Community
Advanced
mscipiomscipio

refactor-workflow

Refactor code incrementally while verifying tests pass before and after each transformation.

Community
Advanced
Kushal9889Kushal9889

husky

Sets up Husky git hooks to automate code quality checks and testing before commits.

Community
Intermediate
CuriousLearnerCuriousLearner
27

complexity-analyzer

Measure code complexity metrics and identify high-complexity areas in software projects.

Community
Advanced