decomposition-planning-roadmap

Generate phased decomposition roadmaps for migrating monoliths to distributed architectures.

5.0k|454|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/tech-leads-club/agent-skills --skill decomposition-planning-roadmap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decomposition-planning-roadmap
Source: https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/%28architecture%29/decomposition-planning-roadmap
Command: npx skills add https://github.com/tech-leads-club/agent-skills --skill decomposition-planning-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineering teams plan and orchestrate the migration from monolithic codebases to distributed architectures by generating structured decomposition roadmaps, prioritizing work, and tracking progress through defined patterns.

Core Features & Use Cases

  • Current State Assessment: Evaluate decomposition readiness, inventory components, detect oversized elements, and map dependencies.
  • Pattern-Based Planning: Apply the six decomposition patterns in sequence to form a coherent plan.
  • Prioritization & Roadmap: Compute risk/value scores, resolve dependencies, and produce phased roadmaps with milestones.
  • Architecture Stories & Tracking: Generate architecture stories for tracking, plus dashboards and metrics to monitor progress.
  • Usage Scenarios: Use when planning a migration from monolith to distributed architecture, or when asked to create a decomposition roadmap, prioritize decomposition work, or track progress.

Quick Start

Use this skill to generate a decomposition roadmap for a given codebase, plan the phases, and produce architecture stories.

Frequently Asked Questions about decomposition-planning-roadmap

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

FAQPage Schema
How do I plan a migration from a monolith to distributed architecture?

To plan a monolith to distributed architecture migration, you generate a structured decomposition roadmap that assesses the current codebase, sequences decomposition patterns, and produces phased milestones for tracking the transition.

What is a decomposition roadmap and when do I need one?

A decomposition roadmap is a phased plan for migrating monolithic codebases into distributed architectures. You need one when planning codebase migration, prioritizing decomposition work, or tracking migration progress across defined patterns.

How do I prioritize decomposition work for a monolithic codebase?

You prioritize decomposition work by computing risk and value scores for codebase components, resolving dependency constraints, and sequencing six decomposition patterns into a phased roadmap with milestones.

What's the best way to assess monolith decomposition readiness?

The best way to assess monolith decomposition readiness is to inventory components, detect oversized elements, map dependencies, and evaluate the current state before generating a phased migration roadmap.

How do I track progress during a monolith migration?

You track monolith migration progress by generating architecture stories and using dashboards with metrics that monitor advancement across phased decomposition patterns and milestones.

Can I generate architecture stories for a distributed architecture migration?

Yes, you can generate architecture stories specifically for tracking distributed architecture migrations, providing structured work items that align with phased decomposition roadmaps and progress dashboards.