What problem does it solves?
Preparing a Django codebase for parallel development by multiple AI agents requires a thorough audit of app boundaries, shared state, and adherence to best practices to avoid conflicts and ensure smooth integration. This Skill provides tools and guidance for this complex task.
Core Features & Use Cases
- Automated Analysis: A Python script (
analyze-readiness.py) to automatically audit Django project structure, app organization, shared state, API contracts, tests, documentation, and dependencies.
- Assessment Dimensions: Detailed scoring and identification of issues across critical areas like app boundaries, shared mutable state, API contracts, and test infrastructure.
- Remediation Actions: Practical steps to fix common blockers, such as splitting "god apps," refactoring cross-app signals, and improving serializer definitions.
- Infrastructure Setup: Guidance on establishing project conventions (CLAUDE.md) and contract definitions for multi-agent collaboration.
- Use Case: Auditing an existing Django project for parallelization readiness, generating a report on codebase health, setting up a new Django project for multi-agent work, or identifying and fixing circular imports and tight coupling.
Quick Start
Use the parallel-ready-django skill to run the automated analysis script on the current Django project and generate a readiness report.