architecture-guide

Reference architectural decisions for Clean Architecture, DDD, and event-driven systems.

13|1|Updated Jun 28, 2023
One-click install
npx skills add https://github.com/jovicon/nestjs-clean-architecture-event-driven-template --skill architecture-guide-jovicon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-guide
Source: https://github.com/jovicon/nestjs-clean-architecture-event-driven-template/tree/main/.claude/skills/architecture-guide
Command: npx skills add https://github.com/jovicon/nestjs-clean-architecture-event-driven-template --skill architecture-guide-jovicon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a concise, practical reference for architectural decisions in Clean Architecture, Domain-Driven Design, and event-driven systems to help teams align quickly and document rationale.

Core Features & Use Cases

  • Quick orientation on layered architecture, domain boundaries, and event-driven communication.
  • Guidance for common scenarios like choosing between layers, identifying domain events, and naming conventions.
  • Use Case: teams decide on architectural patterns for a new NestJS service, document trade-offs, and create consistent guidelines.

Quick Start

Ask for a topic such as layers to receive a structured overview and recommended best practices.

Frequently Asked Questions about architecture-guide

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

FAQPage Schema
What is Clean Architecture and how do its layers work in a NestJS project?▼

Clean Architecture separates concerns into distinct layers to keep domain logic independent of frameworks. This guide provides a compact reference for structuring these layers, defining domain boundaries, and applying naming conventions in NestJS services.

How do I identify domain events when designing event-driven systems?▼

To identify domain events in event-driven systems, you model significant state changes within bounded contexts. This guide offers recommended practices for naming these events and structuring event-driven communication across architectural boundaries.

What is the best way to structure a new NestJS service using Domain-Driven Design?▼

The best way to structure a new NestJS service with Domain-Driven Design is to codify core patterns and define strict domain boundaries. This reference helps teams align quickly on DDD patterns, architectural trade-offs, and consistent guidelines.

Can I use this architecture guidance for refactoring existing event-driven architectures?▼

Yes, this architecture guidance applies to both designing new NestJS projects and refactoring existing architectures. It covers framework-agnostic patterns, testing approaches, and event-driven communication to help teams document rationale and align.

When should I not use Clean Architecture for my software project?▼

Clean Architecture may introduce unnecessary overhead for small or simple projects that do not require strict domain boundaries. This guide helps evaluate architectural trade-offs and decide when layered architecture adds genuine value versus unnecessary complexity.

How do I document architectural decisions and trade-offs for my team?▼

You document architectural decisions by codifying core patterns, recommended practices, and concrete examples. This guide serves as a practical reference to help teams align quickly on layers, events, and testing approaches while recording rationale.