diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 2e0e669..10536e1 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -29,6 +29,20 @@
       },
       "source": "./plugins/qa",
       "category": "development"
+    },
+    {
+      "name": "devx-ralph",
+      "description": "Predicate-driven agentic loop with structured planning and iterative implementation",
+      "version": "1.0.0",
+      "author": {
+        "name": "Pierre Tomasina",
+        "email": "contact@dev3o.com"
+      },
+      "source": {
+        "source": "github",
+        "repo": "agentic-dev3o/cc-ralph-loop"
+      },
+      "category": "development"
     }
   ]
 }
diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 8ba1308..a9b1e63 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -13,18 +13,13 @@ devx-plugins/
 ├── .claude-plugin/
 │   └── marketplace.json      # Plugin registry (lists all plugins)
 └── plugins/
-    ├── git/                   # devx-git plugin
-    │   ├── .claude-plugin/
-    │   │   └── plugin.json   # Plugin manifest
-    │   └── commands/         # Slash commands
-    │       ├── ci.md         # /commit - conventional commits
-    │       └── pr.md         # /pr - create pull requests
-    └── qa/                    # devx-qa plugin
+    └── <plugin-name>/
         ├── .claude-plugin/
-        │   └── plugin.json
+        │   └── plugin.json   # Plugin manifest
         ├── commands/         # Slash commands
-        ├── agents/           # Autonomous agents
-        └── skills/           # Knowledge/skill definitions
+        ├── agents/           # Autonomous agents (optional)
+        ├── skills/           # Knowledge/skill definitions (optional)
+        └── hooks/            # Event hooks (optional)
 ```
 
 ## Plugin Structure
@@ -60,3 +55,4 @@ Inline bash execution uses `!` syntax: `!`git status``
 |--------|---------|----------|
 | devx-git | Git workflow automation | `/commit`, `/pr` |
 | devx-qa | Code quality analysis | `/explain`, `/claudemd` |
+| devx-ralph | Predicate-driven agentic loop | `/plan`, `/ralph`, `/analyze` |
diff --git a/README.md b/README.md
index d4c5b10..229a301 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,7 @@ Or install directly:
 ```
 /plugin install devx-git@devx-plugins
 /plugin install devx-qa@devx-plugins
+/plugin install devx-ralph@devx-plugins  # Premium - requires yearly membership
 ```
 
 ---
@@ -188,6 +189,88 @@ Your project memory stays current without manual maintenance.
 
 ---
 
+### devx-ralph
+
+**Predicate-driven agentic loop** — Define success criteria, let Claude iterate until they pass.
+
+> **Premium Plugin** — Available to yearly community members at [dev3o.com](https://dev3o.com)
+
+#### `/devx-ralph:plan <task>`
+
+Generate a structured implementation plan with verifiable predicates.
+
+```
+/devx-ralph:plan add user authentication with JWT
+```
+
+**What happens:**
+1. Asks clarifying questions (definition of done, verification command, TDD preference)
+2. Analyzes your codebase for patterns and architecture
+3. Generates ASCII state machine and sequence diagrams
+4. Breakdown to multi-task with shell predicates for success rate
+5. Write the detail specification plan use for the half loop
+
+---
+
+#### `/devx-ralph:ralph`
+
+Execute the agentic loop — implements tasks until all predicates pass.
+
+```
+/devx-ralph:ralph
+```
+
+**What happens:**
+1. Reads current plan and identifies next pending task
+2. Implements the task (TDD if specified)
+3. Runs the predicate to verify completion
+4. On success: marks task complete, moves to next
+5. On failure: analyzes error, retries with feedback
+6. After all tasks pass: enters review phase to catch drift
+
+**Status lifecycle:** `draft` → `running` → `review` → `complete`
+
+---
+
+#### `/devx-ralph:archive`
+
+Archive completed plans and prepare for new work.
+
+```
+/devx-ralph:archive
+```
+
+Plans are archived to `.claude/ralph-plan/archive/` with incremental numbering.
+
+---
+
+#### Orchestrator Mode
+
+For large plans, run with isolated sessions to avoid context rot:
+
+```bash
+~/.claude/plugins/devx-ralph/scripts/ralph-loop.sh
+```
+
+**Benefits:**
+- Fresh context for each task (no context rot)
+- Auto-commit after each task completion
+- Token efficient
+
+---
+
+#### Join the Community
+
+devx-ralph is available exclusively to yearly community members.
+
+**[Join at dev3o.com](https://dev3o.com)** to get access to:
+- devx-ralph plugin
+- Priority support
+- Early access to new plugins
+- Direct feedback channel
+
+---
+
 ## Philosophy
 
 **Battle-tested** — Every command exists because it solved a real problem, repeatedly. Nothing theoretical.