Does it help with folder organization?

Absolutely. It provides a standard feature folder structure and public API guidelines to physically enforce dependency rules within your project.

How does this skill help with code reviews?

It identifies circular references and dependency violations to ensure that new code adheres to your established architectural policies and layer definitions.

What architectural philosophy does this skill promote?

It follows the principle that dependencies must always flow inward toward high-level policies, treating the UI and Database as interchangeable details or plugins.

How do I decide between a Repository and a Service?

The skill includes specific decision heuristics to help you determine exactly where business logic belongs based on composition rules and component nature.

Can I use this for mobile development?

Yes, this skill is platform-agnostic and provides specific guidance for Mobile, Web, Backend, AI/ML, CLI, and Desktop applications.

BD Software Architecture

Name: BD Software Architecture
Author: bitsydarel

bybitsydarel

0•

Developer Tools

Enforces architectural standards and dependency rules to ensure scalable, maintainable software design across all platforms.

This skill provides a comprehensive framework for designing and refactoring software with a focus on loose coupling and high testability. By implementing inward-flowing dependency patterns and clear layer separation—from Domain and Use Cases to outer layers—it helps developers organize feature folders, make informed decisions between Repositories and Services, and identify architectural anti-patterns. Whether you are building a new feature from scratch or breaking down a legacy monolith, this tool ensures your codebase remains clean, compliant, and easy to maintain across web, mobile, and backend environments.

Key Features

01Dependency violation and circular reference detection

02Standardized feature-based folder organization guidelines

03Heuristic-based logic placement between Services and Repositories

040 GitHub stars

05Automated architectural enforcement for layer-based design

06Strategic guidance for refactoring legacy monoliths into modules

Use Cases

01Designing the folder structure and public API for a complex new software feature

02Refactoring legacy codebases into modern, testable architectural patterns

03Reviewing Pull Requests to detect architectural debt or dependency leaks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bitsydarel/bdskills bd-software-architecture

For use in Claude.ai and ChatGPT

Download Skill