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.