pragmatic-architect

Analyze software architecture and propose phased evolution plans with ADRs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/MDLDev-site/mdl-brand-website --skill pragmatic-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pragmatic-architect
Source: https://github.com/MDLDev-site/mdl-brand-website/tree/main/.claude/skills/pragmatic-architect
Command: npx skills add https://github.com/MDLDev-site/mdl-brand-website --skill pragmatic-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridges the gap between practical delivery and robust system design, helping teams design scalable, maintainable architectures that endure change.

Core Features & Use Cases

  • Context-first guidance that asks for scale, constraints, and timelines before recommending solutions.
  • Evolutionary planning with phased migrations and ADR-backed decisions to minimize risk.
  • Documentation discipline including ADRs and rationale to preserve architectural intent over time.
  • Use Case: When refactoring a monolith, you get a pragmatic plan that avoids over-engineering and ships value quickly while enabling growth.

Quick Start

Describe your current system, enumerate constraints, and request a 2-3 phase evolution plan with concrete milestones.

Frequently Asked Questions about pragmatic-architect

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

FAQPage Schema
How do I design a scalable architecture without over-engineering?

To design a scalable architecture without over-engineering, analyze your system constraints, team size, and timelines first. Propose an evolutionary plan with phased milestones to ship value quickly while enabling future growth.

What is an ADR and when do I need it for system design?

An ADR, or Architecture Decision Record, documents architectural decisions and their rationale. You need ADRs during system design to preserve architectural intent over time and provide a risk-aware trade-off framework for implementation.

How do I plan a phased migration for refactoring a monolith?

Plan a phased migration for refactoring a monolith by requesting a 2-3 phase evolution plan with concrete milestones. Describe your current system and enumerate constraints to get a pragmatic plan that ships value quickly while minimizing risk.

Can I get system design recommendations that fit my budget and timeline?

Yes, you can get system design recommendations that fit your budget and timeline. The context-first guidance asks for scale, constraints, and timelines before proposing solutions, ensuring the architecture balances purity with delivery.

What is the best way to document architectural trade-offs?

The best way to document architectural trade-offs is by producing clear rationale and ADRs. This documentation discipline ensures your risk-aware trade-off framework guides implementation and maintains architectural intent over time.

Why does my system architecture fail to scale under growing demands?

Your system architecture fails to scale when it lacks an evolutionary plan aligned with team size and budget. Analyze the core software architecture to improve scalability through phased milestones and ADR-backed decisions.