What is the Vertical vs. Horizontal mental model?

Verticals (features/) contain all code specific to one feature, grouped together. Horizontals (platform/) contain shared capabilities used by multiple features across the system.

How does this skill help with code readability?

It enforces the separation of intent from execution, ensuring high-level flows are visible at the top level while implementation details are hidden in lower-level methods.

Why are entrypoints forbidden from importing from the domain layer?

To maintain strict separation where entrypoints only handle input parsing and output mapping. This ensures domain logic is only invoked through the orchestration of use-cases.

Where should external API clients and database drivers live?

Generic wrappers for external services belong in platform/infra/external-clients/, keeping the feature-specific code focused purely on business logic.

What happens if a piece of logic is used by two different features?

The skill identifies this as a shared capability and moves it into platform/domain/, naming it for what it is rather than which feature first utilized it.

Separation of Concerns Architect

Name: Separation of Concerns Architect
Author: NTCoding

byNTCoding

•

121

•

API 开发

Enforces clean architecture patterns through structured folders and strict dependency rules for maintainable, scalable software development.

This skill guides Claude in implementing a robust Separation of Concerns (SoC) architecture, organizing code into features (verticals), platform (horizontals), and shell layers. It ensures clear boundaries between external clients, domain logic, and orchestration, preventing spaghetti code by enforcing a strict 'Vertical/Horizontal' mental model. By applying specific principles like separating intent from execution and isolating state dependencies, it helps developers build systems that are easier to test, refactor, and evolve over time.

主要功能

01Enforces 'Vertical Slice' organization via feature-specific entrypoints and use-cases.

02Centralizes shared capabilities within a structured platform/ domain and infra layer.

03Refactors code based on state dependency and semantic naming alignment.

04121 GitHub stars

05Separates intent from execution to ensure high-level business flow readability.

06Validates strict dependency rules, such as preventing entrypoints from touching domain logic.

使用场景

01Refactoring monolithic service files into a clean, feature-based directory structure.

02Scaffolding new project modules with pre-defined architectural boundaries and layers.

03Automating code reviews to identify leaked domain logic or improper cross-feature dependencies.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ntcoding/claude-skillz separation-of-concerns

For use in Claude.ai and ChatGPT

Download Skill