architecture-planner

Purpose

The architecture-planner skill provides comprehensive guidance for designing component architecture and module structure in feature implementations. This skill helps the Architecture Designer agent plan clean, layered architectures following established patterns such as Layered Architecture, Hexagonal Architecture (Ports and Adapters), and Clean Architecture principles.

This skill emphasizes:

• Clear component boundaries with single responsibilities
• Layer separation between interfaces, business logic, and data access
• Dependency injection for testability and flexibility
• Extension points for future enhancements
• Design patterns that improve maintainability

The architecture-planner skill is essential for creating implementations that are easy to test, maintain, and extend over time.

When to Use

This skill auto-activates when the agent describes:

• "Plan component architecture for..."
• "Design module structure with..."
• "Separate concerns into layers..."
• "Structure the codebase with..."
• "Organize components using..."
• "Define interfaces between..."
• "Create extension points for..."
• "Apply architectural pattern..."

Provided Capabilities

1. Component Identification and Boundaries

What it provides:

• Identification of distinct components based on responsibilities
• Clear component boundaries following Single Responsibility Principle
• Component naming conventions and file organization
• Determination of component granularity (not too large, not too small)

Guidance:

• Each component should have ONE primary responsibility
• Components should be independently testable
• Components should have minimal coupling with others
• Use descriptive names that reflect the component's purpose

Example:

# Good: Clear, focused components
components = [
    {
        "name": "FeatureProcessor",
        "responsibility": "Process feature requests according to business rules",
        "file": "src/core/processor.py"
    },
    {
        "name": "DataValidator",
        "responsibility": "Validate input data against schemas",
        "file": "src/core/validator.py"
    },
    {
        "name": "ResultFormatter",
        "responsibility": "Format processing results for output",
        "file": "src/core/formatter.py"
    }
]

# Bad: Too broad, multiple responsibilities
components = [
    {
        "name": "FeatureHandler",
        "responsibility": "Process, validate, format, store, and log features",
        "file": "src/feature_handler.py"  # Too many responsibilities!
    }
]