UserTrace: User-Level Requirements Generation and Traceability Recovery from Software Project Repositories

Fuente: arXiv
Saved in:
Bibliographic Details
Main Authors: Jin, Dongming, Jin, Zhi, Zhang, Yiran, Fang, Zheng, Li, Linyu, He, Yuanpeng, Chen, Xiaohong, Sun, Weisong
Format: Preprint
Published: 2025
Subjects:
Online Access:
Tags: Add Tag
No Tags, Be the first to tag this record!
_version_ 1866916949091418112
author Jin, Dongming
Jin, Zhi
Zhang, Yiran
Fang, Zheng
Li, Linyu
He, Yuanpeng
Chen, Xiaohong
Sun, Weisong
author_facet Jin, Dongming
Jin, Zhi
Zhang, Yiran
Fang, Zheng
Li, Linyu
He, Yuanpeng
Chen, Xiaohong
Sun, Weisong
contents Software maintainability critically depends on high-quality requirements descriptions and explicit traceability between requirements and code. Although automated code summarization (ACS) and requirements traceability (RT) techniques have been widely studied, existing ACS methods mainly generate implementation-level (i.e., developer-oriented) requirements (IRs) for fine-grained units (e.g., methods), while RT techniques often overlook the impact of project evolution. As a result, user-level (i.e., end user-oriented) requirements (URs) and live trace links remain underexplored, despite their importance for supporting user understanding and for validating whether AI-generated software aligns with user intent. To address this gap, we propose UserTrace, a multi-agent system that automatically generates URs and recovers live trace links (from URs to IRs to code) from software repositories. UserTrace coordinates four specialized agents (i.e., Code Reviewer, Searcher, Writer, and Verifier) through a three-phase process: structuring repository dependencies, deriving IRs for code units, and synthesizing URs with domain-specific context. Our comparative evaluation shows that UserTrace produces URs with higher completeness, correctness, and helpfulness than an established baseline, and achieves superior precision in trace link recovery compared to five state-of-the-art RT approaches. A user study further demonstrates that UserTrace helps end users validate whether the AI-generated repositories align with their intent.
format Preprint
id arxiv_https___arxiv_org_abs_2509_11238
institution arXiv
publishDate 2025
record_format arxiv
spellingShingle UserTrace: User-Level Requirements Generation and Traceability Recovery from Software Project Repositories
Jin, Dongming
Jin, Zhi
Zhang, Yiran
Fang, Zheng
Li, Linyu
He, Yuanpeng
Chen, Xiaohong
Sun, Weisong
Software Engineering
Software maintainability critically depends on high-quality requirements descriptions and explicit traceability between requirements and code. Although automated code summarization (ACS) and requirements traceability (RT) techniques have been widely studied, existing ACS methods mainly generate implementation-level (i.e., developer-oriented) requirements (IRs) for fine-grained units (e.g., methods), while RT techniques often overlook the impact of project evolution. As a result, user-level (i.e., end user-oriented) requirements (URs) and live trace links remain underexplored, despite their importance for supporting user understanding and for validating whether AI-generated software aligns with user intent. To address this gap, we propose UserTrace, a multi-agent system that automatically generates URs and recovers live trace links (from URs to IRs to code) from software repositories. UserTrace coordinates four specialized agents (i.e., Code Reviewer, Searcher, Writer, and Verifier) through a three-phase process: structuring repository dependencies, deriving IRs for code units, and synthesizing URs with domain-specific context. Our comparative evaluation shows that UserTrace produces URs with higher completeness, correctness, and helpfulness than an established baseline, and achieves superior precision in trace link recovery compared to five state-of-the-art RT approaches. A user study further demonstrates that UserTrace helps end users validate whether the AI-generated repositories align with their intent.
title UserTrace: User-Level Requirements Generation and Traceability Recovery from Software Project Repositories
topic Software Engineering
url https://arxiv.org/abs/2509.11238