pragmatic-engineering

Apply a 5-step framework to simplify software planning and reviews.

20|3|Updated Aug 16, 2016
One-click install
npx skills add https://github.com/heyJordanParker/dotfiles --skill pragmatic-engineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pragmatic-engineering
Source: https://github.com/heyJordanParker/dotfiles/tree/main/claude/.claude/skills/pragmatic-engineering
Command: npx skills add https://github.com/heyJordanParker/dotfiles --skill pragmatic-engineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pragmatic Engineering helps avoid overengineering by guiding teams to pursue minimal, ship-first designs. It emphasizes fast delivery, iterative learning, and clear decision criteria to prevent feature creep.

Core Features & Use Cases

  • KISS-driven planning: Prioritize simple, robust solutions and prune unnecessary complexity.
  • 5-step decision framework: Apply questions, delete, simplify, speed up, automate to reach a minimal viable approach.
  • Code & architecture reviews: Use the rules to simplify code and design without sacrificing value.
  • Use Case: When evaluating a new feature, run the framework to determine if it truly adds value or if it should be simplified.

Quick Start

Ask it to review a feature proposal and outline a minimal, shipping-focused plan that avoids overengineering.

Frequently Asked Questions about pragmatic-engineering

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

FAQPage Schema
How do I avoid overengineering during software feature planning?

To avoid overengineering in feature planning, apply a 5-step decision framework: Question, Delete, Simplify, Speed up, and Automate. This method guides teams toward minimal, ship-first designs by pruning unnecessary complexity and preventing feature creep.

What is the best way to simplify architecture and code reviews?

The best way to simplify architecture and code reviews is using KISS-driven planning principles. By applying a simplicity-focused decision framework, you can evaluate whether components truly add value and strip out unnecessary complexity without sacrificing robustness.

How does the Question, Delete, Simplify, Speed up, Automate framework work?

The Question, Delete, Simplify, Speed up, Automate framework works by sequentially evaluating a feature proposal to reach a minimal viable solution. It questions value, deletes unnecessary parts, simplifies design, accelerates delivery, and automates tasks to ensure fast shipping.

Can I use this pragmatic engineering approach for team-level architectural decisions?

Yes, you can use this pragmatic engineering approach for team-level architectural decisions. It provides clear decision criteria focused on iterative learning and fast delivery, specifically helping teams seeking simple, shipping-first outcomes avoid feature creep.

When should I not use a minimal viable solution approach for shipping code?

You should not use a minimal viable solution approach when a feature requires complex, non-iterative compliance or deep architectural overhauls that cannot be safely simplified. The framework prioritizes fast delivery and pruning complexity, which may skip necessary robust design elements.