architecture

Design software with Clean Architecture patterns and explicit boundaries.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/ddsyasas/pomodoro-app-shared --skill architecture-ddsyasas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/ddsyasas/pomodoro-app-shared/tree/main/pomodoro-app/.claude/skills/architecture
Command: npx skills add https://github.com/ddsyasas/pomodoro-app-shared --skill architecture-ddsyasas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to designing software using Clean Architecture principles, helping teams separate concerns, define clear boundaries, and enforce inward-facing dependencies to reduce coupling.

Core Features & Use Cases

  • Identify layers and boundaries, including Entities, Use Cases, Interface Adapters, and Frameworks & Drivers.
  • Apply the Dependency Rule to ensure all dependencies point inward toward higher-level policies.
  • Define use cases and interactors, with simple boundary data structures for crossing boundaries.
  • Create proper boundary data structures (DTOs) and apply SOLID principles to design for testability and maintainability.
  • Follow the recommended design patterns and framework-independence practices to maintain architectural integrity.

Quick Start

Outline a Clean Architecture plan for a new feature in a hypothetical app. Define the Use Case input boundary, interactor, output boundary, and a simple boundary DTO crossing the boundary. Provide a high-level inward data flow map from UI to use cases to entities.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I design software using clean architecture patterns?

Clean architecture design separates concerns by defining explicit layers like entities, use cases, and interface adapters. This approach establishes clear module boundaries, enforces inward-facing dependencies, and reduces system coupling for better maintainability.

What is the dependency rule in clean architecture?

The dependency rule mandates that all dependencies point inward toward higher-level policies. Source code dependencies must only cross boundaries pointing inward, ensuring outer layers like frameworks and controllers depend on inner use cases and entities, never the reverse.

How do I define use cases and interactors with boundary data structures?

Define use cases and interactors by creating simple boundary data structures, such as DTOs, for crossing boundaries. You outline input boundaries, interactors, and output boundaries to ensure data transfer remains isolated from internal application logic.

When do I need to apply clean architecture for feature development?

Apply clean architecture during feature development and module planning when you need framework independence and high testability. It enforces SOLID principles through defined input and output boundaries, making it ideal for complex systems requiring strict separation of concerns.

Does clean architecture work without external dependencies or frameworks?

Yes, clean architecture maintains framework independence by treating frameworks and drivers as outer layers. This design keeps your inner entities and use cases isolated, allowing you to swap external dependencies without impacting core business logic.