chore: remove ralph-orchestrator and retire docs/plans/#122
Merged
Conversation
Windows incompatibility in ralph-cli was a hard blocker. All 18 monorepo specs (00–17) are complete; docs/plans/ has no future intake role now that unic-archon-dlc (unic-dlc-build) is the target runner. - Delete all ralph.yml, PROMPT.md, and .ralph/ artifacts (root + 3 plugins) - Remove @ralph-orchestrator/ralph-cli from package.json and pnpm-workspace.yaml - Retire Spec/Spec Runner terms from CONTEXT.md; Feature Runner now backed by unic-dlc-build - Add ADR-0030; mark ADR-0020 and ADR-0024 superseded - Update AGENTS.md, process docs, and per-plugin CLAUDE.md accordingly See docs/adr/0030-retire-ralph-adopt-archon-runner.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR removes the deprecated ralph-orchestrator workflow and artifacts from the monorepo and updates documentation/process guidance to treat the Feature Runner (unic-dlc-build direction) as the forward path, while marking docs/plans/ as historical/retired.
Changes:
- Deleted repo + plugin Ralph loop artifacts (
ralph.yml,PROMPT.md, and the Ralph loop guide doc). - Removed workspace-level
ralphdependency wiring (catalog/allowBuilds + root script) and updated process docs to drop “Spec Runner” terminology. - Added ADR-0030 and marked ADR-0020/0024 as superseded; updated repo docs (AGENTS/CONTEXT) to reflect the new direction.
Reviewed changes
Copilot reviewed 21 out of 21 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| ralph.yml | Deleted root Ralph config. |
| PROMPT.md | Deleted root Ralph loop prompt. |
| pnpm-workspace.yaml | Removed @ralph-orchestrator/ralph-cli entries from workspace config. |
| package.json | Removed root ralph script and @ralph-orchestrator/ralph-cli optional dependency. |
| docs/process/ralph-loop-guide.md | Deleted Ralph loop guide documentation. |
| docs/process/development-workflow.md | Removed Spec Runner execution path from workflow docs. |
| docs/process/ai-development.md | Updated mental model docs to describe Feature Runner as the sole path; retained historical notes for docs/plans/. |
| docs/plans/README.md | Added retirement notice and reframed docs/plans/ as historical. |
| docs/adr/0030-retire-ralph-adopt-archon-runner.md | Added ADR documenting retirement and future runner direction. |
| docs/adr/0024-ralph-atomic-iteration.md | Marked ADR as superseded. |
| docs/adr/0020-per-plugin-ralph-loops.md | Marked ADR as superseded. |
| CONTEXT.md | Removed “Spec/Spec Runner” vocabulary; updated Feature Runner definition. |
| CONTEXT-MAP.md | Updated shared vocabulary list to remove Spec/Spec Runner terms. |
| apps/claude-code/unic-confluence/ralph.yml | Deleted plugin Ralph config. |
| apps/claude-code/unic-confluence/PROMPT.md | Deleted plugin Ralph prompt. |
| apps/claude-code/pr-review/ralph.yml | Deleted plugin Ralph config. |
| apps/claude-code/pr-review/PROMPT.md | Deleted plugin Ralph prompt. |
| apps/claude-code/auto-format/ralph.yml | Deleted plugin Ralph config. |
| apps/claude-code/auto-format/PROMPT.md | Deleted plugin Ralph prompt. |
| apps/claude-code/auto-format/CLAUDE.md | Removed Ralph-specific section from plugin agent guidance. |
| AGENTS.md | Updated repo navigation/commands/docs guidance to reflect ADR focus and removal of pnpm ralph. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Remove leftover `ralph` scripts from 3 plugin package.json files (the ADR decision stated they should be removed but they were missed) - Fix ADR-0030 title: "Spec Runner" → "Feature Runner" to match the terminology retirement in the ADR body and CONTEXT.md - Expand AGENTS.md docs/ tree to show all actual subdirectories - Fix ADR-0026 link description in ai-development.md to accurately reflect dispatch-by-version-impact content Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ates - Remove `ralph` script from both package-json-template.md variants - Remove ralph.yml, PROMPT.md, docs/plans/ stub from new-plugin SKILL.md - Fix docs/plans/README.md Backlog section to use historical-tense framing - feature-runner.md: drop "counterpart to the Spec Runner" framing; mark historical cleanup section as a historical note - AGENTS.md: replace chore(spec-NN) commit example; fix "spec step" in LICENSE section; add conversations/ and research/ to docs tree - CONTRIBUTING.md: replace spec-driven workflow with Feature-driven, remove ralph-loop install step and spec-writing sections Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
ralph-orchestratorhas no Windows support, making it a hard blocker for cross-platform contributors. All 18 monorepo specs (00–17) are complete anyway, so the tool has fulfilled its original purpose.The strategic direction is
unic-archon-dlc(unic-dlc-build) as the sole runner. In the interim,/tddis used directly for the last batch of specs (pr-review 12–16).What changed
ralph.yml,PROMPT.md, and.ralph/artifacts (root + 3 plugins)@ralph-orchestrator/ralph-clifrompackage.jsonandpnpm-workspace.yamlCONTEXT.md; Feature Runner updated to referenceunic-dlc-buildAGENTS.md,docs/process/ai-development.md,docs/process/development-workflow.md, andauto-format/CLAUDE.mddocs/process/ralph-loop-guide.mddocs/plans/README.mdDecision record
See
docs/adr/0030-retire-ralph-adopt-archon-runner.md.Test plan
pnpm checkpasses (no stray references in linted files)pnpm testpassespnpm typecheckpassesralph,PROMPT.md, or.ralph/artifacts remain outsidedocs/adr/and done spec files🤖 Generated with Claude Code