clean-architecture

Identify and repair layer boundary and SOLID violations in Swift/iOS codebases.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill clean-architecture-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/clean-architecture
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill clean-architecture-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you diagnose and fix iOS architecture issues by enforcing SOLID principles, clear layer separation, and dependency direction so your codebase stays maintainable as it grows.

Core Features & Use Cases

  • Layer Separation Analysis: Evaluates whether Presentation, Application, Domain, and Infrastructure layers are properly isolated and wired.
  • SOLID & Dependency Direction Checks: Flags violations like domain depending on frameworks, presentation importing infrastructure, and cyclic dependencies.
  • Modern iOS Architecture Guidance: Applies Clean Architecture with iOS-appropriate patterns (e.g., TCA, Coordinator, MVVM) while keeping boundaries testable and replaceable.
  • Actionable Improvement Plan: Produces a stepwise roadmap, severity-tagged issues, and concrete “Before/After” refactoring recommendations.

Quick Start

Ask the AI to analyze your iOS feature for layer separation and SOLID compliance, and to propose specific refactor steps with a dependency direction fix.

Frequently Asked Questions about clean-architecture

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

FAQPage Schema
How do I fix SOLID violations and broken layer boundaries in an iOS Swift project?

To fix SOLID violations and broken layer boundaries in iOS, you must enforce inward-only dependency rules and isolate Presentation, Application, Domain, and Infrastructure layers. This Skill diagnoses these architecture issues and provides concrete remediation steps to restore domain framework independence.

How do I verify dependency direction in a TCA or MVVM iOS codebase during a refactor?

Verifying dependency direction in TCA or MVVM refactors involves checking that domain layers remain framework-independent and presentation layers do not import infrastructure. This Skill flags cyclic dependencies and protocol injection issues, generating a severity-tagged improvement plan.

What is the best way to separate Presentation and Domain layers in Swift concurrency code?

The best way to separate Presentation and Domain layers in Swift concurrency is to apply protocol-based injection for testability and ensure inward-only dependencies. This Skill analyzes your iOS feature and suggests specific refactor steps aligned to Swift concurrency patterns.

Can I use Clean Architecture to improve testability and replaceability in existing iOS apps?

Yes, you can use Clean Architecture to improve testability and replaceability in existing iOS apps by enforcing layer separation and dependency inversion. This Skill evaluates whether your layers are properly isolated and wired, producing actionable before/after refactoring recommendations.

Why does my iOS domain layer depend on external frameworks, and how do I isolate it?

Your iOS domain layer depends on external frameworks due to broken dependency inversion rules where higher-level modules are coupled to lower-level infrastructure. This Skill identifies these SOLID violations and provides stepwise refactoring guidance to ensure domain framework independence.

Does this architecture review approach work with both TCA and Coordinator patterns for boundary improvements?

Yes, this architecture review approach works with both TCA and Coordinator patterns by evaluating layer isolation and applying Clean Architecture guidance. It ensures boundaries remain testable and replaceable while applying iOS-appropriate patterns during refactors or PR reviews.