rocq-bisect

>

shentufoundation/openmath-skills2 installsApache-2.0Synced Aug 22

Tech stack

Works with

Claude CodeCursorCodex CLIGitHub CopilotGemini CLI
---
name: rocq-bisect
description: >
license: Apache-2.0
---

# Bisecting Rocq Regressions

Use this skill when you already have a reproducible regression and need to find
the release or commit that changed behavior. Keep `SKILL.md` for the tiered
decision process; use the guide for exact commands and reporting detail.

## Instructions

- Minimise the failing example first; do not bisect a noisy or flaky test.
- Choose the cheapest tier that can answer the question: release, Docker, then source.
- Make the pass/fail command deterministic before running any bisect loop.
- Confirm one known-good and one known-bad endpoint before narrowing the range.
- Record exact versions, tags, or commits as you go.
- Re-run the final culprit manually before reporting it.

## Workflow Checklist

1. Produce a standalone test file or script, ideally with `rocq-mwe`.
2. Decide whether release bisection, Docker bisection, or `git bisect` is appropriate.
3. Validate the good and bad endpoints on the same test.
4. Automate the pass/fail condition with a shell command or script.
5. Run the bisect loop and save the first bad release or commit.
6. Package the result with the minimized example and environment summary.

## Notes

- Use `rocq-setup` when you need help managing opam switches during release bisection.
- The full tier-by-tier procedures, anti-patterns, and reporting checklist live
  in [references/guide.md](references/guide.md).

## References

- [guide.md](references/guide.md)

More Debugging skills

← All Debugging skills

Check your AI visibility

One URL in, a 0–100 score and the exact fixes out.

RUN THE CHECK

Browse all the tools

15 tools across six categories
13 of them never send your data anywhere

Free · No signup · No trial clock

SEE THE DIRECTORY