Ariadna

A meta-prompting and context engineering system for building Ruby on Rails applications with Claude Code.

Ariadna turns Claude Code into a disciplined Rails project execution engine. It installs commands, agents, workflows, and Rails Skills into ~/.claude/ that give Claude Code structured planning, parallel multi-agent execution, goal-backward verification, and persistent memory across sessions. This is not a vibe-coding tool. You will get the best results when you review both the created plans and the outcomes of each phase.

Why Ariadna

Without Ariadna, Claude Code sessions are stateless. There’s no memory between sessions, no structure to large projects, no verification that what was built matches what was planned, and no way to coordinate parallel work streams.

With Ariadna, you get:

• Persistent memory – a memory/ directory tracks decisions, progress, blockers, and metrics across sessions
• Structured planning – roadmaps with milestones, phases, and wave-based parallel execution plans
• 6 specialized agents – planner, executor, verifier, debugger, roadmapper, and codebase mapper, each spawned with a fresh context window
• 5 Rails Skills – domain knowledge packages (backend, frontend, testing, security, performance) that agents load automatically based on plan domain
• Goal-backward verification – checks whether the phase achieved its goal, not just whether tasks were completed
• Session continuity – pause mid-phase, resume later with full context restoration via /ariadna:progress

How It Works

1. You invoke a slash command (e.g., /ariadna:execute-phase 1)
2. The command loads a workflow and calls ariadna-tools init to gather paths and metadata
3. An orchestrator spawns specialized agents in parallel, each with a fresh context window
4. Agents load their own context (plans, skills, memory files), execute tasks, and make atomic commits
5. Project memory is updated in .ariadna_planning/memory/

Quick Start

Installation

gem install ariadna

Install commands, agents, and skills globally (recommended):

ariadna install --global    # Installs to ~/.claude/ -- available in all projects

Or locally for a single project:

ariadna install --local     # Installs to ./.claude/ -- project-specific

New Rails Project (Greenfield)

/ariadna:new-project           # Define vision, set preferences, create roadmap
/clear
/ariadna:plan-phase 1          # Create detailed plan for first phase
/clear
/ariadna:execute-phase 1       # Execute it with parallel agents
/ariadna:verify-work 1         # Verify phase goal achievement