Rocq Build Troubleshoot
Testing & Qualityrocq-build-troubleshootRocq Build Troubleshoot is an Agent Skill for testing & quality published in the formal-land/rocq-of-rust repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Fast workflow to diagnose and fix Rocq/Coq compile errors in this repository, especially missing imports after links/simulate splits and per-file compile checks.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/formal-land/rocq-of-rust/blob/HEAD/RocqOfRust/skills/rocq-build-troubleshoot/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/rocq-build-troubleshoot, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Rocq Build Troubleshoot
Use this skill when a .v file fails to compile and the goal is a minimal targeted fix.
Scope
- Repository:
RocqOfRust - Commands use project flags:
-R . RocqOfRust -impredicative-set - Prefer single-file checks first, then dependency checks.
Workflow
- Reproduce exactly:
coqc -R . RocqOfRust -impredicative-set path/to/file.v
- If error references missing module/loadpath:
- Add explicit
Require Import ...in the failing file. - Do not rely on removed aggregator modules.
- Prefer per-function imports in
revm/revm_interpreter/instructions/{links,simulate}/....
- If error is argument-order/type mismatch in
run_*call:
- Compare the local
run_*instance signature in.../links/.... - Align call order exactly; remove placeholder
_arguments unless required by implicit params.
- If
Rangeliterals fail type inference:
- Use record notation with typed zeros:
{|
Range.start := (0 : usize);
Range.end_ := (0 : usize)
|}
- Recompile touched file(s):
coqc -R . RocqOfRust -impredicative-set path/to/file.v
- Optional dependency sanity check:
make path/to/file.vo
Guardrails
- Keep fixes minimal and local.
- Do not reintroduce removed aggregators.
- Preserve
Admittedwhere the project intentionally keeps placeholders. - If proving
_eqfails, check semantic alignment before attemptingQed.