Why am I talking to you about this thing called EAROS Calibrate?
To be honest, my impression of architecture reviews used to be—a bunch of people sitting together, pointing at PPTs or documents, discussing for hours, and finally maybe not even reaching a solid conclusion. That was until I stumbled upon ThomasRohde's EAROS project on GitHub, which includes a Skill called earos-calibrate, described as "Making architecture review irresistible." I thought, huh? Architecture reviews can become irresistible? Driven by curiosity, I looked into it and found that this thing is actually quite interesting.
Let me first explain what it does. EAROS Calibrate is essentially a Skill plugin for Claude Desktop, specifically designed to help you with architecture reviews. It provides a complete set of standardized processes, checklists, and interaction templates, so you're not chatting aimlessly during a review but moving forward with steps and focus. For example, when you start a decision about splitting a microservice, it guides you to consider key points like responsibility boundaries, data consistency, communication overhead, and then automatically records your conclusions and reasons. This saves you the trouble of manually writing documents and ensures the quality of each review stays high.
My first reaction was: Isn't this a bit too "heavy"? After all, many teams don't even have an architecture review process. But upon reflection, the more chaotic a team is, the more they need such a tool to establish discipline. Moreover, its design philosophy is "irresistible"—meaning it has a low barrier to use; you don't need to learn complex tools, just use natural language conversations in Claude. For instance, you can simply say, "Help me review the architecture of this order system," and it will start asking you questions step by step, like a chat, and the review is done.
What I personally like most is that it includes a references directory, presumably containing some reference documents and best practices to help you have a basis during the review. For example, when evaluating high availability, it proactively prompts you to consider patterns like redundancy, failover, monitoring, etc., to avoid omissions. For novice architects, this is practically a "living dictionary"-level auxiliary tool.
The installation process was much simpler than I imagined
Actually, installing this Skill is similar to installing other npm packages. Open the terminal, type a command: npx skills add https://github.com/ThomasRohde/EAROS --skill earos-calibrate and then wait for it to download. However, note that you must ensure Node.js and npx are installed on your computer, otherwise the command won't run. After installation, you'll see this Skill in Claude Desktop. At first, I thought it would require complex configuration, but it turned out it works directly without even setting environment variables.
Here's a small pitfall to remind you: If your network environment is unstable, the download may get stuck. It's recommended to use a VPN or try a different time. Also, after successful installation, it's best to open the SKILL.md file first, which should detail the commands and usage supported by this Skill. I didn't read it initially and started asking questions directly, only to find some command formats were incorrect, wasting some time.
Hands-on experience: I tried it with my own project
To test the effect, I used it to conduct an architecture review for a RESTful API design I was working on. The startup is very simple: just say "Start architecture review" in Claude, and it will pop up a series of questions. For example: What is the core responsibility of the current system? What are the main external dependencies? What is the data flow? What are the security requirements? Each question is followed by some hint options, somewhat like multiple-choice, but you can also input freely. It took me about half an hour to go through the whole process, and finally it automatically generated a clear review report, including my decisions, reasons, priorities, and action items. It's much better than documents I would write myself—at least the format is unified and the logic is coherent.
However, it's not a panacea. I think for particularly unique business scenarios, such as complex aggregate root design in Domain-Driven Design, the suggestions it provides may not be deep enough. After all, it's a general-purpose tool and cannot cover all details. But as a starting point and framework for review, it's definitely sufficient.
Ideas for practical application scenarios
Besides technical team internal reviews, I think this tool can also be used in the following scenarios:
- Newcomer training: Let new architects use this Skill to conduct simulated reviews, quickly familiarizing themselves with the company's architecture decision process.
- Remote collaboration: Distributed teams can use this Skill asynchronously, each filling in their own opinions, then discussing together, which is highly efficient.
- Project postmortems: Use it to conduct retrospective reviews of completed projects, identifying shortcomings in past decisions, forming knowledge accumulation.
Also, it can export review records for future reference. Although I haven't found the specific export method yet, since it has a references directory, it should support export in Markdown or JSON format, right?
Some noteworthy points
First, this Skill is still relatively new, with only 0 stars, indicating few users. However, the author ThomasRohde seems experienced, so the code quality should be fine. Second, because it's based on Claude Desktop, you need to ensure your Claude version supports it and the API works properly. Also, if you're using the free version of Claude, you might encounter context limit issues; it's recommended to split the review into multiple conversations.
Finally, I want to say that no matter how good a tool is, if the team doesn't have a genuine review culture, it's useless. EAROS Calibrate is at best a catalyst; what truly makes architecture reviews irresistible is your team's determination and habits. Well, that's all for today. Hope it helps you...
