ruah-orchestrator

What problem does it solve?

ruah prevents concurrent edit collisions when multiple AI agents or executors work on the same repository by giving each task an isolated workspace, tracking file claims, and producing durable artifacts for safe merges.

Core Features & Use Cases

• Isolated Workspaces: Creates Git worktrees per task so agents do not share a checkout and edits remain isolated.
• Claim-Based File Locking: Tracks canonical claims for owned/shared/read-only access to prevent overlapping edits before execution.
• Artifacts & Compatibility: Captures task artifacts, emits compatibility signals for dependency-ordered merges, and supports DAG workflows and governance gates.
• Use Case: Run parallel AI agents to implement frontend and backend features in the same repo without merge conflicts, then validate and merge in dependency order.

Quick Start

Create and start an isolated task named auth that locks the src/auth/** files, run its executor to produce artifacts, then finalize and merge the task.