What problem does it solve?
Provides a clear human override for Ratchet debates that have been escalated or left undecided by an automated tiebreaker, preventing stalled issues and ensuring a definitive decision and reasoning are recorded so the workflow can progress.
Core Features & Use Cases
- Human Verdict Capture: Presents escalated debates, summarizes rounds and key arguments, and collects an Accept, Reject, or Modify decision with human reasoning.
- State & Plan Management: Writes or updates .ratchet/debates/<id>/verdict.json and meta.json, updates .ratchet/plan.yaml phase_status and issue state, and advances phases when conditions are met.
- Scoring & Audit Trail: Invokes score update scripts to append outcomes to .ratchet/scores and records timestamps and resolver identity for auditing.
- Use Case: A reviewer inspects a disputed build change, chooses Accept to advance the issue phase, or selects Modify with required changes to return work to the generative agent.
Quick Start
Use the /ratchet:verdict command with the debate id and your choice (accept, reject, or modify) to record a human decision and update the plan.