How does it help with logic placement?

It provides specific heuristics and composition rules to help developers decide whether specific business logic belongs in a Repository, Service, or Use Case.

Which platforms does this skill support?

The bd-software-architecture skill is platform-agnostic and applies to Mobile, Web, Backend, AI/ML, CLI, and Desktop applications.

Can it be used for code reviews?

Yes, it is designed to review Pull Requests specifically for architectural violations, such as circular references or dependency rule breaks.

Does it provide a specific folder structure?

Yes, it guides the organization of files to physically enforce dependency rules, including public API guidelines and data flow patterns.

What is the main philosophy of this software architecture skill?

It follows the principle that dependencies must always flow inward toward high-level business policies, treating the UI and Database as external plugins to the core logic.

Software Architecture Guard

Name: Software Architecture Guard
Author: bitsydarel

bybitsydarel

0•

Developer Tools

Enforces architectural standards and structural patterns across the software development lifecycle to ensure maintainability and testability.

This skill provides a comprehensive framework for designing and maintaining robust software architectures across various platforms, including web, mobile, and backend systems. By implementing a "dependency-inward" philosophy, it helps developers organize folder structures, resolve logic placement dilemmas (such as Service vs. Repository), and eliminate circular dependencies. Whether you are refactoring a legacy monolith or scaffolding a new feature, this skill acts as an automated architect to ensure your codebase remains loosely coupled, highly testable, and easy to maintain.

Key Features

01Dependency violation and circular reference detection

020 GitHub stars

03Logic placement heuristics for Repositories, Services, and Use Cases

04Automated folder structure design for new features

05Cross-platform architectural enforcement for Mobile, Web, and Backend

06Inward-flowing dependency mapping based on Clean Architecture principles

Use Cases

01Conducting architectural reviews of Pull Requests to ensure compliance with design patterns

02Scaffolding a new feature with a standardized, scalable folder structure

03Refactoring legacy monolithic code into a modular, decoupled architecture

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