Type: url
Original: https://techblog.zozo.com/entry/verify-ai-agent-coding-rules-with-archunit
Status: generated
Summary
A ZOZO team describes moving the coding rules it gives to AI agents from natural-language documents checked by reviewers to ArchUnit tests enforced as a required CI gate. Two premises drive the shift: that the reader of these rules is the agent rather than a person, so each rule should be self-contained rather than cross-referenced across files, and that a rule which cannot be mechanically checked is only as reliable as whichever review happens to catch a violation — with each rule document additionally stating which of its own constraints are already machine-checked and which still depend on the eye. The post also reports what did not work: a plan to distribute shared rules across repositories was abandoned when almost no team took up another team’s rules, which the authors attribute to there being fewer genuinely portable rules than expected and to the standing cost of keeping an imported rule consistent with its test and the code.