[PR #146] [MERGED] chore: preflight gates + skills refresh #163

New issue

Closed

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

kerem commented

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

Owner

📋 Pull Request Information

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

Base: main ← Head: pr/last-71-commits

📝 Commits (10+)

bddcae0 Add playwriter and tmux terminal skills
d4c8410 feat: add ralph preflight command
49b1079 feat: auto-preflight before ralph run
637fd7c feat: add cargo audit backpressure gate
b6e9794 feat: add coverage backpressure gate
e0d3374 chore(presets): add decision confidence protocol
737cf79 Add self-healing hat to confession-loop preset
f4635f0 feat: add persistent mode to suppress LOOP_COMPLETE termination
25168b7 Add verifier quality report backpressure
f1003f7 Add performance regression backpressure gate

📊 Changes

172 files changed (+12020 additions, -8293 deletions)

View changed files

📝 .claude/agents/ralph-loop-runner.md (+1 -1)
📝 .claude/skills/code-assist/SKILL.md (+75 -323)
📝 .claude/skills/code-task-generator/SKILL.md (+64 -247)
➖ .claude/skills/codebase-summary/SKILL.md (+0 -314)
📝 .claude/skills/pdd/SKILL.md (+90 -253)
➕ .claude/skills/playwriter/SKILL.md (+90 -0)
➖ .claude/skills/ralph-diagnostics/SKILL.md (+0 -231)
➖ .claude/skills/ralph-loop/SKILL.md (+0 -300)
➕ .claude/skills/ralph-operations/SKILL.md (+213 -0)
➕ .claude/skills/test-driven-development/SKILL.md (+134 -0)
➕ .claude/skills/tmux-terminal/SKILL.md (+107 -0)
➕ .github/ISSUE_TEMPLATE/bug_report.yml (+91 -0)
➕ .github/ISSUE_TEMPLATE/config.yml (+5 -0)
➕ .github/ISSUE_TEMPLATE/feature_request.yml (+64 -0)
➕ .github/ISSUE_TEMPLATE/question.yml (+50 -0)
➕ .ralph/agent/decisions.md (+86 -0)
📝 AGENTS.md (+3 -3)
📝 Cargo.lock (+2 -2)
📝 Cargo.toml (+1 -1)
📝 README.md (+1 -1)

...and 80 more files

📄 Description

Summary

Introduces preflight/backpressure improvements (auto-preflight, new gates for coverage, cargo audit, performance regression, verifier quality) plus spec completeness/acceptance criteria checks.
Updates orchestration/robot flows and skills/presets (Self-Healer hat, decision confidence protocol, skill consolidation, SOP alignment, preset trimming, human-in-the-loop refinements).
Expands CLI/tooling & TUI behavior (doctor command, tutorial onboarding, skill discovery, token/tsx parsing fixes, task status normalization, TUI width/iteration buffer fixes).
Broadens test coverage across CLI/core/adapters and adds/refreshes docs and templates.
Adds --yolo to Codex CLI invocation and adjusts tests.

Testing

cargo test

Commits (last 71)

299d45b feat(adapters): add --yolo to codex cli
758cce2 feat(robot): human-in-the-loop improvements - separate queue, TUI metadata, event naming
7c99179 refactor: decouple ralph-telegram from ralph-core via RobotService trait (KISS item #9)
bb2129f refactor: remove unused ralph-adapters dependency from ralph-tui (KISS item #13)
720cdf6 refactor: unify TDD skills into single test-driven-development skill (KISS item #2)
a6c2588 fix: resolve 26 clippy warnings across workspace (unblock backpressure)
eb622e1 refactor: reduce PDD and code-task-generator constraint density (KISS item #11)
cf79fc3 refactor: reduce code-assist constraint density from 111 to 32 MUSTs (KISS item #11)
877989c refactor: consolidate ralph-loop and ralph-diagnostics into ralph-operations skill (KISS item #10)
794d142 chore: remove standalone codebase-summary skill (KISS item #12)
7216417 feat(config): add extra_instructions field for shared hat instruction fragments
95eb069 feat: gate session recorder/player behind recording feature flag (KISS #7)
23ecdbb refactor: remove chaos_mode dead code (KISS item #6)
8f57421 fix: handle wide character display widths in TUI ContentPane
0fba205 fix: resolve events path from current-events marker for interact.human
09a54d8 refactor(presets): remove 13 redundant/experimental presets, slim to core 15
0096624 fix: preserve TUI iteration buffers across task.start reset
16442fd feat(code-task-generator): align CTG SOP with Level 5 spec-driven pipeline
43a58b0 feat(pdd): align PDD SOP with Level 5 spec-driven pipeline
655cdca feat: add spec acceptance criteria verification gate to backpressure
0b136fc feat: add spec-to-test stub generation skill and acceptance criteria parser
3a1819d feat: add spec completeness validator to preflight checks
b8082e9 feat: add Self-Healer hat, improve tests, fix UTF-8 boundary, make preflight opt-in
5c801a3 feat(presets): add confidence scoring thresholds
ad2d0c0 docs: define decision journal format
1f92695 fix(core): resolve parent skills dirs
2304aa2 fix(cli): resolve configured skill dirs in parent workspace
2ed48c0 fix(cli): discover parent skills dir for nested roots
f38f3fa fix(cli): discover nested skills dirs
5797294 test(cli): cover user skill discovery
32ff3b0 feat(cli): add skill list and improve discovery
d98b221 feat(cli): add tutorial onboarding command
1320131 test(cli): cover run_command dry-run and continue error
45475eb test(cli): expand loops command coverage
eddd321 fix(cli): allow partial merge queue id resolution
eaadda4 test(core): cover event loop helper branches
8bc8569 test: cover termination reasons and merge queue resolution
013af96 test: expand event loop and loops coverage
9f706cb test: add preset run coverage and shared cwd guard
147a2a9 test(cli): expand coverage for bot/web/loop runner
7d9fa33 test(cli,adapters): expand coverage for config and pty
a4a84c9 test: expand pty streaming and planning session coverage
7d19b5c test(cli): add loops and sop runner coverage
d6e6f2a test(cli): add memory formatting tests
08c3987 fix(cli): normalize task status filtering
e78b5c5 test(cli): cover bot token resolution
fde3383 fix(cli): normalize token and tsx version parsing
76ebd53 test(adapters,cli): cover pty executor paths
1eb3275 test(cli): expand coverage for bot/web/loop_runner
7f80ffb test: add cli run/web integration coverage
35267f4 test(cli,adapters): expand unit coverage for helpers
3261dbb test(cli): expand web and bot coverage
8157eb7 test(cli,core): stabilize cwd handling and completion tests
8998d62 test: extend loop runner and pty executor coverage
f85ce55 test: extend coverage for cli helpers
0df20f4 Add troubleshooting links to common errors
a77c0cd docs(api): add Rust examples for agents/config/metrics/security
b0de08d docs: detail backend configuration
fa6bcf7 Update getting started quick start tutorial
44c618c feat(cli): add doctor diagnostics command
40116f2 Add GitHub issue templates
0e3d503 Fix installation guide for Rust CLI
f1003f7 Add performance regression backpressure gate
25168b7 Add verifier quality report backpressure
f4635f0 feat: add persistent mode to suppress LOOP_COMPLETE termination
737cf79 Add self-healing hat to confession-loop preset
e0d3374 chore(presets): add decision confidence protocol
b6e9794 feat: add coverage backpressure gate
637fd7c feat: add cargo audit backpressure gate
49b1079 feat: auto-preflight before ralph run
d4c8410 feat: add ralph preflight command

_{🔄 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/146 **Author:** [@mikeyobrien](https://github.com/mikeyobrien) **Created:** 2/2/2026 **Status:** ✅ Merged **Merged:** 2/2/2026 **Merged by:** [@mikeyobrien](https://github.com/mikeyobrien) **Base:** `main` ← **Head:** `pr/last-71-commits` --- ### 📝 Commits (10+) - [`bddcae0`](https://github.com/mikeyobrien/ralph-orchestrator/commit/bddcae09d5772006a386e67bd392ab5fcccf9c06) Add playwriter and tmux terminal skills - [`d4c8410`](https://github.com/mikeyobrien/ralph-orchestrator/commit/d4c84109ed100b31f0563a420b3a9fb23a266f4d) feat: add ralph preflight command - [`49b1079`](https://github.com/mikeyobrien/ralph-orchestrator/commit/49b1079f5a69d2136c5fe795ab30c70d018fd80c) feat: auto-preflight before ralph run - [`637fd7c`](https://github.com/mikeyobrien/ralph-orchestrator/commit/637fd7c356060ceae461aea3a97fc5911634f364) feat: add cargo audit backpressure gate - [`b6e9794`](https://github.com/mikeyobrien/ralph-orchestrator/commit/b6e97944a4da13019c23eddd67b71510b8204278) feat: add coverage backpressure gate - [`e0d3374`](https://github.com/mikeyobrien/ralph-orchestrator/commit/e0d3374ed525491d44a2f7868a7b63ff5ea489dc) chore(presets): add decision confidence protocol - [`737cf79`](https://github.com/mikeyobrien/ralph-orchestrator/commit/737cf7920ea461c81f573ee072301a9eb751fc76) Add self-healing hat to confession-loop preset - [`f4635f0`](https://github.com/mikeyobrien/ralph-orchestrator/commit/f4635f07bb0911ceb15cd8ea1fefb481a070f9b2) feat: add persistent mode to suppress LOOP_COMPLETE termination - [`25168b7`](https://github.com/mikeyobrien/ralph-orchestrator/commit/25168b7b63a05d7e4bb65962b608e3c8e982164a) Add verifier quality report backpressure - [`f1003f7`](https://github.com/mikeyobrien/ralph-orchestrator/commit/f1003f71981baa722e3af9b8d71692493c7799c7) Add performance regression backpressure gate ### 📊 Changes **172 files changed** (+12020 additions, -8293 deletions) <details> <summary>View changed files</summary> 📝 `.claude/agents/ralph-loop-runner.md` (+1 -1) 📝 `.claude/skills/code-assist/SKILL.md` (+75 -323) 📝 `.claude/skills/code-task-generator/SKILL.md` (+64 -247) ➖ `.claude/skills/codebase-summary/SKILL.md` (+0 -314) 📝 `.claude/skills/pdd/SKILL.md` (+90 -253) ➕ `.claude/skills/playwriter/SKILL.md` (+90 -0) ➖ `.claude/skills/ralph-diagnostics/SKILL.md` (+0 -231) ➖ `.claude/skills/ralph-loop/SKILL.md` (+0 -300) ➕ `.claude/skills/ralph-operations/SKILL.md` (+213 -0) ➕ `.claude/skills/test-driven-development/SKILL.md` (+134 -0) ➕ `.claude/skills/tmux-terminal/SKILL.md` (+107 -0) ➕ `.github/ISSUE_TEMPLATE/bug_report.yml` (+91 -0) ➕ `.github/ISSUE_TEMPLATE/config.yml` (+5 -0) ➕ `.github/ISSUE_TEMPLATE/feature_request.yml` (+64 -0) ➕ `.github/ISSUE_TEMPLATE/question.yml` (+50 -0) ➕ `.ralph/agent/decisions.md` (+86 -0) 📝 `AGENTS.md` (+3 -3) 📝 `Cargo.lock` (+2 -2) 📝 `Cargo.toml` (+1 -1) 📝 `README.md` (+1 -1) _...and 80 more files_ </details> ### 📄 Description ## Summary - Introduces preflight/backpressure improvements (auto-preflight, new gates for coverage, cargo audit, performance regression, verifier quality) plus spec completeness/acceptance criteria checks. - Updates orchestration/robot flows and skills/presets (Self-Healer hat, decision confidence protocol, skill consolidation, SOP alignment, preset trimming, human-in-the-loop refinements). - Expands CLI/tooling & TUI behavior (doctor command, tutorial onboarding, skill discovery, token/tsx parsing fixes, task status normalization, TUI width/iteration buffer fixes). - Broadens test coverage across CLI/core/adapters and adds/refreshes docs and templates. - Adds `--yolo` to Codex CLI invocation and adjusts tests. ## Testing - `cargo test` ## Commits (last 71) - 299d45b feat(adapters): add --yolo to codex cli - 758cce2 feat(robot): human-in-the-loop improvements - separate queue, TUI metadata, event naming - 7c99179 refactor: decouple ralph-telegram from ralph-core via RobotService trait (KISS item #9) - bb2129f refactor: remove unused ralph-adapters dependency from ralph-tui (KISS item #13) - 720cdf6 refactor: unify TDD skills into single test-driven-development skill (KISS item #2) - a6c2588 fix: resolve 26 clippy warnings across workspace (unblock backpressure) - eb622e1 refactor: reduce PDD and code-task-generator constraint density (KISS item #11) - cf79fc3 refactor: reduce code-assist constraint density from 111 to 32 MUSTs (KISS item #11) - 877989c refactor: consolidate ralph-loop and ralph-diagnostics into ralph-operations skill (KISS item #10) - 794d142 chore: remove standalone codebase-summary skill (KISS item #12) - 7216417 feat(config): add extra_instructions field for shared hat instruction fragments - 95eb069 feat: gate session recorder/player behind `recording` feature flag (KISS #7) - 23ecdbb refactor: remove chaos_mode dead code (KISS item #6) - 8f57421 fix: handle wide character display widths in TUI ContentPane - 0fba205 fix: resolve events path from current-events marker for interact.human - 09a54d8 refactor(presets): remove 13 redundant/experimental presets, slim to core 15 - 0096624 fix: preserve TUI iteration buffers across task.start reset - 16442fd feat(code-task-generator): align CTG SOP with Level 5 spec-driven pipeline - 43a58b0 feat(pdd): align PDD SOP with Level 5 spec-driven pipeline - 655cdca feat: add spec acceptance criteria verification gate to backpressure - 0b136fc feat: add spec-to-test stub generation skill and acceptance criteria parser - 3a1819d feat: add spec completeness validator to preflight checks - b8082e9 feat: add Self-Healer hat, improve tests, fix UTF-8 boundary, make preflight opt-in - 5c801a3 feat(presets): add confidence scoring thresholds - ad2d0c0 docs: define decision journal format - 1f92695 fix(core): resolve parent skills dirs - 2304aa2 fix(cli): resolve configured skill dirs in parent workspace - 2ed48c0 fix(cli): discover parent skills dir for nested roots - f38f3fa fix(cli): discover nested skills dirs - 5797294 test(cli): cover user skill discovery - 32ff3b0 feat(cli): add skill list and improve discovery - d98b221 feat(cli): add tutorial onboarding command - 1320131 test(cli): cover run_command dry-run and continue error - 45475eb test(cli): expand loops command coverage - eddd321 fix(cli): allow partial merge queue id resolution - eaadda4 test(core): cover event loop helper branches - 8bc8569 test: cover termination reasons and merge queue resolution - 013af96 test: expand event loop and loops coverage - 9f706cb test: add preset run coverage and shared cwd guard - 147a2a9 test(cli): expand coverage for bot/web/loop runner - 7d9fa33 test(cli,adapters): expand coverage for config and pty - a4a84c9 test: expand pty streaming and planning session coverage - 7d19b5c test(cli): add loops and sop runner coverage - d6e6f2a test(cli): add memory formatting tests - 08c3987 fix(cli): normalize task status filtering - e78b5c5 test(cli): cover bot token resolution - fde3383 fix(cli): normalize token and tsx version parsing - 76ebd53 test(adapters,cli): cover pty executor paths - 1eb3275 test(cli): expand coverage for bot/web/loop_runner - 7f80ffb test: add cli run/web integration coverage - 35267f4 test(cli,adapters): expand unit coverage for helpers - 3261dbb test(cli): expand web and bot coverage - 8157eb7 test(cli,core): stabilize cwd handling and completion tests - 8998d62 test: extend loop runner and pty executor coverage - f85ce55 test: extend coverage for cli helpers - 0df20f4 Add troubleshooting links to common errors - a77c0cd docs(api): add Rust examples for agents/config/metrics/security - b0de08d docs: detail backend configuration - fa6bcf7 Update getting started quick start tutorial - 44c618c feat(cli): add doctor diagnostics command - 40116f2 Add GitHub issue templates - 0e3d503 Fix installation guide for Rust CLI - f1003f7 Add performance regression backpressure gate - 25168b7 Add verifier quality report backpressure - f4635f0 feat: add persistent mode to suppress LOOP_COMPLETE termination - 737cf79 Add self-healing hat to confession-loop preset - e0d3374 chore(presets): add decision confidence protocol - b6e9794 feat: add coverage backpressure gate - 637fd7c feat: add cargo audit backpressure gate - 49b1079 feat: auto-preflight before ralph run - d4c8410 feat: add ralph preflight command --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>