# Story Dependency Analysis Report

> ✅ **Works with any IDE** - Template for documenting dependency analysis results

## Analysis Summary

- **Analysis Date**: {date}
- **Total Stories Analyzed**: {story_count}
- **Conflict Zones Identified**: {conflict_count}
- **Recommended Waves**: {wave_recommendation}

## Story File Dependencies

### Detailed Analysis

{for each story}

#### Story {story_id}: {story_title}

**Status**: {status}
**Complexity**: {complexity_score}/10

**Files to be Modified**:

- Primary files:
  {primary_files_list}
- Test files:
  {test_files_list}
- Configuration files:
  {config_files_list}

**Dependencies**:

- Imports from: {import_dependencies}
- Imported by: {reverse_dependencies}
- Shared utilities: {shared_utilities}

**Potential Conflicts**:

- Direct conflicts with: {direct_conflicts}
- Indirect conflicts with: {indirect_conflicts}
- Risk level: {risk_level}
  {/for each}

## Conflict Matrix

| Story      | {story_ids...}     |
| ---------- | ------------------ |
| {story_id} | {conflict_markers} |

Legend:

- ✓ = No conflict
- ⚠️ = Indirect conflict (shared dependencies)
- ❌ = Direct conflict (same files)

## Dependency Graph

```mermaid
graph TD
    {dependency_graph_content}
```

## Wave Grouping Recommendations

### Option 1: Maximum Parallelization

- **Wave 1**: {stories} (No conflicts)
- **Wave 2**: {stories} (After Wave 1 dependencies)
- **Wave 3**: {stories} (Remaining conflicts)
- **Parallel Efficiency**: {efficiency_percentage}%

### Option 2: Balanced Approach

- **Wave 1**: {stories} (Mixed complexity)
- **Wave 2**: {stories} (Mixed complexity)
- **Parallel Efficiency**: {efficiency_percentage}%

### Option 3: Conservative Approach

- **Wave 1**: {stories} (Low risk)
- **Wave 2**: {stories} (Medium risk)
- **Wave 3**: {stories} (High risk)
- **Parallel Efficiency**: {efficiency_percentage}%

## Risk Assessment

### High-Risk Combinations

1. **{story_pair}**: Both modify {shared_file}
   - Recommendation: Sequential execution
   - Alternative: Coordinate changes

2. **{story_pair}**: Shared component dependencies
   - Recommendation: Different waves
   - Alternative: Clear boundaries

### Medium-Risk Areas

- Database migrations: {stories}
- API contracts: {stories}
- Shared components: {stories}

### Low-Risk Opportunities

- Independent features: {stories}
- Isolated modules: {stories}
- Documentation updates: {stories}

## Integration Considerations

### Merge Order Recommendation

1. {story_id} - Foundation changes
2. {story_id} - Dependent features
3. {story_id} - UI components
4. {story_id} - Integration layer

### Pre-Integration Checklist

- [ ] All tests passing individually
- [ ] No uncommitted changes
- [ ] Feature branches up to date
- [ ] Integration tests prepared

## Optimization Opportunities

### Parallel Development Efficiency

- **Sequential Time**: {sequential_estimate}
- **Parallel Time**: {parallel_estimate}
- **Time Saved**: {time_saved}
- **Efficiency Gain**: {efficiency_percentage}%

### Resource Utilization

- **Available Agents**: {agent_count}
- **Optimal Wave Size**: {optimal_size}
- **Context Switching**: {context_overhead}

## Recommendations

1. **Immediate Actions**:
   - {recommendation_1}
   - {recommendation_2}

2. **Preparation Steps**:
   - {prep_step_1}
   - {prep_step_2}

3. **Monitoring Focus**:
   - {monitor_area_1}
   - {monitor_area_2}

## Command Suggestions

```bash
# Recommended execution
/stories --waves {recommended_waves} --sophistication 1

# Alternative for risk mitigation
/stories:manual {manual_story_order}

# Monitoring command
/stories:status --verbose
```