What problem does it solve?
When teams run Ratchet-driven development there are often ad-hoc discoveries that occur mid-debate, mid-phase, or mid-milestone that are not captured by automated detectors. This skill provides a fast, manual way to record those findings into the Ratchet plan so they are tracked, surfaced, and processed like other sidequests without triggering debates or guards.
Core Features & Use Cases
- Lightweight manual logging: Walks the user through a short interactive flow to capture a discovery description, category, severity, related pairs, and context.
- Resilient plan updates: Reads and safely appends entries to .ratchet/plan.yaml, using yq when available and falling back to direct YAML edits with validation and rollback suggestions.
- Contextual association: Attempts to auto-detect current milestone, issue, and active debate, and lets the user override or leave context blank; ideal for capturing CI surprises, review findings, or in-flight ideas.
Quick Start
Use /ratchet:sidequest to interactively log a new discovery into your project's ratchet plan.