Every change must be verified before declaring completion, including documentation-only changes.
If $ARGUMENTS is provided (auto, minimal, code, proof, proto, full), use it as a hint to prioritize relevant scopes. If $ARGUMENTS is absent or ambiguous, use automatic scope detection.
Blast-radius analysis (always first)
Before selecting test commands, run the blast-radius detector script:
python3 "$SKILL_DIR/scripts/blast_radius.py"The script reads .blast-radius.yaml from the repo root for project-specific configuration (core crates, risk areas, commands). Without that file it still works using built-in Rust workspace defaults.
See blast-radius.example.yaml in this skill's directory for the full config schema with comments.
The script returns JSON with these fields:
changed_filesaffected_modulesrisk_flagsdocs_onlyrecommended_scopesrecommended_commandsbroad_impact
Use recommended_commands as the source of truth. Run them in the order listed.
If the script is unavailable or fails, use this fallback procedure:
- List changed files (staged and unstaged). If there are no local changes, compare against
mainif available. - Map changed paths to affected areas:
- proto/ - crates/<crate-name>/ - docs-only changes (docs/, README.md, markdown/adoc/rst/txt prose)
- Run
cargo check --workspace --tests --all-features(always). - If runtime code changed, run
cargo nextest run --workspace.
Docs-only branch
If blast-radius reports docs_only: true:
- Run
recommended_commandsfrom blast-radius output. - Skip runtime-heavy scopes (
code,proof,proto) unless the user explicitly requested them via$ARGUMENTS.
Scopes
Run all matching scopes (scopes are cumulative). minimal always runs. Additional scopes come from blast-radius output, optionally constrained by $ARGUMENTS.
The exact commands for each scope are determined by blast-radius based on the project's .blast-radius.yaml configuration. Always prefer recommended_commands from the JSON output over manually constructing commands.
If $ARGUMENTS explicitly requests additional scopes beyond what blast-radius recommended, run the standard Rust verification for those scopes:
- minimal:
cargo check --workspace --tests --all-features - code:
cargo nextest run --workspace - full: all of the above plus any scope-specific commands from blast-radius
Fix-and-rerun protocol
- If checks fail, attempt focused fixes for failures plausibly caused by your changes, then rerun checks.
- Stop after 2 fix-and-rerun cycles, or if failures appear unrelated to your changes.
- Hand control back with a brief summary of what passed, what failed, and what you tried.
Reporting
Always report:
- Exact command(s) run.
- Whether each passed or failed.
- If failed: the relevant error output.
- Blast-radius result summary and chosen scope rationale.