cs.SEOct 30, 2026

What Carries Architectural Signal? A Code-to-Architecture Mapping Study

Authors: Rakhshanda Jabeen, Morgan Ericsson, Yuyao Duan, Anna Wingkvist

Organizations: Electrolux Professional AB Ljungby, Sweden · Linnaeus University Växjö, Sweden

Abstract

Code-to-architecture mapping assigns source files to modules of a reference architecture. Representations of implementation artifacts can capture code text, dependencies, and directory organization, but predictive gains alone do not establish the contribution of additional graph processing. Dependencies may already be encoded in these representations, while directories may closely match the reference decomposition. We investigate how artifact representations and graph context affect mapping on ten Java, C, and C++ systems with a limited labeling budget. We compare lexical, structural, and contextual file representations and assess each predictor with and without dependency neighbors. Using a Heterogeneous Graph Transformer (HGT), we compare file-level graphs extended with member nodes summarizing each file's program elements, folder nodes, or both, alongside a variant encoding folder paths directly in file representations. We compare folder-aware predictions with a directory rule using the same labeled files. Representations encoding dependency information outperform lexical representations on most systems. Additional neighbor aggregation can improve mapping, depending on the predictor and aggregation direction. Folder-aware variants yield the largest and most consistent gains across the evaluated HGT configurations. However, the directory rule achieves per-system median accuracy of 89-100%, and adding folder information does not consistently improve predictions for files the rule misclassifies. Member nodes provide no consistent improvement over file-level graphs. These findings support assessing what file representations and directory organization already provide before attributing improvements to graph neural networks.

Figures & tables

Explore similar work

CardsList
  1. When Does the Dependency Graph Help Code-to-Architecture Mapping?

    Oct 14, 2026Rakhshanda Jabeen, Morgan Ericsson, Jonas Nordqvist +1Software EngineeringGraph-Based Semi-Supervised Learning

  2. Codebase-Memory: Tree-Sitter-Based Knowledge Graphs for LLM Code Exploration via MCP

    Mar 28, 2026Martin Vogel, Falk Meyer-Eschenbach, Severin Kohler +2AI Coding AgentsGraph-Based Agent Memory