Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
}
]
}
16 changes: 6 additions & 10 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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` |
83 changes: 83 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

---
Expand Down Expand Up @@ -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.
Expand Down