How does this skill handle shared code?

It defines a 'common/' directory for truly generic utilities used by three or more features, ensuring that business logic remains inside feature folders while shared UI or helpers are centralized.

What is the core principle of Screaming Architecture?

The core principle is to group code by its business feature or domain (e.g., 'billing', 'users') rather than its technical type (e.g., 'controllers', 'models'), making the application's purpose obvious from its folder structure.

Why does this skill discourage using index.tsx for components?

Using descriptive names (e.g., login-form.tsx) instead of generic index files makes searching for files easier in IDEs and prevents confusion when multiple 'index' tabs are open.

Does this work with React and TypeScript?

Yes, while the principles are language-agnostic, this skill provides specific patterns for React components, hooks, and TypeScript type organization.

Screaming Architecture Guidelines

Name: Screaming Architecture Guidelines
Author: acbcdev

byacbcdev

开发者工具

Organizes project files by business feature and domain intent rather than technical framework layers to improve code discoverability.

关于

This skill implements the 'Screaming Architecture' philosophy, ensuring that your project's folder structure clearly communicates its business purpose at first glance. By grouping code by feature (e.g., /features/auth) instead of type (e.g., /components), it reduces cognitive load, minimizes circular dependencies, and simplifies onboarding for new developers. It provides strict patterns for naming conventions, barrel files, and shared utilities, making it ideal for building scalable React, TypeScript, or Node.js applications that remain maintainable as they grow.

主要功能

Standardized kebab-case naming conventions for files and folders
Prevention of circular dependencies between domains
Automated barrel file (index.ts) management for clean public APIs
0 GitHub stars
Clear separation of global common utilities vs. feature-scoped logic
Feature-based folder organization and co-location

使用场景

Improving developer productivity by making code locations intuitive and predictable
Bootstraping new projects with scalable architectural best practices
Refactoring monolithic folder structures into modular, domain-driven features

关于

主要功能

Standardized kebab-case naming conventions for files and folders
Prevention of circular dependencies between domains
Automated barrel file (index.ts) management for clean public APIs
0 GitHub stars
Clear separation of global common utilities vs. feature-scoped logic
Feature-based folder organization and co-location

使用场景

Improving developer productivity by making code locations intuitive and predictable
Bootstraping new projects with scalable architectural best practices
Refactoring monolithic folder structures into modular, domain-driven features