system-design-decomposition

Decompose system designs into a Phase 1–5 study with an ADR.

Updated Mar 29, 2026

Search Tags:#learning #decomposition #principles #ADR #system-design #architecture-diagrams #architecture-analysis

Ready to run

npx skills add https://github.com/gokuno1/research-agent-mcp --skill system-design-decomposition

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: system-design-decomposition
Source: https://github.com/gokuno1/research-agent-mcp/tree/main/.cursor/skills/system-design-decomposition
Command: npx skills add https://github.com/gokuno1/research-agent-mcp --skill system-design-decomposition

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

System designers and learners often struggle to build a transferable mental model of how complex systems are put together. This skill provides a structured, phase-based approach to study architecture, components, decisions, and the reusable principles that emerge from them, without requiring source code reading.

Core Features & Use Cases

Phase-based study methodology (Phase 1–Phase 5) to guide deep understanding of any system.
Ability to extract design decisions, tradeoffs, and generalizable principles for quick reference.
Use cases include studying messaging systems, storage engines, or concurrency primitives to compare architectures at a high level and derive transferable insights.

Quick Start

Plan a study by outlining the problem space, mapping the architecture, evaluating design decisions, extracting principles, and drafting an Architecture Decision Record (ADR).

Frequently Asked Questions about system-design-decomposition

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

FAQPage Schema

How do I analyze system design and architecture without reading the source code?▼

You can analyze system design without source code by applying a structured phase-based methodology to map architecture, evaluate design decisions, extract principles, and draft an Architecture Decision Record.

What is the best way to study the architecture of complex systems like Kafka or RocksDB?▼

The best way to study complex systems like Kafka or RocksDB is to decompose them into problem space, architecture maps, design decisions, and reusable principles to build a transferable mental model.

How do I create an Architecture Decision Record for an existing software system?▼

To create an Architecture Decision Record for an existing system, evaluate its design tradeoffs through a phased study, extracting problem space definitions, architecture maps, and generalizable principles for the final ADR.

Does this system design decomposition method require any specific technical dependencies or components?▼

The system design decomposition method requires no specific dependencies or components, allowing you to study messaging systems, storage engines, and concurrency primitives purely through architecture analysis.

Can I compare the design decisions and tradeoffs of different messaging systems using this approach?▼

Yes, you can compare design decisions and tradeoffs of different messaging systems by executing the phased study to derive transferable insights and generalizable principles from their high-level architectures.

When do I need a structured methodology to extract reusable patterns from software architecture?▼

You need a structured methodology to extract reusable patterns when you struggle to build a transferable mental model of how complex systems are put together and want to avoid deep source-code review.