yoshpy-dev/ralph
Claude Code + Codex harness engineering — scaffold, upgrade, and run opinionated agent harnesses with deterministic hooks, evidence-backed review pipelines, and an autonomous multi-seat org runtime.
ARCHETYPE
YOLO Cowboy
Permissions? Never heard of 'em. Ships at the speed of `--dangerously-skip-permissions`.
Copy this rig
# review before running: this installs third-party code
$ npx degit yoshpy-dev/ralph/.claude ./rig-ralph # inspect, then merge into .claude/ MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ npx degit yoshpy-dev/ralph/.agents/skills/anti-bottleneck .claude/skills/anti-bottleneck $ npx degit yoshpy-dev/ralph/.agents/skills/audit-harness .claude/skills/audit-harness $ npx degit yoshpy-dev/ralph/.agents/skills/cross-review .claude/skills/cross-review $ npx degit yoshpy-dev/ralph/.agents/skills/implement .claude/skills/implement $ npx degit yoshpy-dev/ralph/.agents/skills/org .claude/skills/org $ npx degit yoshpy-dev/ralph/.agents/skills/plan .claude/skills/plan $ npx degit yoshpy-dev/ralph/.agents/skills/pr .claude/skills/pr $ npx degit yoshpy-dev/ralph/.agents/skills/release .claude/skills/release $ npx degit yoshpy-dev/ralph/.agents/skills/self-review .claude/skills/self-review $ npx degit yoshpy-dev/ralph/.agents/skills/spec .claude/skills/spec $ npx degit yoshpy-dev/ralph/.agents/skills/sync-docs .claude/skills/sync-docs $ npx degit yoshpy-dev/ralph/.agents/skills/verify .claude/skills/verify
$ curl -fsSL --create-dirs -o .claude/agents/doc-maintainer.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/.claude/agents/doc-maintainer.md $ curl -fsSL --create-dirs -o .claude/agents/implementer.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/.claude/agents/implementer.md $ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/.claude/agents/reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/tester.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/.claude/agents/tester.md $ curl -fsSL --create-dirs -o .claude/agents/verifier.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/.claude/agents/verifier.md $ curl -fsSL --create-dirs -o .claude/agents/doc-maintainer.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/templates/base/.claude/agents/doc-maintainer.md $ curl -fsSL --create-dirs -o .claude/agents/implementer.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/templates/base/.claude/agents/implementer.md $ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/templates/base/.claude/agents/reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/tester.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/templates/base/.claude/agents/tester.md $ curl -fsSL --create-dirs -o .claude/agents/verifier.md https://raw.githubusercontent.com/yoshpy-dev/ralph/main/templates/base/.claude/agents/verifier.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "./.claude/hooks/ralph-dispatch.sh PreToolUse"
},
{
"type": "command",
"command": "./.claude/hooks/ralph-dispatch.sh PreToolUse"
}
]
}
]
}
} Skills (12)
Subagents (10)
| doc-maintainer model: sonnet | Keep plans, docs, rules, and reports aligned with the current implementation and workflow. |
| implementer model: opus | Scoped implementation specialist executing one plan slice from a structured handoff. Does not plan, review, or widen scope. |
| reviewer model: sonnet | Self-review specialist for diff quality — naming, readability, unnecessary changes, security, and maintainability. Does NOT evaluate spec compliance or test coverage. |
| tester model: opus | Test execution specialist. Runs unit, integration, and regression tests. Produces test reports with coverage, failure analysis, and pass/fail verdicts. |
| verifier model: opus | Spec compliance and static analysis specialist. Checks acceptance criteria, documentation drift, linters, and type checks. Does NOT run tests. |
| doc-maintainer model: sonnet | Keep plans, docs, rules, and reports aligned with the current implementation and workflow. |
| implementer model: opus | Scoped implementation specialist executing one plan slice from a structured handoff. Does not plan, review, or widen scope. |
| reviewer model: sonnet | Self-review specialist for diff quality — naming, readability, unnecessary changes, security, and maintainability. Does NOT evaluate spec compliance or test coverage. |
| tester model: opus | Test execution specialist. Runs unit, integration, and regression tests. Produces test reports with coverage, failure analysis, and pass/fail verdicts. |
| verifier model: opus | Spec compliance and static analysis specialist. Checks acceptance criteria, documentation drift, linters, and type checks. Does NOT run tests. |
Hooks (14)
| event | matcher | runs |
|---|---|---|
| SessionStart | startup|resume|clear|compact | ./.claude/hooks/ralph-dispatch.sh SessionStart |
| UserPromptSubmit | * | ./.claude/hooks/ralph-dispatch.sh UserPromptSubmit |
| PreToolUse | Bash | ./.claude/hooks/ralph-dispatch.sh PreToolUse |
| PostToolUse | Edit|Write|MultiEdit | ./.claude/hooks/ralph-dispatch.sh PostToolUse |
| PostToolUseFailure | Bash|Edit|Write|MultiEdit | ./.claude/hooks/ralph-dispatch.sh PostToolUseFailure |
| PreCompact | manual|auto | ./.claude/hooks/ralph-dispatch.sh PreCompact |
| SessionEnd | * | ./.claude/hooks/ralph-dispatch.sh SessionEnd |
| SessionStart | startup|resume|clear|compact | ./.claude/hooks/ralph-dispatch.sh SessionStart |
| UserPromptSubmit | * | ./.claude/hooks/ralph-dispatch.sh UserPromptSubmit |
| PreToolUse | Bash | ./.claude/hooks/ralph-dispatch.sh PreToolUse |
| PostToolUse | Edit|Write|MultiEdit | ./.claude/hooks/ralph-dispatch.sh PostToolUse |
| PostToolUseFailure | Bash|Edit|Write|MultiEdit | ./.claude/hooks/ralph-dispatch.sh PostToolUseFailure |
| PreCompact | manual|auto | ./.claude/hooks/ralph-dispatch.sh PreCompact |
| SessionEnd | * | ./.claude/hooks/ralph-dispatch.sh SessionEnd |
Permissions
deny (0)
—
ask (0)
—
allow (120)
Bash(./scripts/*)
Bash(git status:*)
Bash(git diff:*)
Bash(git log:*)
Bash(git show:*)
Bash(git add:*)
Bash(git commit:*)
Bash(git checkout:*)
Bash(git branch:*)
Bash(git rev-parse:*)
Bash(git worktree:*)
Bash(git push:*)
Bash(git fetch:*)
Bash(git pull:*)
Bash(git ls-tree:*)
Bash(git config:*)
Bash(git remote get-url:*)
Bash(gh issue view:*)
Bash(gh issue list:*)
Bash(gh pr view:*)
Bash(gh pr list:*)
Bash(gh pr diff:*)
Bash(gh pr checks:*)
Bash(gh pr edit:*)
Bash(gh pr create:*)
Bash(gh api:*)
Bash(codex exec:*)
Bash(mkdir:*)
Bash(chmod:*)
Bash(rm:*)
Bash(mv:*)
Bash(sort:*)
Bash(sed:*)
Bash(tail:*)
Bash(head:*)
Bash(sh -n:*)
Bash(bash -n:*)
Bash(claude:*)
Bash(go build:*)
Bash(go test:*)
Bash(go vet:*)
Bash(go run:*)
Bash(go mod:*)
Bash(go get:*)
Bash(go install:*)
Bash(go tool:*)
Bash(go generate:*)
Bash(go list:*)
Bash(go env:*)
Bash(go fmt:*)
Bash(go version)
Bash(go clean:*)
Bash(go doc:*)
Bash(gofmt:*)
Bash(golangci-lint:*)
Bash(staticcheck:*)
Bash(goimports:*)
Bash(shellcheck:*)
Bash(./ralph:*)
Bash(./bin/ralph:*)
Similar rigs
yanis-vroland/fieldops
Plateforme fictive de maintenance industrielle avec IA intégrée : API NestJS, app Flutter, RAG, MCP et agents. Projet portfolio de développement agentique.
Fort Knox 2.0k tok ·
Trolzie/claude-loop-systems-demo
A small demo of Markdown-as-system AI dev loops with Claude Code: issues → agents → skills → verification.
Pragmatist 480 tok ·
chrille0313/agentic-monorepo-template
Stack-agnostic monorepo template where agents are the workflow: PM → implementer → fresh-context reviewer loops via Claude Code subagents, skills, and GitHub Actions
Pragmatist 1.5k tok ·
lamngockhuong/aiteamkit
Multi-harness AI plugin for Claude Code, Cursor and Codex CLI: skills that run the delivery lifecycle of a project team - intake, estimate, design, spec, breakdown, plan, implement, fix, review, QA, verify, release, incident, retro, onboard
Skill Collector 26.8k tok ·