
π΄ Your architecture rules are dying in Confluence. Here's how to make them bite back.
Every team has that architecture doc. You know the one β 47 pages, last updated 8 months ago, ignored by everyone shipping features. The problem isn't discipline. It's that rules written in prose don't fail builds. Here's a workflow I've been using to convert architecture documentation into executable, failing JUnit tests β in under 10 minutes. The 3-Step Process Step 1 β Copy your arch rules from Confluence/Wiki Just grab the raw text. Doesn't need to be formatted perfectly. Example rules I copied: Classes extending a parent must use the parent name as suffix e.g., CacheDataProvider extends DataProvider β No string literals inside methods β use static final class members e.g., static final String DATE_FORMAT = "yyyy-MM-dd HH:mm:ss" β Controllers must live under .controller. package only Domain objects must NOT be instantiated with "new" inside methods e.g., new CacheHelper() inside a method β Step 2 β Feed them to Claude Code with this prompt Open Claude Code and paste this: You are a
Continue reading on Dev.to
Opens in a new tab


