{"enrichment":{"faq":[{"a":"code-architecture guides you through selecting patterns like clean, hexagonal, feature-based, and vertical slice architectures tailored to Node.js projects. The skill helps you evaluate team size and domain complexity to choose the right fit, then walks through folder structure, dependency inversion, and module boundaries specific to Node environments. Each pattern trades simplicity for testability and maintainability differently.","q":"What clean architecture patterns work best for Node.js?"},{"a":"code-architecture covers feature-based organization by defining clear module boundaries around business capabilities rather than technical layers. It shows how to structure folders vertically around features, establish dependency rules between features, and use barrel exports to control what each feature exposes. The skill also addresses when feature-based structure outperforms layer-based approaches and how to prevent cross-feature coupling.","q":"How do I organize code in a feature-based structure?"},{"a":"code-architecture diagnoses circular dependency problems by identifying where modules depend on each other cyclically, then applies dependency inversion and clear module boundaries to break cycles. The skill teaches you to extract shared abstractions, use interfaces to decouple modules, and restructure folder hierarchies so dependencies flow in one direction. It also covers detecting these issues early through architecture reviews.","q":"How can I fix circular dependencies in TypeScript?"},{"a":"code-architecture identifies the fat controller problem\u2014when a single controller handles too many responsibilities\u2014and shows how to refactor it into focused use cases and domain logic. The skill guides you toward extracting business logic into separate layers, organizing code around user workflows rather than HTTP verbs, and applying SOLID principles at module scale to keep controllers thin and testable.","q":"What is the fat controller problem and how do I solve it?"},{"a":"code-architecture provides a decision framework comparing clean and hexagonal patterns based on team experience, domain complexity, and infrastructure needs. Clean architecture emphasizes concentric layers and testability; hexagonal (ports and adapters) emphasizes external dependency isolation. The skill helps you weigh trade-offs: hexagonal adds abstraction overhead but excels when you need to swap infrastructure; clean is simpler for smaller teams and domains.","q":"When should I use clean vs hexagonal architecture?"},{"a":"code-architecture teaches you to recognize symptoms like fat controllers, circular dependencies, unclear module boundaries, and tight coupling between features. The skill walks through diagnostic techniques\u2014mapping dependency graphs, measuring module cohesion, reviewing folder structure\u2014and connects problems to root causes. Once identified, it guides you toward refactoring strategies using dependency inversion, SOLID principles, and clearer architectural patterns.","q":"How do I detect architectural problems in existing code?"}],"shadow_tags":["layered-design","domain-modeling","code-organization","abstraction-strategy","testing-layers","interface-design","module-coupling","enterprise-patterns","refactoring-structure"],"summary_rewrite":"Guides you through selecting the right architecture pattern\u2014clean, hexagonal, feature-based, or vertical slice\u2014based on team size and domain complexity. Covers folder structure, dependency inversion, module boundaries, and SOLID principles at application scale. Diagnoses architectural problems like fat controllers and circular dependencies."},"files":[{"bytes":17094,"path":".claude/skills/code-architecture/SKILL.md","sha256":"2b12bcb342219e50421ad0238c190b2953c6c7102d5117f0f78644b2dd8a2e34","url":"https://skillfed.io/files/curiositech/some_claude_skills/code-architecture/4daf0766/SKILL.md"}],"id":"curiositech/some_claude_skills/code-architecture","links":{"html":"https://skillfed.io/curiositech/some_claude_skills/code-architecture","md":"https://skillfed.io/curiositech/some_claude_skills/code-architecture.md","repo":"https://github.com/curiositech/some_claude_skills"},"meta":{"agents_supported":["claude-code"],"first_seen":"2026-07-28","forks":27,"language":"TypeScript","last_updated":"2026-07-14","license":"MIT","name":"code-architecture","publisher":"curiositech","stars":164},"relations":{"similar":[{"id":"giuseppe-trisciuoglio/developer-kit/clean-architecture"},{"id":"affaan-m/ECC/hexagonal-architecture"},{"id":"miles990/claude-software-skills/architecture-patterns"},{"id":"foryourhealth111-pixel/Vibe-Skills/architecture-patterns"},{"id":"HermeticOrmus/LibreUIUX-Claude-Code/architecture-patterns"},{"id":"CloudAI-X/claude-workflow-v2/designing-architecture"},{"id":"wshobson/agents/architecture-patterns"},{"id":"ccheney/robust-skills/clean-ddd-hexagonal"},{"id":"secondsky/claude-skills/architecture-patterns"},{"id":"wshaddix/dotnet-skills/dotnet-mermaid-diagrams"}]},"slug":{"owner":"curiositech","repo":"some_claude_skills","skill":"code-architecture"},"version":"4daf0766"}