| Human Note | REVIEW-BUGS.md showed up in my root |
| Version | 6.0.0 |
| Skill | rapid:bug-hunt |
Bug Description
The bug-hunt judge subagent writes REVIEW-BUGS.md to the worktree root (e.g. .rapid-worktrees/foundation/REVIEW-BUGS.md) instead of .planning/sets/{setId}/REVIEW-BUGS.md. The orchestrator then writes its own canonical version to the correct path, but never cleans up the judge's misplaced copy.
The two files have different formats: the worktree root copy uses the judge's role-judge.md template (H1-xxx IDs, narrative "Hunter evidence"/"Advocate response"/"Ruling" structure), while the canonical version uses the orchestrator's BUG-xxx structure.
Steps to Reproduce
- Run
/rapid:bug-hunt on a set that uses a worktree
- After completion, check the worktree root directory (e.g.
.rapid-worktrees/{setId}/)
- A
REVIEW-BUGS.md exists at the worktree root in addition to the canonical copy at .planning/sets/{setId}/REVIEW-BUGS.md
Root Cause / Suggested Fix
Contradictory specifications between role definition and skill orchestrator:
src/modules/roles/role-judge.md (lines 11, 19, 50) tells the judge to "Write REVIEW-BUGS.md at the review path" and expects a "Review path" input.
skills/bug-hunt/SKILL.md step 3.6 (lines 228-255) spawns the judge but never passes a ## Review Path section. It only passes Findings, Challenges, Working Directory, and Instructions.
skills/bug-hunt/SKILL.md step 3.8 (lines 269-276) has the orchestrator write its own REVIEW-BUGS.md to the correct path.
At runtime, the judge follows its role definition and writes REVIEW-BUGS.md, but without a review path it falls back to writing relative to the ## Working Directory (the worktree root).
Suggested fix (Option B preferred): Add "Do NOT write REVIEW-BUGS.md — only return rulings data via RAPID:RETURN" to the judge instructions in step 3.6, and update role-judge.md to remove the write responsibility. This is cleaner since the orchestrator already reformats the output with its own BUG-xxx ID scheme.
Workaround
Manually delete the misplaced file from the worktree root, or run /rapid:cleanup on the set.
Related Issues
None identified.
Co-Authored-By: Claude Opus 4.6
Bug Description
The bug-hunt judge subagent writes
REVIEW-BUGS.mdto the worktree root (e.g..rapid-worktrees/foundation/REVIEW-BUGS.md) instead of.planning/sets/{setId}/REVIEW-BUGS.md. The orchestrator then writes its own canonical version to the correct path, but never cleans up the judge's misplaced copy.The two files have different formats: the worktree root copy uses the judge's
role-judge.mdtemplate (H1-xxx IDs, narrative "Hunter evidence"/"Advocate response"/"Ruling" structure), while the canonical version uses the orchestrator's BUG-xxx structure.Steps to Reproduce
/rapid:bug-hunton a set that uses a worktree.rapid-worktrees/{setId}/)REVIEW-BUGS.mdexists at the worktree root in addition to the canonical copy at.planning/sets/{setId}/REVIEW-BUGS.mdRoot Cause / Suggested Fix
Contradictory specifications between role definition and skill orchestrator:
src/modules/roles/role-judge.md(lines 11, 19, 50) tells the judge to "Write REVIEW-BUGS.md at the review path" and expects a "Review path" input.skills/bug-hunt/SKILL.mdstep 3.6 (lines 228-255) spawns the judge but never passes a## Review Pathsection. It only passes Findings, Challenges, Working Directory, and Instructions.skills/bug-hunt/SKILL.mdstep 3.8 (lines 269-276) has the orchestrator write its own REVIEW-BUGS.md to the correct path.At runtime, the judge follows its role definition and writes
REVIEW-BUGS.md, but without a review path it falls back to writing relative to the## Working Directory(the worktree root).Suggested fix (Option B preferred): Add "Do NOT write REVIEW-BUGS.md — only return rulings data via RAPID:RETURN" to the judge instructions in step 3.6, and update
role-judge.mdto remove the write responsibility. This is cleaner since the orchestrator already reformats the output with its own BUG-xxx ID scheme.Workaround
Manually delete the misplaced file from the worktree root, or run
/rapid:cleanupon the set.Related Issues
None identified.
Co-Authored-By: Claude Opus 4.6