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.