English

CodeSpec: Dual Executable Specifications for Agentic Long-Horizon Feature Development

Software Engineering 2026-07-29 v1

Abstract

LLM-based code agents have advanced repository-level software development through iterative interaction with codebases and tools. However, feature development requires integrating new behaviors into existing architectures through coherent cross-component functional chains. Existing agents typically derive such chains through free-form reasoning, often producing unreliable feature designs with incomplete functional chains. Moreover, textual designs are difficult to verify and enforce, making it challenging to maintain design-implementation consistency throughout long-horizon development. We propose CodeSpec, a dual executable specification method for repository-level feature development. It builds reliable functional chains from evidence pairing sub-requirement semantics with repository architectures, then compiles them into complementary architecture and behavior specifications that check chain completeness and correctness while preserving design-implementation consistency over long interactions. On FeatureBench, which targets feature development in existing repositories, CodeSpec achieves 70.7%, 55.0%, and 49.9% pass rates under DeepSeek-V4-Pro, outperforming representative baselines such as Claude Code. Results on the repository generation benchmark NL2Repo-Bench further demonstrate its generalizability.

Cite

@article{arxiv.2607.26777,
  title  = {CodeSpec: Dual Executable Specifications for Agentic Long-Horizon Feature Development},
  author = {Peiding Wang and Li Zhang and Fang Liu and Taichuan Li and Yinghao Zhu},
  journal= {arXiv preprint arXiv:2607.26777},
  year   = {2026}
}