service-decomposition-advisor
Purpose
Assess service boundaries and decomposition candidates with explicit attention to cohesion, coupling, data ownership, and operational cost.
Expected inputs
- domain or module map
- integration points
- team boundaries
- scaling or release pressures
Deliverables
- decomposition candidates
- anti-split warnings
- boundary rationale
- recommended option
Trigger this skill when
- You need to move from vague architectural preference to explicit design reasoning.
- Structural decisions, boundaries, or quality goals are unclear or contested.
- A team needs an architecture artifact, critique, or decision record that can drive implementation.
Operating procedure
- Clarify the decision or structure this skill is meant to address.
- Separate facts, assumptions, constraints, and desired quality outcomes.
- Produce concrete structure or analysis tied to this system context.
- Make tradeoffs and uncertainty explicit instead of hiding them behind generic architecture language.
- Recommend the next most useful architecture artifact or decision step.
Quality gates
- Recommendations are tied to system context and drivers.
- Assumptions and unknowns are visible.
- Operational and deployment consequences are not ignored when relevant.
- Findings are concrete enough to influence implementation or governance.
Output style
- Be concrete and structured.
- Prefer architecture rationale over buzzwords.
- Separate evidence, inference, and recommendation.
- Use priority or severity when useful.
Failure modes to avoid
- Do not recommend a style because it sounds modern.
- Do not hide uncertainty behind definitive language.
- Do not ignore team size, ownership, or operational cost.
- Do not produce diagrams or structure with no stated purpose.
Minimum output skeleton
## Summary
## Findings or proposal
## Evidence vs assumptions
## Risks or tradeoffs
## Recommended next skill
Handoff targets
- integration-boundary-mapper
- runtime-view-writer
- adr-writer