[PR #93] [MERGED] feat: add memory system, task tracking, and ralph.yml preset #130

New issue

Closed

opened 2026-02-27 10:22:21 +03:00 by kerem · 0 comments

kerem commented

2026-02-27 10:22:21 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/mikeyobrien/ralph-orchestrator/pull/93
Author: @mikeyobrien
Created: 1/22/2026
Status: ✅ Merged
Merged: 1/22/2026
Merged by: @mikeyobrien

Base: main ← Head: feat/memory-system-and-ralph-yml

📝 Commits (10+)

8dc1a9a feat(memories): add core data structures for persistent learning
c9a0b9d feat(memories): add markdown parser and store for persistent memories
ba1848d feat(memories): add CLI commands for ralph memory namespace
2a7cbfb feat(memories): add auto-injection to event loop
68a73ed test(memories): add integration tests for CLI commands
97f9ef4 feat(e2e): add E2E test harness with reliability fixes
4fa27d0 docs(e2e): update spec with remaining 6 test failures
01cb24f fix(e2e): improve scenario prompts for remaining failures
c013b79 feat(e2e): add isolated scratchpad config for E2E orchestration
5dd7003 feat: add diagnostics, task system, and memory enhancements

📊 Changes

166 files changed (+34823 additions, -1106 deletions)

View changed files

➕ .agent/memories.md (+33 -0)
➕ .agent/tasks.jsonl (+14 -0)
➕ .claude/agents/ralph-e2e-verifier.md (+146 -0)
➕ .claude/agents/ralph-loop-runner.md (+96 -0)
➕ .claude/skills/pr-demo/SKILL.md (+203 -0)
➖ .claude/skills/ralph-code-assist/SKILL.md (+0 -116)
➕ .claude/skills/ralph-memories/SKILL.md (+108 -0)
➕ .claude/skills/ralph-tools/SKILL.md (+82 -0)
📝 .github/workflows/ci.yml (+2 -1)
📝 .gitignore (+1 -1)
📝 AGENTS.md (+152 -4)
📝 Cargo.lock (+34 -6)
📝 Cargo.toml (+13 -7)
📝 PROMPT.md (+7 -4)
📝 README.md (+60 -9)
📝 crates/ralph-adapters/src/cli_executor.rs (+2 -1)
📝 crates/ralph-adapters/src/pty_executor.rs (+15 -4)
📝 crates/ralph-cli/Cargo.toml (+8 -0)
➕ crates/ralph-cli/examples/calculator.rs (+118 -0)
➕ crates/ralph-cli/examples/greeter.rs (+51 -0)

...and 80 more files

📄 Description

Summary

Add persistent memory system for cross-session learning (.agent/memories.md)
Add runtime task tracking system (.agent/tasks.jsonl)
Add ralph.yml as the default memory-enabled preset with Builder/Confessor/Handler workflow
Add ralph-tools skill for runtime task and memory management
Add E2E test harness for validating orchestration behavior
Track .agent/ directory in version control for persistence

Key Features

Memory System

Memories persist across sessions in .agent/memories.md
Auto-injection into agent context with configurable budget
CLI commands: ralph tools memory add/search/list

Task System

Runtime work tracking in .agent/tasks.jsonl
Replaces scratchpad for completion verification
CLI commands: ralph tools task add/list/ready/close

ralph.yml Preset

Builder: implements tasks, records thinking as memories
Confessor: audits work, produces confidence-scored reports
Handler: verifies claims, commits on success, creates fix tasks on failure

Test plan

cargo test passes
Pre-commit hooks (fmt, clippy) pass
Manual test: run ralph run -c ralph.yml -p "simple task" to verify workflow

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/mikeyobrien/ralph-orchestrator/pull/93 **Author:** [@mikeyobrien](https://github.com/mikeyobrien) **Created:** 1/22/2026 **Status:** ✅ Merged **Merged:** 1/22/2026 **Merged by:** [@mikeyobrien](https://github.com/mikeyobrien) **Base:** `main` ← **Head:** `feat/memory-system-and-ralph-yml` --- ### 📝 Commits (10+) - [`8dc1a9a`](https://github.com/mikeyobrien/ralph-orchestrator/commit/8dc1a9a79f5d82c0311acecea7fe4bbb7e1be32c) feat(memories): add core data structures for persistent learning - [`c9a0b9d`](https://github.com/mikeyobrien/ralph-orchestrator/commit/c9a0b9d51ebc372e2dc985ab343429dbbc14b316) feat(memories): add markdown parser and store for persistent memories - [`ba1848d`](https://github.com/mikeyobrien/ralph-orchestrator/commit/ba1848dce536b023de1590af8aa0bca82692cb29) feat(memories): add CLI commands for ralph memory namespace - [`2a7cbfb`](https://github.com/mikeyobrien/ralph-orchestrator/commit/2a7cbfb79e6b895168dceb209d51f87113e2ac93) feat(memories): add auto-injection to event loop - [`68a73ed`](https://github.com/mikeyobrien/ralph-orchestrator/commit/68a73ed64859528e6070c8a5ec1145b5cebcf0bb) test(memories): add integration tests for CLI commands - [`97f9ef4`](https://github.com/mikeyobrien/ralph-orchestrator/commit/97f9ef44bc03bd1b3758eecba124108f08f02f85) feat(e2e): add E2E test harness with reliability fixes - [`4fa27d0`](https://github.com/mikeyobrien/ralph-orchestrator/commit/4fa27d0c8a8ec8ff1f27dfc6518e2f3afb77021c) docs(e2e): update spec with remaining 6 test failures - [`01cb24f`](https://github.com/mikeyobrien/ralph-orchestrator/commit/01cb24fb39204cb3bf11dd816ad89f9d12d64d3c) fix(e2e): improve scenario prompts for remaining failures - [`c013b79`](https://github.com/mikeyobrien/ralph-orchestrator/commit/c013b79b48f9590b2bf6895c0200855bcf8120f8) feat(e2e): add isolated scratchpad config for E2E orchestration - [`5dd7003`](https://github.com/mikeyobrien/ralph-orchestrator/commit/5dd7003a369955c1c2de14f06445f55804f7cf76) feat: add diagnostics, task system, and memory enhancements ### 📊 Changes **166 files changed** (+34823 additions, -1106 deletions) <details> <summary>View changed files</summary> ➕ `.agent/memories.md` (+33 -0) ➕ `.agent/tasks.jsonl` (+14 -0) ➕ `.claude/agents/ralph-e2e-verifier.md` (+146 -0) ➕ `.claude/agents/ralph-loop-runner.md` (+96 -0) ➕ `.claude/skills/pr-demo/SKILL.md` (+203 -0) ➖ `.claude/skills/ralph-code-assist/SKILL.md` (+0 -116) ➕ `.claude/skills/ralph-memories/SKILL.md` (+108 -0) ➕ `.claude/skills/ralph-tools/SKILL.md` (+82 -0) 📝 `.github/workflows/ci.yml` (+2 -1) 📝 `.gitignore` (+1 -1) 📝 `AGENTS.md` (+152 -4) 📝 `Cargo.lock` (+34 -6) 📝 `Cargo.toml` (+13 -7) 📝 `PROMPT.md` (+7 -4) 📝 `README.md` (+60 -9) 📝 `crates/ralph-adapters/src/cli_executor.rs` (+2 -1) 📝 `crates/ralph-adapters/src/pty_executor.rs` (+15 -4) 📝 `crates/ralph-cli/Cargo.toml` (+8 -0) ➕ `crates/ralph-cli/examples/calculator.rs` (+118 -0) ➕ `crates/ralph-cli/examples/greeter.rs` (+51 -0) _...and 80 more files_ </details> ### 📄 Description ## Summary - Add persistent memory system for cross-session learning (`.agent/memories.md`) - Add runtime task tracking system (`.agent/tasks.jsonl`) - Add `ralph.yml` as the default memory-enabled preset with Builder/Confessor/Handler workflow - Add `ralph-tools` skill for runtime task and memory management - Add E2E test harness for validating orchestration behavior - Track `.agent/` directory in version control for persistence ## Key Features **Memory System** - Memories persist across sessions in `.agent/memories.md` - Auto-injection into agent context with configurable budget - CLI commands: `ralph tools memory add/search/list` **Task System** - Runtime work tracking in `.agent/tasks.jsonl` - Replaces scratchpad for completion verification - CLI commands: `ralph tools task add/list/ready/close` **ralph.yml Preset** - Builder: implements tasks, records thinking as memories - Confessor: audits work, produces confidence-scored reports - Handler: verifies claims, commits on success, creates fix tasks on failure ## Test plan - [x] `cargo test` passes - [x] Pre-commit hooks (fmt, clippy) pass - [x] Manual test: run `ralph run -c ralph.yml -p "simple task"` to verify workflow --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>