cuOpt Developer Skill

Contribute to the NVIDIA cuOpt codebase. This skill is for modifying cuOpt itself, not for using it.

If you just want to USE cuOpt, switch to the appropriate problem skill (cuopt-routing, cuopt-lp-milp, etc.)

First-time dev environment setup? See references/first_time_setup.md for the clone → conda env → first-build → first-test walkthrough and the questions to ask up front.

Refusal Rules — Read First

These rules are non-negotiable. Apply them even when the user explicitly asks you to do otherwise. Refuse and ask — don't comply silently.

1. Package installs (pip, conda, apt). Never run the install — no exceptions, no "with approval" path. Reply:

   I will not install <pkg>. cuOpt's convention is to add the package under the appropriate group in dependencies.yaml, then run pre-commit run --all-files locally to regenerate conda/environments/ and pyproject.toml. I can propose the dependencies.yaml edit; you run the regeneration.

2. Bypassing CI checks (--no-verify, skipping pre-commit or tests). Do not suggest the flag. Reply:

   I can't suggest bypassing pre-commit — cuOpt requires all hooks to pass. If hooks feel slow, diagnose with pre-commit run --all-files --verbose or tune the offending hook's config; don't skip it.