architecture

Enforce module boundaries and scalable folder layouts in software projects.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/AlexanderStephenThompson/claude-hub --skill architecture-alexanderstephenthompson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/AlexanderStephenThompson/claude-hub/tree/main/core/skills/architecture
Command: npx skills add https://github.com/AlexanderStephenThompson/claude-hub --skill architecture-alexanderstephenthompson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams enforce clear module boundaries and scalable project layouts.

Core Features & Use Cases

  • Guiding Principles: explicit boundaries, ownership, and predictable dependency flow.
  • Folder Structure Guidance: advocating a three-layer layout (01-presentation / 02-logic / 03-data) and feature-based organization.
  • Use Cases: architecture audits, onboarding new engineers, and guiding refactors to minimize cross-cutting changes.

Quick Start

Apply these principles when starting a new project: define the public module API, establish the 01-02-03 folder structure, and document boundaries in a module-boundary readme.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I enforce module boundaries and scalable project layouts in my software architecture?

To enforce module boundaries and scalable project layouts, define explicit surface APIs, establish a predictable three-layer folder structure, and document ownership rules to guide both new initiatives and refactors.

What is the best way to structure folders for feature-based modularity and predictable dependency flow?

The best way to structure folders for feature-based modularity is adopting a three-layer layout with 01-presentation, 02-logic, and 03-data directories, ensuring predictable dependency direction across modules.

How do I guide an architecture audit or refactor to minimize cross-cutting changes?

Guide an architecture audit or refactor by codifying architecture principles to evaluate explicit boundaries, ownership, and dependency flow, which minimizes cross-cutting changes during structural restructuring.

Can I use these software design principles for onboarding new engineers to an existing codebase?

Yes, you can use these software design principles for onboarding new engineers. The explicit module boundaries and predictable folder architecture provide clear guidance on project structure and code ownership.

When should I not use a strict three-layer folder architecture for my software design?

You should not use a strict three-layer folder architecture when your software project lacks designable structures or when the codebase does not require explicit surface APIs and strict dependency direction rules.