clean-architecture-guidelines

Provide guidelines for implementing Clean Architecture, DDD, and Clean Code principles.

Updated Aug 6, 2023
One-click install
npx skills add https://github.com/k2bg-technology/k2bg-branding --skill clean-architecture-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture-guidelines
Source: https://github.com/k2bg-technology/k2bg-branding/tree/main/.claude/skills/clean-architecture-guidelines
Command: npx skills add https://github.com/k2bg-technology/k2bg-branding --skill clean-architecture-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive framework for designing and implementing software that is scalable, maintainable, and testable by adhering to Clean Architecture, Domain-Driven Design, and Clean Code principles.

Core Features & Use Cases

  • Architectural Guidance: Offers a clear, layered architecture with defined dependency rules.
  • Design Patterns: Implements key DDD tactical patterns like Entities, Value Objects, Aggregates, and Domain Services.
  • Code Quality: Enforces Clean Code principles for readable and efficient code.
  • Use Case: When starting a new project or refactoring an existing one, use these guidelines to structure modules, define interfaces, and ensure business logic remains isolated and testable.

Quick Start

Follow the recommended directory structure for organizing your modules and infrastructure code.

Frequently Asked Questions about clean-architecture-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure my software project to follow Clean Architecture?

To structure a software project for Clean Architecture, follow a defined layered directory structure with strict dependency rules, ensuring dependencies point inward toward the domain to enforce separation of concerns.

What are the tactical DDD patterns for building maintainable software?

Tactical DDD patterns for maintainable software include Entity, Value Object, Aggregate, and Domain Service. These patterns isolate business logic, making applications robust, testable, and strictly separated from infrastructure.

Why does my business logic mix with infrastructure in my current architecture?

Business logic mixes with infrastructure when strict separation of concerns is unenforced. Clean Architecture solves this by isolating domain models and applying inward dependency direction rules to keep logic testable.

What is the best way to isolate business logic for better testability?

The best way to isolate business logic for testability is applying Clean Code principles and DDD tactical patterns. This isolates domain rules from external concerns, ensuring applications remain scalable and testable.

Can I use Clean Architecture guidelines when refactoring an existing application?

Yes, you can use Clean Architecture guidelines when refactoring an existing application. They provide a framework to restructure modules, define interfaces, and enforce separation of concerns to make the application maintainable.

When do I need Domain-Driven Design in my software development process?

You need Domain-Driven Design when building scalable, maintainable software. It provides tactical patterns like Aggregates and Domain Services to manage complex business logic and ensure strict separation of concerns.