dependency-mapping

Dependency Mapping Skill

Map dependencies between implementation slices using Design Structure Matrix (DSM), calculate risk scores, and recommend implementation sequence.

When to Use

• During Ask mode Phase 2 (CONVERGE)
• When planning multi-slice features
• Before phasing to understand risk order

Instructions

Phase 1: Build DSM Matrix

Create a square matrix with slices on both axes. Mark dependencies with *:

         | #1.1 | #1.2 | #2.1 | #2.2 | #2.3 | #3.1 |
---------+------+------+------+------+------+------+
#1.1     |  -   |      |      |      |      |      |
#1.2     |  *   |  -   |      |      |      |      |
#2.1     |      |  *   |  -   |      |      |      |
#2.2     |      |      |  *   |  -   |      |  *   |
#2.3     |      |  *   |  *   |      |  -   |      |
#3.1     |      |      |      |      |      |  -   |

Legend: * = row depends on column
Reading: Row #2.2 has * in columns #2.1 and #3.1 = #2.2 depends on #2.1 AND #3.1

Phase 2: Calculate Dependency Score

For each slice, count:

Metric	Formula	Meaning
Fan-in	How many slices depend ON this?	High = blocker, ship early
Fan-out	How many slices does this DEPEND on?	High = risky, ship later
Dependency Score	Fan-out count	Lower = safer

Phase 3: Calculate Leverage Score

Score each slice on reuse of existing patterns:

Level	Score	Description
Full Reuse	0	Uses existing component from design system/Storybook as-is
Extend	1	Extends existing component with new props/variants
Compose	2	Composes multiple existing components
New Pattern	3	Creates new component following design system tokens
New System	5	Requires new patterns not in design system

Check these sources before scoring:

• /docs/design-system/components.md - Existing components
• Glob **/*.stories.tsx - Storybook patterns
• SemanticSearch for similar implementations in codebase

Phase 4: Calculate Risk Score

Risk Score = (Dependencies x 2) + Leverage + PriorityTier

Where PriorityTier:
- P1 (Frontend-only) = 0
- P2 (Frontend + Backend non-breaking) = 1
- P3 (Backend contract changes) = 2
- P4 (Data model changes) = 3

Phase 5: Identify Blockers

Flag slices that block others (high fan-in):

#3.1 WorkspaceInvite Entity
  Fan-in: 3 (blocks #2.2, #2.3, #2.4)
  RECOMMENDATION: Consider stub/mock for Phase 1, or ship early despite risk

Phase 6: Rank by Risk

Sort slices by Risk Score (lowest first = ships first):

Rank	Slice	Deps	Leverage	Tier	Risk Score
1	#1.1 Workspace Switcher	0	Extend (1)	P1 (0)	1
2	#1.2 Members Page UI	1	Compose (2)	P1 (0)	4
3	#2.1 List Members API	1	N/A	P2 (1)	4

Output Format

## Dependency Analysis

### DSM Matrix

[Matrix as shown above]

### Risk Scoring

| Slice | Deps | Leverage | Tier | Risk | Rank |
|-------|------|----------|------|------|------|
| [Slice] | [N] | [Level (score)] | P[N] | [Score] | [#] |

### Blockers Identified

| Slice | Blocks | Fan-in | Recommendation |
|-------|--------|--------|----------------|
| [Slice] | [List] | [N] | [Stub/Ship early/etc] |

### Recommended Sequence

1. [Lowest risk slice] - [Why safe]
2. [Next slice] - [Dependencies satisfied by #1]
...

### Existing System Leverage

| Component | Source | Slices Using | LOC Saved |
|-----------|--------|--------------|-----------|
| [Component] | [design-system/Storybook] | [List] | ~[N] |

Invocation

Invoke manually with "use dependency-mapping skill" or follow Ask mode Phase 2 (CONVERGE) which references this skill.

Related Skills

• phasing - Uses risk scores to group into phases
• design-context - Identifies existing patterns to leverage
• gtm-alignment - May override risk-based order for GTM priority