How does it help with business logic placement?

It provides specific heuristics to help you decide whether logic belongs in a Repository, a Service, or a Use Case based on your requirements.

Can I use this for mobile and web projects?

Yes, this skill is designed to be platform-agnostic and applies to Mobile, Web, Backend, AI/ML, CLI, and Desktop applications.

What architectural styles does this skill promote?

The skill focuses on Clean Architecture and Hexagonal principles, ensuring that dependencies flow inward toward high-level business policies.

Does it help identify circular references?

Yes, one of its primary functions is to review code for dependency violations and circular references that complicate maintenance.

Software Architecture Guide

Name: Software Architecture Guide
Author: bitsydarel

bybitsydarel

0•

開発者ツール

Enforces architectural integrity and clean code principles to ensure software features remain loosely coupled and highly testable.

The bd-software-architecture skill acts as a specialized consultant for maintaining high-level structural standards across various software platforms, including Web, Mobile, and Backend. It guides developers through the process of identifying components, organizing feature-based folder structures, and making critical decisions about where business logic should reside. By emphasizing that dependencies must flow inward toward core business rules, this skill helps teams prevent circular references, reduce technical debt during refactoring, and ensure that UI or database details do not leak into the domain logic.

主な機能

010 GitHub stars

02Enforces inward-flowing dependency rules and prevents circular references

03Validates architectural compliance during PR reviews and refactoring

04Provides heuristics for placing logic in Repositories, Services, or Use Cases

05Aligns development with Clean Architecture and SOLID principles

06Standardizes feature-folder structures across multiple platforms

ユースケース

01Refactoring a legacy monolith into modular, maintainable components

02Designing the initial folder structure and layer boundaries for a new project

03Reviewing code changes to ensure business logic is isolated from infrastructure details

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