code-architecture

Guide application architecture pattern selection and code organization strategies.

181|30|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/curiositech/some_claude_skills --skill code-architecture-curiositech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-architecture
Source: https://github.com/curiositech/some_claude_skills/tree/main/.claude/skills/code-architecture
Command: npx skills add https://github.com/curiositech/some_claude_skills --skill code-architecture-curiositech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers design and organize software projects to ensure long-term maintainability, testability, and understandability, preventing common architectural pitfalls.

Core Features & Use Cases

  • Architecture Pattern Selection: Guides you in choosing between Clean Architecture, Hexagonal Architecture, Vertical Slices, or Feature-Based organization based on project needs.
  • Code Organization: Provides best practices for structuring code within modules and features, promoting clarity and reducing complexity.
  • Anti-Pattern Identification: Helps detect and resolve issues like circular dependencies, fat controllers, and excessive abstraction.
  • Use Case: When starting a new project, use this Skill to decide on the best architectural pattern and folder structure, ensuring a solid foundation for future development.

Quick Start

Use the code-architecture skill to help me choose an architecture pattern for a new web application.

Frequently Asked Questions about code-architecture

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

FAQPage Schema
How do I choose between Clean Architecture and Hexagonal Architecture for my application?

Choosing between Clean Architecture and Hexagonal Architecture depends on your project's testability and module boundary needs. This Skill guides you in selecting the appropriate pattern by evaluating your specific requirements for maintainability, feature-based organization, and long-term code organization strategies.

What's the best way to structure code to avoid circular dependencies and fat controllers?

To avoid circular dependencies and fat controllers, apply SOLID principles and enforce strict module boundary management. This Skill identifies these common anti-patterns and provides actionable solutions for structuring code within modules to reduce complexity and promote architectural clarity.

How do I organize a new software project to ensure long-term maintainability?

To organize a new software project for maintainability, select an appropriate architecture pattern like Vertical Slices or Feature-Based organization. This Skill provides best practices for code organization, helping you establish a solid foundation that prevents common architectural pitfalls as the application scales.

When do I need to use SOLID principles for module boundary management?

You need to use SOLID principles for module boundary management when your codebase faces excessive abstraction or coupling. This Skill requires an understanding of SOLID principles to effectively manage dependencies between modules, ensuring your software design remains robust, testable, and understandable.

Does this architecture guidance work for fixing existing projects with bad code organization?

Yes, this architecture guidance works for fixing existing projects by identifying and resolving anti-patterns like circular dependencies and fat controllers. It helps detect architectural pitfalls in your current code organization and provides solutions to refactor toward a more maintainable and testable software structure.