concept-refactor

Refactor concept designs using six transformational moves across splitting, merging, unifying, and specialising.

1|Updated Mar 10, 2025
One-click install
npx skills add https://github.com/igorrazvodovsky/pattern-playground --skill concept-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: concept-refactor
Source: https://github.com/igorrazvodovsky/pattern-playground/tree/main/.claude/skills/concept-refactor
Command: npx skills add https://github.com/igorrazvodovsky/pattern-playground --skill concept-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps refine and optimize existing concept designs by applying six systematic transformational moves. It addresses common design trade-offs, allowing you to improve flexibility, simplicity, generality, specificity, automation, or independent control, leading to more robust and adaptable software. This reduces future rework and enhances system maintainability.

Core Features & Use Cases

  • Six Transformational Moves: Guides through applying Split/Merge, Unify/Specialise, and Tighten/Loosen strategies to concepts.
  • Trade-off Management: Explicitly helps navigate the balance between design qualities like flexibility vs. simplicity or automation vs. control.
  • Problem-Driven Refactoring: Provides a workflow to identify design problems (e.g., monolithic concepts, concept proliferation, error-prone coordination) and select the appropriate refactoring move.
  • Use Case: After an initial concept design phase, use this skill to systematically review and improve the concepts, ensuring they are well-suited for their intended purpose and user base.

Quick Start

I have a "User Management" concept that feels too broad. Should I split it, and if so, how?

Frequently Asked Questions about concept-refactor

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

FAQPage Schema
How do I refactor a concept design that's too rigid or complex?

Refactor concept designs using six transformational moves—split/merge, unify/specialise, and tighten/loosen—to resolve rigidity and complexity. Map your concepts, select the appropriate move based on your design problem, then apply state and action updates while managing trade-offs like flexibility versus simplicity.

When should I split versus merge concepts in my design?

Split concepts when they're monolithic or doing too much, reducing coordination errors and increasing specialization. Merge when concept proliferation creates overhead. The workflow helps you inventory relationships, identify which move addresses your specific problem, then evaluate the trade-off between generality and control.

What's the difference between unifying and specialising design concepts?

Unifying consolidates related concepts to increase automation and reduce independent control surfaces; specialising divides concepts to increase independent control and reduce shared coupling. Choose based on whether your current design needs tighter coordination or looser autonomy.

How do I know if my concept design needs tightening or loosening?

Tighten concepts when you need to reduce flexibility and increase simplicity through stronger synchronization. Loosen when you need more flexibility and generality with independent control. The skill's workflow guides you to inventory concepts, map relationships, and evaluate trade-offs before refactoring.

Can I use concept refactoring after my initial design is complete?

Yes. Concept refactoring applies after initial design phases to systematically review and improve concepts. It ensures your design is well-suited for its intended purpose and user base by identifying rigidity, complexity, or coordination problems and applying targeted transformational moves.

What design problems does concept refactoring actually solve?

It solves monolithic concepts, concept proliferation, error-prone coordination, and inflexible architectures. The six moves address scenarios where you need to increase flexibility, generality, automation, specificity, or independent control, reducing future rework and enhancing system maintainability.