bx-bash-clean-architecture

What problem does it solve?

This Skill provides a robust framework for structuring Bash scripts and multi-file projects, ensuring long-term maintainability, testability, and clear separation of concerns. It helps prevent common pitfalls like mixed logic and I/O, and guides developers on where functions belong across different architectural layers.

Core Features & Use Cases

• Layered Architecture: Enforces Domain, Application, and Adapter layers with strict inward dependencies.
• Dependency Inversion: Uses function name parameters to decouple components.
• Testing Strategy: Supports unit, stub, and integration testing for Bash scripts.
• Use Case: Refactoring a monolithic "god script" into a maintainable, testable application by applying clean architecture principles to Bash.

Quick Start

Use the bx-bash-clean-architecture skill to generate a new project structure for a Bash script.