[Tech. Repo] Structure-Aware Enhanced LLMs via Knowledge Graphs for Microservice Architecture Documentation

Mr. Lin, a second-year master student in our research group, presented his research at the 222nd meeting of the IPSJ Special interest group of Software Engineering (SIGSE), held over two days starting March 9 at the Ookayama Campus of our university. This presentation is based on a portion of his master thesis.

Authors：Qiao Lin, Profir-Petru Par?achi，Takashi Kobayashi（Science Tokyo）
Title：Structure-Aware Enhanced LLMs via Knowledge Graphs for Microservice Architecture Documentation
Publication： The SIG Technical Reports of IPSJ, Vol. 2026-SE-222, No. 20, pp.1-8. [Link], Mar. 9, 2026.

Abstract：
Microservice documentation is critical yet hard to maintain due to its complex and distributed architecture. Developers use Large Language Models (LLMs) with Retrieval Augmented Generation (RAG) to automate the creation and update of microservice documentations; however, this approach has limitations. Standard RAG is blind to the high level, global structural dependencies among services and relies solely on semantic similarity (Structural Blindness). As a result, LLMs suffer from missing key dependencies and information during generation and leading to inaccurate documentation. We introduce a Graph RAG framework that integrates structural awareness into the generation process. A Knowledge Graph (KG) and a GNN are used to help retrieve the most relevant dependencies for the LLM during generation. This ensures the generated documentation is both semantically coherent and architecturally complete, addressing some of the current limitation. As the result, we improve on three metrics over our baselines: Correctness (0.66-1.64), Completeness (0.86-2.24), and Faithfulness (0.64-1.62).