Decomposition Planning Roadmap

You've got a monolith and need a battle plan to break it apart without creating chaos. This walks you through a six-pattern sequence from identifying components to extracting actual services, with prioritization based on risk, value, and dependencies. The phased approach is solid: analyze and prepare first, organize into domains, then extract services. It generates architecture stories and estimates effort, which beats the usual "let's just start pulling things out" approach. The prioritization formula (value times three, minus risk times two, minus dependencies) gives you something concrete to argue about instead of going with gut feelings. Best used when you're past the initial domain analysis and need an actual migration roadmap with phases and milestones.

skills.sh installs: 314
GitHub stars: 7.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add tech-leads-club/agent-skills --skill decomposition-planning-roadmap --agent claude-code

Installs into .claude/skills of the current project.

Files

Decomposition Planning and Roadmap

This skill creates structured decomposition plans and roadmaps to guide the migration from monolithic to distributed architectures, prioritizing work and tracking progress through decomposition patterns.

How to Use

Quick Start

Request creation of a decomposition plan:

"Create a decomposition roadmap for this codebase"
"Plan the decomposition migration strategy"
"Prioritize decomposition work based on component analysis"
"Create a step-by-step decomposition plan"

Usage Examples

Example 1: Complete Roadmap

User: "Create a decomposition roadmap for this codebase"

The skill will:
1. Analyze current codebase state
2. Identify decomposition patterns to apply
3. Prioritize work based on risk and value
4. Create phased roadmap
5. Generate architecture stories
6. Estimate effort and dependencies

Example 2: Prioritized Plan

User: "Prioritize decomposition work based on component analysis"

The skill will:
1. Review component inventory and dependencies
2. Assess risk and value for each pattern
3. Prioritize patterns by impact
4. Create prioritized work plan

SKILL.md on GitHub