Manage Architecture

What problem does it solve?

This Skill defines and enforces robust architecture and import strategies to prevent circular imports, promote modular design, and eliminate "Import Hell" in large codebases.

Core Features & Use Cases

• Absolute vs Relative imports guidance: Cross-package references use ABSOLUTE imports, while intra-package siblings use RELATIVE imports to keep boundaries clean.
• Public API pattern: Export key components in package init.py to avoid importing deep modules directly.
• Structural Integrity & Packaging: Encourage grouping by domain, enforce module size considerations, and prevent God files by distributing logic across sub-packages.
• Review Protocol & Troubleshooting: Provide a standard checklist before changes and guidance for common import issues.
• Use Case: A large monorepo with multiple packages maintaining clean import graphs and easy evolvability.

Quick Start

Enforce architecture standards across your codebase by applying absolute imports for cross-package references, using relative imports for siblings, and exporting essential symbols in init.py to avoid deep imports.