An Evidence-Based LLM Framework for Expert-Validated Clean Architecture Conformance Assessment in Enterprise Software Systems

Architectural erosion and technical debt make it difficult to preserve intended design principles in long-lived enterprise software systems. Clean Architecture offers principles for separating business rules from frameworks, persistence and interface concerns, but its assessment often remains informal and difficult to scale across heterogeneous repositories. This article presents a hybrid framework for evaluating Clean Architecture conformance using traceable static evidence, a criterion-based rubric and structured large language model (LLM) prompts. The framework was evaluated over an inventoried corpus of 50 open-source enterprise repositories, from which 12 repositories and 36 modules were selected for an expanded validation phase. Two LLM-based configurations produced 1136 auditable candidate findings, reviewed blindly by three expert reviewers and resolved through a 2-of-3 consensus rule, with ordinal-median resolution for eight severity ties. In the final expanded gold standard, all 1136 candidate findings were consensus-supported, no candidate finding reached majority false-positive consensus, 975 rows had sufficient evidence and 161 had partial evidence. The final mean absolute score error was 0.0118 and severity agreement was 0.9525. The results suggest that LLMs can support AI-enhanced software engineering when constrained by evidence, rubrics and expert validation, but should not be treated as autonomous architectural judges.

Authors

Institutions

Publication Details

Journal
Computers
Published
2026-09-28
DOI
https://doi.org/10.3390/computers15100657
Primary Topic
Software Engineering Research
Type
article
Field-Weighted Citation Impact
0.00
Controls
|||
ALL TIME
JAN
FEB
MAR
APR
MAY
JUN
JUL
AUG
SEP
article

An Evidence-Based LLM Framework for Expert-Validated Clean Architecture Conformance Assessment in Enterprise Software Systems

Gabriel Chavira, Adriana Montoto-González, Eduardo Álvarez-Navarro, Eder Jahir Gonzalez Bravo et al.
Computers
Software Engineering Research
article

An Evidence-Based LLM Framework for Expert-Validated Clean Architecture Conformance Assessment in Enterprise Software Systems

Gabriel Chavira, Adriana Montoto-González, Eduardo Álvarez-Navarro, Eder Jahir Gonzalez Bravo, Jose Luis Diaz Juarez
article en

Abstract

Architectural erosion and technical debt make it difficult to preserve intended design principles in long-lived enterprise software systems. Clean Architecture offers principles for separating business rules from frameworks, persistence and interface concerns, but its assessment often remains informal and difficult to scale across heterogeneous repositories. This article presents a hybrid framework for evaluating Clean Architecture conformance using traceable static evidence, a criterion-based rubric and structured large language model (LLM) prompts. The framework was evaluated over an inventoried corpus of 50 open-source enterprise repositories, from which 12 repositories and 36 modules were selected for an expanded validation phase. Two LLM-based configurations produced 1136 auditable candidate findings, reviewed blindly by three expert reviewers and resolved through a 2-of-3 consensus rule, with ordinal-median resolution for eight severity ties. In the final expanded gold standard, all 1136 candidate findings were consensus-supported, no candidate finding reached majority false-positive consensus, 975 rows had sufficient evidence and 161 had partial evidence. The final mean absolute score error was 0.0118 and severity agreement was 0.9525. The results suggest that LLMs can support AI-enhanced software engineering when constrained by evidence, rubrics and expert validation, but should not be treated as autonomous architectural judges.

ComputersVol. 15(10)
Autonomous University of Tamaulipas (MX)
Industry, innovation and infrastructure
Openalex Percentile: Top 4%
Software Engineering Research
AI Navigator

Ask Laika to Summarize, Analyze, and Connect papers live on the map.

Summarize Papers & Methodologies

Extract key findings, datasets, and comparative methods across publications.

Benchmark Rankings & Visual Analytics

Rank top research institutions, authors, funders, topics, and journals by Field-Weighted Citation Impact (FWCI) and paper volume with instant charts.

Connect Distant Disciplines

Bridge topological clusters on the map to find hidden collaborative intersections.

An Evidence-Based LLM Framework for Expert-Validated Clean Architecture Conformance Assessment in Enterprise Software Systems — Gabriel Chavira, Adriana Montoto-González, et al. · Computers (2026) | TGRS Research Map | TGRS