parallel-fix-django

parallel-fix-django

Category: Parallel Development (Django)

Usage

/parallel-fix-django [--dimension <name>] [--dry-run]

Arguments

• --dimension: Optional - Focus on specific dimension (app-boundaries, shared-state, contracts, tests, docs, deps)
• --dry-run: Optional - Show what would be fixed without making changes

Purpose

Fix blockers identified by /parallel-ready-django to prepare the Django codebase for parallel multi-agent development. References the remediation-checklist.md from the skill.

Prerequisites

• Run /parallel-ready-django first
• .claude/readiness-report.md must exist with identified blockers

Execution Instructions for Claude Code

When this command is run, Claude Code should:

1. Read Readiness Report

cat .claude/readiness-report.md

Parse the "Blockers" and "Risks" sections to identify what needs fixing.

2. Fix by Dimension

App Boundaries Fixes

Problem: God App (>15 models)

1. Identify models that can be grouped by domain
2. Create new Django app: python manage.py startapp [domain] apps/[domain]
3. Move models incrementally with migrations
4. Update all imports
5. Verify tests pass

Problem: Circular Imports

# Before - circular import
from apps.orders.models import Order  # in users/models.py
from apps.users.models import User    # in orders/models.py

# After - use string reference
class Order(models.Model):
    user = models.ForeignKey("users.User", on_delete=models.CASCADE)

Problem: Cross-App Imports >30%

1. Identify shared types/utilities
2. Create apps/shared/ app for common code
3. Move shared code to shared app
4. Update imports to use shared

Shared State Fixes

Problem: Cross-App Signals

# Before - implicit signal
@receiver(post_save, sender=User)
def create_user_stats(sender, instance, created, **kwargs):
    if created:
        UserStats.objects.create(user=instance)

# After - explicit service call
class UserService:
    def __init__(self, stats_service: StatsService):
        self.stats_service = stats_service

    def create_user(self, email: str, name: str) -> User:
        user = User.objects.create(email=email, name=name)
        self.stats_service.initialize_for_user(user.id)
        return user