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.