alfredolopez80/multi-agent-ralph-loop

138 stars · Last commit 2026-04-20

Autonomous orchestration framework for Claude Code with MemPalace-inspired memory (4-layer stack, 818-token wake-up), parallel-first Agent Teams (6 teammates), Aristotle First Principles methodology, and 4-stage quality gates. 925+ tests, 22 active hooks, automatic learning pipeline.

README preview

# Multi-Agent Ralph Loop

Autonomous orchestration framework for Claude Code with MemPalace-inspired memory, parallel-first Agent Teams, Aristotle First Principles methodology, and quality gates.

## What It Does

Ralph extends Claude Code into a multi-agent development framework with a structured memory system inspired by the [Memory Palace technique](https://en.wikipedia.org/wiki/Method_of_loci). Every task is analyzed from first principles, decomposed into parallel subtasks, assigned to specialized teammates, and validated through quality gates before completion.

| Capability | Description |
|---|---|
| **MemPalace Memory** | 4-layer memory stack (L0-L3) with Obsidian vault knowledge graph and learned rules taxonomy |
| **Parallel-First** | All independent tasks execute in parallel via Agent Teams (mandatory for complexity >= 3) |
| **6 Teammates** | ralph-coder, ralph-reviewer, ralph-tester, ralph-researcher, ralph-frontend, ralph-security |
| **Hook System** | Lifecycle hooks for validation, quality gates, security guards, and automatic learning |
| **Aristotle Analysis** | 5-phase first principles deconstruction before every non-trivial task |
| **Quality Gates** | 4-stage blocking validation: correctness, quality, security, consistency |
| **Comprehensive Tests** | Full test suite covering layers, hooks, security, skills, and pipeline |

## MemPalace Memory System

View full repository on GitHub →