DEV Community

Cover image for What happens when an AI architect performs 10 reviews of their architecture?
Julio Pessan
Julio Pessan

Posted on

What happens when an AI architect performs 10 reviews of their architecture?

They become 10x better.

I launched arch-review today — an open-source architecture review assistant with 4 specialized agents running in parallel. But the feature I'm most proud of isn't the speed. It's the memory.

The evolution cycle:

After each squad review, each agent logs a lesson:

🔐 Security Agent: "Always check for rate limiting on the API Gateway before checking internal authentication"
🛡️ Reliability Agent: "PostgreSQL shared between 2+ services = disguised SPOF"
📡 Observability Agent: "Local logs in EC2 without ship = first symptom of a system lacking an observability culture"

These lessons are injected into each agent's prompt in the next review.

Over time, the squad calibrates to your tech stack, your failure modes, and your business context.

Evolution levels of each agent:
🌱 Fresh (0 revisions) — standard prompts
🟢 Growing (1-2) — begins to recognize your patterns
🔵 Experienced (3-7) — calibrated to your stack
🟣 Expert (8+) — highly customized

The Evolution Dashboard tab shows this in real time: total revisions, lessons per agent, cross-patterns discovered, and findings accumulated over time.

What's included in the project:
✅ 4 parallel agents: Security · Reliability · Cost · Observability
✅ Persistent evolutionary memory per agent
✅ PDF + image upload with OCR → Structured Markdown
✅ ADR Generator in MADR format
✅ Web UI with live Squad Office
✅ CLI + Docker + Railway/Render deployment
✅ Portuguese (Brazil) / English interface
✅ 68 tests · MIT License

🔗 github.com/juliopessan/arch-review-assistant

If you're an architect, tech lead, or senior engineer — work on an architecture you know well. You'll see things the team hasn't seen.

And after 5 reviews, the squad will know your architecture better than any tool you've ever used.

⭐ If it makes sense for your work, a star in the repo helps a lot in reaching more people.

OpenSource#SoftwareArchitecture#AI#MultiAgent#SelfEvolvingAI#Python#ArchitectureReview#ADR#TechLead#DevTools

P.S.: The squad's loading message says '🎸 The cost agent is playing the budget blues. What a sad song.' Because waiting should have personality. 🎭

Top comments (0)