My son Mario Alvarez Navarro and I released Ariadna, a Ruby gem that turns Claude Code into a disciplined engineering team for Rails projects.
Claude Code is exceptional for quick changes and one-off tasks, but when work gets complex (new modules, intricate integrations, features spanning multiple application layers) direct execution falls short.
Ariadna adds what's missing: structure.
The workflow is built around a three-step cycle: plan, execute, verify. Each phase produces detailed plans with Rails conventions baked in. Execution spawns specialised agents in parallel (backend, frontend, testing), each with its own context window. And verification doesn't check whether tasks were completed — it checks whether the phase goal was actually achieved.
What changes compared to using Claude Code directly:
- Persistent memory across sessions. A STATE.md file tracks decisions, progress, and blockers.
- Specialised agents that automatically load Rails guides based on the plan's domain.
- Wave-based parallel execution, where plans without dependencies run simultaneously.
- Conversational verification that evaluates results against objectives, not against a task checklist.
This is not vibe coding. You get the best results when you review both the generated plans and the outcome of each phase. It's a tool for complex work that requires human judgment at every step.
It works for greenfield projects and existing applications alike. The map-codebase command analyses the codebase before starting, and you can work with full milestones or quick tasks that maintain the same guarantees.
Open source, MIT license.
