review-architecture

Analyze modular monolith projects for DDD, Clean/Onion Architecture, and bITdevKit compliance.

4|Updated Apr 25, 2024
One-click install
npx skills add https://github.com/BridgingIT-GmbH/bITdevKit.Examples.GettingStarted --skill review-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-architecture
Source: https://github.com/BridgingIT-GmbH/bITdevKit.Examples.GettingStarted/tree/main/.opencode/skills/review-architecture
Command: npx skills add https://github.com/BridgingIT-GmbH/bITdevKit.Examples.GettingStarted --skill review-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured methodology to review modular monoliths for correctness against Domain-Driven Design (DDD), Clean/Onion Architecture, and bITdevKit conventions, helping teams identify architectural drift early.

Core Features & Use Cases

  • Architecture boundary verification: Ensure inward dependencies and separation of concerns across Domain, Application, Infrastructure, and Presentation layers.
  • Pattern compliance checks: Validate adherence to ADRs (e.g., ADR-0001, ADR-0011, ADR-0014, ADR-0005, ADR-0002) and encourages evidence-backed feedback.
  • Actionable review guidance: Provide structured feedback templates and examples to accelerate PR reviews and architectural discussions.

Quick Start

Run the architecture review skill against a module or PR using the standard review templates and ADR references.

Frequently Asked Questions about review-architecture

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

FAQPage Schema
How do I review a modular monolith for DDD and Clean Architecture boundaries?

Architecture review for modular monoliths validates DDD patterns and Clean Architecture boundaries by checking inward dependencies across Domain, Application, Infrastructure, and Presentation layers to ensure proper layer isolation and separation of concerns.

What are ADR guidelines for Domain-Driven Design pattern compliance?

ADR guidelines like ADR-0001 and ADR-0011 enforce specific architectural decisions for DDD pattern compliance. They validate domain events, cross-module contracts, and module boundaries to prevent architectural drift and maintain structural integrity across the codebase.

How do I enforce layer isolation during a PR review?

Enforce layer isolation during a PR review by verifying inward dependencies and cross-module contract compliance using structured feedback templates to validate separation of concerns across Domain, Application, Infrastructure, and Presentation layers.

Does this architecture review skill work with Onion Architecture conventions?

Yes, the architecture review skill verifies Onion Architecture conventions by analyzing dependency directions and layer boundaries to ensure dependencies point inward toward the domain core and maintain proper infrastructure and application separation.

When should I use domain events in a modular monolith architecture?

Use domain events in a modular monolith architecture to handle cross-module communication and enforce bITdevKit conventions, with the architecture review skill validating proper event usage to ensure loose coupling and maintain clean architectural boundaries.

What is the best way to prevent architectural drift in a modular monolith?

The best way to prevent architectural drift is conducting regular architecture reviews that verify DDD patterns, Clean Architecture boundaries, and ADR compliance to identify dependency violations and cross-module contract issues early during refactoring and PR discussions.